文档中心 > API文档

taobao.omniitem.item.fullupdate (全渠道商品全量更新)

全渠道商品全量更新,仅适用于全渠道门店商品 需要全量传入商品相关所有参数,更新时会根据传入的字段进行全量更新 对于SKU信息,会以skus对象进行判断,若传入的skus对象的sku为商品之前未包含的,则新增SKU,如果原先商品有该sku但现在没有传,则删除该SKU。所有传入的SKU信息要么全部均传入skuId,要么全部都不传入skuId。对于新增SKU的场景,目前无需传入SKUID,会根据传入的销售属性自动对应

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
light_publish_info ItemLightPublishDto 必须 发布商品信息
  • └ barcode
  • String
  • 可选
  • 6936983800013
  • 商品条形码
  • └ cat_id
  • Number
  • 必须
  • 126518010
  • 商品叶子类目
  • └ desc
  • String
  • 必须
  • 商品描述实例
  • 商品描述信息
  • └ extend_attr
  • String
  • 可选
  • {}
  • 扩展字段
  • images
  • ItemLightPublishImageDto []
  • 必须
  • 商品图片,最少1张,最多5张
  • └ url
  • String
  • 必须
  • i7/T1rfxpXcVhXXXH9QcZ_033150.jpg
  • 图片空间URL
  • └ item_id
  • Number
  • 可选
  • 123456
  • 商品ID,若填入则以itemId为准
  • └ operator
  • String
  • 可选
  • 子账号
  • 操作人
  • └ outer_id
  • String
  • 可选
  • 12345
  • 商家编码
  • └ pretium
  • String
  • 可选
  • 100.00
  • 销售价
  • └ price
  • String
  • 必须
  • 100.00
  • 吊牌价
  • skus
  • ItemLightPublishSkuDto []
  • 必须
  • sku信息
  • └ sku_barcode
  • String
  • 可选
  • 6936983800013
  • sku条形码
  • └ extend_attr
  • String
  • 可选
  • {}
  • sku扩展字段
  • └ pretium
  • String
  • 可选
  • 100.00
  • sku销售价
  • └ price
  • String
  • 必须
  • 100.00
  • sku吊牌价
  • sale_props
  • ItemLightPublishSalePropDto []
  • 必须
  • sku销售属性
  • └ pid
  • Number
  • 必须
  • 10016
  • 销售属性pid
  • └ value
  • String
  • 必须
  • XL
  • 销售属性值
  • └ sku_id
  • Number
  • 可选
  • 1234567
  • skuId
  • └ sku_outer_id
  • String
  • 可选
  • 12345
  • sku商家编码
  • └ subtitle
  • String
  • 必须
  • 宝贝
  • 商品卖点
  • └ title
  • String
  • 必须
  • 宝贝标题
  • 商品标题
operate_type String 必须 STORE 操作类型,STORE表示门店域新增,ALL表示全域新增

响应参数

