[30-09-2025] Order List/Detail API

Published date: 30-09-2025

What is Changing?

New Attributes in `Get Order Detail` and `Get Order List` API Response

store_created_time: The timestamp when the order was created on the marketplace (e.g., Shopee, Lazada). This represents the original order creation date/time.

first_delivery_time: The timestamp of the first delivery attempt, i.e., when the parcel was first dispatched or handed over to the receiver.

failed_delivery_reason: The reason why a delivery attempt failed, such as: customer not available, wrong address, or unable to contact receiver.

delivery_attempt: The number of delivery attempts made for the order. This counter increments each time the courier tries to deliver.

delivery_success_time: The timestamp when the order was successfully delivered to the customer (completed delivery).

return_success_time: The timestamp when the return process is completed successfully, after the parcel has been returned, inspected and re-stocked in the warehouse.

Example of Updated API Response

{
  // ...
  "items": [
    {
        // ...
        "store_created_time": 1753981745,
        "first_delivery_time": 1754121896,
        "failed_delivery_reason": "Giao hàng lần 1: Delay giao hàng vì KH hẹn ngày giao. Thời gian hẹn: Sáng 2025-08-06 - Tất cả khung giờ",
        "delivery_attempt": 2,
        "delivery_success_time": 1755270869,
        "return_success_time": 1755260296
    }
  ]
}

Who is Affected?

This change applies to developers using any version of the following APIs:

Get Order List

Get Order Detail

How to Apply?

Update and Handle API Response

Review API Documentation: Understand the new attributes and their data types.

Update Your Implementation:

Ensure your application can process:

store_created_time

first_delivery_time

failed_delivery_reason

delivery_attempt

delivery_success_time

return_success_time

If these fields are not relevant, ensure your application ignores them gracefully.

Test Your Integration:

Test with sample API responses to confirm proper handling.

Verify no disruptions or errors occur when these fields are present.

Deploy Changes:

Deploy the updated implementation before Sep 30, 2025, to avoid disruptions.

Need Help?

For questions or assistance, contact the API support team.

[30-09-2025] Order List/Detail API

What is Changing?#

New Attributes in Get Order Detail and Get Order List API Response#

Example of Updated API Response#

Who is Affected?#

How to Apply?#

Update and Handle API Response#