Order Tracking
Order tracking. The number of tracking should not exceed 3,000,000 times/day.
API Staging: https://tracking-stg.247tech.xyz API Production: https://tracking.247express.vn
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.
TRACKING API KEY
To get the apikey, following:
Login to the website: https://247express.vn
Go to the function "CUSTOMER INFORMATION".
Error codes
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 _-).
Workflow
Tracking
GET
https://tracking.247express.vn /api/Order/v1/Tracking?ordercode=12345&apikey=1111-1111-1111-1111-111111111
The number of tracking should not exceed 3,000,000 times/day.
Query Parameters
Name | Type | Description |
---|---|---|
apiKey | string | Api key |
ordercode | string | Order code |
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 Code | DelayNote |
---|---|
1 | Wrong address. |
2 | The recipient is not at the address, the recipient's house is closed. |
3 | Addresses on envelopes and delivery slips are different. Mean when the dispatcher mistakenly pasted the delivery information slip on the package. |
4 | Address not found. |
5 | Wrong route delivered in logistics. |
6 | The recipient changes another address. |
7 | The recipient does not know this information. Mean recipient does not receive notification of delivery information. |
8 | The recipient doesn't want to receive |
9 | The recipient has no free time to receive. |
10 | The recipient is requested to delivery at another time. |
11 | Locked recipient's phone/subscriber, unable to contact the recipient. |
12 | The recipient does not answer the phone, unable to contact the recipient. |
13 | The recipient is not at home/at work. |
14 | No recipient at delivery address. |
15 | The recipient is notified to go to the post office to pick up the goods. |
16 | The receiver requested to inspect the goods, but the package is of a type that is not allowed to check the goods. |
19 | The recipient has no money. |
21 | The recipient do not work on Saturdays. |
22 | Recipients do not work holidays. |
24 | Bad weather: Heavy rain/Flood/Storm/Flood/Natural disaster. |
26 | The sender requested no delivery and return. |
30 | The contents of the parcel were damaged during delivery. |
31 | Part of the parcel is missing during delivery. |
33 | Lost parcel during delivery. |
35 | Incorrect recipient's phone number or incorrect phone number. |
40 | Another reason. |
41 | The order requires the recipient to present ID card to receive, but the ID card is not valid(ID card/ID card lost/damaged). |
43 | When the sender requests to hand-deliver to the recipient, but when contacting again, the recipient requests to deliver to someone else. |
46 | Wrong order information. |
52 | Customer changes delivery address |
53 | The customer requests to cancel the order |
Example
Last updated