Webhook

Trả về trạng thái bưu gửi thông qua api ngay khi có trạng thái mới nhất.

Để cấu hình webhook, người dùng đăng nhập vào hệ thống, tại menu bên trái.

Header / Body json

Header

Content-Type : application/json
ems-transaction : "1234567890"

ems-transaction là 1 chuỗi ký tự ngẫu nhiên duy nhất ứng với mỗi trạng thái bưu gửi

Body json

{
    "tracking_code": "EJ012345678VN",
    "order_code": "ODR356",
    "status_code": 4,
    "status_name": "Đang vận chuyển",
    "note": "Đã đóng chuyến thư đi",
    "locate": "890100 - KTC1 Vĩnh Long (ÐT:02703834180)",
    "datetime": "28/08/2019 07:54:50",
    "total_weight": 240,
    "money_collect": 210000,
    "total_fee": 34000
}

*Note: 
    datetime: thời gian cập nhật trạng thái.
    Chú ý sắp xếp trạng thái nhận về theo trường "datetime".
    Trạng thái có datetime mới nhất sẽ là trạng thái cuối cùng.

Response demo

{
 "code" : "success",
 "transaction" : "1234567890"
}

Api callback phải có định dạng response giống với response demo và có method là POST

Developer xắp sếp dữ liệu webhook nhận về theo param "datetime" trong body json nhận được trước khi hiển thị dữ liệu để tránh hiển thị sai trạng thái.

transaction lấy tại ems-transaction trên header

PreviousHủy bưu gửi NextTạo webhook

Last updated 5 years ago

Was this helpful?