> 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/english-1.0.6/tracking/order-tracking.md). # Order Tracking {% hint style="info" %} API Staging: [https://tracking-stg.247tech.vn](https://tracking-stg.247tech.vn/)\ API Production: {% endhint %} {% hint style="info" %} Statuses: * ACCEPTED: The order was created using API or Customer website 247Express. * PICKED\_UP:The order has been picked up by the delivery staff of 247Express. * IN\_TRANSIT: The order is being shipped by 247. * DELIVERING: Orders are being delivered. * DELIVERED: The order has been successfully delivered. * PENDING\_FOR\_PROCEED: The order has not been successfully delivered, pending. * PENDING\_FOR\_RETURN: The order is being returned to the customer. * RETURNED: The order has been returned to the customer. * LOST: The order has been lost. * CANCEL: The order has been cancelled. * CONFISCATED: The order was confiscated by the authorities for violating the category of goods. {% endhint %} ### TRACKING API KEY {% hint style="info" %} To get the apikey, following: * Login to the website: [https://247express.vn](https://247express.vn/) * Go to the function "CUSTOMER INFORMATION". {% endhint %} ### Error codes {% hint style="danger" %} MISSING\_APIKEY: Missing Apikey.\ MISSING\_ORDERCODE: Missing Ordercode.\ ORDERCODE\_MIN\_LENGTH: OrderCode less than 5 characters.\ ORDERCODE\_MAX\_LENGTH: The maximum number of OrderCode is 20 characters.\ ORDERCODE\_NOT\_FOUND: OrderCode is not found.\ ORDERCODE\_DOES\_NOT\_BELONG\_TO\_YOUR\_ACCOUNT: Ordercode does not belong to your account.\ APIKEY\_NOT\_FOUND: Apikey is not found.\ APIKEY\_LIMIT: Look up more than 200,000 times/day.\ EXCEPTION: Unknown error, please contact 247.\ ORDERCODE\_FORMAT\_EXCEPTION*:* The ordercode contain special characters (except \_-).\ ORDERCODE\_QUERY\_EXPIRED: The order has exceeded the tracking lookup period. {% endhint %} ### Workflow ![](/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 | Api key | | ordercode | string | Order code | {% 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 %} ### Response description | Properties | Description | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | errorMessage | Message when there is an error | | errorCode | Message code | | orderCode | Order code | | status | Order status ID | | statusName | Order status name | | delayCode | Delay code | | delayNote | Note the information when the delivery has not succeeded yet | | deliveryNotes | Delivery notes | | deliveryDate | Delivery date | | receiverName | Receiver name | | mailerTypeID | Type of Order: HH-Goods, TL-Document | | length | Size of Package - Length | | width | Size of Package - Width | | height | Size of Package - Height | | realWeight | Real Weight of Package | | calWeight | Convert weight to charge | | weight | Weight used to calculate freight | | quantity | Number of packages | | price | Main service price (ServiceType) | | priceFR | Forward & Return fee | | farRegionFeeAmount | Suburban Fee | | fuelFeeAmount | Fuel Fee | | vatAmount | V.A.T tax amount | | totalServiceCost | Total service cost | | priceInfo |

Service information used:
\[
{
"serviceName": Service name,
"serviceID": Service ID,
"cost": Service cost
},
...
]

| | statuses |

Status update history:
\[
{
"time": Time update status,
"status": Status ID,
"statusName": Status name,
"trackingName": Tracking name/status
},
...
]

| | trackings |

Track order history:
\[
{
"statusID": Tracking status ID,
"statusName": Tracking status name,
"postOfficeID": Post Office ID,
"postOfficeName": Post Office name,
"provinceID": Province ID of Post Office,
"provinceName": Province name of Post Office,
"dateChange": Update date,
"notes": Notes
},
...
]

| | estimateRoutes | Estimate Delivery Time | | confirmImage | Delivered pictures | | acceptDate | Date 247 Picked up | ### List of reasons for delay
Delay CodeDelayNote
1Wrong address.
2The recipient is not at the address, the recipient's house is closed.
3Addresses on envelopes and delivery slips are different. Mean when the dispatcher mistakenly pasted the delivery information slip on the package.
4Address not found.
5Wrong route delivered in logistics.
6The recipient changes another address.
7The recipient does not know this information. Mean recipient does not receive notification of delivery information.
8The recipient doesn't want to receive
9The recipient has no free time to receive.
10The recipient is requested to delivery at another time.
11Locked recipient's phone/subscriber, unable to contact the recipient.
12The recipient does not answer the phone, unable to contact the recipient.
13The recipient is not at home/at work.
14No recipient at delivery address.
15The recipient is notified to go to the post office to pick up the goods.
16The receiver requested to inspect the goods, but the package is of a type that is not allowed to check the goods.
19The recipient has no money.
21The recipient do not work on Saturdays.
22Recipients do not work holidays.
24Bad weather: Heavy rain/Flood/Storm/Flood/Natural disaster.
26The sender requested no delivery and return.
30The contents of the parcel were damaged during delivery.
31Part of the parcel is missing during delivery.
33Lost parcel during delivery.
35Incorrect recipient's phone number or incorrect phone number.
40Another reason.
41The order requires the recipient to present ID card to receive, but the ID card is not valid(ID card/ID card lost/damaged).
43When the sender requests to hand-deliver to the recipient, but when contacting again, the recipient requests to deliver to someone else.
46Wrong order information.
52Customer changes delivery address
53The customer requests to cancel the order
### Example ``` /api/Order/v1/Tracking?ordercode=12345&apikey=1111-1111-1111-1111-111111111 ```