Webhook

Webhook được cấu hình trong trang MyEMS. Người dùng cần có email và tạo api với response có định dạng giống demo

Header

Header

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

ems-transaction là 1 chuỗi ký tự ngẫu nhiên ứng với mỗi request.

Body json

Body json

{
  "TrackingCode": "ExxxxxxxxxxVN",
  "Fee": [
    {
      "FeeCode": "cod_fee",
      "FeeValue": 13000,
      "Currency": "VND"
    },
    {
      "FeeCode": "handling_fee",
      "FeeValue": 0,
      "Currency": "VND"
    },
    {
      "FeeCode": "overweight_fee",
      "FeeValue": 0,
      "Currency": "VND"
    },
    {
      "FeeCode": "shipping_fee",
      "FeeValue": 55471,
      "Currency": "VND"
    },
    {
      "FeeCode": "special_fee",
      "FeeValue": 0,
      "Currency": "VND"
    }
  ],
  "OrderCode": "ODR22134",
  "Weight": 1000,
  "StatusCode": 11000,
  "StatusName": "Đã giao cho bưu tá",
  "Location": "129060 - BCP Từ Liêm (ÐT:024.37871825)",
  "Note": null,
  "CreatedAt": "2019-07-09 07:48:30"
}

Parameter

Parameter	Description
TrackingCode	Mã tracking
OrderCode	Mã đơn hàng (Nếu có)
Weight	Khối lượng
StatusCode	Mã trạng thái bưu gửi
StatusName	Tên trạng thái bưu gửi
Location	Vị trí bưu gửi
Note	Ghi chú (Nếu có)
CreatedAt	Thời gian tạo
Fee	Mảng các khoản phí
Fee.*.FeeCode	Mã dịch vụ
Fee.*.FeeValue	Phí dịch vụ
Fee.*.Currency	Đơn vị tiền tệ

Response demo

Success response

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

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

Error response

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

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

Danh sách trạng thái bưu gửi