Chuyển tới nội dung chính

Truy vấn đơn nhập - xuất từ vận hành

GET 
/v1/tms/order-requests/:shownCode

Trả về đơn nhập - xuất (chưa tiếp nhận) khi đơn chưa được tiếp nhận. Sau khi đã tiếp nhận, API trả đơn kế hoạch (PLAN) hoặc đơn thực tế (ACTUAL) theo query view; mặc định là ACTUAL.

Ba dạng dữ liệu dùng chung nhóm field top-level. Dữ liệu điều xe nằm trong trip (một object hoặc null) — không còn trips[].

  • OR (chưa tiếp nhận) / view=PLAN → trip: null
  • ACTUAL 0 trip → null; 1 trip → trip đó
  • ACTUAL ≥2 trips → Nhập lấy display_order=2, Xuất lấy display_order=1

Ý nghĩa địa điểm trên tuyến (route):

  • pickup_place: Nơi lấy container — xuất khẩu là depot lấy cont rỗng; nhập khẩu là cảng nhập.
  • warehouse: Kho đầu tiên (tương thích); khi có nhiều kho xem thêm warehouses[].
  • warehouses[]: Toàn bộ kho trên tuyến theo thứ tự (RoutesPickupPoints).
  • dropoff_place: Nơi hạ container — xuất khẩu là cảng hạ hàng; nhập khẩu là depot trả cont rỗng.

Response route trả code/name cho tuyến và các điểm — không trả address.

Khác biệt serialize:

  • Đơn nhập - xuất chưa tiếp nhận: bỏ qua (omit) các field rỗng/undefined — không luôn trả đủ key; mảng rỗng thường không xuất hiện.
  • Đơn kế hoạch / đơn thực tế: giữ key và gán null hoặc [] khi thiếu dữ liệu.

Response area và merchandise_types[] chỉ gồm code/name — không trả description (kể cả khi master có mô tả).

Request​

Responses​

HTTP 200: thành công (body status 200) hoặc lỗi xác thực trong body (status 401).