淘宝开放平台

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

AE-Oversea-Solution

aliexpress.solution.product.post (Product posting API)

Product posting API for Oversea merchants, simplifying the complexity of integration that sellers and merchants face. For example, these sellers can use their own category and attributes instead of mapping those from AE.

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
post_product_request PostProductRequestDto 可选 input param
  • └ subject
  • String
  • 可选
  • Huawei Mate 10
  • Deprecated. Please use multi_language_subject_list. 1-218 length, support multi language. Check the field "language" to find the supported languages.
  • └ description
  • String
  • 可选
  • El Huawei Mate 10 Lite destaca principalmente por su pantalla FullView y sus cuatro cámaras. <img alt="Huawei-Mate-10-Lite_02" src="https://ae01.alicdn.com/kf/UTB8rju8uOaMiuJk43PTq6ySmXXa7.jpg">
  • Deprecated, please use product description, support html format and multi languages. Check the field language to find the supported languages.
  • └ language
  • String
  • 必须
  • es
  • The main language of the product. Aliexpress will depend on the subject and detail in main language to translate to other languages, if not filled in by sellers. Main language could not be modified after product has been uploaded. 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)
  • └ product_unit
  • Number
  • 可选
  • 100000015
  • Product Unit ID, Most common-used ID: 100000015 piece/pieces; 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; 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
  • multi_language_description_list
  • SingleLanguageDescriptionDto []
  • 可选
  • Please refer to 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.
  • └ 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
  • └ 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
  • multi_language_subject_list
  • SingleLanguageTitleDto []
  • 可选
  • Please refer to https://developers.aliexpress.com/en/doc.htm?docId=108976&docType=1
  • └ subject
  • String
  • 可选
  • Versión Global Xiaomi Redmi Note 5
  • product subject, maximum length 218 characters.
  • └ 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.
  • └ 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_type
  • Number
  • 可选
  • 1
  • 1 represents 3:4 rectangle(resolution at least 750*1000) image while 2 represents 1:1 square image(Resolution at least 800*800).
  • └ 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)
  • └ developer_features
  • String
  • 可选
  • {"source":"Lengow"}
  • More information of 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
  • Brand name after applying in https://sellerjoin.aliexpress.com/oversea/getBrandList.htm. If the seller has not applied any brand permission, please leave this field blank.
  • └ 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_value
  • String
  • 可选
  • 1920*1080
  • merchant's attribute value
  • └ attribute_name
  • String
  • 可选
  • Resolution
  • merchant's attribute name
  • └ aliexpress_attribute_value_id
  • Number
  • 可选
  • 593
  • aliexpress attribute value id, which could be obtained from https://developers.aliexpress.com/en/doc.htm?docId=29988&docType=2. The path is: result -> attributes ->values -> id
  • └ aliexpress_attribute_name_id
  • Number
  • 可选
  • 14
  • aliexpress attribute name id, which could be obtained from https://developers.aliexpress.com/en/doc.htm?docId=29988&docType=2. The path is: result -> attributes -> id
  • sku_info_list
  • SkuInfoDto []
  • 必须
  • All the skus included in one product.
  • └ bar_code
  • String
  • 可选
  • 2012331233258
  • barcode of the sku. Except some Russian sellers who will be fulfilled by Aliexpress, please ignore this field for other sellers.
  • 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_image_url
  • 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
  • String
  • 可选
  • red
  • Customized sku attribute value by sellers, do not include these 4 symbols { # : = , }.maximum 70 characters.
  • └ 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_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
  • └ 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
  • └ inventory
  • Number
  • 必须
  • 90
  • stock. Maximum:999999, minumum:1
  • └ price
  • String
  • 必须
  • 12.21
  • price. Maximum: 999999, minumum:0.01
  • └ sku_code
  • String
  • 必须
  • 123abc
  • Merchant's identificator for the SKU. Important reference to maintain the sku relationship between merchant and Aliexpress.
  • └ discount_price
  • String
  • 可选
  • 9.92
  • discount price for the sku. discount_price should be cheaper than price.
  • └ extra_params
  • String
  • 可选
  • extra params
  • extra params. Configured some special products
  • └ ean_code
  • String
  • 可选
  • 12345678
  • EAN, or EAN13, stands for International Article Number (originally European Article Number). It is an extension of the UPC codes and you'll find them as barcodes on most everyday products. Sometimes the barcode is also called GTIN or GTIN13 (Global Trade Identifier)
  • └ inventory_deduction_strategy
  • String
  • 必须
  • payment_success_deduct
  • Indicate when the inventory of a specific product will be deducted: 1) place_order_withhold: the inventory is deducted just after the order is placed by customer. 2) payment_success_deduct: the stock is deducted after the payment is done successfully by the customer.
  • └ weight
  • String
  • 必须
  • 3.2
  • Weight of the product, including package. Measured in Kilograms (Kg) with a maximum 500 and minumum 0.001
  • └ package_length
  • Number
  • 必须
  • 10
  • Package length, measured in centimeters (cm). Maximum 700 cm, minumum: 1 cm
  • └ package_height
  • Number
  • 必须
  • 20
  • Package height 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
  • └ price_type
  • String
  • 可选
  • absolute
  • Support absolute or delete. When filling in "delete", the multi_country_price_configuration will be eliminated.
  • country_price_list
  • SingleCountryPriceDto []
  • 可选
  • Price list for different countries
  • └ 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
  • sku_price_by_country_list
  • SingleSkuPriceByCountryDto []
  • 可选
  • Sku price list under the same ship_to_country
  • └ sku_code
  • String
  • 可选
  • 123abc
  • sku_code, must existed in sku_info_list
  • └ value
  • String
  • 可选
  • 15
  • Deprecated. Will be offline.
  • └ price
  • String
  • 可选
  • 16
  • 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.
  • └ 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(freighttemplate.aliexpress.com) directly or thourgh the API: aliexpress.freight.redefining.listfreighttemplate.Please note that the default template with id:1000 is not applicable to oversea sellers.
  • └ size_chart_id
  • Number
  • 可选
  • 100
  • merchant's size chart id, more used in the category of shoes and clothes.
  • └ shipping_lead_time
  • Number
  • 必须
  • 3
  • refer to the preparation period of merchant before the package could be dispatched to the customer. Minimum:1
  • └ service_policy_id
  • Number
  • 必须
  • 0
  • service policy id, which could be set and obtained in the seller's background(https://cn.ae.aliexpress.com/sellerpromise/sellerPromiseHome.htm). If the merchant would like to use the default setting, pass "0" to this parameter.

