淘宝开放平台

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

淘宝商品API

tmall.item.outerid.update (天猫商品/SKU商家编码更新接口)

天猫商品/SKU商家编码更新接口；支持商品、SKU的商家编码同时更新；支持同一商品下的SKU批量更新。（感谢sample小雨提供接口命名）

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_id Number 必须 1234567890 商品ID
outer_id String 可选 2015_06_01_D_123 商品维度商家编码，如果不修改可以不传；清空请设置空串
sku_outers UpdateSkuOuterId [] 可选
  • 最大列表长度：2000
    		•  商品SKU更新OuterId时候用的数据
    • └ outer_id
    • String
    • 可选
    • 2015_01_05_D_123
    • 被更新的Sku的商家外部id
    • └ properties
    • String
    • 可选
    • 1627207:28326;1630696:3266779
    • Sku属性串。格式:pid:vid;pid:vid,如: 1627207:3232483;1630696:3284570,表示机身颜色:军绿色;手机套餐:一电一充；如果填写将以属性对形式查找被更新SKU
    • └ sku_id
    • Number
    • 可选
    • 123456
    • SkuID，如果填写，将以SKUID查找被更新的SKU

    响应参数

    名称 类型 示例值 描述
    outerid_update_result String 1234567890 商家编码更新结果

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallItemOuteridUpdateRequest req = new TmallItemOuteridUpdateRequest();
    req.setItemId(1234567890L);
    req.setOuterId("2015_06_01_D_123");
    List<TmallItemOuteridUpdateRequest.UpdateSkuOuterId> list2 = new ArrayList<TmallItemOuteridUpdateRequest.UpdateSkuOuterId>();
    TmallItemOuteridUpdateRequest.UpdateSkuOuterId obj3 = new TmallItemOuteridUpdateRequest.UpdateSkuOuterId();
    list2.add(obj3);
    obj3.setOuterId("2015_01_05_D_123");
    obj3.setProperties("1627207:28326;1630696:3266779");
    obj3.setSkuId(123456L);
    req.setSkuOuters(list2);
    TmallItemOuteridUpdateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    1
    2
    3
    <tmall_item_outerid_update_response>
        <outerid_update_result>1234567890</outerid_update_result>
    </tmall_item_outerid_update_response>

    异常示例

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

    错误码解释

    错误码 错误描述 解决方案
    isv.invalid-permission:publish_itemupdate_item C卖家没有调用天猫服务层接口发布或编辑商品的权限 带tmall 字样的schema接口，仅支持天猫商家；淘宝用户使用带taobao 字样的schema接口
    isv.item-service-error:IC_CHECKSTEP_INPUT_PROPERTY_ERROR 输入属性错误 按api描述传人正确值
    isp.tmall_item_service_error 服务错误，稍后重试 服务错误，稍后重试
    isv.item-service-error:CATEGORY_LIMIT_SPU_BOOK_NORMAL 请在ISBN输入框内输入13位或10位ISBN数字，不包括“-”符号，如确认正确，则可能是该ISBN还未授权发布 检查输入的ISBN是否正确 或已授权发布
    isv.item-service-error:ITEM_IS_NOT_BELONG_TO_SELLER 对不起，您不能操作不属于您的商品 检查修改时入参，item_id (商品id）和sessionkey 是否对应同一个商家，非同一个商家不允许修改
    isv.invalid-parameter:item_id 商品id不存在 商品id不存在
    isv.invalid-parameter:item-deleted 商品已被删除 商品已被删除
    isv.item-service-error:IC_CHECKSTEP_ALREADY_EXISTS_SAME_SPU 您已发布过同类宝贝，不允许重复发布； 您已发布过同类宝贝，不允许重复发布；
    isv.item-service-error:IC_ITEM_TITLE_IS_TOO_LONG 宝贝标题最多不能超过60个字节（30个汉字） 宝贝标题最多不能超过60个字节（30个汉字）
    isv.item-service-error:IC_CHECKSTEP_INPUT_PROPERTY_ERROR_1 输入属性值不能包括 其他 、其它、其她 输入属性值不能包括 其他 、其它、其她

    API工具

    API测试工具 错误码查询工具 SDK下载

    如何获得此API

    FAQ

    我要提问
    返回
    顶部