注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > AE-Oversea-Solution

aliexpress.solution.product.edit (Edit Product API)

API for editing product, customized for Oversea merchants. Most of the input fields of this API is similar with aliexpress.solution.product.post. For editing, just fill in the fields you would like to edit, leave other fields to be blank.

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
edit_product_request PostProductRequestDto 可选 input param
  • └ product_id
  • Number
  • 必须
  • 1000005237852
  • aliexpress product Id
  • └ group_id
  • Number
  • 可选
  • 262007001
  • group id, you can get group list from aliexpress.product.productgroups.get
  • └ extra_params
  • String
  • 可选
  • extra params
  • extra params. Configured some special products
  • marketing_images
  • MarketImageDto []
  • 可选
  • marketing images for product. Currently supported 2 types: 1 represents 3:4 rectangle(resolution at least 750*1000) image while 2 represents 1:1 square image(Resolution at least 800*800). The image url needs to be obtained via uploading the image through Aliexpress API: aliexpress.photobank.redefining.uploadimageforsdk(https://developers.aliexpress.com/en/doc.htm?docId=30186&docType=2)
  • └ image_url
  • String
  • 可选
  • https://ae01.alicdn.com/kf/Hf5987123b00246699ac4f86795d59e636.jpg
  • The image url needs to be obtained via uploading the image through Aliexpress API: aliexpress.photobank.redefining.uploadimageforsdk(https://developers.aliexpress.com/en/doc.htm?docId=30186&docType=2)
  • └ image_type
  • String
  • 可选
  • 1
  • 1 represents 3:4 rectangle(resolution at least 750*1000) image while 2 represents 1:1 square image(Resolution at least 800*800).
  • └ developer_features
  • String
  • 可选
  • {"source":"Lengow"}
  • More information about the request.
  • └ aliexpress_category_id
  • Number
  • 可选
  • 200105144
  • Aliexpress leaf category ID obtained through https://developers.aliexpress.com/en/doc.htm?docId=46042&docType=2
  • └ category_id
  • String
  • 可选
  • 200105144
  • Deprecated. Please use aliexpress_category_id
  • └ brand_name
  • String
  • 可选
  • Xiaomi
  • merchant's brand name
  • └ main_image_urls_list
  • String []
  • 可选
  • ["https://upload.wikimedia.org/wikipedia/commons/b/b5/Winnersh_Meadows_Trees.jpg","https://ae01.alicdn.com/kf/UTB85xyVgnzIXKJkSafVq6yWgXXa0/Kingston-SDCS-16GB-MicroSD-Canvas-Select-16GB-velocidades-de-UHS-I-Clase-10-DE-hasta-80.jpg"]
  • Main image that represents the product. The url should be accesible and there is a maximum of 6 pictures. The url can point to a seller's server or to AliExpress photobank. In order to obtain more information about the photobank and how to upload images, please visit the following page: https://developers.aliexpress.com/en/doc.htm?docId=30186&docType=2
  • attribute_list
  • AttributeDto []
  • 可选
  • There are 4 types of how to fill in the content of each element in this attribute list. 1). When filling in the standard dropdown/multi-dropdown attributes, fill in "aliexpress_attribute_name_id" and "aliexpress_attribute_value_id"(For multi-dropdown, splitting them into multiple elements) 2). When filling in the attributes in which the value needs to be manually entered, fill in "aliexpress_attribute_name_id" and "attribute_value" in the element. 3). There exists a special kind of "aliexpress_attribute_value_id" of which the value represents for "Other". When encoutering this scenario, please fill in "aliexpress_attribute_name_id", "aliexpress_attribute_value_id" and "attribute_value". 4). Besides the three types mentioned above, if the seller would like to fully customized all the atttributes, fill in "attribute name" and "attribute_value" in the element.
  • └ attribute_name
  • String
  • 可选
  • Resolution
  • merchant's attribute name
  • └ attribute_value
  • String
  • 可选
  • 1920*1080
  • merchant's attribute value
  • └ aliexpress_attribute_value_id
  • Number
  • 可选
  • 593
  • aliexpress attribute value id, which could be obtained from aliexpress.solution.sku.attribute.query
  • └ aliexpress_attribute_name_id
  • Number
  • 可选
  • 14
  • aliexpress attribute name id, which could be obtained from aliexpress.solution.sku.attribute.query
  • sku_info_list
  • SkuInfoDto []
  • 可选
  • If specified this field, all the previous skus will be replaced by the new skus.
  • sku_attributes_list
  • SkuAttributeDto []
  • 可选
  • sku attribute list. Some categories don't have sku attributes, then sku_attributes_list should be empty.When there are more than one sku in the sku_info_list, sku_attributes_list is required for each of them, please do not let them empty
  • └ sku_attribute_name
  • String
  • 可选
  • Color
  • Deprecated, please use sku_attribute_name_id. To obtain the available sku attribute names under a specific category, please check API: aliexpress.solution.sku.attribute.query
  • └ sku_attribute_value
  • String
  • 可选
  • red
  • Customized sku attribute value by sellers, do not include these 4 symbols { # : = , }.maximum 70 characters.
  • └ sku_image
  • String
  • 可选
  • https://upload.wikimedia.org/wikipedia/commons/b/b5/Winnersh_Meadows_Trees.jpg
  • Image that will represent the variation of the product. The url can point to a seller's server or to AliExpress photobank. In order to obtain more information about the photobank and how to upload images, please visit the following page: https://developers.aliexpress.com/en/doc.htm?docId=30186&docType=2
  • └ sku_attribute_value_id
  • Number
  • 可选
  • 10
  • Please refer to https://developers.aliexpress.com/en/doc.htm?docId=29988&docType=2 to obtain the sku_attribute_value_id under specific category
  • └ sku_attribute_name_id
  • Number
  • 可选
  • 14
  • Please refer to https://developers.aliexpress.com/en/doc.htm?docId=29988&docType=2 to obtain the sku_attribute_name_id under specific category
  • └ extra_params
  • String
  • 可选
  • extra params
  • extra params. Configured some special products
  • └ ean_code
  • String
  • 可选
  • 12345678
  • EAN or EAN13, stands for international product number (formerly European product number). It is an extension of UPC codes, and you will find them as barcodes on most everyday products. It will be empty if you don't fill it in
  • └ inventory
  • Number
  • 可选
  • 90
  • stock. Maximum:999999, minumum:1
  • └ price
  • String
  • 可选
  • 12.21
  • price. Maximum:999999, minumum:0.01
  • └ sku_code
  • String
  • 可选
  • 123abc
  • Code for merchant's sku, important reference to maintain the relationship between merchant and Aliexpress's system.
  • └ discount_price
  • String
  • 可选
  • 9.92
  • discount price for the sku. discount_price should be cheaper than price.
  • └ weight
  • String
  • 可选
  • 3.2
  • Weight of the product, including package. Measured in Kilograms (Kg) with a maximum 500 and minumum 0.001
  • └ inventory_deduction_strategy
  • String
  • 可选
  • place_order_withhold or payment_success_deduct
  • indicate when the inventory of a specific product will be deducted. place_order_withhold: the inventory is deducted just after the order is placed by customer. payment_success_deduct: the stock is deducted after the payment is done successfully by the customer.
  • └ package_height
  • Number
  • 可选
  • 20
  • Package height measured in centimeters (cm). Maximum 700 cm, minumum: 1cm
  • └ package_length
  • Number
  • 可选
  • 10
  • Package length, measured in centimeters (cm). Maximum 700 cm, minumum: 1cm
  • └ package_width
  • Number
  • 可选
  • 30
  • Package width measured in centimeters (cm). Maximum 700 cm, minumum: 1cm
  • multi_country_price_configuration
  • MultiCountryPriceConfigurationDto
  • 可选
  • multi country price configuration
  • country_price_list
  • SingleCountryPriceDto []
  • 可选
  • Price list for different countries
  • sku_price_by_country_list
  • SingleSkuPriceByCountryDto []
  • 可选
  • Sku price list under the same ship_to_country
  • └ value
  • String
  • 可选
  • 15
  • Deprecated. Please do not use.
  • └ price
  • String
  • 可选
  • 15
  • Value of price configuration. If the price of a specific country is set, it must be greater than or equal to 70% of the original sku price
  • └ discount_price
  • String
  • 可选
  • 3.99
  • Value of discount_price for each country, should be less than the retailPrice and greater than or equal to 10% of it.
  • └ sku_code
  • String
  • 可选
  • 123abc
  • sku_code, must existed in sku_info_list
  • └ ship_to_country
  • String
  • 可选
  • FR
  • ISO code of the country. Currently supporting: 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
  • └ price_type
  • String
  • 可选
  • absolute
  • Support absolute or delete. When filling in "delete", the multi_country_price_configuration will be eliminated.
  • └ freight_template_id
  • Number
  • 可选
  • 703476858
  • freight template ID. After the merchant has created an freight template in the backend: freighttemplate.aliexpress.com, the id could be obtained in the backend directly or thourgh the API: aliexpress.freight.redefining.listfreighttemplate
  • └ shipping_lead_time
  • Number
  • 可选
  • 3
  • refer to the preparation period of merchant before the package could be dispatched to the customer.
  • └ service_policy_id
  • Number
  • 可选
  • 0
  • service policy id, which could be set and obtained in the seller's background.
  • └ size_chart_id
  • Number
  • 可选
  • 100
  • merchant's size chart id, more used in the category of shoes and clothes.
  • multi_language_subject_list
  • SingleLanguageTitleDto []
  • 可选
  • List for multi language subject. To learn how to set this field, please refer to the document:https://developers.aliexpress.com/en/doc.htm?docId=108976&docType=1
  • └ language
  • String
  • 可选
  • es
  • Support: en(English) ru(Russian) es(Spanish) fr(French) it(Italian) tr(Turkish) pt(Portuguese) de(German) nl(Dutch) in(Indonesian) ar(Arabic) ja(Japanese) ko(Korean) th(Thai) vi(Vietnamese) iw(Hebrew).Must contains the original locale.
  • └ subject
  • String
  • 可选
  • Versión Global Xiaomi Redmi Note 5
  • subject, maximum 218 characters.
  • multi_language_description_list
  • SingleLanguageDescriptionDto []
  • 可选
  • List for multi language description. To learn how to set this field, please refer to the document:https://developers.aliexpress.com/en/doc.htm?docId=108976&docType=1
  • └ language
  • String
  • 可选
  • es
  • Support: en(English) ru(Russian) es(Spanish) fr(French) it(Italian) tr(Turkish) pt(Portuguese) de(German) nl(Dutch) in(Indonesian) ar(Arabic) ja(Japanese) ko(Korean) th(Thai) vi(Vietnamese) iw(Hebrew).Must contains the original locale.
  • └ mobile_detail
  • String
  • 可选
  • {"moduleList":[{"texts":{"content":"test mobile description","class":"body"},"type":"text"}],"version":"2.0.0"}
  • mobile detail for this language, do not support "html" and "dynamic" type, for more information, please check the format here https://developers.aliexpress.com/en/doc.htm?docId=109534&docType=1
  • └ web_detail
  • String
  • 可选
  • {"moduleList":[{"html":{"content":"test web description"},"type":"html"}],"version":"2.0.0"}
  • web detail for this language, please check the format here: https://developers.aliexpress.com/en/doc.htm?docId=109534&docType=1

响应参数

名称 类型 示例值 描述
result PostItemResponseDto result
  • └ product_id
  • Number
  • 1000005237852
  • productId

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliexpressSolutionProductEditRequest req = new AliexpressSolutionProductEditRequest();
AliexpressSolutionProductEditRequest.PostProductRequestDto obj1 = new AliexpressSolutionProductEditRequest.PostProductRequestDto();
obj1.setProductId(1000005237852L);
obj1.setGroupId(262007001L);
obj1.setExtraParams("extra params");
List<AliexpressSolutionProductEditRequest.MarketImageDto> list3 = new ArrayList<AliexpressSolutionProductEditRequest.MarketImageDto>();
AliexpressSolutionProductEditRequest.MarketImageDto obj4 = new AliexpressSolutionProductEditRequest.MarketImageDto();
list3.add(obj4);
obj4.setImageUrl("https://ae01.alicdn.com/kf/Hf5987123b00246699ac4f86795d59e636.jpg");
obj4.setImageType("1");
obj1.setMarketingImages(list3);
obj1.setDeveloperFeatures("{\"source\":\"Lengow\"}");
obj1.setAliexpressCategoryId(200105144L);
obj1.setCategoryId("200105144");
obj1.setBrandName("Xiaomi");
obj1.setMainImageUrlsList(""https://upload.wikimedia.org/wikipedia/commons/b/b5/Winnersh_Meadows_Trees.jpg","https://ae01.alicdn.com/kf/UTB85xyVgnzIXKJkSafVq6yWgXXa0/Kingston-SDCS-16GB-MicroSD-Canvas-Select-16GB-velocidades-de-UHS-I-Clase-10-DE-hasta-80.jpg"");
List<AliexpressSolutionProductEditRequest.AttributeDto> list6 = new ArrayList<AliexpressSolutionProductEditRequest.AttributeDto>();
AliexpressSolutionProductEditRequest.AttributeDto obj7 = new AliexpressSolutionProductEditRequest.AttributeDto();
list6.add(obj7);
obj7.setAttributeName("Resolution");
obj7.setAttributeValue("1920*1080");
obj7.setAliexpressAttributeValueId(593L);
obj7.setAliexpressAttributeNameId(14L);
obj1.setAttributeList(list6);
List<AliexpressSolutionProductEditRequest.SkuInfoDto> list9 = new ArrayList<AliexpressSolutionProductEditRequest.SkuInfoDto>();
AliexpressSolutionProductEditRequest.SkuInfoDto obj10 = new AliexpressSolutionProductEditRequest.SkuInfoDto();
list9.add(obj10);
List<AliexpressSolutionProductEditRequest.SkuAttributeDto> list13 = new ArrayList<AliexpressSolutionProductEditRequest.SkuAttributeDto>();
AliexpressSolutionProductEditRequest.SkuAttributeDto obj14 = new AliexpressSolutionProductEditRequest.SkuAttributeDto();
list13.add(obj14);
obj14.setSkuAttributeName("Color");
obj14.setSkuAttributeValue("red");
obj14.setSkuImage("https://upload.wikimedia.org/wikipedia/commons/b/b5/Winnersh_Meadows_Trees.jpg");
obj14.setSkuAttributeValueId(10L);
obj14.setSkuAttributeNameId(14L);
list11.setSkuAttributesList(list13);
obj10.setExtraParams("extra params");
obj10.setEanCode("12345678");
obj10.setInventory(90L);
obj10.setPrice("12.21");
obj10.setSkuCode("123abc");
obj10.setDiscountPrice("9.92");
obj1.setSkuInfoList(list9);
obj1.setWeight("3.2");
obj1.setInventoryDeductionStrategy("place_order_withhold or payment_success_deduct");
obj1.setPackageHeight(20L);
obj1.setPackageLength(10L);
obj1.setPackageWidth(30L);
AliexpressSolutionProductEditRequest.MultiCountryPriceConfigurationDto obj15 = new AliexpressSolutionProductEditRequest.MultiCountryPriceConfigurationDto();
List<AliexpressSolutionProductEditRequest.SingleCountryPriceDto> list17 = new ArrayList<AliexpressSolutionProductEditRequest.SingleCountryPriceDto>();
AliexpressSolutionProductEditRequest.SingleCountryPriceDto obj18 = new AliexpressSolutionProductEditRequest.SingleCountryPriceDto();
list17.add(obj18);
List<AliexpressSolutionProductEditRequest.SingleSkuPriceByCountryDto> list21 = new ArrayList<AliexpressSolutionProductEditRequest.SingleSkuPriceByCountryDto>();
AliexpressSolutionProductEditRequest.SingleSkuPriceByCountryDto obj22 = new AliexpressSolutionProductEditRequest.SingleSkuPriceByCountryDto();
list21.add(obj22);
obj22.setValue("15");
obj22.setPrice("15");
obj22.setDiscountPrice("3.99");
obj22.setSkuCode("123abc");
list19.setSkuPriceByCountryList(list21);
obj18.setShipToCountry("FR");
obj15.setCountryPriceList(list17);
obj15.setPriceType("absolute");
obj1.setMultiCountryPriceConfiguration(obj15);
obj1.setFreightTemplateId(703476858L);
obj1.setShippingLeadTime(3L);
obj1.setServicePolicyId(0L);
obj1.setSizeChartId(100L);
List<AliexpressSolutionProductEditRequest.SingleLanguageTitleDto> list24 = new ArrayList<AliexpressSolutionProductEditRequest.SingleLanguageTitleDto>();
AliexpressSolutionProductEditRequest.SingleLanguageTitleDto obj25 = new AliexpressSolutionProductEditRequest.SingleLanguageTitleDto();
list24.add(obj25);
obj25.setLanguage("es");
obj25.setSubject("Versión Global Xiaomi Redmi Note 5");
obj1.setMultiLanguageSubjectList(list24);
List<AliexpressSolutionProductEditRequest.SingleLanguageDescriptionDto> list27 = new ArrayList<AliexpressSolutionProductEditRequest.SingleLanguageDescriptionDto>();
AliexpressSolutionProductEditRequest.SingleLanguageDescriptionDto obj28 = new AliexpressSolutionProductEditRequest.SingleLanguageDescriptionDto();
list27.add(obj28);
obj28.setLanguage("es");
obj28.setMobileDetail("{\"moduleList\":[{\"texts\":{\"content\":\"test mobile description\",\"class\":\"body\"},\"type\":\"text\"}],\"version\":\"2.0.0\"}");
obj28.setWebDetail("{\"moduleList\":[{\"html\":{\"content\":\"test web description\"},\"type\":\"html\"}],\"version\":\"2.0.0\"}");
obj1.setMultiLanguageDescriptionList(list27);
req.setEditProductRequest(obj1);
AliexpressSolutionProductEditResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<aliexpress_solution_product_edit_response>
    <result>
        <product_id>1000005237852</product_id>
    </result>
</aliexpress_solution_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>

错误码解释

错误码 错误描述 解决方案
7009999 Product System Service Error Contact Technical Support
7009999 Product System Service Error Contact Technical Support

API工具

如何获得此API

FAQ

返回
顶部