响应参数

名称 类型 示例值 描述
result PostItemResponseDto {"success":true} result
  • └ product_id
  • Number
  • 1000005237852
  • When invoked successfully, Aliexpress will return a product Id.

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliexpressSolutionProductPostRequest req = new AliexpressSolutionProductPostRequest();
AliexpressSolutionProductPostRequest.PostProductRequestDto obj1 = new AliexpressSolutionProductPostRequest.PostProductRequestDto();
obj1.setSubject("Huawei Mate 10");
obj1.setDescription("El Huawei Mate 10 Lite destaca principalmente por su pantalla FullView y sus cuatro cámaras. <img alt=\"Huawei-Mate-10-Lite_02\" src=\"https://ae01.alicdn.com/kf/UTB8rju8uOaMiuJk43PTq6ySmXXa7.jpg\">");
obj1.setLanguage("es");
obj1.setProductUnit(100000015L);
List<AliexpressSolutionProductPostRequest.SingleLanguageDescriptionDto> list3 = new ArrayList<AliexpressSolutionProductPostRequest.SingleLanguageDescriptionDto>();
AliexpressSolutionProductPostRequest.SingleLanguageDescriptionDto obj4 = new AliexpressSolutionProductPostRequest.SingleLanguageDescriptionDto();
list3.add(obj4);
obj4.setLanguage("es");
obj4.setWebDetail("{\"moduleList\":[{\"html\":{\"content\":\"test web description\"},\"type\":\"html\"}],\"version\":\"2.0.0\"}");
obj4.setMobileDetail("{\"moduleList\":[{\"texts\":{\"content\":\"test mobile description\",\"class\":\"body\"},\"type\":\"text\"}],\"version\":\"2.0.0\"}");
obj1.setMultiLanguageDescriptionList(list3);
List<AliexpressSolutionProductPostRequest.SingleLanguageTitleDto> list6 = new ArrayList<AliexpressSolutionProductPostRequest.SingleLanguageTitleDto>();
AliexpressSolutionProductPostRequest.SingleLanguageTitleDto obj7 = new AliexpressSolutionProductPostRequest.SingleLanguageTitleDto();
list6.add(obj7);
obj7.setSubject("Versión Global Xiaomi Redmi Note 5");
obj7.setLanguage("es");
obj1.setMultiLanguageSubjectList(list6);
obj1.setGroupId(262007001L);
obj1.setExtraParams("extra params");
List<AliexpressSolutionProductPostRequest.MarketImageDto> list9 = new ArrayList<AliexpressSolutionProductPostRequest.MarketImageDto>();
AliexpressSolutionProductPostRequest.MarketImageDto obj10 = new AliexpressSolutionProductPostRequest.MarketImageDto();
list9.add(obj10);
obj10.setImageType(1L);
obj10.setImageUrl("https://ae01.alicdn.com/kf/Hf5987123b00246699ac4f86795d59e636.jpg");
obj1.setMarketingImages(list9);
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<AliexpressSolutionProductPostRequest.AttributeDto> list12 = new ArrayList<AliexpressSolutionProductPostRequest.AttributeDto>();
AliexpressSolutionProductPostRequest.AttributeDto obj13 = new AliexpressSolutionProductPostRequest.AttributeDto();
list12.add(obj13);
obj13.setAttributeValue("1920*1080");
obj13.setAttributeName("Resolution");
obj13.setAliexpressAttributeValueId(593L);
obj13.setAliexpressAttributeNameId(14L);
obj1.setAttributeList(list12);
List<AliexpressSolutionProductPostRequest.SkuInfoDto> list15 = new ArrayList<AliexpressSolutionProductPostRequest.SkuInfoDto>();
AliexpressSolutionProductPostRequest.SkuInfoDto obj16 = new AliexpressSolutionProductPostRequest.SkuInfoDto();
list15.add(obj16);
obj16.setBarCode("2012331233258");
List<AliexpressSolutionProductPostRequest.SkuAttributeDto> list19 = new ArrayList<AliexpressSolutionProductPostRequest.SkuAttributeDto>();
AliexpressSolutionProductPostRequest.SkuAttributeDto obj20 = new AliexpressSolutionProductPostRequest.SkuAttributeDto();
list19.add(obj20);
obj20.setSkuImageUrl("https://upload.wikimedia.org/wikipedia/commons/b/b5/Winnersh_Meadows_Trees.jpg");
obj20.setSkuAttributeValue("red");
obj20.setSkuAttributeName("Color");
obj20.setSkuAttributeNameId(14L);
obj20.setSkuAttributeValueId(10L);
list17.setSkuAttributesList(list19);
obj16.setInventory(90L);
obj16.setPrice("12.21");
obj16.setSkuCode("123abc");
obj16.setDiscountPrice("9.92");
obj16.setExtraParams("extra params");
obj16.setEanCode("12345678");
obj1.setSkuInfoList(list15);
obj1.setInventoryDeductionStrategy("payment_success_deduct");
obj1.setWeight("3.2");
obj1.setPackageLength(10L);
obj1.setPackageHeight(20L);
obj1.setPackageWidth(30L);
AliexpressSolutionProductPostRequest.MultiCountryPriceConfigurationDto obj21 = new AliexpressSolutionProductPostRequest.MultiCountryPriceConfigurationDto();
obj21.setPriceType("absolute");
List<AliexpressSolutionProductPostRequest.SingleCountryPriceDto> list23 = new ArrayList<AliexpressSolutionProductPostRequest.SingleCountryPriceDto>();
AliexpressSolutionProductPostRequest.SingleCountryPriceDto obj24 = new AliexpressSolutionProductPostRequest.SingleCountryPriceDto();
list23.add(obj24);
obj24.setShipToCountry("FR");
List<AliexpressSolutionProductPostRequest.SingleSkuPriceByCountryDto> list27 = new ArrayList<AliexpressSolutionProductPostRequest.SingleSkuPriceByCountryDto>();
AliexpressSolutionProductPostRequest.SingleSkuPriceByCountryDto obj28 = new AliexpressSolutionProductPostRequest.SingleSkuPriceByCountryDto();
list27.add(obj28);
obj28.setSkuCode("123abc");
obj28.setValue("15");
obj28.setPrice("16");
obj28.setDiscountPrice("3.99");
list25.setSkuPriceByCountryList(list27);
obj21.setCountryPriceList(list23);
obj1.setMultiCountryPriceConfiguration(obj21);
obj1.setFreightTemplateId(703476858L);
obj1.setSizeChartId(100L);
obj1.setShippingLeadTime(3L);
obj1.setServicePolicyId(0L);
req.setPostProductRequest(obj1);
AliexpressSolutionProductPostResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

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

错误码解释

错误码 错误描述 解决方案
-1 System Error Try later
F00-00-10006-004 Process main image error Check the format of image
F00-00-10004-001 Brand not exist please contact your KA manager
T-00001-01-16-000 System error Please try later or contact Aliexpress technicians for help
F00-00-10005-001 Category not exist please contact your KA manager
7009999 System error Please check the errormessage
F00-00-10007-010 Format of field:price in sku_info_list is wrong please check your input
F00-00-10007-004 The customized image for each sku is required but found empty Please add customized image url for each sku
F00-00-10007-007 duplicate sku_code please check your input
F00-00-10007-004 The customized image for each sku is required but found empty Please add customized image url for each sku
F00-00-10007-007 duplicate sku_code please check your input

API工具

API测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部