2022-01-11
What's new
Recently, in the process of joint transfer with ERP services, it was found that some merchants mixed with new and old interface delivery operations, resulting in delivery error problems.
Conclusion of technical isolation:
For a transaction order, if the old interface is used to create a logistics order, declare delivery, and modify the declaration of delivery, then the new interface cannot be used to declare the shipment and modify the declaration of delivery;
New and old interfaces are mixed to declare shipment, and there may be an affirmation that the delivery status will not be updated to all declarations of delivery.
For example, there are the following scenarios for a transaction order:
Scenario 1: Use the old interface to create a logistics order; declare shipment and modify the declaration that shipment can only use the corresponding old interface.
Scenario 2: Use the new interface to create a logistics order. The old declaration delivery and modification declaration delivery interface can continue to be used through the dimension of the main transaction order, but the new interface cannot be used after using the old statement/modification statement of delivery.
Scenario 3: Use the new interface to create a logistics order. If a new interface is used to declare delivery, then the declaration of delivery should also be modified and the new interface should be used. If the old interface is used to modify the declaration of delivery, it will indicate that the corresponding declaration shipment record cannot be found.
2022-01-10
What's new
Query available logistics services, create logistics orders, declare shipments, and modify the offline notice of the old interface to declare shipment.
Dear third-party ERP service providers and self-developed ERP merchant partners related to AliExpress delivery:
Recently, we have received feedback from merchants that the current use of the ERP shipping process and page operation is relatively cumbersome, which affects the shipping efficiency of some orders. Therefore, Cainiao plans to transform the delivery tool (ERP) used by merchants to improve the following four modules (query about available logistics services, create logistics orders, declare shipments, modify declaration of delivery) to improve the merchant's delivery operation experience.
I. Description of transformation:
1. This four-module content ERP transformation has added a sub-order delivery function to the original basic functions, and the rookie side of the new interface was launched in the official environment on September 18, 2021.
2. Time: (query about available logistics services, create logistics orders, declare shipments, modify declaration of shipment) The old interface will be officially launched on February 14, 2022 and will no longer be open for use.
Please complete the internal transformation as soon as possible according to the following interface transformation guidance, and contact Cainiao for joint adjustment testing. The new functional version needs to be officially launched by February 14, 2022 at the latest, otherwise it will affect online delivery.
3. If you have any questions, please join the "Shipping Experience ERP Optimization and Transformation Q&A Group" Dingding Group (Group Number: 33521851) for communication. If you join the group, please modify the group name notes in the format of "ERP-Company Name".
II. API documentation:
1. Check the list of online logistics services
Original interface name: aliexpress.logistics.redefining.getonlinelogisticsservicelistbyorderid
New interface name: aliaexpress.logistics.service.query
Change point: Upgraded based on the original interface, and the "Sub-transaction List: sub_order_list" field has been added. For details, please refer to the new interface document.
2. Sub-transaction order to create logistics order
Original interface name: aliexpress.logistics.createwarehouseorder
New interface name: aliaexpress.logistics.order.createorder
Change point: The input parameter is consistent with the original interface. This time, the child_order_id field has been added to declare_product_d_t_os. For details, please refer to the new interface document.
3. Sub-transaction order declares shipment
Original interface
Interface 1 Name:aliexpress.logistics.sellershipmentsupportsubtradeorder
Interface 2 Name:aliexpress.logistics.sellershipmentfortop
New interface
Interface Name:aliexpress.logistics.order.shipment
Change point: The input parameter is the same as the original interface, but the new interface adds the verification of the sub-transaction order. If the declaration shipping interface with transaction order dimension previously needs to be switched to the current interface.
4. Revise Sub-transaction Order to declare shipment
Original interface
Interface 1 name: aliexpress.logistics.redefining.sellermodifiedshipmentsupportsubtradeorder
Interface 2 Name: aliaexpress.logistics.sellermodifiedshipmentfortop
New interface
Interface Name:aliexpress.logistics.order.modifyshipment
Change point: The input parameter is consistent with the original interface, but the new interface adds the verification of sub-transaction orders. If the transaction order dimension modification was previously used, the shipping interface needs to be switched to the current interface.
?
III. Feedback after transformation:
Please give feedback after completing the shipping transformation. The feedback link is as follows: https://yida.alibaba-inc.com/o/FHGZQK
IV. Need to know:
Third-party ERP service providers and self-developed ERP merchants related to delivery: Please be sure to confirm that the transformation has been completed before February 14, 2022. If the transformation is not completed, please inform the merchant to use the rookie online delivery page in the background of the merchant to deliver the goods, so as not to affect the merchant's delivery restrictions.
2021-08-16
What's new
AE (Overseas) Warehouse Interface API Document and New
Background:
ISV actively returns the code of the actual tail-to-range distribution service of overseas warehouses through the declaration delivery interface provided by the AE open platform or modifys the code of the actual tail-to-range delivery service of overseas warehouses, AliExpress analyzes the corresponding carrier information on the side, and automatically obtains the logistics trajectory.
Address the pain points:
Solve the problem that due to the inconsistent logistics service name sent back by the merchant and the actual logistics service, the system cannot recognize the accurate carrier information and ultimately cannot obtain the logistics trajectory.
Action points:
STEP 1 (existing): ISV obtains tail-range logistics services supported by overseas warehouses, and ISV needs to obtain corresponding logistics service products through interface: "Basic Logistics Product Information Inquiry"
Note: The names of different WMS logistics services are slightly different. The four-way is defined as: logistics_product_code, and the barn is defined as: shipping_method
STEP 2 (existing): After ISV obtains the AliExpress platform order, according to the order and seller's requirements, create an outgoing order synchronized to the warehouse through the interface: "Create Outgoing Delegation"
STEP 3 (Adjustment): After the outgoing receipt generates the waybill number, ISV synchronizes the logics_product_code to the AE platform as the actual_carrier field through the AE open platform interface: "Declaration of shipment"
STEP 4 (optional): In the case of warehouse outgoing and using logistics product changes, ISV passes through AE open platform interface: "Modify the declaration of shipment" fills the contents of logics_product_code as the actual_carrier field Content, synchronized to the AE platform
Note: Some AE businesses are not supported: For orders shipped using the "Seller Custom-China" logistics service (service_name=“OTHER"), this part has a special logic before, which does not apply to this rule. Other AE orders can be adjusted according to the above logic.
2021-08-05
What's new
[ERP Get Field Reminder Notice]
Dear third-party ERP service providers and self-developed ERP merchant partners related to AliExpress delivery:
With the launch of the Global AliExpress platform to display tax-inclusive prices in EU countries (hereinafter referred to as "tax-inclusive prices"), if you use ERP for AliExpress delivery, we will once again remind service providers to ensure that the API interface field of ERP is correctly accessed to avoid deviations between the acquisition amount and actual application affecting merchants' stores. Operation. Possible impacts are as follows, but not limited to, using order amount to determine the fulfillment line, using order amount to financially reconcile monthly balances, etc.
重点API文档：
I. Declaration and customs clearance field aliexpress.taxation.calculate.open.query
1) Details: https://open.taobao.com/api.htm? docId=56229&docType=2&source=search
2) Background and application scenario: After the promulgation of the new EU e-commerce value-added tax regulations, it is used to transmit it to offline delivery and logistics providers to declare customs clearance, and is only used for the declaration of offline tax sub-orders. You can query information such as sub-order commodity tax and tax rate.
If the merchant needs to obtain the final pre-tax price or tax-exclusive price of the goods, it needs to be obtained from this API.
Field Name: order_tax_excluded_amount; Field Meaning: Total Price of Goods Not Tax
II. Enquiry for details of the new version of the trading order aliexpress.trade.new.redefining.findorderbyid
1) Details: https://open.taobao.com/api.htm? docId=34813&docType=2
2) Background and application scenarios: This API interface is transaction order details, including fields for all trading orders.
After the tax-inclusive price is launched, the total product amount and order amount will be expressed in-inclusive tax.
Field name: order_amount; field meaning: order amount (including tax included in UK and EU orders after the tax price is fully launched)
Field name: init_oder_amount; field meaning: total product amount (tax included in UK and EU orders after the tax price is fully launched)
Tax reform ERP transformation content: https://www.yuque.com/vincent-30iiy/gnbgw1/gok61z
2021-07-15
What's new
[Must-see] Must-have with tax price
From 6:00 a.m. Beijing time on July 1, 2021, AliExpress will collect value-added tax (VAT) on behalf of goods eligible for taxation in accordance with the new version of the EU's VAT regulations; Simultaneous AliExpress will fully launch the full-link display of EU VAT including tax prices in the near future;
In order to help business friends better understand the differences and necessary to-do things before and after the release of EU VAT including tax prices, a live broadcast was held at 14:00 p.m. on July 14. The live video and content are now integrated as follows for merchant partners to review and interpret:
I. Must-see price including tax: https://www.yuque.com/docs/share/da59a064-55fd-4a28-b2b5-bc083b08a086? #%20
II. Live broadcast with tax price: https://learning.aliexpress.com/course/learn? id=1755&type=video&login=skip
III. EU VAT Review: https://www.yuque.com/vincent-30iiy/gnbgw1/ydyehf
2021-06-26
What's new
[Latest] EU Tax Reform Delivery ERP Transformation Announcement
?
Dear third-party ERP service providers and self-developed ERP merchant partners related to AliExpress delivery:
? From 6:00 a.m. Beijing time on July 1, 2021 (UTC+2), from 6:00 a.m. Beijing time on July 1, 2021, 27 EU countries will implement the new version of the VAT regulations. All AliExpress sites will make corresponding technical adjustments in accordance with the requirements of EU regulations. For merchants to use online delivery for cross-border delivery to EU countries, the delivery tools (including ERP) used by merchants need to be modified as follows four points to avoid affecting merchants' delivery operations after the EU tax reform:
(1) [New] 1 Add a platform IOSS field fill box to the shipping page, and clearly remind merchants the merchant platform to use non-16 rookie online delivery lines, but the platform IOSS number is not filled in to the offline logistics service provider. Consumers may be levied value-added tax or generated for the time of importing. Customs clearance fee. We will update this logistics interface upgrade:
aliexpress.logistics.sellershipmentsupportsubtradeorde and aliexpress.logistics.sellershipmentfortop , add an optional parameter called "IOSS" to the interface entry parameter. From July 1, when the taxed package collected and paid by the merchant platform on behalf declares the delivery of the goods using non-16 rookie online delivery lines, the IOSS parameters will need to be passed in; if it is not passed in, it will be declared that the delivery will be reported.
The API interface jar package and API description page will be updated on June 25. Please get the latest jar package and upgrade the shipping logic of your software after 3 p.m. on June 25.
2 I hope ERP will refer to the IOSS number reminder similar to AE declaration of shipment. I hope it is the first time that it is not checked, and the subsequent support merchants will check by default. ( Click to view the example)
(2) The platform will issue taxable and untaxable marks to the transaction sub-single dimension on the global AliExpress trading terminal, and ISV will receive the tax markers transmitted by AliExpress;
Introduction: The tax marker is a sign for cross-border parcels for buyers from EU countries on sub-orders according to whether the platform has collected and paid VAT on its behalf, and will be used from July 1, 2021.
- Tax: The platform collects and pays parcels on behalf of others. When arriving at the customs of the destination country, you need to use the platform IOSS number to declare the customs of the destination country;
- Non-tax: The platform does not collect and pay value-added tax on behalf of others, and the IOSS number of the platform cannot be used to declare the customs of the destination country.
(3) Cainiao receives taxable and non-taxable identification based on the dimension of transaction suborders from ERP, and ERP should send the details of sub-orders to Cainiao;
(4) Restrict the combined delivery of cross-main orders;
?
The above transformation countries are limited to the 27 EU countries:
Austria, Belgium, Bulgaria, Cyprus, Croatia, Czech Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Poland, Portugal, Romania, Slovakia, Sloe Venia, Spain, Sweden;
Note: Exception countries do not involve any transformation.
Time: Please complete the transformation before June 30 according to the following interface transformation guidance. Otherwise, it will affect online delivery.
If you have any questions, please join the "EU Tax Reform ISV Delivery Transformation Communication Group" Dingding Group (group number: 34262205) to communicate. If you join the group, please note "ERP-Company Name" (please change your name when joining the group).
?
Service providers and self-developed ERP that are already docked/uns still docked, please be sure to enter the nail group and complete the delivery transformation as soon as possible.
At present, the common service providers of the platform in communication and docking are as follows. If merchants use the following ERP, there is no need to worry:
Store secretary, global trading assistant, Puyuan cloud ERP & Puyuan online store wizard, Mabang ERP, Tongtu ERP, mango store manager, Sumai ERP, Saibox ERP.
?
II. API documentation
1. Declaration Shipment Interface (new on June 25)
-aliexpress.logistics.sellershipmentfortop
-aliexpress.logistics.sellershipmentsupportsubtradeorder
2.
AE new version of the transaction order details inquiry
(Modification point: Add a new already_taxed field, I_TAXED indicates cross-border tax, and U_TAXED indicates overseas warehouse tax.)
- Two new API interfaces have been added - for sub-trading order commodity dimension tax information inquiry:
- Background and usage scenario: After the introduction of the EU's new e-commerce value-added tax regulations, it is used to transmit the declaration and customs clearance of offline delivery logistics providers on the customs side, so that only the declaration of offline tax sub-orders can be used.
- Declaration and customs clearance fields required for customs affairs: You can query information such as commodity tax and tax rate of sub-order goods.
https://open.taobao.com/api.htm? docId=56229&docType=2&source=search
Entry: order_id;
Reference: quantity,
order_tax_excluded_amount, delivery_amount,order_tax_amount, delivery_tax_amount,
tax_rates, delivery_tax_rates, sub_order_id, currency
- Platform fixed parameter acquisition: you can query the platform IOSS number
https://open.taobao.com/api.htm? docId=56215&docType=2&source=search
Entry: None
Reference: ioss_number
4. Cainiao creates an online logistics order interface
https://open.taobao.com/api.htm? docId=30198&docType=2
?
III. Feedback after transformation
Please give feedback after completing the shipping transformation. The feedback link is as follows:
https://yida.alibaba-inc.com/o/FHGZ
?
IV. Need to know
Third-party ERP service providers and self-developed ERP merchants: Please be sure to confirm that the transformation has been completed before June 30. If the transformation has not been completed, please inform the merchant to use the rookie online delivery page in the background of the merchant to deliver the goods, so as not to affect the merchant's delivery restrictions.
?
AliExpress & Rookie
2021-06-11
What's new
The European Union has launched a new e-commerce value-added tax regulation, which will take effect from July 1, 2021. The New Deal will affect the requirements of ERP delivery to the European Union. Please refer to the following documents and complete the relevant transformation. https://www.yuque.com/docs/share/0bab482e-d1a8-4f5d-8a1b-ea4e0336de8d? # [EU Tax Reform] Delivery ERP Transformation Announcement
In addition, some ERP service providers have recently joined the "EU Tax Reform ISV Delivery Transformation Communication Group" Dingding Group (group number 33156687). The information synchronization and transformation plans in the two groups are the same.
2021-04-08
What's new
Dear ISV partners,
The following is a description of the dynamic Tibetan mail function of the AE platform communicated in the morning. Please refer to:
"Dynamic Tibetan Mail Function Online Description - Business Background", please refer to the following documents: (including links to each API interface description)
? https://www.yuque.com/siyeneal/mnmqu6/ssxdxh?
For instructions on changes to the product API, please refer to the following documents:
Involving the description of transaction API changes, please refer to the following documents:
Marketing-related API changes are detailed in the following documents: https://www.yuque.com/docs/share/ae50e6de-1677-444e-b241-a45d424969f1? #
The API related to logistics-freight template has not changed.
2020-08-13
What's new
Interface name: aliexpress.ugc.product.video.upload (short video of the main picture of the new product)
Usage Scenario: When uploading goods in bulk through the API, you can upload the corresponding videos of the goods to AliExpress through this interface. After uploading, the video content will be synchronized to the main map position of the product in AE.
Business value:
1 As one of the core content businesses this year, short video will be connected to major channels inside and outside the AE station (first guess, Feeds, promotion venue transparency, off-site community, etc.). Products with videos will have the opportunity to get more traffic and exposure inside and outside the station;
2 The expression of short videos is of great help to improve the click efficiency and display value of products. Products with short videos are increased by about 30% compared with non-video products in the corresponding indicators.
3 Enhance buyers' trust in merchants and goods, improve communication efficiency, and better convey commodity information.
Interface information: ? https://developers.aliexpress.com/doc.htm? docId=51659&docType=2
2020-08-03
What's new
AE Value Coverage Upgrade Service ISV Access
New interface
AE Value Guarantee Upgrade Service ISV Access Document: https://www.yuque.com/docs/share/45a841ea-4f88-43e1-9032-5c088fc51cf4? spm=5261.notice_detail.Text.4.3db24edfMqjjJO
2020-06-12
What's new
1) Transaction Order Details Interface
2) Obtain the online shipping logistics service list interface according to the transaction order id
Add the list of available logistics services available_logistic_service_list to indicate which of all logistics lines available for the store owner's trading order are the logistics lines that can be used for the order activity. If the logistics line is a non-solid line, the property value is empty; if the logistics line is a single line, it will return as a single line in code and name.
3) Declaration Shipment Interface
[aliexpress.logistics.sellershipmentfortop] (aliexpress.logistics.sellershipmentfortop) Goods interface))
Interface input adds field package_type, non-essential, optional value consolidation. If you want to mark an package as a single package during the declaration shipping process, you need to send back the consolidation in the interface; if no special marking is required, keep this field empty. At present, it is not supported to mark packages as non-packed packages.
4) Modify the declaration shipping interface
The interface input adds a new package_type field, non-essential items, and the optional value consolidation. If you want to mark an package as a package as a single package during the modification declaration shipping process, you need to send back the consolidation in the interface; if no special marking is required, keep this field empty. At present, it is not supported to mark packages as non-packed packages.
2020-05-12
Marketing interface offline notification
Now these two old interfaces will be offline on May 30, 2020, please migrate to the new interface in time.
2020-05-09
Change content
The three interfaces will be launched on May 15, 2020. Now the window management service has been upgraded, the window issuance and setting use functions have changed greatly (from the original window settings cannot be replaced, the invisible effect, upgraded to replaceable goods, and the data effect is visible), a new set of API interfaces (including querying windows, querying window goods, Set up/replace window goods, effect viewing, etc.), which is expected to be completed by the end of June. Therefore, these three interfaces are no longer in use and will be launched on May 15, 2020.
Impact
Users using this interface need to remove the corresponding business to avoid reporting errors after the interface is offline.
2020-04-13
Change content
Due to the change of rookie settlement logic, the logistics_fee value returned by the original interface aliexpress.logistics.querylogisticsorderdetail (query logistics order information (recommended)) is inaccurate. In order for merchants to obtain accurate freight, the interface has added a freight list field to return freight, including RMB or US dollars or both.
Return sample as follows:
"logistics_fee_list": {
"money": [
{
"amount": 3,
"cent": 300,
"currency_code": "USD"
},
{
"amount": 58.59,
"cent": 5859,
"currency_code": "CNY"
}
]
}
2020-03-05
What's new
Dear AliExpress seller & ISV friends,
In order to improve the delivery efficiency of participating merchants for AEplus orders, merchants need to develop their own ERP and ISV in the service market according to the AliExpress trading API in advance.
Interface upgrade ERP. After the ERP upgrade and the transaction function is released, merchants can quickly identify AEplus orders through ERP to facilitate delivery.
In order not to affect the AEplus seller assessment results, we hope you can start the upgrade as soon as possible. AliExpress will be launched on March 12. At that time, you can jointly tune, test and use it. Finally, it is expected that the upgrade will be completed no later than March 15, otherwise the seller will not be able to recognize the AEplus order, which will affect the seller's delivery efficiency.
Escalation content:
1) Description of the docking plan:
Two query AE order interfaces will return the AEPlus mark for AEPlus orders.
2) Return to the sample:
A, order details inquiry interface aliexpress.trade.new.redefining.findorderbyid
<child_order_list>
<aeop_tp_child_order_dto>
<tags>
<string>AE_PLUS_RU</string>
</tags>
</aeop_tp_child_order_dto>
</child_order_list>
B, order list query interface aliexpress.trade.seller.orderlist.get
<aeop_order_item_dto>
<product_list>
<aeop_order_product_dto>
<tags>
<string>AE_PLUS_RU</string>
</tags>
</aeop_order_product_dto>
</product_list>
</aeop_order_item_dto>
2019-10-11
From November 25, 2019, all logistics orders created online must fill in the "Return Address Information" when creating logistics orders. Please modify them in time to avoid creating online logistics orders due to the failure to fill in the return address information at the time of delivery.
2019-07-31
The new version of the transaction order details inquiry (aliexpress.trade.new.redefining.findorderbyid) adds the cancel_request_reason field for the reason why the buyer applies for cancellation, only Cancelled orders are valid (this field will not be returned when the seller refuses, agrees to cancel or the buyer withdraws, so it can only be used in scenarios where the seller agrees or rejects the buyer's cancellation request), and is limited to new orders (some orders created between 7.18-8.15 and all orders created after 8.15).
2019-07-23
The new version of the transaction order details inquiry (aliexpress.trade.new.redefining.findorderbyid) adds a new_order_amount field, which is more accurate than order_amount. Seller price adjustment and COD fees. Only new orders (some orders created between 7.18-8.15 and all orders created after 8.15). This field is consistent with the order amount on the website, the pay_amount of the order list query (aliexpress.trade.seller.orderlist.get).
2019-07-16
The message of some orders created after July 18 will be changed. Please refer to the relevant changes in the trading message on July 18.
2019-07-08
2019-07-02
2019-06-26
Change content
From July 8, there will be some changes in the trading, marketing and commodity API (aming which the changes in goods have begun), initially affecting some sellers, and then gradually expanding the scope until July 18 for all sellers. Please use the following documents to view the impact on yourself and make corresponding modifications.
2019-05-30
Change content
aliexpress.marketing.redefining.restocklimiteddiscountpromproduct (store limited-time active goods inventory) will be offline on June 20, 2019. Now the store's limited-time active inventory mode has been upgraded, the original active inventory mode has been cancelled, and the normal inventory mode is consistent with the whole store discount activity. After setting the limited-time activity, the inventory is synchronized with the ordinary inventory you set at the time of product release. The original price will be displayed after the ordinary inventory is sold out, and the active price can be restored after the inventory is replenished. Therefore, this interface is no longer meaningful and will be launched on June 20, 2019.
Impact
Users using this interface need to remove the corresponding business to avoid reporting errors after the interface is offline.
2019-04-17
Change content
2019-04-16
Offline notification of the old interface of the transaction
The following old interfaces have been declared no longer maintained long ago, and the replacement new interface has been provided for a long time. Now these two old interfaces will be offline on June 1, 2019. Please migrate to the new interface in time.
2019-04-11
Change content
Add a return field for cash on delivery
2019-04-10
Change content
- The interface to check whether the order details is added to the return field of cash on delivery.
- Add an interface for querying seller information to query the current seller's country and quotation currency.
2019-03-26
The second phase of logistics address localization is launched, details: https://developers.aliexpress.com/doc.htm? docId=109639&docType=1
2019-03-12
Change content
Qimen.aliexpress.trade.findorderbyid adds the field: result -> child_order_list -> logistics_warehouse_type. For the specific background and meaning of the new field, please refer to the changes on March 11 below.
2019-03-11
Change content
It is expected that on March 15, 2019, AliExpress's overseas warehouse business will be launched for rookie certification. At that time, Cainiao certified overseas warehouse shipment orders will be added to AliExpress orders (the order logo will be marked on the suborder).
Such orders (suborders) will be issued by the rookie system to carry out order fulfillment. Merchant ERP needs to filter this type of order (suborder), otherwise duplicate shipment may occur, resulting in loss of capital.
Add a field to aliaexpress.trade.new.redefining.findorderbyid: target -> child_order_list -> l ogistics_warehouse_type. This field currently has only one optional value except null. CainiaoInternationalWarehouse means that it is shipped in the rookie certified overseas warehouse. Such orders (suborders) will be issued by the rookie system to the overseas warehouse system for order fulfillment, and the merchant ERP needs to filter this type of order (suborder). Other situations are empty. At present, there is no value in this field, and there may be no value in this field until the business goes online.
Impact
For AliExpress open platform applications related to logistics and delivery, in order to avoid loss caused by repeated shipment by the seller after the new business is launched, please modify the code logic before March 15: if the value of this new field in a suborder for the order details obtained is cainiaoIn ternationalWarehouse, there is no need to perform the order; if the value is empty, it will be processed as before.
2019-03-08
Change content
Change to the format of the country-specific quotation configuration (aeop_national_quote_configuration) of the product. Involve the following APIs
Old format
When configuration_type is
- percentage: Proportionally based on the benchmark price, at which percentage is the price adjustment ratio relative to the benchmark price (percentage integer, negative support, current limit >=-30 && <=100)
- Relative: Relative to how much the original price rises or falls, at this time, the percentage is based on how much the benchmark price rises or falls.
The format is as follows.
[
{"shiptoCountry":"US","percentage":"5"},
{"shiptoCountry":"RU","percentage":"-2"}
]
When configuration_type is absolute (direct quotation), the format is as follows. Among them, the key format of absoluteQuoteMap is ":"; if there are multiple sku attributes, it is separated by ";"; if there is no sku attribute, use the empty string example as "," 14:173" 14:17 3;3:2034781"
[
{"absoluteQuoteMap":{"14:193":84.99,"14:771":84.99},"shiptoCountry":"FR"},
{"absoluteQuoteMap":{"14:193":89.99,"14:771":89.99},"shiptoCountry":"ES"}
]
New format
The new format will no longer use the Percentage field and use absoluteQuoteMap. When the old format uses percentage or relatative, it can only uniformly adjust the price of all sku. The new format uses absoluteQuoteMap to adjust the price of any one or more sku. The value of absoluteQuoteMap is related to the value of the root configuration_type. The format of the key of absoluteQuoteMap remains unchanged.
| configuration_type | The meaning of the value of absoluteQuoteMap |
|---|
| percentage | Price adjustment ratio relative to the benchmark price (percentage integer, support negative number, current limit >=-30 && <=100) |
| Relative | Adjustment value relative to the benchmark price, supporting negative numbers |
| absolute | Set the specific value directly, and negative numbers are not supported. |
Example
[
{"absoluteQuoteMap":{"14:193":1.0},"shiptoCountry":"RU"},
{"absoluteQuoteMap":{"14:193":2.0},"shiptoCountry":"US"}
]
Impact
- At present, when entering sub-country quotations, both the new and old formats can be used, but it is recommended to switch to the new format as soon as possible. First, the old format will not be supported in the future, and second, some of the synchronized commodity data may be the new format.
- When obtaining commodity information, it is possible to return to the new format or the old format. Please do it compatible. After returning to the new format uniformly in the future, remove the compatibility processing.
2019-02-20
From February 21, when calling aliaxpress.logistics.createwarehouseorder, the system will determine whether the seller is an oil seller (oil seller refers to the fact that there are goods that have joined the oil program) and has not signed it. If the oil plan agreement has been signed, the interface will not be able to use the interface and return the corresponding error report. The error is: "Because you haven't signed the oil program agreement, the shipping function is temporarily unavailable. Please click this link: https://sellercenter.aliexpress.com/protocol/protocolInfo.htm? protocolId=10000011001 Go to the agreement page to sign before trying to use it. Click the link to sign and use the interface normally.
2019-02-13
Change content
Added aliaexpress.offer.draftproducts.get (query the list of products in the draft box) and aliexpress.offer.draftproduct.get .
Note: To publish the goods in the draft box, please use aliaexpress.postproduct.redefining.postaeproduct instead of editing interface; in addition, the input parameter product_id needs to To fill in the product_id of the draft box item.
2019-01-02
Change content
From January 3, when calling aliaexpress.logistics.createwarehouseorder, the system will determine whether the seller is an oil seller (the oil seller refers to the fact that there are goods that have joined the oil plan) and has not signed it. If you have passed the oil plan agreement, you will not be able to use the interface and return the corresponding error report. The error is: "Because you haven't signed the oil program agreement, the shipping function is temporarily unavailable. Please click this link: https://sellercenter.aliexpress.com/seller/index.htm Go to the seller's background homepage to sign, and then try to use it, thank you." Click the link to sign and use the interface normally.
2019-01-02
Change content
aliexpress.trade.redefining.findorderreceiptinfo (order receiving information query) returns to add a country_name.
2018-12-04
Change content
qimen.aliexpress.trade.findorderbyid (deal order details inquiry) Return results added buyer notes (result -> child_order_list -> buyer_mem o), please refer to the 2018-11-30 change for details.
2018-11-30
Change content
aliexpress.trade.new.redefining.findorderbyid (New Version of the transaction order details inquiry) returns to add order notes (target -> child_order_list - > buyer_memo)
Original target -> memo represents buyer notes. This field is only applicable to the main order with only one sub-order, and the new buyer_memo field is the buyer's note for each sub-order. If a master order has multiple suborders, target -> memo is null, and only target -> child_order_list -> buyer_memo may have a value; if a master order has only one suborder, there is a purchase. In the case of home notes, target -> memo and target -> child_order_list -> buyer_memo are the same. Therefore, you can use target -> child_order_list -> buyer_memo to get buyer notes and ignore target -> memo.
2018-11-30
Offline notification of dispute interface
The following old interface will be offline on December 30, 2018. Please migrate to the new interface in time.
2018-11-27
Change content
aliexpress.offer.ds.product.simplequery ( Dropshipper's simple information about querying a single product)
- Fix the problem that the sku_bulk_order, offer_bulk_sale_price, offer_sale_price attributes in aeoop_ae_product_s_k_us are worthless when the product has no sku.
- Add s_k_u_available_stock to the subelement in aeop_ae_product_s_k_us to indicate available active inventory.
- Added item_offer_site_sale_price and total_available_stock
aliexpress.postproduct.redefining.findaeproductbyidfordropshipper (dropshipper lookup product information interface)
- Fixes sku_bulk_order, offer_bulk_sale_price, offer_sale_price, s_k_u_avail in aeop_ae_product_s_k_us when the product has no sku The problem of able_stock worthless
- Fix the problem that sku_property_name and sku_property_value in aeop_aeop_product_s_k_u_propertys are empty
- Return the result and add the following fields:
– Store_info, including store name (store_name), ID (store_id), store DSR three values (communication_rating, item_as_descriped_ rating, shipping_speed_rating)
– Commodity information, including order_count, commodity evaluation_count, avg_evaluation_rating
2018-09-12
Change content
New API
2018-08-14
Marketing interface offline notification
Using the following marketing API will cause the promotion to take up activity resources (time and number of times), resulting in no activity resources for daily activities:
Please migrate to the new interface as soon as possible. The promotional activities in the new interface do not occupy activity resources (time and number of times).
The following interfaces will be offline on September 15, 2018. Please migrate to the new interface in time.
2018-08-06
- AliExrepss Direct worry-free converage line has been added to the oil plan.
- Declare Shipment Scenario
Sellers can use the aliaexpress.logistics.redefining.listlogisticsservice API to obtain all the route information of the platform that can be used to declare shipments.
CAINIAO_CONSOLIDATION_AE (WORRY-FREE CONSOLIDATION_UATES), CAINIAO_CONSLIDATION_SA (WORRY-SAUDI), SOLDERS CAN MAKE A DECLARATION OF DELIVERY OF OIL TRANSACTION ORDERS. - Online Shipping Scenarios
Sellers can use aliaexpress.logistics.redefining.getonlinelogisticsservicelistbyorderid to obtain online shipping logistics line information available for specified transaction orders.
Note: This interface will only return to the worry-free consignment line if the trading order contains petroleum goods.
The line name specified in the seller's online shipping logistics order must be returned in aliaexpress.logistics.redefining.getonlinelogisticsservicelistbyorderid API The line information.
2018-07-25
Please read the notice of change of IP information on the open platform public network. If you all use domain names, it doesn't matter; if you use VIP directly, or bind VIP, or use it locally to make ACL restrictions, please follow the instructions in the document.
2018-06-06
Change content
New API
1. The buyerLoginId has been added as an input, and the money class in the out-out reference has been deleted.
2. The Qimen official scene entry parameter of the order list has been modified synchronously, and the money class in the out of the parameter needs to be developed and adapted.
3. The interface reveals all time-related fields to U.S. time in format 2018-01-01 12:12
4. Fix the problem that the interface reveals all amount-related fields with amount to 0.
5. The original order list query interface is no longer maintained.
Optimize the API
The following four new entries have been added to the new version of the transaction order details inquiry interface:
product_img_url Product main chart Url
product_snap_url Snapshot Url
goods_prepare_time lead time
logistics_service_name logistics service
Bug fix
Fix limited-time active goods add interface entry terminal for MOBILE or ALL aliexpress.marketing.limiteddiscountpromotion.addpromotion product
2018-05-17
Change content
New on-site letter faq API
2018-05-11
Change content
Modify the API
Product list query interface aliexpress.postproduct.redefining.findproductinfolistquery adds product creation time, and finally modify the time.
2018-04-27
Change content
New marketing API
Modify the API
Increase the current state timeout date;
Add the refund information and loan information of the suborder dimension;
The official scene of the corresponding order details of Qimen API has also been modified;
On-site message push API: aliexpress_message_Pushnewmsg.
Messages belonging to the sub-account are pushed to the main account synchronously.
Messages sent by sellers are also pushed.
Impact
Old marketing interface
aliexpress.marketing.redefining.createlimitdiscountpromotion
aliexpress.marketing.redefining.adjustlimiteddiscountpromendtimebeta
aliexpress.marketing.redefining.joinlimiteddiscountpromotion
aliexpress.marketing.redefining.exitlimiteddiscountpromotion
aliexpress.marketing.redefining.updatelimiteddiscountpromotion
Maintenance has stopped and will be offline gradually.
2018-04-25
Change content
Modify the API
The dispute API has been modified as follows:
Add dispute process records (the process record will correspond to the picture attachment information (if any), and if there is a video, it will indicate whether there is a video)
When you receive a dispute and add a seller scheme, you can choose the type (return or return for refund). If the return, you must provide the return address id. After-sales treasure dispute, the second child has been modified to ordinary, and operation is allowed.
2018-04-23
Change content
New API
The following APIs have been added to the category:
Bug fix
Fix the issue where the new order details interface aliaexpress.trade.new.redefining.findorderbyid order closure reason is empty.
2018-04-16
Change content
New API
Impact
The old interface of the dispute
aliexpress.issue.redefining.findissuedetailbyissueid
aliexpress.issue.redefining.queryissuelist
Maintenance has stopped and will be offline gradually.
2018-04-02
Change content
New API
Subscribe to this message to receive a new message to the seller.
Bug fix
Fix the inconsistency in the brand category permissions of this interface.
2018-03-28
Change content
Qimen official scene qimen.aliexpress.logistics.createwarehouseorder id changed from required to optional.
2018-03-27
Change content
The parameter channel_id of the sending in-station email interface aliaspress.message.redefining.versiontwo.addmsg has been abandoned.
Impact
You can get channelId without calling aliaxpress.message.redefining.versiontwo.querymsgchannelidbybuyerid.
2018-03-22
Change content
Fixed the problem that qimen.aliexpress.logistics.getnextleveladdressdata (read the next level of address information) could not pass the signature verification, and added the error_code field. Please press the new check error. Misformatted returns a check error.
2018-03-19
Change content
Fixed the error that the SDK of aliaexpress.postproduct.redefining.getproductgrouplist (get the product grouping of the current member) could not be used, and a new APIaliexpress was created. product.productgroups.get to replace it.
Impact
Recommended use of new API: aliexpress.product.productgroups.get Replace the old API: aliexpress.postproduct.redefining.getproductgrou plist (Get the product group of the current member). The old API can still be used to parse the returned results by itself, but it will be offline later. It is recommended to migrate to the new API when you are free.
2018-03-14
Change content
Modified the size limit of the list-type input parameters of the following interface
- Edit product categories, attributes, SKU (aliexpress.postproduct.redefining.editproductcidattidsku), product_skus, product_skus. The size limit of aeop_s_k_u_property and product_properties has been increased from 20 to 999.
- Bulk access to online shipping labels (aliexpress.logistics.redefining.getprintinfos), and the size limit of the warehouse_order_query_d_t_os parameter is increased from 20 Up to 200
2018-03-12
Change content
Modified the official interface of Qimen: qimen.aliexpress.trade.findorderbyid. Support the new order details interface aliaexpress.trade.new.redefining.findorderbyid.
2018-03-08
Change content
API-Order Details Interface aliexpress.trade.new.redefining.findorderbyid
New version of the order details interface release: Compared with the original interface parameters, the data is basically compatible. Added the following parameters:
1. Dispute information (the original interface is empty): At the same time, increase the dispute creation time.
2. The actual payment amount of the order payAmountBySettlementCur, settlementCurrency
3. Image snapshot address of the goods in the order
4. sendGoodsOperator
5. Increase the refund amount, the time to successfully refund
6. The interface reveals all time-related fields to U.S. time in format 2018-01-01 12:12
7. Fix the problem that the interface reveals all amount-related fields with amount to 0.
The old interface aliaexpress.trade.redefining.findorderbyid is no longer maintained and will be offline in 3 months.
2018-03-07
Change content
- API - Get the content of a single freight template through template ID aliexpress.freight.redefining.getfreightsettingbytemplatequery
- Fix the error of the type of response parameterfreight_setting_list, from AeopFreightSelfdefine[] to AeopFreightSetting[], and the corresponding response result is Freight_setti The child elements of ng_list have been changed from aeop_freight_selfdefine to aeop_freight_setting
Impact
- Use SDK to call API - Users who obtain the content of a single freight template through the template ID could not be used normally before, but now they can use it normally.
- Use the API directly - Obtain the content of a single freight template through the template ID to obtain users who return to the XML/JSON data parsed by themselves. Originally, it could not be used normally, but now it cannot be used normally. You need to change the parsing code (the sub-element of freight_setting_list from aeop_freight_selfdefine changed to aeop_freight_setting)
Comments
Post a Comment