ParcelTrack API

(0 reviews)

Edifact Codes

When using the ParcelTrack API to check on the status of your parcel, the API will return all tracking events and status information that have occurred with a specific parcel as it passes through NZ Post's parcel network. The API response contains a number of data fields and will include the field "event_edifect_code". This particular field is from our internal parcel network confirming the processing events that have occurred to the parcel. These events are presented with a status description and event description explaining what the status is at each stage.

We recommend that developers use the "event_edifect_code" for their integration solutions as our status and event description comments may change over time, but the status code will remain the same.

Beneath these code tables, we have some code samples showing responses from the API and what the responses would look like and the kinds of event edifact codes that occur and the relevant status for each stage.

Domestic Services Edifact Codes

EDIFACT CODE STATUS
8 Processing at depot
13 Picked up
14 Handed over for delivery
22 Delivered
32 With courier for delivery
35 With courier for delivery
42 Delivery attempted
50 Delivery attempted
51 Delivery attempted
52 Delivery attempted
53 Delivery attempted
54 Processing delay
55 Awaiting delivery
56 Item at depot
57 Item at depot
58 Waiting for courier
59 Item at depot
60 Pick up attempted
61 Misdirected
62 Delivery attempted
63 ParcelPod expired
67 Returned to sender
77 In transit to local depot
78 Courier to collect
80 Left New Zealand
85 In transit to depot
95 Redirected
141 Ready to collect
142 With RuralPost for delivery
143 Handed over
144 Handed over
145 Handed over
146 Handed over for delivery
147 In ParcelPod
148 Item on way to collection point
149 Ready to collect
200 Redirection requested
201 Redelivery requested
202 Redirection requested
203 Delivery instructions added
542 Sorted incorrectly
544 Problem with delivery
546 Awaiting delivery
547 Not suitable for ParcelPod
548 Attempted Pick Up
549 Attempted Pick Up
550 Attempted Pick Up
552 Processed for local delivery
553 Processed for local delivery
554 Handed over to depot
555 Handed over to a PostShop
556 Relabelled
558 Card to Call Transfer
559 Processing
560 Processing
561 Processing
562 Processing
564 Oversized
571 Processing
578 Returned
580 Processing
584 Sorted at parcel depot
585 NZ Customs Inspection
586 Released for delivery
587 Held for clearance
588 Released for delivery
589 MPI Inspection required
590 Released for delivery
591 International arrival
595 In transit to local depot
596 NZ Customs Import Entry required
597 MPI Import Entry required
997 Label created
1013 Picked up
1014 Handed over for delivery
1054 Delayed
1060 Pick up attempted
1080 Waiting to leave New Zealand
1081 Item held
1146 Handed over for delivery
9999 Event not available

International Services Edifact Codes

EdifactCode Status (External)
5000 Picked up/Collected
5002 Processed at outbound depot
5007 International departure
5015 International arrival
5016 Held for clearance
5017 At local/regional depot
5018 Handover for local delivery
5019 Held for clearance
5020 In transit to local depot
5021 Attempted delivery
5022 Delivery Complete
5022 Delivery Complete
5023 Released for delivery
5024 Handover to delivery agent
5028 International arrival
5040 Held for clearance
5041 Item held
5042 Arrival at sorting centre
5043 In transit to delivery depot
5044 Held at delivery depot
5045 With courier for delivery
5046 Ready for collection
5064 In transit with airline
5186 NZ Customs assessment
5187 NZ Biosecurity (MPI) assessment
5188 NZ Medsafe assessment
5192 Import duty & tax assessment
5193 Released for delivery
5194 Released for delivery
5195 Released for delivery
5196 Released for delivery
5199 Processed for export
5200 Processing
5201 Departure from New Zealand
5202 Arrival at parcel facility
5203 Arrival at delivery depot
5204 Held for clearance
5205 Departure from parcel facility
5206 Airline handling processing
5207 Delivery Complete
5278 In transit with airline
5279 In transit with airline
5280 In transit with airline
5281 In transit with airline
5282 In transit with airline
5283 In transit with airline
5284 In transit with airline
5285 In transit with airline
5286 In transit with airline
5288 In transit with airline
5290 In transit with airline
5291 In transit with airline
5292 In transit with airline
5294 In transit with airline
5295 In transit with airline
5297 In transit with airline
5299 Redelivery requested
5300 Redirection requested
5301 Redirection requested
5304 Pick up attempted
5305 Pick up attempted
5306 Pick up attempted
5307 Pick up attempted
5308 Pick up attempted
5309 Pick up attempted
5310 Pick up attempted
5311 Pick up attempted
5312 Attempted delivery
5313 Attempted delivery
5314 Attempted delivery
5315 Attempted delivery
5316 Attempted delivery
5317 Attempted delivery
5318 ParcelPod time expired
5319 Attempted delivery
5320 Attempted delivery
5321 Item on way to collection point
5322 With RuralPost for delivery
5323 With courier for delivery
5324 Handover to Delivery Agent
5325 Handover to Delivery Agent
5326 Handover to Delivery Agent
5327 Export inspection
5328 In ParcelPod
5330 Item held
5331 In transit
5334 Item at depot
5336 Item at depot
5337 Problem with delivery
5340 Item at depot
5341 Waiting for courier
5346 Item at depot
5347 Reprocessing
5349 Not suitable for ParcelPod
5350 Item returned to sender
5351 Item ready to collect
5352 Item ready to collect
5353 Reprocessing
5355 Item held at depot
5356 Item sent from depot
5357 Sorted at depot
5359 At local/regional depot
5360 At local/regional depot
5361 In Transit
5362 Transferred
5363 Processed for local delivery
5364 Processed for local delivery
5365 Handed over to depot
5366 Handed over to PostShop
5367 Relabelled
5369 Card to Call Transfer
5370 Import duty & tax payable

