Đồng bộ trạng thái đơn hàng

Sau khi tạo đơn hàng trên hệ thống AG - Fulfillment, chúng tôi sẽ đồng bộ trạng thái đơn hàng nếu có thay đổi thông qua Webhook Url đã được config trên trang client của bạn.

Trong mục Config tích hợp khi bạn sử dụng Webhook Url thì khi trạng thái đơn hàng bên AG - Fulfillment có thay đổi sẽ sử dụng nó theo giao thức HTTP.

Attribute	Value	Description
URL	Webhook URL	Đường dẫn URL đã được cài đặt
Method	POST	Phương thức HTTP Request
Headers	content-type: application/json	HTTP Headers
	ag-signature	Chữ ký để kiểm tra tính đúng đắn của dữ liệu khi truyền tải trên mạng. Lấy chữ ký ở đây.
Payload	json	Tham khảo Request Dto bên dưới

Request Dto

Attribute	Type	Description
displayId	string	Mã đơn hàng trên hệ thống Fulfillment
carrier	string	Tên của đơn vị vận chuyển
waybillNumber	number	Mã vận đơn của đơn hàng
discount	number	Số tiền giảm giá
surcharge	number	Phụ phí
shippingFee	number	Phí vận chuyển
paid	number	Trả trước
subTotal	number	Tổng tiền (Giá trị đơn hàng chưa trừ giảm giá, trả trước và tính phụ phí)
externalId	string	Mã đơn hàng nội bộ của bạn
status	string	Canceled: Hủy, New: Mới, AwaitingStock: Chờ hàng, Reconfirm: Xác nhận lại, Confirmed: Đã xác nhận, AwaitingCollection: Chờ lấy hàng, Collecting: Đang lấy hàng, Awaiting3PLPickup: Chờ bàn giao, PickedUp3PL: 3PL đã lấy, InTransit: Đang trung chuyển, Stocked3PL: Lưu kho 3PL, InDelivery: Đang giao, FailedDelivery: Giao thất bại, Delivered: Đã giao (Chờ đối soát), AwaitingReturn: Chờ hoàn, InReturn: Đang hoàn, Returned: Đã hoàn (Chờ lưu kho), ReturnedStocked: Đã hoàn (Lưu kho), ReturnedCompleted: Đã hoàn (Hoàn tất), DeliveredCompleted: Đã giao (Hoàn tất), ReturnedDamagedBy3PL: Đã hoàn (Hư hỏng bởi 3PL), ReturnedDamaged: Đã hoàn (Hư hỏng bởi kho), ReturnedLost: Đã hoàn (Thất lạc bởi kho), LostBy3PL: Thất lạc bởi 3PL, Damaged: Hư hỏng, DamagedCompleted: Hư hỏng (Hoàn tất), Lost: Thất lạc, LostCompleted: Thất lạc (Hoàn tất)

Request mẫu

{
   "externalId":"BB-HVL-20210312",
   "carrier": "J&T",
   "waybillNumber": "SPX9766199900",
   "discount":1097,
   "surcharge":0,
   "shippingFee":0,
   "paid":0,
   "subTotal":2396,
   "displayId":"AGPTHCP",
   "status": "InDelivery"
}