文档中心 > API类目 > 淘宝商品API

tmall.item.apple.shiptime.update (更新商品发货时间和批次)

增加更新删除商品/SKU发货时间和批次库存(支持同一商品下的SKU同时批量更新) 1. { "shipTimeType": 2, ----相对发货时间(值为1则为绝对发货时间) "updateType": 0 ---更新SKU }, 按照指定SKU更新指定SKU的发货时间,如果原本是商品级发货时间,商品级发货时间也清空 2. { "shipTimeType": 0, -- 删除发货时间 "updateType": 0 --更新SKU }, 按照指定SKU删除指定SKU的发货时间 3. { "shipTimeType": 2, ----相对发货时间(值为1则为绝对发货时间) "updateType": 1 ---更新商品 }, 更新商品级发货时间,如果原本是SKU级发货时间,清空所有SKU上的发货时间 4. { "shipTimeType": 0, -- 删除发货时间 "updateType": 1 --更新商品 }, 删除商品级的发货时间

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_id Number 必须 123456789 商品ID
ship_time String 可选 7 被更新SKU的发货时间,后台会根据三个子属性去查找匹配的sku,如果找到就默认对sku进行更新,当无匹配sku且更新类型针对sku,会报错。
commit_code String 可选 1 批次信息
sku_ship_times UpdateAppleSkuShipTime 可选 sku发货时间
  • └ ship_time
  • String
  • 可选
  • 7
  • 被更新发货时间;格式和具体设置的发货时间格式相关。绝对发货时间填写yyyy-MM-dd;相对发货时间填写数字。
  • └ outer_id
  • String
  • 可选
  • 123456
  • Sku的商家外部id;如:2015_07_23_D_123
  • └ commit_code
  • String
  • 可选
  • 1
  • 批次信息
  • └ sku_id
  • Number
  • 可选
  • 123456
  • SKU id
  • └ properties
  • String
  • 可选
  • 1627207:28326;1630696:3266779
  • sku属性
option UpdateItemShipTimeOption 必须 批量更新商品/SKU发货时间的备选项
  • └ ship_time_type
  • Number
  • 必须
  • 1
  • 0代表清空匹配的SKU发货时间数据或者商品发货时间数据;1代表:固定发货时间;2代表:相对发货时间
  • └ update_type
  • Number
  • 可选
  • 0
  • 更新类型,默认不填时更新sku,0表示更新sku,1表示更新商品维度,其他值均非法

响应参数

名称 类型 示例值 描述
result String 1234567890 错误码信息集合

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallItemAppleShiptimeUpdateRequest req = new TmallItemAppleShiptimeUpdateRequest();
req.setItemId(123456789L);
req.setShipTime("7");
req.setCommitCode("1");
TmallItemAppleShiptimeUpdateRequest.UpdateAppleSkuShipTime obj1 = new TmallItemAppleShiptimeUpdateRequest.UpdateAppleSkuShipTime();
obj1.setShipTime("7");
obj1.setOuterId("123456");
obj1.setCommitCode("1");
obj1.setSkuId(123456L);
obj1.setProperties("1627207:28326;1630696:3266779");
req.setSkuShipTimes(obj1);
TmallItemAppleShiptimeUpdateRequest.UpdateItemShipTimeOption obj2 = new TmallItemAppleShiptimeUpdateRequest.UpdateItemShipTimeOption();
obj2.setShipTimeType(1L);
obj2.setUpdateType(0L);
req.setOption(obj2);
TmallItemAppleShiptimeUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_item_apple_shiptime_update_response>
    <result>1234567890</result>
</tmall_item_apple_shiptime_update_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部