Xác thực

Mọi API trong mục Kết nối API yêu cầu xác thực qua header. Cookie ngôn ngữ là tùy chọn.

Header bắt buộc

Header	Mô tả
Authorization	Bearer <token> — token truy cập từ hệ thống xác thực AutoTMS
x-client-id	Mã client được cấp cho tích hợp (UUID)
Content-Type	application/json (với request có body)

Cookie tùy chọn

Cookie	Giá trị	Mô tả
NEXT_LOCALE	vi hoặc en	Chọn ngôn ngữ thông báo trả về (mặc định vi)

Ví dụ curl

curl --location 'https://api.autotms.vn/v1/tms/order-requests' \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <your-client-id>' \
  --header 'Authorization: Bearer <your-token>' \
  --header 'Cookie: NEXT_LOCALE=vi' \
  --data '[
    {
      "shown_code": "TEST-EXPORT-001",
      "type": "EXPORT_CARGO",
      "customer": { "code": "CHENG-LOONG", "name": "Cheng Loong" },
      "username": "your-username",
      "participants": [{ "username": "your-username", "role": "OWNER" }],
      "route": {
        "pickup_place": { "code": "LONG-SON", "name": "Long Sơn" },
        "warehouse": { "code": "LINH-XUAN", "name": "Linh Xuân" },
        "dropoff_place": { "code": "HAI-PHONG", "name": "Hải Phòng" }
      },
      "details": [{
        "container_pickup_date": "2027-07-01T00:00:00.000+07:00",
        "container_type": { "name": "Cont 40" },
        "gross_weight": 26.65
      }],
      "booking_number": "BK95001325"
    }
  ]'

Ví dụ đầy đủ với đơn xuất khẩu và nhập khẩu xem tại trang endpoint Nhận thông tin đơn nhập - xuất từ vận hành trong sidebar.