Môi trường
Nhất Tín cung cấp hai môi trường riêng biệt cho việc tích hợp:
Sandbox: Sử dụng cho việc xây dựng tính năng, kiểm thử, gỡ lỗi, v.v...
Production: Sử dụng cho Người dùng cuối.
Thông tin tích hợp
Nhất Tín cung cấp bộ Mã tương ứng với từng môi trường.
username: Nhat Tin provide by email
password: Nhat Tin provide by email
Lưu ý không được tiết lộ những thông tin này cho bất kỳ ai.
Cấu hình
| Môi trường | Host |
|---|---|
| Sandbox | https://apisandbox.ntlogistics.vn (opens in a new tab) |
| Production | https://apiws.ntlogistics.vn (opens in a new tab) |
| Môi trường | Portal Web |
|---|---|
| Sandbox | https://bodev.ntlogistics.vn (opens in a new tab) |
| Production | https://khachhang.ntlogistics.vn (opens in a new tab) |
Master Data
1. Dịch vụ (service_id)
| ID | Tên dịch vụ (cũ) |
|---|---|
| 10 | Giao hàng nhanh |
| 11 | Hỏa tốc |
| 20 | Đường bộ |
| 21 | MES |
| ID | Tên dịch vụ (mới từ 01/07/2023) |
|---|---|
| 90 | Giao hàng nhanh (CPN) |
| 81 | Hỏa tốc |
| 91 | Tiết kiệm |
2. Hình thức thanh toán (payment_method)
| ID | Hình thức thanh toán |
|---|---|
| 10 | Người gửi thanh toán ngay |
| 11 | Người gửi thanh toán sau |
| 20 | Người nhận thanh toán ngay |
3. Loại hàng hóa (cargo_type_id)
| ID | Loại hàng hóa |
|---|---|
| 1 | Chứng từ |
| 2 | Hàng hóa |
| 3 | Hàng lạnh |
| 4 | Sinh phẩm |
| 5 | Mẫu bệnh phẩm |
3. Trạng thái đơn (status_id)
| Status ID | Status Code | Description |
|---|---|---|
| 1 | Waiting | Chưa thành công |
| 2 | Waiting | Chờ lấy hàng |
| 3 | KCB | Đã lấy hàng |
| 4 | FBC | Đã giao hàng |
| 6 | GBV | Huỷ |
| 7 | FUD | Không phát được |
| 9 | NRT | Đang chuyển hoàn |
| 10 | MRC | Đã chuyển hoàn |
| 11 | QIU | Sự cố giao hàng |
| 12 | DRF | Vận đơn nháp |
| 13 | DEL | Đang giao hàng |
| 15 | Đang vận chuyển | |
| 16 | Đang giao hàng hoàn | |
| 17 | Lỗi lấy hàng |
Qui trình trạng thái vận đơn
Lịch sử cập nhật
| Version | Author | Desc | Date update |
|---|---|---|---|
| 1.0.4 | KhoaNT | Change fulladdress from sender | 10/07/2021 |
| 1.0.5 | KhoaNT | Add calculate fee api | 23/07/2021 |
| 1.0.6 | KhoaNT | Add email receiver | 28/05/2022 |
| 1.0.7 | KhoaNT | Edit request webhook | 26/08/2022 |
| 1.0.7 | KhoaNT | Add connect to NTL | 26/08/2022 |
| 1.0.7 | KhoaNT | Add params create bill : is_return_doc | 26/08/2022 |
| 1.0.8 | KhoaNT | Add params partner_id in Print Waybill | 01/12/2022 |
| 1.0.9 | KhoaNT | Add new api for update shipping info | 02/12/2022 |
| 1.0.10 | KhoaNT | Add new params response when tracking : p_link_image | 24/02/2023 |
| 1.0.11 | KhoaNT | Add new shipping version 2 | 29/03/2023 |
| 1.0.12 | KhoaNT | Update new service list | 01/07/2023 |
| 1.0.13 | KhoaNT | Add new status (15,16) | 28/07/2023 |
| 1.0.14 | KhoaNT | Add new status (17) && Add length, width, height Fields into webhook request | 30/12/2023 |
Danh sách API
| API List | |
|---|---|
| 1. Create a Shipping v2 | 10/4/2023 sử dụng V2. |
| 2. Update Shipping | |
| 3. Cancel Shipping | |
| 4. Calculate Price | |
| 5. Tracking Shipping | |
| 6. Webhook | |
| 7. Print waybill | |
| 8. Login - connect to NTL | Use for ecommerce/POS platforms |
| 9. Create a Shipping By ID | Xóa api này, hổ trợ KH cũ |