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

aliexpress.offer.product.edit (商品发布新的编辑接口)

商品编辑接口(修改任何一个商品信息时,必须将其他所有信息进行填写全面后再提交,否则会出现报错情况出现。)营销图功能上线,增加字段

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
aeop_a_e_product AeopAeProduct 必须 产品信息
  • └ bulk_order
  • Number
  • 可选
  • 5
  • 批发最小数量 。取值范围2-100000。批发最小数量和批发折扣需同时有值或无值。
  • └ lot_num
  • Number
  • 可选
  • 1
  • 每包件数。 打包销售情况,lotNum>1,非打包销售情况,lotNum=1
  • aeop_ae_product_s_k_us
  • AeopAeProductSku []
  • 可选
  • 列表类型,以json格式来表达。参看aeopAeProductSKUs数据结构。特别提示:新增SKU实际可售库存属性ipmSkuStock,该属性值的合理取值范围为0~999999,如该商品有SKU时,请确保至少有一个SKU是有货状态,也就是ipmSkuStock取值是1~999999,在整个商品纬度库存值的取值范围是1~999999。
  • └ sku_price
  • String
  • 必须
  • 200.07
  • Sku价格。取值范围:0.01-100000;单位:美元。 如:200.07,表示:200美元7分。需要在正确的价格区间内。
  • └ sku_code
  • String
  • 可选
  • cfas00978
  • Sku商家编码。 格式:半角英数字,长度20,不包含空格大于号和小于号。如果用户只填写零售价(productprice)和商品编码,需要完整生成一条SKU记录提交,否则商品编码无法保存。系统会认为只提交了零售价,而没有SKU,导致商品编辑未保存。
  • └ ipm_sku_stock
  • Number
  • 可选
  • 1111
  • SKU实际可售库存属性ipmSkuStock,该属性值的合理取值范围为0~999999,如该商品有SKU时,请确保至少有一个SKU是有货状态,也就是ipmSkuStock取值是1~999999,在整个商品纬度库存值的取值范围是1~999999。 如果同时设置了skuStock属性,那么系统以ipmSkuStock属性为优先;如果没有设置ipmSkuStock属性,那么系统会根据skuStock属性进行设置库存,true表示999,false表示0。
  • └ id
  • String
  • 可选
  • "200000182:193;200007763:201336100"
  • SKU id,格式:sku_property_id:sku_property_value_id,不需要变更类目不用传,自定义属性必传
  • └ currency_code
  • String
  • 可选
  • USD;RUB
  • 货币单位。如果不提供该值信息,则默认为"USD";非俄罗斯卖家这个属性值可以不提供。对于俄罗斯海外卖家,该单位值必须提供,如: "RUB"。
  • aeop_s_k_u_property
  • AeopSkuProperty []
  • 可选
  • SKU属性信息
  • └ sku_property_id
  • Number
  • 可选
  • 14
  • SKU属性ID
  • └ sku_image
  • String
  • 可选
  • http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg
  • SKU图片地址
  • └ property_value_definition_name
  • String
  • 可选
  • pink
  • 属性值自定义名称
  • └ property_value_id
  • Number
  • 可选
  • 366
  • SKU属性值ID
  • └ image_url_list
  • String []
  • 可选
  • [http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg]
  • sku 套图,3:4,最多6张
  • aeop_s_k_u_national_discount_price
  • AeopSkuNationalDiscountPrice []
  • 可选
  • sku分国家的日常促销价
  • └ discount_price
  • String
  • 可选
  • 10.01
  • sku分国家的日常促销价价格
  • └ shipto_country
  • String
  • 可选
  • RU
  • sku分国家的日常促销价国家
  • └ sku_discount_price
  • String
  • 可选
  • 12.05
  • sku日常促销价
  • └ gross_weight
  • String
  • 可选
  • 1
  • sku重量,单位公斤
  • └ package_height
  • Number
  • 可选
  • 2
  • sku物流尺寸-高,单位cm
  • └ package_width
  • Number
  • 可选
  • 3
  • sku物流尺寸-宽,单位cm
  • └ package_length
  • Number
  • 可选
  • 4
  • sku物流尺寸-长,单位cm
  • └ ean_code
  • String
  • 可选
  • 12345678
  • eanCode
  • └ package_type
  • Boolean
  • 必须
  • false
  • 打包销售: true 非打包销售:false
  • └ add_unit
  • Number
  • 可选
  • 2
  • isPackSell为true时,此项必填。 每增加件数.取值范围1-1000。
  • └ reduce_strategy
  • String
  • 必须
  • place_order_withhold
  • 库存扣减策略,两种策略:place_order_withhold(下单减库存)或payment_success_deduct(支付减库存)
  • └ product_unit
  • Number
  • 可选
  • 100000000
  • 商品单位 (存储单位编号) 100000000:袋 (bag/bags)100000001:桶 (barrel/barrels)100000002:蒲式耳 (bushel/bushels)100078580:箱 (carton)100078581:厘米 (centimeter)100000003:立方米 (cubic meter)100000004:打 (dozen)100078584:英尺 (feet)100000005:加仑 (gallon)100000006:克 (gram)100078587:英寸 (inch)100000007:千克 (kilogram)100078589:千升 (kiloliter)100000008:千米 (kilometer)100078559:升 (liter/liters)100000009:英吨 (long ton)100000010:米 (meter)100000011:公吨 (metric ton)100078560:毫克 (milligram)100078596:毫升 (milliliter)100078597:毫米 (millimeter)100000012:盎司 (ounce)100000014:包 (pack/packs)100000013:双 (pair)100000015:件/个 (piece/pieces)100000016:磅 (pound)100078603:夸脱 (quart)100000017:套 (set/sets)100000018:美吨 (short ton)100078606:平方英尺 (square feet)100078607:平方英寸 (square inch)100000019:平方米 (square meter)100078609:平方码 (square yard)100000020:吨 (ton)100078558:码 (yard/yards)
  • └ base_unit
  • Number
  • 可选
  • 1
  • 自定义计重的基本产品件数,isPackSell为true时,此项必填。购买几件以内不增加运费。取值范围1-1000
  • └ sizechart_id
  • Number
  • 可选
  • 123
  • 产品所关联的尺码模版ID
  • └ package_length
  • Number
  • 必须
  • 20
  • 商品包装长度。取值范围:1-700,单位:厘米。产品包装尺寸的最大值+2×(第二大值+第三大值)不能超过2700厘米。
  • └ package_height
  • Number
  • 必须
  • 40
  • 商品包装高度。取值范围:1-700,单位:厘米。
  • └ package_width
  • Number
  • 必须
  • 30
  • 商品包装宽度。取值范围:1-700,单位:厘米。
  • └ is_pack_sell
  • Boolean
  • 可选
  • false
  • 是否自定义计重.true为自定义计重,false反之.
  • └ currency_code
  • String
  • 可选
  • USD;RUB
  • 货币单位。如果不提供该值信息,则默认为"USD";非俄罗斯卖家这个属性值可以不提供。对于俄罗斯海外卖家,该单位值必须提供,如: "RUB"。
  • └ category_id
  • Number
  • 必须
  • 200002101
  • 商品所属类目ID。必须是叶子类目,通过类目接口获取。
  • └ image_u_r_ls
  • String
  • 必须
  • 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
  • 图片URL.静态单图主图个数为1,动态多图主图个数为2-6.可从图片接口uploadTempImage上传,也可以从图片银行引入. 多个图片url用‘;’分隔符连接。
  • aeop_a_e_multimedia
  • AeopAeMultimedia
  • 可选
  • 商品多媒体信息,该属性主要包含商品的视频列表
  • aeop_a_e_videos
  • AeopAeVideo []
  • 可选
  • 多媒体信息。
  • └ poster_url
  • String
  • 可选
  • http://img01.taobaocdn.com/bao/uploaded/TB1rNdGIVXXXXbTXFXXXXXXXXXX.jpg
  • 视频封面图片的URL
  • └ media_type
  • String
  • 可选
  • video
  • 视频的类型
  • └ media_id
  • Number
  • 可选
  • 12345678
  • 视频ID
  • aeop_ae_product_propertys
  • AeopAeProductProperty []
  • 可选
  • 产品属性,以json格式进行封装后提交。参看aeopAeProductPropertys数据结构。此字段是否必填,需从类目接口getAttributesResultByCateId获取(即获取到的required来判断属性是否必填),该项只输入普通类目属性数据,不可输入sku类目属性。对于类目属性包含子类目属性的情况,此处不确认父属性和子属性,即选择任何属性,都以该对象提交。对于一个属性多个选中值的情况,以多个该对象存放。其中"attrNameId","attrValueId"为整型(Integer), "attrName", "attrValue"为字符串类型(String)。 i). 当设置一些系统属性时,如果类目自定义了一些候选值,只需要提供"attrNameId"和"attrValueId"即可。例如:{"attrNameId":494, "attrValueId":284}。 ii). 当设置一些需要手工输入属性内容时,只需要提供"attrNameId"和"attrValue"即可。例如:{"attrNameId": 1000, "attrValue": "test"} iii)当设置自定义属性时,需要提供"attrName"和"attrValue"即可。例如: {"attrName": "Color", "attrValue": "red"} iv) 当设置一个Other属性时,需要提供"attrNameId", "attrValueId", "attrValue"三个参数。例如:{"attrNameId": 1000, "attrValueId": 4, "attrValue": "Other Value"}。
  • └ attr_value_unit
  • String
  • 可选
  • 0
  • 自定义属性值单位
  • └ attr_value_start
  • String
  • 可选
  • 0
  • 自定义属性值的开始端
  • └ attr_value_end
  • String
  • 可选
  • 0
  • 自定义属性值的结束端
  • └ attr_value
  • String
  • 可选
  • 2 - 5 kg
  • 自定义属性值。自定义属性名时,该项必填。 当自定义属性值内容为区间情况时,建议格式2 - 5 kg。(注意,数字'-'单位三者间是要加空格的!)
  • └ attr_name_id
  • Number
  • 可选
  • 200000043
  • 属性名ID。从类目属性接口getAttributesResultByCateId获取普通类目属性,不可填入sku属性。 自定义属性名时,该项不填.
  • └ attr_name
  • String
  • 可选
  • size
  • 自定义属性名属性名。 自定义属性名时,该项必填.
  • └ attr_value_id
  • Number
  • 可选
  • 493
  • 属性值ID
  • └ add_weight
  • String
  • 可选
  • 30.11
  • isPackSell为true时,此项必填。 对应增加的重量.取值范围:0.001-500.000,保留三位小数,采用进位制,单位:公斤。
  • └ gross_weight
  • String
  • 可选
  • 50
  • 商品毛重,取值范围:0.001-500.000,保留三位小数,采用进位制,单位:公斤。
  • └ product_id
  • Number
  • 可选
  • 1239273
  • 编辑产品ID
  • └ group_id
  • Number
  • 可选
  • 123
  • 产品分组ID(目前不支持更改。会从数据库查历史的数据然后回填,这儿填写的不生效)
  • └ delivery_time
  • Number
  • 必须
  • 3
  • 备货期。取值范围:1-60;单位:天。
  • └ ws_valid_num
  • Number
  • 可选
  • 30
  • 商品有效天数。取值范围:1-30,单位:天。
  • └ bulk_discount
  • Number
  • 可选
  • 90
  • 批发折扣。扩大100倍,存整数。取值范围:1-99。注意:这是折扣,不是打折率。 如,打68折,则存32。批发最小数量和批发折扣需同时有值或无值。
  • └ promise_template_id
  • Number
  • 必须
  • 100
  • 服务模板ID。如果不填,则为新手模板ID。
  • └ product_price
  • String
  • 可选
  • 10.11
  • 商品一口价。取值范围:0-100000,保留两位小数;单位:美元。如:200.07,表示:200美元7分。需要在正确的价格区间内。
  • aeop_national_quote_configuration
  • AeopNationalQuoteConfiguration
  • 可选
  • 商品分国家报价的配置,如果需要删除分国家报价,只需将该对象的属性值设为空串:{"configurationType":"","configurationData":""}
  • └ configuration_data
  • String
  • 可选
  • [{"absoluteQuoteMap":{"":1.0},"shiptoCountry":"RU"},{"absoluteQuoteMap":{"":2.0},"shiptoCountry":"US"}]
  • jsonArray格式的分国家定价规则数据。 [{"absoluteQuoteMap":{"":1.0},"shiptoCountry":"RU"},{"absoluteQuoteMap":{"":2.0},"shiptoCountry":"US"}] 其中shiptoCountry:ISO两位的国家编码(目前支持国家:RU US CA ES FR UK NL IL BR CL AU UA BY JP TH SG KR ID MY PH VN IT DE SA AE PL TR), absoluteQuoteMap:价格调整信息,为map结构,其中的key为[sku_property_id:property_value_id],如果多个sku属性,则用“;”进行分割,没有sku则直接用空字符串,示例为"", "14:173", "14:173;3:2034781";值则为具体的按照configuration_type设置的数据 percentage:相对于基准价的调价比例(百分比整数,支持负数,当前限制>=-30 && <=100); relative: 相对基准价的调整值,支持负数; absolute:直接设置具体数值,不支持负数。
  • └ configuration_type
  • String
  • 可选
  • percentage, relative,absolute
  • 分国家定价规则类型[percentage:基于基准价格按比例配置; relative:相对原价涨或跌多少;absolute:按照具体报价配置 ]
  • subject_list
  • Subject []
  • 必须
  • 多语言标题
  • └ value
  • String
  • 必须
  • product subject
  • 多语言标题内容
  • └ locale
  • String
  • 必须
  • en_US
  • 多语言标题语种标记
  • └ locale
  • String
  • 必须
  • en_US
  • 商品初始发布语种标记
  • detail_source_list
  • DetailSource []
  • 必须
  • 多语言详描
  • └ web_detail
  • String
  • 可选
  • {\"version\":\"2.0.0\",\"moduleList\":[{\"type\":\"text\",\"texts\":[{\"content\":\"Thisistitle\",\"class\":\"title\"},{\"content\":\"Thisisdescription\",\"class\":\"body\"}]}]}
  • pc端详描内容,具体格式请参考 https://developers.aliexpress.com/doc.htm?docId=109513&docType=1
  • └ mobile_detail
  • String
  • 可选
  • {\"version\":\"2.0.0\",\"moduleList\":[{\"type\":\"text\",\"texts\":[{\"content\":\"Thisistitle\",\"class\":\"title\"},{\"content\":\"Thisisdescription\",\"class\":\"body\"}]}]}
  • 移动端详描内容,具体格式请参考 https://developers.aliexpress.com/doc.htm?docId=109513&docType=1
  • └ locale
  • String
  • 必须
  • en_US
  • 语言标记
  • market_images
  • MarketImage []
  • 可选
  • 营销图列表
  • └ url
  • String
  • 可选
  • https://ae01.alicdn.com/kf/HTB1C72NbcvrXXX.jpg
  • 营销图片URL
  • └ image_type
  • Number
  • 可选
  • 1
  • 1:代表长图,大小为750*1000; 2:代表方图,大小为800*800
  • └ freight_template_id
  • Number
  • 可选
  • 1000
  • 运费模版ID。通过运费接口listFreightTemplate获取。
  • └ dp_bulk_discount
  • Number
  • 可选
  • 90
  • 批发折扣。扩大100倍,存整数。取值范围:1-99。注意:这是折扣,不是打折率。 如,打68折,则存32。批发最小数量和批发折扣需同时有值或无值。
  • └ dp_bulk_order
  • Number
  • 可选
  • 2
  • 批发最小数量 。取值范围2-100000。批发最小数量和批发折扣需同时有值或无值。
  • mode_size_chart_list
  • AeopAeModeSizeChartDto []
  • 可选
  • 模特尺码数据
  • └ mode_size
  • String
  • 可选
  • 2
  • 试穿尺码
  • └ height
  • String
  • 可选
  • 2
  • 身高
  • └ bust
  • String
  • 可选
  • 2
  • 胸围
  • └ waist
  • String
  • 可选
  • 2
  • 腰围
  • └ hips
  • String
  • 可选
  • 2
  • 臀围
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
  • └ product_id
  • Number
  • 124
  • 商品的ID。

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliexpressOfferProductEditRequest req = new AliexpressOfferProductEditRequest();
AliexpressOfferProductEditRequest.AeopAeProduct obj1 = new AliexpressOfferProductEditRequest.AeopAeProduct();
obj1.setBulkOrder(5L);
obj1.setLotNum(1L);
List<AliexpressOfferProductEditRequest.AeopAeProductSku> list3 = new ArrayList<AliexpressOfferProductEditRequest.AeopAeProductSku>();
AliexpressOfferProductEditRequest.AeopAeProductSku obj4 = new AliexpressOfferProductEditRequest.AeopAeProductSku();
list3.add(obj4);
obj4.setSkuPrice("200.07");
obj4.setSkuCode("cfas00978");
obj4.setIpmSkuStock(1111L);
obj4.setId("\"200000182:193;200007763:201336100\"");
obj4.setCurrencyCode("USD;RUB");
List<AliexpressOfferProductEditRequest.AeopSkuProperty> list7 = new ArrayList<AliexpressOfferProductEditRequest.AeopSkuProperty>();
AliexpressOfferProductEditRequest.AeopSkuProperty obj8 = new AliexpressOfferProductEditRequest.AeopSkuProperty();
list7.add(obj8);
obj8.setSkuPropertyId(14L);
obj8.setSkuImage("http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg");
obj8.setPropertyValueDefinitionName("pink");
obj8.setPropertyValueId(366L);
obj8.setImageUrlList("http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg");
list5.setAeopSKUProperty(list7);
List<AliexpressOfferProductEditRequest.AeopSkuNationalDiscountPrice> list11 = new ArrayList<AliexpressOfferProductEditRequest.AeopSkuNationalDiscountPrice>();
AliexpressOfferProductEditRequest.AeopSkuNationalDiscountPrice obj12 = new AliexpressOfferProductEditRequest.AeopSkuNationalDiscountPrice();
list11.add(obj12);
obj12.setDiscountPrice("10.01");
obj12.setShiptoCountry("RU");
list9.setAeopSKUNationalDiscountPrice(list11);
obj4.setSkuDiscountPrice("12.05");
obj4.setGrossWeight("1");
obj4.setPackageHeight(2L);
obj4.setPackageWidth(3L);
obj4.setPackageLength(4L);
obj4.setEanCode("12345678");
obj1.setAeopAeProductSKUs(list3);
obj1.setPackageType(false);
obj1.setAddUnit(2L);
obj1.setReduceStrategy("place_order_withhold");
obj1.setProductUnit(100000000L);
obj1.setBaseUnit(1L);
obj1.setSizechartId(123L);
obj1.setPackageLength(20L);
obj1.setPackageHeight(40L);
obj1.setPackageWidth(30L);
obj1.setIsPackSell(false);
obj1.setCurrencyCode("USD;RUB");
obj1.setCategoryId(200002101L);
obj1.setImageURLs("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");
AliexpressOfferProductEditRequest.AeopAeMultimedia obj13 = new AliexpressOfferProductEditRequest.AeopAeMultimedia();
List<AliexpressOfferProductEditRequest.AeopAeVideo> list15 = new ArrayList<AliexpressOfferProductEditRequest.AeopAeVideo>();
AliexpressOfferProductEditRequest.AeopAeVideo obj16 = new AliexpressOfferProductEditRequest.AeopAeVideo();
list15.add(obj16);
obj16.setPosterUrl("http://img01.taobaocdn.com/bao/uploaded/TB1rNdGIVXXXXbTXFXXXXXXXXXX.jpg");
obj16.setMediaType("video");
obj16.setMediaId(12345678L);
obj13.setAeopAEVideos(list15);
obj1.setAeopAEMultimedia(obj13);
List<AliexpressOfferProductEditRequest.AeopAeProductProperty> list18 = new ArrayList<AliexpressOfferProductEditRequest.AeopAeProductProperty>();
AliexpressOfferProductEditRequest.AeopAeProductProperty obj19 = new AliexpressOfferProductEditRequest.AeopAeProductProperty();
list18.add(obj19);
obj19.setAttrValueUnit("0");
obj19.setAttrValueStart("0");
obj19.setAttrValueEnd("0");
obj19.setAttrValue("2 - 5 kg");
obj19.setAttrNameId(200000043L);
obj19.setAttrName("size");
obj19.setAttrValueId(493L);
obj1.setAeopAeProductPropertys(list18);
obj1.setAddWeight("30.11");
obj1.setGrossWeight("50");
obj1.setProductId(1239273L);
obj1.setGroupId(123L);
obj1.setDeliveryTime(3L);
obj1.setWsValidNum(30L);
obj1.setBulkDiscount(90L);
obj1.setPromiseTemplateId(100L);
obj1.setProductPrice("10.11");
AliexpressOfferProductEditRequest.AeopNationalQuoteConfiguration obj20 = new AliexpressOfferProductEditRequest.AeopNationalQuoteConfiguration();
obj20.setConfigurationData("[{\"absoluteQuoteMap\":{\"\":1.0},\"shiptoCountry\":\"RU\"},{\"absoluteQuoteMap\":{\"\":2.0},\"shiptoCountry\":\"US\"}]");
obj20.setConfigurationType("percentage, relative,absolute");
obj1.setAeopNationalQuoteConfiguration(obj20);
List<AliexpressOfferProductEditRequest.Subject> list22 = new ArrayList<AliexpressOfferProductEditRequest.Subject>();
AliexpressOfferProductEditRequest.Subject obj23 = new AliexpressOfferProductEditRequest.Subject();
list22.add(obj23);
obj23.setValue("product subject");
obj23.setLocale("en_US");
obj1.setSubjectList(list22);
obj1.setLocale("en_US");
List<AliexpressOfferProductEditRequest.DetailSource> list25 = new ArrayList<AliexpressOfferProductEditRequest.DetailSource>();
AliexpressOfferProductEditRequest.DetailSource obj26 = new AliexpressOfferProductEditRequest.DetailSource();
list25.add(obj26);
obj26.setWebDetail("{\\"version\\":\\"2.0.0\\",\\"moduleList\\":[{\\"type\\":\\"text\\",\\"texts\\":[{\\"content\\":\\"Thisistitle\\",\\"class\\":\\"title\\"},{\\"content\\":\\"Thisisdescription\\",\\"class\\":\\"body\\"}]}]}");
obj26.setMobileDetail("{\\"version\\":\\"2.0.0\\",\\"moduleList\\":[{\\"type\\":\\"text\\",\\"texts\\":[{\\"content\\":\\"Thisistitle\\",\\"class\\":\\"title\\"},{\\"content\\":\\"Thisisdescription\\",\\"class\\":\\"body\\"}]}]}");
obj26.setLocale("en_US");
obj1.setDetailSourceList(list25);
List<AliexpressOfferProductEditRequest.MarketImage> list28 = new ArrayList<AliexpressOfferProductEditRequest.MarketImage>();
AliexpressOfferProductEditRequest.MarketImage obj29 = new AliexpressOfferProductEditRequest.MarketImage();
list28.add(obj29);
obj29.setUrl("https://ae01.alicdn.com/kf/HTB1C72NbcvrXXX.jpg");
obj29.setImageType(1L);
obj1.setMarketImages(list28);
obj1.setFreightTemplateId(1000L);
obj1.setDpBulkDiscount(90L);
obj1.setDpBulkOrder(2L);
List<AliexpressOfferProductEditRequest.AeopAeModeSizeChartDto> list31 = new ArrayList<AliexpressOfferProductEditRequest.AeopAeModeSizeChartDto>();
AliexpressOfferProductEditRequest.AeopAeModeSizeChartDto obj32 = new AliexpressOfferProductEditRequest.AeopAeModeSizeChartDto();
list31.add(obj32);
obj32.setModeSize("2");
obj32.setHeight("2");
obj32.setBust("2");
obj32.setWaist("2");
obj32.setHips("2");
obj1.setModeSizeChartList(list31);
req.setAeopAEProduct(obj1);
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   }] }");
AliexpressOfferProductEditResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<aliexpress_offer_product_edit_response>
    <result>
        <product_id>124</product_id>
    </result>