名称 类型 示例值 描述
result OmniResult result 返回结果
  • └ code
  • String
  • code
  • 错误码,code=0表示成功
  • data
  • ItemLightPublishResult
  • data
  • data
  • duplicate_infos
  • ItemSkuDuplicateInfo []
  • 重复商品信息
  • 重复商品信息
  • └ barcode
  • String
  • 123456
  • 商品barcode
  • duplicate_details
  • ItemSkuDuplicateDetail []
  • 重复商品详情列表
  • 重复商品详情列表,如果重复商品过多,目前只展示部分
  • └ barcode
  • String
  • 123456
  • 商品barcode
  • └ item_id
  • Number
  • 12345
  • itemId
  • └ outer_id
  • String
  • aaa
  • outerId
  • └ sku_barcode
  • String
  • 123456
  • skuBarcode
  • └ sku_id
  • Number
  • 123
  • skuId
  • └ sku_outer_id
  • String
  • 1234567
  • skuOuterId
  • └ duplicate_size
  • Number
  • 30
  • duplicateSize
  • └ outer_id
  • String
  • 12345
  • outerId
  • └ sku_barcode
  • String
  • 11111
  • skuBarcode
  • └ sku_outer_id
  • String
  • 22222
  • skuOuterId
  • └ item_id
  • Number
  • 12345
  • 创建生成的itemId
  • └ sku_ids
  • String
  • skuId:outerId
  • 创建生成的skuId
  • └ message
  • String
  • msg
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
OmniitemItemFullupdateRequest req = new OmniitemItemFullupdateRequest();
OmniitemItemFullupdateRequest.ItemLightPublishDto obj1 = new OmniitemItemFullupdateRequest.ItemLightPublishDto();
obj1.setBarcode("6936983800013");
obj1.setCatId(126518010L);
obj1.setDesc("商品描述实例");
obj1.setExtendAttr("{}");
List<OmniitemItemFullupdateRequest.ItemLightPublishImageDto> list3 = new ArrayList<OmniitemItemFullupdateRequest.ItemLightPublishImageDto>();
OmniitemItemFullupdateRequest.ItemLightPublishImageDto obj4 = new OmniitemItemFullupdateRequest.ItemLightPublishImageDto();
list3.add(obj4);
obj4.setUrl("i7/T1rfxpXcVhXXXH9QcZ_033150.jpg");
obj1.setImages(list3);
obj1.setItemId(123456L);
obj1.setOperator("子账号");
obj1.setOuterId("12345");
obj1.setPretium("100.00");
obj1.setPrice("100.00");
List<OmniitemItemFullupdateRequest.ItemLightPublishSkuDto> list6 = new ArrayList<OmniitemItemFullupdateRequest.ItemLightPublishSkuDto>();
OmniitemItemFullupdateRequest.ItemLightPublishSkuDto obj7 = new OmniitemItemFullupdateRequest.ItemLightPublishSkuDto();
list6.add(obj7);
obj7.setSkuBarcode("6936983800013");
obj7.setExtendAttr("{}");
obj7.setPretium("100.00");
obj7.setPrice("100.00");
List<OmniitemItemFullupdateRequest.ItemLightPublishSalePropDto> list10 = new ArrayList<OmniitemItemFullupdateRequest.ItemLightPublishSalePropDto>();
OmniitemItemFullupdateRequest.ItemLightPublishSalePropDto obj11 = new OmniitemItemFullupdateRequest.ItemLightPublishSalePropDto();
list10.add(obj11);
obj11.setPid(10016L);
obj11.setValue("XL");
list8.setSaleProps(list10);
obj7.setSkuId(1234567L);
obj7.setSkuOuterId("12345");
obj1.setSkus(list6);
obj1.setSubtitle("宝贝");
obj1.setTitle("宝贝标题");
req.setLightPublishInfo(obj1);
req.setOperateType("STORE");
OmniitemItemFullupdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<omniitem_item_fullupdate_response>
    <result>
        <code>code</code>
        <data>
            <duplicate_infos>
                <item_sku_duplicate_info>
                    <barcode>123456</barcode>
                    <duplicate_details>
                        <item_sku_duplicate_detail>
                            <barcode>123456</barcode>
                            <item_id>12345</item_id>
                            <outer_id>aaa</outer_id>
                            <sku_barcode>123456</sku_barcode>
                            <sku_id>123</sku_id>
                            <sku_outer_id>1234567</sku_outer_id>
                        </item_sku_duplicate_detail>
                    </duplicate_details>
                    <duplicate_size>30</duplicate_size>
                    <outer_id>12345</outer_id>
                    <sku_barcode>11111</sku_barcode>
                    <sku_outer_id>22222</sku_outer_id>
                </item_sku_duplicate_info>
            </duplicate_infos>
            <item_id>12345</item_id>
            <sku_ids>skuId:outerId</sku_ids>
        </data>
        <message>msg</message>
    </result>
</omniitem_item_fullupdate_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

返回
顶部