Order Tracking

Order tracking. The number of tracking should not exceed 3,000,000 times/day.

API Staging: https://tracking-dev.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://khachhang.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

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,
    "senderID": null,
    "senderName": 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
}

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

/api/Order/v1/Tracking?ordercode=12345&apikey=1111-1111-1111-1111-111111111