API seller xác nhận ready to ship

Đối tác gửi mã đơn hàng sang hệ thống của OMS thông qua APIs để đánh dấu Seller đã xác nhận sẵn sàng lấy hàng. Sau khi xác nhận thành công, hệ thống OMS sẽ xử lý đơn hàng và gửi lại thông tin trạng thái đơn hàng đã xử lý thông qua luồng webhook callback.

Đường dẫn

POST /api/v1/orders/ready-to-ship

Headers

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

CURL

curl --location '{{url}}/api/v1/orders/ready-to-ship' \
--header 'Authorization: Bearer {{token}}' \
--header 'X-Client-Source: mwg' \
--header 'Content-Type: application/json' \
--data '{
    "oms_order_id": 614727610891980800
}'

Các tham số

Tham số	Bắt buộc	Kiểu dữ liệu	Mô tả
oms_order_id	yes	Number	Mã đơn hàng thuộc hệ thống oms (Nhận được ở API tạo đơn)

Phản hồi

Kết quả trả về khi đăng đơn thành công:

{
  "status": 200,
  "message": "Xác nhận sẵn sàng lấy hàng thành công",
  "timestamp": "2025-10-10T15:36:56.794Z",
  "data": {
    "partner_id": "MGW_ORDER_1",
    "oms_order_id": 614727610891980800,
    "status": "READY_TO_BE_SHIPPED"
  }
}

Trường hợp có lỗi

{
  "status": 400,
  "message": "Đơn hàng đã được xác nhận",
  "error_code": 4010201,
  "timestamp": "2025-10-10T15:38:43.780Z"
}