</aliexpress_offer_product_edit_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>

错误码解释

错误码 错误描述 解决方案
1315008 卖家容许发布的商品数达到上限 请删除无用的商品或申请扩容商品数
1315010 发布商品存储阶段失败 后台商品存储失败,请进行重试;重试失败请联系技术支持
1315022 基础报价与分国家报价不一致 请检查分国家报价和基础报价的字段值
13000003 用户被网规处罚,限制操作产品 请联系技术支持
13001001 imageURLs参数中主图的张数超过了6张。 请参考错误描述解决
13001002 freightTemplateId参数设置错误。出错原因可能有以下几种: 1)freightTemplateId参数对应的运费模版不存在 2)非虚拟类目使用了虚拟类目的运费模版。 3)海外仓商品aeopAeProductSKUs参数中的aeopSKUProperty属性设置了skuPropertyId: 200007763)中的发布国与运费模版中的国家不一致。 4) 运费模版内容为空。 请参考错误描述解决
13001003 "freightTemplateId参数对应的运费模版中的内容有错误。 " 请修改运费模板相关参数,例如重量超过2千克
13001007 categoryId参数所指定的类目属于非叶子类目,无法发布商品。 请重新指定categoryId
13001008 categoryId参数所指定的类目不存在,无法发布商品。 请重新指定categoryId
13001011 多图产品主图数量限制为2-6张 请填写正确的主图图片张数
13001013 deliveryTime参数值超过了当前类目所规定的上限。 请参考错误描述解决
13001013 备货期时间错误.不在类目规定的范围之内 请选择正确的备货期值(容许范围1-60天)
13001014 批发折扣为1%-99%区间 请修改批发价折扣参数,在合理范围
13001015 bulk_order参数取值不合法。应该位于[2,100000]之间。 请参考错误描述解决
13001016 非法的产品组ID 请选择正确的产品组ID
13001017 产品图片的URL格式错误 请填写正确的图片url
13001021 bulkOrder参数和bulkDiscount参数必须同时存在或者不设置。 请参考错误描述解决
13001022 productPrice参数取值不在1-1000000之间。 请参考错误描述解决
13001024 编辑的产品不存在 请检查你的产品id字段是否正确
13001028 imageURLs参数中有图片丢失。 请参考错误描述解决
13001029 产品在审核中, 不允许被编辑 审核中的商品,不允许被编辑
13001030 编辑的产品正在活动中 活动中的商品,字段被锁定不容许编辑
13001032 categoryId参数所指定的类目是属于一个假一赔三类目,但当前账户的卖家未加入假一赔三服务,无法发布商品。 请参考错误描述解决
13001034 卖家的图片银行空间已满。系统无法将详描中的图片保存到图片银行。 请参考错误描述解决
13001035 商品详描中的图片已经在图片银行中,无需重复上传。请直接引用图片银行中的图片即可。 请参考错误描述解决
13001036 商品详描中存在一些图片。这些图片在图片银行中已被卖家删除。请删除这些图片后重新发布。 请参考错误描述解决
13001037 商品详描中存在一些图片的大小超过了3M。导致无法上传到图片银行。请删除或者缩减这些图片的大小后再发布。 请参考错误描述解决
13001038 商品详描中存在一些图片是一些废图片(无法读取这些图片内容)。导致无法上传到图片银行。请删除这些图片后再发布。 请参考错误描述解决
13001041 产品处于"TBD"状态, 不允许被编辑 请等待产品状态审核通过,后再编辑
13001042 保存详描中的图片失败 详描图片保存失败
13001043 商品维度的总库存值不合法。即aeopAeProductSKUs参数中的ipmSkuStock之和不在1~999999之间。 请参考错误描述解决
13001043 产品维度的总库存错误. 不在1~999999之间 请填写正确的库存数值
13001047 商品所属类目属于隐藏类目,不能发布隐藏类目的商品 请重新选择正确的类目
13001053 当前操作与商品所处的策略步骤不匹配 请按策略步骤进行操作
13001058 检查品牌权限失败 请选择有权限的品牌权限商品
13001059 商品分国家报价的配置数据格式错误 请参考错误描述解决
13001060 商品分国家报价的配置数据错误:包含不支持分国家报价的国家 请参考错误描述解决
13001061 商品分国家报价的配置数据错误:某些国家调价比例超过限制 请参考错误描述解决
13001062 卖家未开放分国家报价功能 请参考错误描述解决
13001099 此类目商品只可通过卖家后台上传 请通过卖家后台上传此类商品
13002001 aeopAeProductSKUs参数中的skuPrice属性的取值不在1-1000000之间。 请参考错误描述解决
13002002 aeopAeProductSKUs参数填写有误。可能有以下几种情况: 1. aeopAeProductSKUs中同时存在默认SKU(aeopSKUProperty:[])以及自定义SKU。 2. SKU必填属性没填。 请参考错误描述解决
13002003 aeopAeProductSKUs参数中的aeopSKUProperty属性中的skuPropertyId不在类目规定的候选值列表中。 请参考错误描述解决
13002004 aeopAeProductSKUs参数中的aeopSKUProperty属性中的propertyValueId不在类目规定的候选值列表中。 请填写正确的sku的属性value
13002005 aeopAeProductSKUs参数中的aeopSKUProperty属性中的SKU顺序排列有误。 请参考错误描述解决
13002006 aeopAeProductSKUs参数中的aeopSKUProperty数组的长度大于3。 请参考错误描述解决
13002007 aeopAeProductSKUs参数中的aeopSKUProperty属性中存在skuPropertyId:null的SKU。 请参考错误描述解决
13002008 aeopAeProductSKUs参数中的aeopSKUProperty属性中存在propertyValueId:null的SKU。 请参考错误描述解决
13002009 aeopAeProductSKUs参数中的aeopSKUProperty属性提供了propertyValueDefinitionName参数,但这一维SKU属性不允许自定义名称。请删除propertyValueDefinitionName参数。 请参考错误描述解决
13002010 参数中的aeopSKUProperty属性提供了skuImage参数,但这一维SKU属性不允许自定义图片 请检查和校验属性字段是否存在自定义图片
13002011 aeopAeProductSKUs参数中的aeopSKUProperty属性提供了propertyValueDefinitionName参数填写有误。只能包含20个字符以内的英文、数字 请检查自定义属性名称值是否合理
13002012 SKU自定义图片不符合规则 SKU图片必须满足以下要求: 1. 图片的连接必须以http或者https开头; 2. 图片的格式必须是jpg后者jpeg; 3. 图片必须存在
13002013 aeopAeProductSKUs参数中的skuPrice属性填写错误。出错原因有以下几种: 1)skuCode的长度超过了20个字符。 2)skuCode参数值中包含了空格、大于号和小于号、中文和全角字符。 请参考错误描述解决
13002014 SKU属性重复 请检查和修正去重复的sku属性
13002015 aeopAeProductSKUs参数中的ipmSkuStock属性取值不在0~999999之间。 请填写正确的sku库存数量值
13002016 aeopAeProductSKUs参数中的aeopSKUProperty属性存在重复的SKU属性 请检查是否填写或存在重复的sku属性
13002017 不符合sku属性要求 不符合sku屬性要求 请检查和校验属性字段值是否合法
13002018 "aeopAeProductSKUs参数中的SKU个数大于256个" 请检查产品的SKU个数是否超过上限个数
13002026 一个商品不允许使用多个码制 请检查码制参数
13002995 aeopAeProductSKUs参数中所有aeopSKUProperty数组长度不一致。 请检查aeopAeProductSKUs参数中所有aeopSKUProperty数组的长度是否一致。
13002998 aeopAeProductSKUs参数的格式错误。具体的出错原因可能有以下几种:1). 参数类型错误:请查看aeopAeProductSKUs数据结构中对各个属性类型的声明。 对于String类型的属性,其取值必须用双引号括起来。 对于数字类型的属性,其取值就填一个数字即可,不能用双引号括起来。
13003001 当前商品的详描中存在盗图。 请参考错误描述解决
13003002 detail参数中所关联的产品模块超过了2个 请修改详描字段值: 详描模块超过了2个,请按上限要求进行详描修改
13003003 detail参数中所关联的产品模块中至少有一个无内容 请检查详描中产品模板内容是否有值
13003004 处理详描外链失败。 请参考错误描述解决
13004001 packageType参数设置为true(打包出售)。但是未提供lotNum参数或者lotNum参数的取值不在2~100000之间。 请参考错误描述解决
13004002 packageHeight参数未设置或者packageHeight参数的取值不在1-700之间 请修改产品宽度字段值: 取值不在1-700之间(单位厘米)
13004003 packageLength参数未设置或者packageLength参数的取值不在1-700之间。 请参考错误描述解决
13004004 "packageWidth参数未设置或者packageWidth参数的取值不在1-700之间" 请修改产品宽度字段值: 取值不在1-700之间(单位厘米)
13004005 产品包装尺寸的最大值(packageLength, packageWidth, packageHeight三者之间的最大值)+ 2*(packageHeight+packageLength+packageWidth - 最大值) &amp;amp;amp;amp;amp;amp;gt; 2700 请参考错误描述解决
13004006 grossWeight参数未设置或者grossWeight参数的取值不在0.001~500.00之间。 请参考错误描述解决
13004008 isPackSell参数设置为true(支持自定义计重)。但是未提供addUnit参数或者addUnit参数的取值不在1~1000之间。 请参考错误描述解决
13004009 isPackSell参数设置为true(支持自定义计重)。但是未提供baseUnit参数或者baseUnit参数的取值不在1~1000之间。 请参考错误描述解决
13004010 isPacketSell参数设置为true(支持自定义计重)。但是未提供addWeight参数或者addWeight参数的取值不在0.001~500.00之间。 请参考错误描述解决
13004011 productUnit参数取值非法, 请查看productUnit的参数说明,选择正确的单位 请修改产品单元字段值: 为正确的单位后选址
13004016 商品必填类目属性未填。 请调用aliexpress.category.redefining.getchildattributesresultbypostcateidandpath( 根据发布类目id、父属性路径(可选)获取子属性信息 )找出哪些属性是必填的:https://developers.aliexpress.com/doc.htm#?docType=2&docId=29988
13004017 aeopAeProductPropertys参数中的所有非自定义属性加起来的长度超过了4000个字符。 请参考错误描述解决
13004018 aeopAeProductPropertys参数中的所有自定义属性加起来的长度超过了4000个字符。 请参考错误描述解决
13004019 用户未加入类目的白名单 请申请授权次类目的权限
13004020 当前卖家不在海外仓白名单内,不能发布海外仓商品。 请卖家先申请加入海外仓白名单后再试。
13004021 类目白名单校验失败。当前卖家没有加入到发布商品所在类目的白名单中,无法发布此类目下的商品。 请卖家先加入当前发布类目的白名单。
13004022 品牌属性不可以自定义 请检查品牌属性字段值
13004401 currencyCode与aeopAeProductSKUs参数中的currencyCode属性设置有误 "1. 对于俄罗斯本地卖家,currencyCode参数和aeopAeProductSKUs数据结构中的currencyCode参数必须都设置成RUB; 2.对于非俄罗斯卖家,currencyCode参数和aeopAeProductSKUs数据结构中的currencyCode参数可以不提供, 3. 如果需要提供这两个参数,那么它们的取值必须为USD"
13004402 不容许修改产品的币种单位 请检查是否修改了产品的币种单位
13004403 currencyCode与aeopAeProductSKUs参数中的currencyCode属性设置有误。 对于俄罗斯本地卖家,currencyCode参数和aeopAeProductSKUs数据结构中的currencyCode参数必须都设置成RUB。对于非俄罗斯卖家,currencyCode参数和aeopAeProductSKUs数据结构中的currencyCode参数可以不提供,如果需要提供这两个参数,那么它们的取值必须为USD。
13004404 currencyCode与aeopAeProductSKUs参数中的currencyCode属性设置有误。 非俄罗斯卖家错误的将currencyCode参数和aeopAeProductSKUs数据结构中的currencyCode参数设置成了RUB,请改为USD。
13004999 aeopAeProductPropertys参数的格式错误。具体的出错原因可能有以下几种: 1). 参数类型错误:请查看aeopAeProductPropertys数据结构中对各个属性类型的声明。 对于String类型的属性,其取值必须用双引号括起来。 对于数字类型的属性,其取值就填一个数字即可,不能用双引号括起来。
13005001 当前卖家账户未通过实名认证,无法发布商品。 请先实名认证后再发商品。
13005003 当前卖家账户被处罚,无法发布商品。 等待处罚结束后再发布商品
13005005 帐户不存在,出现这种情况可能原因有:1) 卖家提供的账号有误,系统查询不到这个会员信息。 请卖家检查账户信息是否正确。
13005008 品牌无权限 请申请此品牌权限或更改品牌名
13005050 发布失败,可发布商品超过数量上限,您可以继续完善商品信息后保存到草稿箱。 请管理好自己要发布的商品总数。
13005999 系统调用会员服务超时。 系统内部错误,请联系技术支持。
13009993 调用尺码表服务超时。 系统内部异常,请联系技术支持。
13009994 编辑产品超时 请进行重试,重试超时请联系技术支持
13009998 发布商品后台超时 请优先重试,如果重复出现,请联系技术支持
13009999 发布商品后台未知错误 请优先重试,如果重复出席那, 联系技术支持
13010003 发布类目错误 发布类目错误 请选择最后一级叶子类目,进行商品发布
13010008 卖家无权发布次类目 请申请此类目权限
13010011 您填写的自定义属性名中含有非英文字符 请检查自定义属性名称值是否合乎规则
13010014 自定义属性和自定义属性值需同时填写 请检查商品的自定义属性名称和值是否正确
13010016 自定义属性不能重复 请检查是否有重复的自定义属性
13010019 有必填系统属性未填写 请检查系统属性存在遗漏的必填项
13010022 产品属性名称长度限制为0-128字符 请填写正确的产品名称长度
13010023 产品属性值长度限制为0-128字符 请检查产品属性值长度是否超过约定的上限
13010024 属性名对应的属性值为空 请检查对应属性名的值
13010025 属性值非法或不在候选列表内 请检查属性值是否正确
13020003 详描信息模块丢失 请补齐详细描述
13030002 产品分组不存在 请校正产品分组字段
13040006 填写的包装大小不正确 请检查包装信息,大小请填写1~700之间的整数
13040008 填写的产品重量不正确 请填写合理的产品重量值(0.001~500.000之间的数字)
13040011 打包销售的数量区间为2-100000之间的整数 请填写正确的打包数量值
13050004 填写的图片url有误 请填写公司站内的图片url
13060002 请输入3~60之间的整数数字 请填写正确的运货时间
13060003 请输入3~60之间的整数数字 请填写正确的运货时间
13060008 运费模板不存在,或产品包装后重量大于2公斤,或您选择的运费模板的发货地与产品发货地不一致 请检查运费模板是否存在或包装参数是否合理
13080009 批发最小数量取值范围为2-100000区间 请检查产品的批发数量值是否合理
13080010 批发折扣为1%-99%区间 请检查商品的批发折扣数值是否合理
13080012 sku价格值填写不在合理区间 请检查商品价格是否在合理区间
13080019 商家编码只能填写数字、英文字符及特殊字符 请填写正确格式的商品编码
13080037 分国家调价比例应当大于-30%, 即分国家报价应该大于基准价的70% 请填写正确的分国家报价比例值
13090004 产品名称的长度必须为1 - 128个字符 请填写正确长度的产品标题
13092001 sizechartId参数非法。正确的应该是一个正整数。 请参考错误描述解决
13092003 sizechartId所指定的尺码模版不属于当前卖家 请填写正确的尺码模板
13092005 sizechartId所指定的尺码模版与categoryId参数所对应的服务模版不匹配,无法设置。 请参考错误描述解决
13099000 sizechartId参数所指定的尺码模版不存在 请填写正确的尺码模板
13099999 编辑商品后台未知错误 请重试,重试报错请联系技术支持
13140005 颜色属性构建失败 请填写正确的颜色属性字段值
13140006 服务模板不正确 请选择正确的服务模板
13140010 颜色自定义名称请不要包含#:关键字 请校验颜色自定义名称值, 不要包含非法字符(只容许填写数字或字母)
13150019 品牌未授权 请选择正确的品牌或品牌进行授权
13160001 锁定字段不能编辑 请检查产品是否处于活动中,待字段解锁后进行编辑
13200021 deliveryTime参数未设置。 请检查当前请求中是否提供了deliveryTime参数。
13200051 freightTemplateId参数未设置。 请检查当前请求中是否提供了freightTemplateId参数。
13200061 subject参数包含了一些非英文字符。 请检查subject参数中是否包含了非英文参数。
13200062 subject参数包含了一些非法字符。这些非法字符的ASCII编码不在[0, 128]之间。 请检查subject参数是否包含了上述的非法字符。
13200063 subject参数未设置。 请检查当前请求中是否提供了subject参数。
13200064 subject参数的长度超过了128个字符。 请检查subject参数的长度。
13200101 categoryId参数未设置。 请检查当前请求中是否提供了categoryId参数。
13201001 detail参数未设置。 请检查当前请求中是否提供了detail参数。
13201002 detail参数包含了一些非英文字符。 请检查detail参数中是否包含了非英文参数。
13201003 detail参数中包含了@符号(这会于后面的字符组成一个邮箱地址)或者一些非阿里系的外链。即详描中包含的站点信息不在以下列表中: 1. img.vip.alibaba.com 2. uploan.alibaba.com 3. style.alibaba.com 4. img.alibaba.com 5. *.aliimg.com 6. cp.aliimg.com 淘代销商品不在此范围之内。 去除detail参数中包含的@符号(这会于后面的字符组成一个邮箱地址)或者一些非阿里系的外链。
13201004 detail参数的的长度超过了60000个字符。 请检查detail参数的长度。
13201022 产品类目属性名包含非英文字符 请填写正确的产品属性名称值
13201022 产品类目属性名包含非英文字符 请填写正确的产品属性名称值
13201023 aeopAeProductPropertys参数中的attrName属性长度超过了40个字符。 减少attrName属性长度
13201031 aeopAeProductPropertys参数中的attrValue属性包含了一些非英文字符。 去除非英文字符
13201032 aeopAeProductPropertys参数中的attrValue属性包含了一些非法字符。 去除非法字符
13201033 aeopAeProductPropertys参数中的attrValue属性长度超过了70个字符。 请填写正确的产品名称长度
13202001 productUnit参数未设置。 设置productUnit参数。
13202021 grossWeight参数未设置。 设置grossWeight参数
13204021 未设置商品的图片url 请填写正确的商品url值
13205002 wsValidNum参数的取值不在14~30天之间。 请检查wsValidNum参数的值是否在14~30天之间。
13230001 类目接口服务异常 请重试,重试报错请联系技术支持
13230004 编辑产品超时 请重试,重试报错请联系技术支持
13230008 类目接口服务异常 请重试,重试报错请联系技术支持
13240001 商品id分配报错 请重试,重试报错请联系技术支持
1318110004 存在遗漏的必填字段 请参考错误说明,检查是否存在遗漏的必填字段
isv.13080047 080047:The quote attribute supports up to 256 combinations. AE商品最多支持256个sku。请调整sku个数至低于256.
isv.13THD_FREIGHT_-6 THD_FREIGHT_-6:The shipping template does not exist 运费模本不存在
isv.13020053 020053:This picture's aspect ratio must be 3:4 and its resolution should be at least 750 x 1,000 pixels. Please add a new picture /:020053:This picture's aspect ratio must be 3:4 and its resolution should be at least 750 x 1,000 pixels. Please add a new picture 商品营销图比例不符。请检查图片

API工具

如何获得此API

FAQ

返回
顶部