文档中心 > API类目 > 全球速卖通-商品管理

全球速卖通-商品管理

aliexpress.postproduct.redefining.editproductcidattidsku (编辑产品类目、属性、sku)

编辑产品类目、属性、sku

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
product_id Number 可选 32962798010 必填，商品id，一次只能上传一个
category_id Number 可选 200000392 产品类目ID，如果不想调整类目，则不要填写。
product_skus AeopAeProductSku [] 可选
  • 最大列表长度：999
    		•  该产品新的类目SKU属性。如果没有指定categoryId, 则该SKU属性则为当前产品所属类目下的SKU属性，如果指定了categoryId, 则该SKU属性则为新类目下的SKU属性。特别提示：新增SKU实际可售库存属性ipmSkuStock，该属性值的合理取值范围为0~999999，如该商品有SKU时，请确保至少有一个SKU是有货状态，也就是ipmSkuStock取值是1~999999，在整个商品纬度库存值的取值范围是1~999999。
    • aeop_s_k_u_property
    • AeopSkuProperty []
    • 可选
    • SKU属性
    • └ property_value_definition_name
    • String
    • 可选
    • pink
    • 属性值自定义名称，商品SKU属性值没有自定义名称时，该字段不填
    • └ sku_image
    • String
    • 可选
    • http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg
    • SKU图片地址
    • └ sku_property_id
    • Number
    • 可选
    • 14
    • SKU属性ID
    • └ property_value_id
    • Number
    • 可选
    • 366
    • SKU属性值ID
    • └ currency_code
    • String
    • 可选
    • USD
    • 商品价格的货币单位。美元: USD, 卢布: RUB，人民币：CNY
    • └ id
    • String
    • 可选
    • "200000182:193;200007763:201336100"
    • SKU id，格式：sku_property_id:sku_property_value_id,不需要变更类目不用传，自定义属性必传
    • └ ipm_sku_stock
    • Number
    • 可选
    • 1234
    • SKU实际可售库存属性ipmSkuStock，该属性值的合理取值范围为0~999999，如该商品有SKU时，请确保至少有一个SKU是有货状态，也就是ipmSkuStock取值是1~999999，在整个商品纬度库存值的取值范围是1~999999。 如果同时设置了skuStock属性，那么系统以ipmSkuStock属性为优先；如果没有设置ipmSkuStock属性，那么系统会根据skuStock属性进行设置库存，true表示999，false表示0。
    • └ sku_code
    • String
    • 可选
    • 1111
    • Sku商家编码。 格式:半角英数字,长度20,不包含空格大于号和小于号。如果用户只填写零售价（productprice）和商品编码，需要完整生成一条SKU记录提交，否则商品编码无法保存。系统会认为只提交了零售价，而没有SKU，导致商品编辑未保存。
    • └ sku_price
    • String
    • 可选
    • 0.01
    • Sku价格。取值范围:0.01-100000;单位:美元。 如:200.07，表示:200美元7分。需要在正确的价格区间内。
    • └ sku_stock
    • Boolean
    • 可选
    • true
    • 默认值：false
    • Sku库存,数据格式有货true，无货false；至少有一条sku记录是有货的。
    • └ sku_discount_price
    • String
    • 可选
    • 10.01
    • sku日常促销价
    • aeop_s_k_u_national_discount_price
    • AeopSkuNationalDiscountPrice []
    • 可选
    • sku分国家的日常促销价
    • └ discount_price
    • String
    • 可选
    • 9.09
    • sku分国家的日常促销价价格
    • └ shipto_country
    • String
    • 可选
    • RU
    • sku分国家的日常促销价国家
    product_properties AeopAeProductProperty [] 可选
  • 最大列表长度：12000
    		•  该产品新的类目属性。如果没有指定categoryId, 则该类目属性则为当前产品所属类目下的类目属性，如果指定了categoryId, 则该类目属性则为新类目下的类目属性。
    • └ attr_name
    • String
    • 可选
    • yellow
    • 自定义属性名属性名。 自定义属性名时,该项必填.
    • └ attr_name_id
    • Number
    • 可选
    • 284
    • 属性名ID。从类目属性接口getAttributesResultByCateId获取普通类目属性，不可填入sku属性。 自定义属性名时,该项不填.
    • └ attr_value
    • String
    • 可选
    • yellow-red
    • 自定义属性值。自定义属性名时,该项必填。 当自定义属性值内容为区间情况时，建议格式2 - 5 kg。(注意，数字'-'单位三者间是要加空格的！)
    • └ attr_value_end
    • String
    • 可选
    • 0
    • 自定义属性值的结束端
    • └ attr_value_start
    • String
    • 可选
    • 0
    • 自定义属性值的开始端
    • └ attr_value_unit
    • String
    • 可选
    • 0
    • 自定义属性值单位
    • └ attr_value_id
    • Number
    • 可选
    • 493
    • 属性值ID
    ext_param String 可选 { "custom_image": { "image": { "RU": "http://g01.a.alicdn.com/kf/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http://g02.a.alicdn.com/kf/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http://g02.a.alicdn.com/kf/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http://g03.a.alicdn.com/kf/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http://g02.a.alicdn.com/kf/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg", "BR": "http://g01.a.alicdn.com/kf/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http://g02.a.alicdn.com/kf/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http://g02.a.alicdn.com/kf/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http://g03.a.alicdn.com/kf/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http://g02.a.alicdn.com/kf/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg", "ES": "" }, "process_customized_image": true }, "vat_tags": [{ "sku_id": "200007763:201336100", "is_sku_vat_tag": true }] } 扩展参数 json格式custom_image 分国家主图。 vat_tags 含税标

    响应参数

    名称 类型 示例值 描述
    result AeopModifyProductResponse 0 result
    • error_details
    • ErrorDetail []
    • 0
    • errorDetails
    • └ error_code
    • String
    • 0
    • 错误代码
    • └ product_ids
    • Number []
    • 0
    • productIds
    • └ modify_count
    • Number
    • 1
    • 修改的产品数
    • └ product_id
    • Number
    • 1724649102
    • 待修改产品的ID
    • └ success
    • Boolean
    • true
    • 接口调用结果。true/false分别表示成功和失败。
    • └ error_code
    • Number
    • 16009999
    • 错误子代码
    • └ error_message
    • String
    • 系统异常！
    • 系统异常信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliexpressPostproductRedefiningEditproductcidattidskuRequest req = new AliexpressPostproductRedefiningEditproductcidattidskuRequest();