ParcelTrack API domestic parcel response example

{  
"success":true,
"results":{  
        "tracking_reference":"00393311680005810444",
        "message_id":"46384aa1-54ae-4097-9f59-b321a80e7c0e",
        "message_datetime":"2020-10-08T12:12:54",
        "service":"",
        "carrier":"",
        "tracking_events":[  
            {  
                "tracking_reference":"00393311680005810444",
                "event_edifact_code":"13",
                "source":"CME",
                "seqref":"2631897613",
                "status_description":"Acceptance",
                "event_description":"Your item was picked up by our courier based at Penrose.",
                "event_datetime":"2020-06-24T10:05:13",
                "signed_by":{  
                    "name":"",
                    "signature":""
                }
            },
            {  
                "tracking_reference":"00393311680005810444",
                "event_edifact_code":"580",
                "source":"CME",
                "seqref":"2632081694",
                "status_description":"Sort To",
                "event_description":"Item has been sorted to a location in the depot",
                "event_datetime":"2020-06-24T11:06:07",
                "signed_by":{  
                    "name":"",
                    "signature":""
                }
            },
            {  
                "tracking_reference":"00393311680005810444",
                "event_edifact_code":"32",
                "source":"CME",
                "seqref":"2632175995",
                "status_description":"Out for Delivery",
                "event_description":"Your item was processed for delivery.",
                "event_datetime":"2020-06-24T13:25:40",
                "signed_by":{  
                    "name":"",
                    "signature":""
                }
            },
            {  
                "tracking_reference":"00393311680005810444",
                "event_edifact_code":"22",
                "source":"CME",
                "seqref":"2632230597",
                "status_description":"Delivery",
                "event_description":"Your item was delivered by our courier based at Sunnynook -Auckland. Thank you for using CourierPost",
                "event_datetime":"2020-06-24T14:19:00",
                "signed_by":{  
                    "name":"TEST CUSTOMER",
                    "signature":"/zwxQS1EK0YpSChMJU4jMUQvRS1IKkonTCROIVAeUxtUGVYWWBNZEFsOWxBZElcVVRdUGlEeTyJNJUspSS1HMUU1RDhDO0E9QEBAQj9DQUFDPkU7RzhJNko3SDpGPEU/Q0JBRUBIPks8TjtSOVQ3VzZZNls1XTVfNV43YDdjNmgzajNsMm8xcTBzMHYveC94MXczdjV5Nns2fTaANoI4hDiGN4g2ijWMNI8zkjKWMJouniyjKqgorSayJLciuyDAH8Qexx3KHcwdyx/IIcUiwCS7JrUoryqoLKAumDCRMok0gTV6N3I3bDhmOGE4XTdZN1c2VTRWMlgyWzFeMWEyZTNpNWw3cDl0PHc+ekF9RH9GgkmDS4ROhVCHUohUiVM="
                }
            }
        ]
    }
}

