Developing documents（已废弃）
1. Products
Please refer to below documents
2. Orders and Logistics
2.1 Manage order sequence
2.2 Get lists of orders of the seller
Use aliexpress.trade.redefining.findorderlistquery to get lists of orders. The results can be filtered based on order status.
2.3 Get basic info of any single order
For basic info like order status and logistics status, use aliexpress.trade.redefining.findorderbaseinfo
2.4 Get detailed info of any single order
Use aliexpress.trade.redefining.findorderbyid
2.5 The status list and state machine of Aliexpress order
| order_status | Explanation | seller’s operation |
|---|---|---|
| PLACE_ORDER_SUCCESS | wait buyer to pay | No |
| PAYMENT_PROCESSING | buy’s payment is processing | No |
| RISK_CONTROL | payment success, the order is under risk control | No |
| WAIT_SELLER_EXAMINE_MONEY | wait seller examine money(offline payment amount is less than order amount) | seller can accept or refuse |
| WAIT_SELLER_SEND_GOODS | risk control passed, waiting seller to send goods | seller can begin sending goods, then update tracking number in Aliexpress System |
| SELLER_PART_SEND_GOODS | already partly sended goods | seller can continuously send goods, then update tracking number in AE |
| WAIT_BUYER_ACCEPT_GOODS | seller has sended all goods, waiting buyer accept goods | No |
| IN_CANCEL | reaching anagreement between buyer and seller and wait fund processing | seller can accept or refuse |
| FINISH | fund processing completed, the order finish | No |
| ARCHIVE | finished order in archive | No |
| RISK_CONTROL_HOLD | payment success, risk control results in hold(wait buyer apply payment appeal) | No |
| in_issue | order in issue status | seller can accept or refuse the issue, or further negotiating with the buyer |
| frozen_status | No | |
| in_frozen | order in frozen status(buyer and seller both cannot operate order) | No |
State Machine:
2.6 Update tracking info for shipments
Once an order is shipped (all or partially), the seller can update the order with tracking info:
There are 2 cases of an order status for which the client need to send tracking info to AE (NOTE: the status strings can be slightly different in basic and detailed order info):
1. WAIT_SELLER_SEND_GOODS
2. SELLER_PART_SEND_GOODS
Use aliexpress.logistics.sellershipmentfortop to upload the tracking information. 4 params are important:
1. serviceName: The name of the carrier company that is used for the shipment. This name must matches the records on AE platform. See below for more details on how to get the name.
2. logisticsNo: The tracking number of the shipment.
3. sendType: Whether the products in this order are all shipped (all), or only part of them (part)
4. outRef: The associated order id of this shipment.
2.7 Get carrier name
- aliexpress.freight.redefining.getfreightsettingbytemplatequery
- Use logisticsCompany
- aliexpress.logistics.redefining.listlogisticsservice
- Use serviceName
3. Send message between seller and buyers on AE
4. Issues between seller and buyers
- Get the list of issues from buyers
- Get details of an issue
- Handle the issue using the available APIs in the menu.
5. Marketing-Limited Discount Store Promotion
Please refer to https://developers.aliexpress.com/en/doc.htm#?docType=1&docId=108452.
6.Marketing-Platform Promotion
6.1 Reset platform promotion product stock
If the seller wants to reset stock(quantities) for the product in platform promotion, please use this api:Reset stock for platform promotion
This api has some _**slight difference**_ with the restock operation on website as bellow. The operation in the website add the quantities to the current stock of a specific sku, while in api the quantities of the stock is an absolute value, not an additive number.
7. Query promotion&product information
7.1 Query all the product Ids, which have joined a promotion.
[API Guide](https://developers.aliexpress.com/en/doc.htm?spm=a219a.7386653.0.0.0dbleO#?source=search&docId=33133&docType=2)
9.2 Query the information of all the promotions that the product joins
Based on the product id, query all the promotions which the product has already joined, including platform promotion and store promotion. API Guide
