Số container, AWB & UN/LOCODE API
Kiểm tra số container ISO 6346 và mã kích thước-loại, số kiểm tra vận đơn hàng không (AWB) và mã hãng, tra cứu, tìm kiếm cảng, sân bay theo UN/LOCODE.
Một endpoint cho các loại mã trên chứng từ vận tải. container kiểm tra số container ISO 6346 (CSQU3054383): mã chủ sở hữu, loại thiết bị (U container hàng, J thiết bị rời, Z rơ-moóc / khung xe), số sê-ri và chữ số kiểm tra, hoặc tính chữ số kiểm tra khi bạn nhập 10 ký tự. size_type giải mã mã kích thước và loại ISO 6346 (22G1, 45G1, 22R1): chiều dài, chiều cao và chiều rộng, nhóm loại và loại chi tiết.
awb kiểm tra số vận đơn hàng không (738-1234 5675): mã hãng 3 chữ số, số sê-ri và chữ số kiểm tra mod 7, kèm tên hãng với khoảng 50 hãng lớn (danh bạ đầy đủ của IATA là sản phẩm trả phí, nên mã chưa có được báo rõ). locode trả về mục UN/LOCODE (VNSGN, VNHPH, VNCLI): tên có dấu và không dấu, quốc gia, tỉnh, chức năng (cảng biển, đường sắt, đường bộ, sân bay, cảng cạn ICD, cửa khẩu…), trạng thái, mã IATA và toạ độ. q tìm theo tên không cần dấu; không có country thì tìm trong cảng, sân bay, cảng cạn và cửa khẩu của mọi quốc gia, có country thì tìm mọi địa điểm của nước đó. code tự nhận ra loại mã.
Dữ liệu UN/LOCODE: bản phát hành chính thức của UNECE / UN/CEFACT (CC BY 4.0, ghi nguồn trong mỗi kết quả), kiểm tra hằng tuần xem có bản mới. Không tra mã chủ container (sổ BIC là dữ liệu trả phí) và không cung cấp trạng thái hành trình.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
code | query|body | string | không | Mã bất kỳ, API tự nhận loại: số container, AWB, UN/LOCODE hoặc mã kích thước-loại. Cũng nhận trên đường dẫn: /v1/freight-codes/CSQU3054383. | |
container | query|body | string | không | Số container ISO 6346 (11 ký tự, hoặc 10 ký tự để tính chữ số kiểm tra). | |
size_type | query|body | string | không | Mã kích thước và loại ISO 6346, ví dụ 22G1, 45G1, 42R1. | |
awb | query|body | string | không | Số vận đơn hàng không, 11 chữ số (738-1234 5675). | |
locode | query|body | string | không | Mã UN/LOCODE, 5 ký tự (VNSGN). | |
q | query|body | string | không | Tìm UN/LOCODE theo tên (không cần dấu) hoặc mã IATA. | |
country | query|body | string | không | Kèm q: mã quốc gia ISO để tìm mọi địa điểm của một nước. | |
function | query|body | string | không | Kèm q: port, rail, road, airport, postal, icd, fixed, inland-port hoặc border. | |
limit | query|body | number | không | 20 | Kèm q: số kết quả trả về (1-100). |
Ví dụ
curl "https://apibox.io.vn/v1/freight-codes?locode=VNHPH" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/freight-codes?locode=VNHPH', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/freight-codes?locode=VNHPH",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/freight-codes?locode=VNHPH');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"locode": {
"code": "VNHPH",
"formatted": "VN HPH",
"name": "Haiphong",
"name_ascii": "Haiphong",
"country": "VN",
"country_name": "VIET NAM",
"subdivision": "HP",
"subdivision_name": "Hải Phòng",
"functions": [
"port",
"rail terminal",
"road terminal",
"airport"
],
"function_code": "1234----",
"status": "AI",
"status_name": "code adopted by international organisation (IATA or ECLAC)",
"iata": null,
"coordinates": {
"lat": 20.85,
"lng": 106.6833
},
"date": "2024-07"
},
"data_version": "UN/LOCODE 2025-1",
"source": "UN/LOCODE, UNECE / UN/CEFACT",
"licence": "CC BY 4.0",
"attribution": "UN/LOCODE © United Nations Economic Commission for Europe (UNECE), CC BY 4.0"
}
Ứng dụng
- Kiểm tra số container nhập trên tờ khai hải quan, booking, phiếu giao nhận
- Giải mã mã kích thước-loại container trên EDI, packing list
- Kiểm tra số vận đơn hàng không trước khi tra hành trình hoặc khai báo
- Tra cứu, gợi ý cảng và sân bay (UN/LOCODE) trong phần mềm logistics
Hỏi đáp
Chữ số kiểm tra container được tính thế nào?
Theo ISO 6346: chữ cái mang giá trị 10-38 (bỏ các bội số của 11), mỗi ký tự trong 10 ký tự đầu nhân với 2^vị trí, tổng chia 11 lấy dư (dư 10 tính là 0) là chữ số kiểm tra.
Dùng bản UN/LOCODE nào?
Bản phát hành chính thức mới nhất của UNECE (trường data_version, ví dụ 2025-1); dữ liệu được kiểm tra hằng tuần để cập nhật bản mới.
Có theo dõi được hành trình container hay chuyến bay không?
Không. API chỉ kiểm tra và giải mã các mã; theo dõi hành trình cần hệ thống của hãng tàu, hãng bay hoặc cảng.
API liên quan
Kiểm tra JSON
Kiểm tra cú pháp JSON, báo đúng dòng và cột bị lỗi, và validate dữ liệu theo JSON Schema (draft 4, 7, 2019-09 hoặc 2020-12).
{ }Định dạng JSON
Làm đẹp JSON với thụt lề 0-8 dấu cách hoặc tab, rút gọn (minify) hoặc sắp xếp key theo bảng chữ cái. Báo lỗi cú pháp kèm dòng và cột.
CSVCSV sang JSON
Chuyển CSV thành mảng object JSON theo dòng tiêu đề, tự nhận dấu phân cách, tự chuyển số và boolean, báo lỗi từng dòng.