> For the complete documentation index, see [llms.txt](https://apidoc.247express.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.247express.vn/tracking/tracking-don-hang.md). # Tracking đơn hàng ### TRẠNG THÁI ĐƠN {% hint style="info" %} API Staging: [https://tracking-stg.247tech.vn](https://tracking-stg.247tech.vn/)\ API Pro : {% endhint %} {% hint style="info" %} Các trạng thái đơn hàng: * DATIEPNHAN: Đơn hàng vừa tạo qua API hoặc web khách hàng.. * DALAYHANG: Đơn hàng đã được nhân viên giao nhận của 247Express tới lấy hàng. * DANGVANCHUYEN: Đơn hàng đang được vận chuyển bởi 247. * DANGDIPHAT: Đơn hàng đang phát. * PHATTHANHCONG: Đơn hàng đã được phát thành công. * CHOXULY: Đơn hàng phát chưa thành công, đang chờ xử lý. * CHOCHUYENHOAN: Đơn hàng đang được chuyển hoàn lại cho khách hàng. * DACHUYENHOAN: Đơn hàng đã được chuyển hoàn lại cho khách hàng. * THATLAC: Đơn hàng bị thất lạc. * HUY: Đơn hàng đã bị hủy. * TICHTHU: Đơn hàng đã bị tịch thu bởi cơ quan chức năng do vi phạm về loại hàng hóa... {% endhint %} ### TRACKING API KEY {% hint style="info" %} Để lấy apikey, thực hiện các bước như sau: * Đăng nhập website: [https://247express.vn](https://247express.vn/) * Vào chức năng "THÔNG TIN KHÁCH HÀNG" {% endhint %} ### THÔNG TIN MÃ LỖI {% hint style="danger" %} MISSING\_APIKEY: Chưa truyền APIKey\ MISSING\_ORDERCODE: Chưa truyền số vận đơn \ ORDERCODE\_MIN\_LENGTH: Số vận đơn nhỏ hơn 5 ký tự\ ORDERCODE\_MAX\_LENGTH: Số vận đơn tối đa là 20 ký tự \ ORDERCODE\_NOT\_FOUND: Số vận đơn không tìm thấy ORDERCODE\_DOES\_NOT\_BELONG\_TO\_YOUR\_ACCOUNT: số vận đơn thuộc tài khoản khác APIKEY\_NOT\_FOUND: Apikey không tìm thấy \ APIKEY\_LIMIT: Tra cứu vượt quá 200.000 lần/ngày \ EXCEPTION: Lỗi không xác định, vui lòng liên hệ 247\ ORDERCODE\_FORMAT\_EXCEPTION*:* Số vận đơn chứa ký tự đặc biệt (ngoại trừ\_-)\ ORDERCODE\_QUERY\_EXPIRED: Đơn hàng đã quá hạn tra cứu thông tin {% endhint %} ### LUỒNG TRẠNG THÁI ![](/files/-MexUviLpxvQZ7RMxPi2) ## Tracking `GET` `https://tracking.247express.vn/api/Order/v1/Tracking?ordercode=12345&apikey=1111-1111-1111-1111-111111111` #### Query Parameters | Name | Type | Description | | --------- | ------ | -------------------------------- | | apiKey | string | Liên hệ với 247 để được cung cấp | | ordercode | string | Mã vận đơn | {% tabs %} {% tab title="200 " %} ``` { "errorMessage": null, "errorCode": null, "orderCode": "CNN2200057", "externalCode": null, "acceptDate": "2022-10-10T00:00:00+07:00", "status": "25", "statusName": "DANGDIPHAT", "trackingName": "Đang đi phát", "delayCode": null, "delayNote": null, "deliveryNotes": null, "deliveryDate": null, "poDeliveryID": null, "mailMan": null, "receiverName": null, "serviceTypeID": "DE", "mailerTypeID": "TL", "extraServiceName": null, "length": 0, "width": 0, "height": 0, "realWeight": 0.3, "calWeight": 0, "weight": 0.3, "quantity": 1, "price": 32000.0000, "priceFR": 0.0000, "farRegionFeeAmount": 6400.0000, "fuelFeeAmount": 9216.0000, "vatAmount": 3809.0000, "totalServiceCost": 51425.0000, "edtFrom": null, "edtTo": null, "postOfficeAcceptID": null, "codAmount": 0.000, "priceInfo": [ { "serviceName": "Chuyển phát nhanh", "serviceID": "DE", "cost": 32000.0000 }, { "serviceName": "Phí ngoại thành", "serviceID": "VSVX", "cost": 6400.0000 }, { "serviceName": "Phí xăng dầu", "serviceID": "Fuel", "cost": 9216.0000 }, { "serviceName": "Phí VAT", "serviceID": "VAT", "cost": 3809.0000 } ], "statuses": [ { "time": "2022-10-10T15:36:56.92+07:00", "status": "23", "statusName": "DALAYHANG", "trackingName": "Đã lấy hàng", "provinceName": "HỒ CHÍ MINH", "postOfficeName": "Phòng Công nghệ" }, { "time": "2022-10-10T15:37:10.323+07:00", "status": "24", "statusName": "DANGVANCHUYEN", "trackingName": "Đang vận chuyển", "provinceName": "HỒ CHÍ MINH", "postOfficeName": "Phòng Công nghệ" }, { "time": "2022-10-10T15:38:50.407+07:00", "status": "25", "statusName": "DANGDIPHAT", "trackingName": "Đang đi phát", "provinceName": "HỒ CHÍ MINH", "postOfficeName": "Phòng Công nghệ" } ], "trackings": [ { "statusID": "0", "postOfficeID": "CNN", "provinceID": "HCM", "provinceName": "HỒ CHÍ MINH", "dateChange": "2022-10-10T15:36:56.92+07:00", "postOfficeName": "Phòng Công nghệ", "statusName": "Nhập hệ thống", "notes": null }, { "statusID": "2", "postOfficeID": "CNN", "provinceID": "HCM", "provinceName": "HỒ CHÍ MINH", "dateChange": "2022-10-10T15:36:56.92+07:00", "postOfficeName": "Phòng Công nghệ", "statusName": "Đóng gói", "notes": null }, { "statusID": "3", "postOfficeID": "CNN", "provinceID": "HCM", "provinceName": "HỒ CHÍ MINH", "dateChange": "2022-10-10T15:37:10.323+07:00", "postOfficeName": "Phòng Công nghệ", "statusName": "Đang chuyển tiếp", "notes": null }, { "statusID": "4", "postOfficeID": "CNN", "provinceID": "HCM", "provinceName": "HỒ CHÍ MINH", "dateChange": "2022-10-10T15:38:50.4+07:00", "postOfficeName": "Phòng Công nghệ", "statusName": "Đến bưu cục", "notes": "" }, { "statusID": "10", "postOfficeID": "CNN", "provinceID": "HCM", "provinceName": "HỒ CHÍ MINH", "dateChange": "2022-10-10T15:38:50.407+07:00", "postOfficeName": "Phòng Công nghệ", "statusName": "Giao bưu tá phát", "notes": "" }, { "statusID": "5", "postOfficeID": "CNN", "provinceID": "HCM", "provinceName": "HỒ CHÍ MINH", "dateChange": "2022-10-10T15:38:50.41+07:00", "postOfficeName": "Phòng Công nghệ", "statusName": "Đi phát", "notes": "" } ], "estimateRoutes": null, "confirmImage": null } ``` {% endtab %} {% endtabs %} ### **Mô tả kết quả trả về** | Properties | Description | | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | errorMessage | Thông báo khi có lỗi | | errorCode | Mã lỗi | | orderCode | Mã đơn hàng | | status | Mã trạng thái đơn hàng | | statusName | Tên trạng thái đơn hàng | | delayCode | Mã lý do phát chưa thành công | | delayNote | Diễn giải khi phát chưa thành công | | deliveryNotes | Ghi chú giao hàng | | deliveryDate | Ngày phát | | receiverName | Tên người nhận | | mailerTypeID | Loại hình đơn hàng: HH - Hàng hóa; TL - Tài liệu | | length | Chiều dài | | width | Chiều rộng | | height | Chiều cao | | realWeight | Trọng lượng thực tế | | calWeight | Trọng lượng quy đổi dựa theo kích thước để tính giá | | weight | Trọng lượng tính cước | | quantity | Số lượng kiện | | price | Cước dịch vụ chính | | priceFR | Cước chuyển hoàn - chuyển tiếp | | farRegionFeeAmount | Phí ngoại thành | | fuelFeeAmount | Phí nhiên liệu | | vatAmount | VAT | | totalServiceCost | Tổng tiền phí các dịch vụ | | priceInfo |

Thông tin dịch vụ sử dụng:
\[
{
"serviceName": Tên dịch vụ,
"serviceID": Mã dịch vụ,
"cost": Giá tiền
},
...
]

| | statuses |

Lịch sử cập nhật trạng thái:
\[
{
"time": Thời gian cập nhật,
"status": Mã trạng thái,
"statusName": Tên trạng thái,
"trackingName": Tên tracking/trạng thái
},
...
]

| | trackings |

Lịch sử đơn hàng:
\[
{
"statusID": Mã trạng thái,
"statusName": Tên trạng thái,
"postOfficeID": Mã bưu cục,
"postOfficeName": Tên bưu cục,
"provinceID": Mã tỉnh thành của bưu cục,
"provinceName": Tên tỉnh thành của bưu cục,
"dateChange": Ngày cập nhật,
"notes": Ghi chú
},
...
]

| | estimateRoutes | Thời gian phát dự kiến | | confirmImage | Thông tin hình ảnh xác nhận | | acceptDate | Ngày 247 lấy thư/hàng | ### Bảng lý do phát chưa thành công
Delay CodeDelayNote
01Địa chỉ sai
02Địa chỉ đóng cửa
03Địa chỉ trên phong bì và phiếu gửi khác nhau
04Không tìm thấy địa chỉ
05Lạc tuyến
06Người nhận chuyển địa chỉ
07Người nhận báo không biết về thông tin này
08Người nhận không muốn nhận nữa
09Người nhận báo bận nên không nhận được
10Người nhận yêu cầu nhận vào thời gian khác
11Điện thoại người nhận khóa máy/thuê bao
12Người nhận không nghe điện thoại
13Người nhận vắng nhà/không có mặt ở cơ quan
14Không tồn tại người nhận tại địa chỉ phát
15Chờ người nhận đến văn phòng nhận
16Người nhận yêu cầu kiểm tra nội dung hàng
20Người nhận hẹn phát lại quá thời gian quy định
21Người nhận nghỉ thứ 7
22Người nhận nghỉ lễ
24Mưa lớn/Ngập nước/Bão lũ/Thiên tai
26Người gửi yêu cầu không phát và chuyển hoàn
30Hư hỏng nội dung bên trong bưu gửi
31Mất một phần bưu gửi
33Mất bưu gửi
35Số điện thoại người nhận bị sai số/nhầm số
40Lý do khác
41CMND/Thẻ căn cước bị mất/hỏng
43Người nhận yêu cầu giao cho người khác
46Sai thông tin đơn hàng
52Người gửi thay đổi địa chỉ phát
53Người gửi yêu cầu tiêu hủy
### Mẫu ví dụ ``` /api/Order/v1/Tracking?ordercode=12345&apikey=1111-1111-1111-1111-111111111 ```