Workflow

Decoding AliExpress order_status and logistics_status

When automating your eBay × AliExpress dropshipping operation, understanding the raw data from the AliExpress API is critical. Specifically, the order_status and logistics_status fields provide the most granular insight into an order's lifecycle. While Fetch Order Tracking translates these into simplified statuses for convenience, knowing the underlying values allows for more precise workflow triggers and advanced refund detection logic.

This guide breaks down the common values you'll encounter for these two fields and how they relate to the order's progress, payment, and potential refund scenarios.

Understanding order_status

The order_status field reflects the overall state of the order from creation to completion or cancellation. It's a high-level indicator of where the order stands within AliExpress's system.

Key order_status Values and Their Meanings:

• WAIT_SELLER_SEND_GOODS: The order has been paid for, but the seller has not yet shipped the goods. This is the initial state after a successful payment (gmt_pay is set).
• SELLER_SEND_GOODS: The seller has marked the order as shipped. At this point, you should expect a tracking number to be available. The logistics_status field will become relevant here.
• WAIT_BUYER_ACCEPT_GOODS: The goods have been shipped, and the system is waiting for the buyer to confirm receipt or for the protection period to expire. This is a common state for orders in transit.
• BUYER_ACCEPT_GOODS: The buyer has manually confirmed receipt of the goods. This usually happens after delivery.
• FINISH: The order has been completed. This can occur after the buyer accepts goods, the protection period expires without dispute, or a refund is processed (if the refund completes the order).
• CANCELLED: The order was cancelled. This can happen for various reasons, such as non-payment, seller cancellation, or buyer cancellation before shipment. Check end_reason for specifics.
• CLOSE: Similar to CANCELLED, indicating the order is no longer active. Often used interchangeably with CANCELLED for practical purposes.
• PLACE_ORDER_SUCCESS: The order has been successfully placed but not yet paid for. The gmt_create timestamp is set, but gmt_pay is null.
• IN_CANCEL: The order is currently undergoing a cancellation process.
• IN_FROZEN: The order has been frozen, often due to suspicious activity detected by AliExpress. This requires manual intervention.

For refund detection, monitoring order_status transitioning to CANCELLED or CLOSE is a primary indicator. However, a refund can also occur while the order is in WAIT_SELLER_SEND_GOODS or even SELLER_SEND_GOODS, if the refund resolves the order entirely.

Understanding logistics_status

The logistics_status field provides more granular detail about the physical movement of the package. This field is only populated once the seller has marked the order as shipped (i.e., when order_status is SELLER_SEND_GOODS or WAIT_BUYER_ACCEPT_GOODS).

Key logistics_status Values and Their Meanings:

• WAIT_SELLER_SEND_GOODS: This value is confusingly shared with order_status, but when found in logistics_status, it implies that while the order is technically 'shipped' (order_status = SELLER_SEND_GOODS), the logistics provider has not yet received or processed the package. Think of it as 'shipping label created, but not yet in transit.'
• SELLER_SEND_GOODS: The package has been handed over to the logistics provider and is officially in transit. This is when tracking updates typically begin.
• BUYER_ACCEPT_GOODS: The package has been delivered and the buyer has confirmed receipt (or the system automatically confirmed). This often aligns with order_status = BUYER_ACCEPT_GOODS.
• NO_LOGISTICS: No logistics information is available for this order. This can happen if the seller ships without proper tracking or if there's a delay in the logistics system updating.
• WAIT_BUYER_ACCEPT_GOODS: Similar to the order_status, this means the package is in transit and awaiting buyer confirmation or protection period expiry.
• UNDELIVERED: The package could not be delivered to the buyer. This is a critical status for refund detection and requires immediate attention.
• TRANSPORT_CLOSED: The logistics process for this order has concluded, typically after delivery or an extended period of inactivity.
• NOT_RECEIVE: The buyer has not received the goods. This often precedes a dispute or refund request.
• WAIT_LOGISTICS_SEND_GOODS: The package is waiting to be picked up or processed by the logistics company after the seller has prepared it.

Connecting Statuses to Your Workflow

By monitoring changes in these raw fields, you can trigger specific actions in your dropshipping workflow:

1. Payment Confirmation:

When order_status changes from PLACE_ORDER_SUCCESS to WAIT_SELLER_SEND_GOODS, and gmt_pay is populated, you know the order is paid. This is your cue to confirm the eBay order.

2. Shipping Confirmation:

A transition of order_status to SELLER_SEND_GOODS, coupled with logistics_status updating from WAIT_SELLER_SEND_GOODS to SELLER_SEND_GOODS, indicates the item is truly in transit. This is when you should push tracking to eBay.

3. Delivery Detection:

When logistics_status becomes BUYER_ACCEPT_GOODS or order_status becomes BUYER_ACCEPT_GOODS, you can consider the order fulfilled. This is a good time to set a reminder for a potential feedback request on eBay.

4. Refund Detection:

This is where granular status monitoring shines. While Fetch Order Tracking detects refunds, understanding the underlying triggers helps with edge cases:

• Early Refund: If order_status is WAIT_SELLER_SEND_GOODS and gmt_refund is populated, it's an early refund before shipment.
• In-Transit Refund: If order_status is WAIT_BUYER_ACCEPT_GOODS or SELLER_SEND_GOODS, and gmt_refund is populated, it's a refund during transit. This often implies a dispute.
• Delivery Issue Refund: A logistics_status of UNDELIVERED combined with a populated gmt_refund is a clear signal for a delivery failure refund. You might also see order_status move to CANCELLED or CLOSE with an end_reason related to logistics.

By directly parsing these fields, you can build custom alerts or automated rules within your Google Sheet for scenarios not covered by simplified status reporting. For instance, you might want to specifically flag orders where logistics_status remains WAIT_SELLER_SEND_GOODS for more than 72 hours after order_status becomes SELLER_SEND_GOODS, indicating a potential seller delay or fake tracking.

Leveraging these specific API fields allows you to create highly robust and proactive refund and order management systems for your dropshipping business. To streamline this process and automate the data flow, integrate Fetch Order Tracking into your workflow: Learn more about Fetch Order Tracking.

---