ParcelTrack API international parcel response example

   {
    "success": true,
    "results": {
        "message_id": "12f74be0-3e4e-11eb-b8f4-02f11aec075c",
        "tracking_reference": "LP519388311NZ",
        "message_datetime": "2020-12-14T20:51:01Z",
        "service": "",
        "carrier": "",
        "tracking_events": [
            {
                "tracking_reference": "LP519388311NZ",
                "source": "IPS",
                "status_description": "Labelled",
                "status_description2": "Label created",
                "depot_name": "(Location Not Available)",
                "event_description": "",
                "event_datetime": "2020-08-17T09:22:29",
                "signed_by": {
                    "name": "",
                    "signature": ""
                },
                "event_edifact_code": "5303"
            },
            {
                "tracking_reference": "LP519388311NZ",
                "source": "IPS",
                "status_description": "Receive item from customer ",
                "status_description2": "Picked up/Collected",
                "depot_name": "East Tamaki (East Tamaki Depot)",
                "event_description": "Your item has been collected and is in transit to the outbound mail centre",
                "event_datetime": "2020-08-17T14:56:22",
                "signed_by": {
                    "name": "",
                    "signature": ""
                },
                "event_edifact_code": "5000"
            },
            {
                "tracking_reference": "LP519388311NZ",
                "source": "IPS",
                "status_description": "Receive item at office of exchange",
                "status_description2": "Processed at outbound depot",
                "depot_name": "AUCKLAND",
                "event_description": "Your item has arrived at the outbound mail centre and is being prepared for sending overseas",
                "event_datetime": "2020-08-19T08:13:08",
                "signed_by": {
                    "name": "",
                    "signature": ""
                },
                "event_edifact_code": "5002"
            },
            {
                "tracking_reference": "LP519388311NZ",
                "source": "IPS",
                "status_description": "Insert item into bag",
                "status_description2": "International departure",
                "depot_name": "AUCKLAND",
                "event_description": "Your item has been processed and cleared for transit to its country of destination",
                "event_datetime": "2020-08-20T03:44:07",
                "signed_by": {
                    "name": "",
                    "signature": ""
                },
                "event_edifact_code": "5007"
            },
            {
                "tracking_reference": "LP519388311NZ",
                "source": "IPS",
                "status_description": "Carrier Uplift",
                "status_description2": "In transit with airline",
                "event_description": "Your item is being transported by the airline to its overseas destination",
                "event_datetime": "2020-08-20T23:15:00",
                "signed_by": {
                    "name": "",
                    "signature": ""
                },
                "event_edifact_code": "5285"
            },
            {
                "tracking_reference": "LP519388311NZ",
                "source": "IPS",
                "status_description": "Carrier Delivered",
                "status_description2": "In transit with airline",
                "event_description": "Your item is being transported by the airline to its overseas destination",
                "event_datetime": "2020-08-21T07:20:00",
                "signed_by": {
                    "name": "",
                    "signature": ""
                },
                "event_edifact_code": "5283"
            },
            {
                "tracking_reference": "LP519388311NZ",
                "source": "IPS",
                "status_description": "Receive item at office of exchange",
                "status_description2": "International arrival",
                "depot_name": "KAWASAKI",
                "event_description": "Your item has arrived at its country of destination",
                "event_datetime": "2020-08-22T17:15:00",
                "signed_by": {
                    "name": "",
                    "signature": ""
                },
                "event_edifact_code": "5015"
            },
            {
                "tracking_reference": "LP519388311NZ",
                "source": "IPS",
                "status_description": "Send item to customs",
                "status_description2": "With border agency",
                "depot_name": "KAWASAKI",
                "event_description": "Your parcel is with overseas border agencies for processing.",
                "event_datetime": "2020-08-23T08:59:00",
                "signed_by": {
                    "name": "",
                    "signature": ""
                },
                "event_edifact_code": "5016"
            },
            {
                "tracking_reference": "LP519388311NZ",
                "source": "IPS",
                "status_description": "Record item customs information",
                "status_description2": "Held for clearance",
                "depot_name": "KAWASAKI",
                "event_description": "Your item is currently being held for clearance",
                "event_datetime": "2020-08-23T09:00:00",
                "signed_by": {
                    "name": "",
                    "signature": ""
                },
                "event_edifact_code": "5019"
            },
            {
                "tracking_reference": "LP519388311NZ",
                "source": "IPS",
                "status_description": "Return item from customs",
                "status_description2": "Released for delivery",
                "depot_name": "NARITA AP A",
                "event_description": "Your item has been released for delivery",
                "event_datetime": "2020-08-24T00:59:00",
                "signed_by": {
                    "name": "",
                    "signature": ""
                },
                "event_edifact_code": "5023"
            },
            {
                "tracking_reference": "LP519388311NZ",
                "source": "IPS",
                "status_description": "Send item to domestic location",
                "status_description2": "In transit to local depot",
                "depot_name": "KAWASAKI",
                "event_description": "Your item has left the inbound mail centre and is on its way to a local/regional delivery depot",
                "event_datetime": "2020-08-24T01:00:00",
                "signed_by": {
                    "name": "",
                    "signature": ""
                },
                "event_edifact_code": "5020"
            },
            {
                "tracking_reference": "LP519388311NZ",
                "source": "IPS",
                "status_description": "Receive item at delivery office",
                "status_description2": "At local/regional depot",
                "event_description": "Your item has arrived at a depot for sorting",
                "event_datetime": "2020-08-25T13:30:00",
                "signed_by": {
                    "name": "",
                    "signature": ""
                },
                "event_edifact_code": "5017"
            },
            {
                "tracking_reference": "LP519388311NZ",
                "source": "IPS",
                "status_description": "Send item out for physical delivery",
                "status_description2": "With courier for delivery",
                "event_description": "Your item is with a courier for delivery",
                "event_datetime": "2020-08-26T07:38:00",
                "signed_by": {
                    "name": "",
                    "signature": ""
                },
                "event_edifact_code": "5045"
            },
            {
                "tracking_reference": "LP519388311NZ",
                "source": "IPS",
                "status_description": "Deliver item",
                "status_description2": "Delivery Complete",
                "event_description": "Your item has been delivered",
                "event_datetime": "2020-08-26T15:08:00",
                "signed_by": {
                    "name": "",
                    "signature": ""
                },
                "event_edifact_code": "5022"
            }
        ]
    }
}

Reviews