API lấy trạng thái đơn hàng

API dùng để lấy trạng thái hiện tại của 1 mã vận đơn

Mô tả

Sau khi đơn hàng được gửi tới hệ thống của OMS. Khách hàng có thể kiểm tra trạng thái các đơn hàng dựa vào mã đơn hàng.

Request

Đường dẫn

GET /api/v1/orders/{TRACKING_ORDER}

Headers

Authorization: Bearer {JWT}
X-Client-Source: {PARTNER_CODE}
Content-Type: application/json

Code

CURL

curl --location --globoff '{{url}}/api/v1/orders/{TRACKING_ORDER}' \
--header 'Authorization: Bearer {{token}}' \
--header 'X-Client-Source: mwg'

HTTP

GET /services/shipment/v2/S1.A1.17373471 HTTP/1.1
Token: {API_TOKEN}
X-Client-Source: {PARTNER_CODE}

Tham số

Tham số	Bắt buộc	Mô tả
TRACKING_ORDER	Có	Mã đơn hàng OMS hoặc mã Đối tác được truyền qua ở trường order.id ở API đăng đơn

Phản hồi

Kết quả trả về

Hệ thống sẽ trả về kết quả dưới dạng JSON. Kết quả trả về được mô tả như sau:

Tham số	Kiểu dữ liệu	Mô tả
label_id	String	Mã đơn hàng của hệ thống OMS
partner_id	String	Mã đơn hàng thuộc hệ thống của đối tác
status	String	Mã trạng thái đơn hàng. Tham khảo [bảng mã trạng thái đơn hàng]
status_text	String	Trang thái đơn hàng.
created	String	Thời gian tạo đơn hàng, định dạng YY-MM-DD hh:mm:ss
modified	String	Thời gian sửa đổi đơn hàng, định dạng YY-MM-DD hh:mm:ss
message	String	Ghi chú đơn hàng
pickup_date	Date	Ngày hẹn lấy đơn hàng nếu có, nếu đơn hàng đã được lấy thành công thì là ngày lấy hàng
delivery_date	Date	Ngày hẹn giao đơn hàng nếu có, nếu đơn hàng đã được giao thành công thì là ngày giao hàng
customer_fullname	String	Họ tên người nhận hàng
customer_tel	String	Số điện thoại người nhận hàng
address	String	Địa chỉ người nhận hàng
storage_day	Integer	Số ngày giữ đơn hàng tại kho trước khi trả hàng
shipping_fee	Integer	Phí giao hàng
insurance	Integer	Phí khai giá
value	Integer	Giá trị đơn hàng để tính phí khai giá (VND)
weight	Integer	Cân nặng gói hàng (gram)
type	Integer	Đơn vị tính gram
cod_amount	Integer	Số tiền CoD
is_freeship	Boolean	Miễn phí ship hay không

Thành công

{
  "status": 200,
  "message": "",
  "timestamp": "2025-10-10T15:36:56.794Z",
  "data": {
    "label_id": "LBL001",
    "partner_id": "MGW_ORDER_1",
    "status": "ORDER_CREATED",
    "status_text": "Đơn hàng đã được tạo",
    "created": "2025-07-31T09:50:00.400Z",
    "modified": "2025-07-31T09:50:00.400Z",
    "message": "...",
    "pickup_date": "2025-07-31",
    "delivery_date": "2025-07-31",
    "customer_fullname": "Trần Thị B",
    "customer_tel": "0912345678",
    "address": "Trường Đại học Quốc gia Hà Nội,...",
    "storage_day": 0,
    "shipping_fee": 0,
    "insurance": 0,
    "value": 0,
    "weight": 0,
    "cod_amount": 0,
    "is_freeship": true
  }
}