Logistics and delivery
1. Usage scenario
After the buyer purchases the goods, the seller delivers the goods through API to synchronize Taobao's paid and pending orders to shipped status.
2. Related API
API name
| Description
|
## taobao.logistics.online.send
| Online order delivery processing (supports cash on delivery) |
taobao.logistics.offline.send
| Contact logistics (offline logistics) for delivery
|
taobao.logistics.online.confirm | Confirm shipment notification interface |
taobao.logistics.companies.get | Get Logistics company and waybill number |
taobao.logistics.consign.resend | Modify logistics company and waybill number |
taobao.trades.sold.get | Query the transaction data sold by the seller (according to the creation time) |
taobao.trades .sold.increment.get | Query the incremental transaction data sold by the seller (according to the modification time) |
3. Operation steps
@
Step one: Obtain the pending For shipped orders
, call taobao.trades.sold.get and enter status="WAIT_SELLER_SEND_GOODS" to search for all orders to be shipped, as shown below.
FAQ
Step 2: Determine whether the sub-order has been closed or refunded
The first situation: If there is a closed order in the sub-order (i.e. orders.status="TRADE_CLOSED"), the user needs to mark the items in the sub-order in his local ERP system. Prevent the goods corresponding to the sub-order from being sent to the buyer when shipping;
Second case: If there is an order being refunded in the sub-order (i.e. orders.refund_status=” WAIT_SELLER_AGREE ”), the order needs to wait for the refund to be completed before shipping; otherwise, when shipping, it will default to the seller refusing to refund
Step 3: Shipping Process
Call taobao.logistics.offline.send or taobao.logistics.online.send to ship the order. The only difference between these two interfaces is the delivery method. The former is to contact logistics for delivery by yourself, while the latter is to place an order online. You can choose the specific method to use. Issues to note:
1) When the order is a cash on delivery order (i.e. type="cod", obtained by querying the transaction interface), taobao.logistics.online.send can only be called for shipping processing.
2) company_code is the logistics company code, which can be obtained through taobao.logistics.companies.get
3) taobao.logistics.online.confirm Non-delivery API, only when using taobao.logistics .online.send You need to use
if you do not enter the waybill number out_sid for delivery. 4) If you want to split the order for delivery, in addition to the 3 parameters of tid, out_sid and company_code, you need to add the two parameters of sub_tid and is_split. sub_tid represents the sub-order number (i.e. oid), which can be obtained when querying the order. Enter 1 for is_split to split the order. For more instructions on splitting orders, please refer to: //open.taobao.com/doc/detail.htm?id=101521
- There is no FAQ about this document yet