req.setProductId(32962798010L);
req.setCategoryId(200000392L);
List<AliexpressPostproductRedefiningEditproductcidattidskuRequest.AeopAeProductSku> list2 = new ArrayList<AliexpressPostproductRedefiningEditproductcidattidskuRequest.AeopAeProductSku>();
AliexpressPostproductRedefiningEditproductcidattidskuRequest.AeopAeProductSku obj3 = new AliexpressPostproductRedefiningEditproductcidattidskuRequest.AeopAeProductSku();
list2.add(obj3);
List<AliexpressPostproductRedefiningEditproductcidattidskuRequest.AeopSkuProperty> list6 = new ArrayList<AliexpressPostproductRedefiningEditproductcidattidskuRequest.AeopSkuProperty>();
AliexpressPostproductRedefiningEditproductcidattidskuRequest.AeopSkuProperty obj7 = new AliexpressPostproductRedefiningEditproductcidattidskuRequest.AeopSkuProperty();
list6.add(obj7);
obj7.setPropertyValueDefinitionName("pink");
obj7.setSkuImage("http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg");
obj7.setSkuPropertyId(14L);
obj7.setPropertyValueId(366L);
list4.setAeopSKUProperty(list6);
obj3.setCurrencyCode("USD");
obj3.setId("\"200000182:193;200007763:201336100\"");
obj3.setIpmSkuStock(1234L);
obj3.setSkuCode("1111");
obj3.setSkuPrice("0.01");
obj3.setSkuStock(true);
obj3.setSkuDiscountPrice("10.01");
List<AliexpressPostproductRedefiningEditproductcidattidskuRequest.AeopSkuNationalDiscountPrice> list10 = new ArrayList<AliexpressPostproductRedefiningEditproductcidattidskuRequest.AeopSkuNationalDiscountPrice>();
AliexpressPostproductRedefiningEditproductcidattidskuRequest.AeopSkuNationalDiscountPrice obj11 = new AliexpressPostproductRedefiningEditproductcidattidskuRequest.AeopSkuNationalDiscountPrice();
list10.add(obj11);
obj11.setDiscountPrice("9.09");
obj11.setShiptoCountry("RU");
list8.setAeopSKUNationalDiscountPrice(list10);
req.setProductSkus(list2);
List<AliexpressPostproductRedefiningEditproductcidattidskuRequest.AeopAeProductProperty> list13 = new ArrayList<AliexpressPostproductRedefiningEditproductcidattidskuRequest.AeopAeProductProperty>();
AliexpressPostproductRedefiningEditproductcidattidskuRequest.AeopAeProductProperty obj14 = new AliexpressPostproductRedefiningEditproductcidattidskuRequest.AeopAeProductProperty();
list13.add(obj14);
obj14.setAttrName("yellow");
obj14.setAttrNameId(284L);
obj14.setAttrValue("yellow-red");
obj14.setAttrValueEnd("0");
obj14.setAttrValueStart("0");
obj14.setAttrValueUnit("0");
obj14.setAttrValueId(493L);
req.setProductProperties(list13);
req.setExtParam("{   \"custom_image\": {     \"image\": {       \"RU\": \"http://g01.a.alicdn.com/kf/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http://g02.a.alicdn.com/kf/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http://g02.a.alicdn.com/kf/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http://g03.a.alicdn.com/kf/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http://g02.a.alicdn.com/kf/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg\",       \"BR\": \"http://g01.a.alicdn.com/kf/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http://g02.a.alicdn.com/kf/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http://g02.a.alicdn.com/kf/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http://g03.a.alicdn.com/kf/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http://g02.a.alicdn.com/kf/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg\",       \"ES\": \"\"     },     \"process_customized_image\": true   },   \"vat_tags\": [{     \"sku_id\": \"200007763:201336100\",     \"is_sku_vat_tag\": true   }] }");
AliexpressPostproductRedefiningEditproductcidattidskuResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <aliexpress_postproduct_redefining_editproductcidattidsku_response>
    <result>
        <error_details>
            <error_detail>
                <error_code>0</error_code>
                <product_ids>
                    <number>0</number>
                </product_ids>
            </error_detail>
        </error_details>
        <modify_count>1</modify_count>
        <product_id>1724649102</product_id>
        <success>true</success>
        <error_code>16009999</error_code>
        <error_message>系统异常！</error_message>
    </result>
</aliexpress_postproduct_redefining_editproductcidattidsku_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测试工具 错误码查询工具 SDK下载

    如何获得此API

    FAQ

    我要提问
    返回
    顶部
    阿里巴巴集团 | 淘宝网 | 天猫 | 聚划算 | 全球速卖通 | 阿里巴巴国际交易市场 | 1688 | 阿里妈妈 | 阿里旅行·去啊 | 阿里云计算 | YunOS | 阿里通信 | 万网 | 高德 | 优视 | 友盟 | 酷盘 | 虾米 | 天天动听 | 来往 | 钉钉 | 11Main | 支付宝
    关于淘宝 合作伙伴 营销中心 联系客服 开放平台 诚征英才 联系我们 网站地图 法律声明 © 2016 Taobao.com 版权所有
    网络文化经营许可证：文网文[2010]040号 | 增值电信业务经营许可证：浙B2-20080224-1 | 信息网络传播视听节目许可证：1109364号