API truy xuất thông báo vận chuyển nâng cao
Điểm cuối thử nghiệm:
https://transact.ti.com/v2/store/orders/T10999999/advanced-shipment-notices/test
https://transact.ti.com/v2/store/orders/T10999999/advanced-shipment-notices/499999999/test
Điểm cuối sản xuất:
https://transact.ti.com/v2/store/orders/{Order Number}/advanced-shipment-notices/
https://transact.ti.com/v2/store/orders/{Order Number}/advanced-shipment-notices/{Waybill Number}
Sau khi đóng gói đơn hàng, khi đã sẵn sàng giao hàng, TI sẽ tạo thông tin theo dõi đơn giao có thể truy cập được thông qua API thông báo giao hàng nâng cao (ASN). Phản hồi bao gồm thông tin chi tiết về lô hàng của bạn, chẳng hạn như mã theo dõi lô hàng, thông tin về đơn vị vận chuyển và hóa đơn thương mại. API khả dụng khi thực hiện đẩy hoặc truy xuất. API đẩy sẽ gửi một webhook đến hệ thống của bạn theo thời gian thực để thông báo rằng đơn hàng của bạn đã sẵn sàng để vận chuyển và có thể được sử dụng để kích hoạt các luồng tự động hóa. Xem thiết lập thông báo đẩy để biết thêm thông tin.
Luồng API thông báo trước khi giao hàng (ASN)
- Sau khi đã tạo thông tin theo dõi, hãy xác thực bằng mã bí mật và khóa API bạn được cấp.
- Sau khi nhận được mã token truy cập, bạn có thể nhận thông tin vận chuyển cho toàn bộ đơn hàng bằng cách gửi yêu cầu với chỉ mã đơn hàng. Có thể thực hiện nhiều yêu cầu trong cùng một phiên với mã token truy cập, miễn là mã token chưa hết hạn.
- API sẽ trả lời bằng một mã trạng thái, 200 OK và một JSON chứa thông tin chi tiết về giao hàng.
- Bạn cũng có thể lấy thông tin chi tiết của một đơn giao cụ thể bằng cách cung cấp mã vận đơn từ yêu cầu API trước đó hoặc từ trang lịch sử đơn hàng trên myTI sau khi giao đơn hàng vận chuyển.
API có phiên bản dành cho thử nghiệm. Dữ liệu trong phản hồi sẽ trả về dữ liệu mẫu thử nghiệm được tiêu chuẩn hóa. Khi thử, ID đơn hàng phải luôn được chuyển dưới dạng T10999999 và waybillNumber phải luôn được chuyển dưới dạng 0499999999.
Ví dụ về yêu cầu truy xuất:
curl --request GET \ --url 'https://transact.ti.com/v2/store/orders/{orderNumber}/advanced-shipment-notices/{wayBillNumber}' --header 'Authorization: Bearer {access_token}' \