文档中心 > API类目 > 商品编辑

tmall.item.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 被更新发货时间(商品级);格式和具体设置的发货时间格式相关。绝对发货时间填写yyyy-MM-dd;相对发货时间填写数字。发货时间必须在当前时间后三天。如果设置的绝对时间小于当前时间的三天后,会清除该商品的发货时间设置。如果是相对时间小于3,则会提示出错。如果shiptimeType为0,要清除商品上的发货时间,该字段可以填任意字符,也可以不填。
sku_ship_times UpdateSkuShipTime [] 可选
  • 最大列表长度:20
  • 被更新SKU的发货时间,后台会根据三个子属性去查找匹配的sku,如果找到就默认对sku进行更新,当无匹配sku且更新类型针对sku,会报错。
    • └ ship_time
    • String
    • 可选
    • 7
    • 被更新发货时间;格式和具体设置的发货时间格式相关。绝对发货时间填写yyyy-MM-dd;相对发货时间填写数字。
    • └ sku_id
    • Number
    • 可选
    • 123456
    • SKU的ID
    • └ properties
    • String
    • 可选
    • 1627207:28326;1630696:3266779
    • Sku属性串。格式:pid:vid;pid:vid,如: 1627207:3232483;1630696:3284570,表示机身颜色:军绿色;手机套餐:一电一充
    • └ outer_id
    • String
    • 可选
    • 2015_01_05_D_123
    • Sku的商家外部id;如:2015_07_23_D_123
    option UpdateItemShipTimeOption 必须 批量更新商品/SKU发货时间的备选项
    • └ ship_time_type
    • Number
    • 必须
    • 1
    • 0代表清空匹配的SKU发货时间数据或者商品发货时间数据;1代表:固定发货时间;2代表:相对发货时间
    • └ update_type
    • Number
    • 可选
    • 0
    • 更新类型,默认不填时更新sku,0表示更新sku,1表示更新商品维度,其他值均非法

    响应参数

    名称 类型 示例值 描述
    result String 1234567890 被修改的商品ID

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallItemShiptimeUpdateRequest req = new TmallItemShiptimeUpdateRequest();
    req.setItemId(123456789L);
    req.setShipTime("7");
    List<TmallItemShiptimeUpdateRequest.UpdateSkuShipTime> list2 = new ArrayList<TmallItemShiptimeUpdateRequest.UpdateSkuShipTime>();
    TmallItemShiptimeUpdateRequest.UpdateSkuShipTime obj3 = new TmallItemShiptimeUpdateRequest.UpdateSkuShipTime();
    list2.add(obj3);
    obj3.setShipTime("7");
    obj3.setSkuId(123456L);
    obj3.setProperties("1627207:28326;1630696:3266779");
    obj3.setOuterId("2015_01_05_D_123");
    req.setSkuShipTimes(list2);
    TmallItemShiptimeUpdateRequest.UpdateItemShipTimeOption obj4 = new TmallItemShiptimeUpdateRequest.UpdateItemShipTimeOption();
    obj4.setShipTimeType(1L);
    obj4.setUpdateType(0L);
    req.setOption(obj4);
    TmallItemShiptimeUpdateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

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

    返回
    顶部