文档中心 > API类目 > 度假-商品管理API

taobao.alitrip.travel.item.sku.price.modify (【API3.0】日期级别日历价格库存修改,增量维护)

【API3.0】日期级别日历价格库存增量维护

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_id Number 可选 123 商品id。itemId和outProductId至少填写一个
skus PontusTravelItemSkuInfo [] 可选
  • 最大列表长度:20
  • 商品日历价格库存套餐
    • └ outer_sku_id
    • String
    • 必须
    • 1111
    • 套餐的外部商家编码。注意:如果没有为该商品设置过套餐商家编码,则无法调用本接口更新该套餐的日历价格。请手动去网页端后台编辑下该商品:为该商品的每个套餐添加设置一个商家编码;或者调用sku.override接口给每个套餐设置一个商家编码。
    • prices
    • PontusTravelPrices []
    • 必须
    • 商品日历价格库存相关信息
    • └ date
    • Date
    • 必须
    • 2015-09-19 09:42:24
    • 日期。对于普通商品必填,对于预约商品该字段不填
    • └ operation
    • Number
    • 可选
    • 1
    • 日历价格库存的操作有以下三种:1-新增;2-增量更新;3-覆盖更新;4-删除。其中新增时成人价格和库存都必须大于0;增量更新只能对库存数进行修改,表示对某一天的成人或儿童新增或减少几个库存。覆盖更新能对库存和价格进行修改,表示用传入的值覆盖原有的库存和价格。删除支持删除单房差、儿童价格库存、成人价格库存,如果删除成人价格库存,则同时会把单房差和儿童价格库存也删除。
    • └ price
    • Number
    • 可选
    • 1234
    • 价格
    • └ price_type
    • Number
    • 必须
    • 1
    • 价格类型。price_type 取:1-成人价,2-儿童价,3-单房差
    • └ stock
    • Number
    • 可选
    • 123
    • 库存
    • └ outer_price_id
    • String
    • 可选
    • 123456
    • 外部商家团期id,可选字段,仅供商家自己使用,用来标识每一天的价格库存
    out_product_id String 可选 111 商品 外部商家编码。itemId和outProductId至少填写一个
    modify_type Number 可选 0
  • 默认值:0
  • 商品价库变更类型,0=价格库存均变更,1=价格变更,2=库存变更

    响应参数

    名称 类型 示例值 描述
    travel_item TopTravelItem 日期级别日历价格库存增量维护
    • └ created
    • Date
    • 2015-9-07 22:56:18
    • 商品创建时间
    • └ item_id
    • Number
    • 123
    • 商品id
    • └ modified
    • Date
    • 2015-09-07 22:56:18
    • 商品修改时间

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlitripTravelItemSkuPriceModifyRequest req = new AlitripTravelItemSkuPriceModifyRequest();
    req.setItemId(123L);
    List<AlitripTravelItemSkuPriceModifyRequest.PontusTravelItemSkuInfo> list2 = new ArrayList<AlitripTravelItemSkuPriceModifyRequest.PontusTravelItemSkuInfo>();
    AlitripTravelItemSkuPriceModifyRequest.PontusTravelItemSkuInfo obj3 = new AlitripTravelItemSkuPriceModifyRequest.PontusTravelItemSkuInfo();
    list2.add(obj3);
    obj3.setOuterSkuId("1111");
    List<AlitripTravelItemSkuPriceModifyRequest.PontusTravelPrices> list6 = new ArrayList<AlitripTravelItemSkuPriceModifyRequest.PontusTravelPrices>();
    AlitripTravelItemSkuPriceModifyRequest.PontusTravelPrices obj7 = new AlitripTravelItemSkuPriceModifyRequest.PontusTravelPrices();
    list6.add(obj7);
    obj7.setDate(StringUtils.parseDateTime("2015-09-19 09:42:24"));
    obj7.setOperation(1L);
    obj7.setPrice(1234L);
    obj7.setPriceType(1L);
    obj7.setStock(123L);
    obj7.setOuterPriceId("123456");
    list4.setPrices(list6);
    req.setSkus(list2);
    req.setOutProductId("111");
    req.setModifyType(0L);
    AlitripTravelItemSkuPriceModifyResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alitrip_travel_item_sku_price_modify_response>
        <travel_item>
            <created>2015-9-07 22:56:18</created>
            <item_id>123</item_id>
            <modified>2015-09-07 22:56:18</modified>
        </travel_item>
    </alitrip_travel_item_sku_price_modify_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案
    isv.remote-service-error 远端服务出错 联系服务提供方解决
    isv.invalid-parameter:product 套餐关联的产品元素错误 当地玩乐的商品套餐需要关联产品元素product
    isv.IC_DB_ACCESS_ERRORGENERIC_FAILUREIC_OPTIMISTIC_LOCKING_CONFLICT 系统错误,请稍后再试 系统错误,请稍后再试
    isv.RANGE_ERROR 套餐的价格日历不能定义从当前日期起300天之后的日期 修改套餐的价格日历
    isv.DATE_DUPLICATE 套餐在某日期下的重复设置 检查套餐下的日期设置
    isv.invalid-parameter:bookTips 预定须知不能为空 请输入预定须知
    isv.invalid-parameter:bookTips|missing-parameter:descr 预定须知不能为空|商品PC详情不能为空 请输入预定须知和商品PC详
    isv.IPM_OPERATION_SUCCESS 数据保存出现问题 系统错误,请稍后再试
    isv.CALINPRI_EMPTY 套餐价格日历为空 请在该类目下至少设置一个有效的套餐
    isv.GENERIC_FAILUREIC_DB_ACCESS_ERRORIC_OPTIMISTIC_LOCKING_CONFLICT 系统错误,请稍后再试 系统错误,请稍后再试
    isv.RULE_ERR_TRIP_HUODONG_93058_SKU_QUANTITY_LOCK 该商品参加了活动,不能修改库存 该商品参加了活动,不能修改库存
    isv.GENERIC_FAILUREIC_DB_ACCESS_ERROR 系统错误 请重试
    isv.invalid-parameter:title 商品标题长度不能超过60个字节(30个汉字) 请修改商品标题长度
    isv.missing-parameter:descr 缺少描述字段 根据错误提示修改
    isv.old_sq_not_match 库存已经发生变化 请重新编辑
    isv.FORBIDDEN_QUANTITY_ZERO_ERROR 所有日历库存为0 至少保证一个日历库存不为0
    isv.IP_TRADE_INVENTORY_MODIFY_ERROR 修改库存失败 重试,或减少日期
    isv.IP_DB_RECORD_TOO_MANY_EDIT_ERROR 库存保存失败,可能是因为日期太多 适当减少日期
    isv.invalid-parameter:ERROR 参数错误 请根据errorMsg提示修改请求参数
    isv.IC_ITEM_PRICE_IS_OVER_RANGE 价格必须在0到100亿元之间 请修改价格信息
    isv.ACROSS_ERROR 套餐的价格日历跨度不能超过179天 请修改套餐价格日历的开始和结束日期
    isv.IC_SAVE_INVENTORY_TO_IP_FAILED 保存库存失败 重试解决
    isv.biz-error: 业务异常 根据错误提示修改
    isv.IC_INTERFACE_QPS_LIMIT 商品限流 请稍后重试
    isv.IC_CATEGORY_NOT_GRANT_FOR_B 未授权发布此类目的商品 未授权发布此类目的商品
    isv.invalid-parameter:subtitle 商品亮点长度不能超过35个字符 商品亮点长度不能超过35个字符
    isv.QUERY_ITEM_ERROR 商品查询失败 https://sell.fliggy.com/icenter/errorcode/ErrorCodeSolution.htm?code=QUERY_ITEM_ERROR&owner=1
    isv.sellable_quantity_not_enough 编辑后库存小于预扣数量,库存更新失败 编辑后库存小于预扣数量,库存更新失败
    isv.QUERY_USER_INFO_ERROR 查询用户信息异常 请根据错误提示修改
    isv.IC_PRICE_SERVICE_ERROR 价格保存失败 重试解决
    isv.126:IC商品价格和库存修改错误 价格库存修改异常 请根据错误提示修改
    isp.SYS_EXCEPTION 系统异常 重试,或根据错误提示修改
    isv.IC_ITEM_DESC_COULD_NOT_BE_EMPTY 描述字段为空 根据错误提示修改
    isv.套餐[好莱坞 根据错误提示修改 根据错误提示修改
    isv.PARAM_EXCEPTION 参数异常 根据错误提示修改
    isv.biz-biz-error:COMBO_EMPTY 日历为空 请检查是否有可售卖的日期
    isv.invalid-parameter:NOTNULL 参数异常 请根据错误提示修改
    isv.biz-error:OUTER_SKU_ID_ERROR outerSkuId错误,请仔细检查再尝试 修改outer_sku_id
    isv.out-system-error IP_ILLEGAL_ARGUMENT:quantity should be greater than zero" 更新后库存小于0,修改库存后重试
    isv.IC_OPTIMISTIC_LOCKING_CONFLICT 商品更新失败,乐观锁冲突,请稍后重试 稍后重试
    isv.CHK_ELEMENT_STRUCTURE_ERROR 套餐元素非解结构化 重新申请并使用套餐元素,历史套餐元素已作废

    API工具

    如何获得此API

    FAQ

    返回
    顶部