文档中心 > API文档

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

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

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

请求参数

名称	类型	是否必须	示例值	描述
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>

{
    "omniitem_item_fullupdate_response":{
        "result":{
            "code":"code",
            "data":{
                "duplicate_infos":{
                    "item_sku_duplicate_info":[
                        {
                            "barcode":"123456",
                            "duplicate_details":{
                                "item_sku_duplicate_detail":[
                                    {
                                        "barcode":"123456",
                                        "item_id":12345,
                                        "outer_id":"aaa",
                                        "sku_barcode":"123456",
                                        "sku_id":123,
                                        "sku_outer_id":"1234567"
                                    }
                                ]
                            },
                            "duplicate_size":30,
                            "outer_id":"12345",
                            "sku_barcode":"11111",
                            "sku_outer_id":"22222"
                        }
                    ]
                },
                "item_id":12345,
                "sku_ids":"skuId:outerId"
            },
            "message":"msg"
        }
    }
}

异常示例

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文档