🔑 New Zealand Post Track & Trace

The action is used to get the tracking information from New Zealand Post.

Inputs

Name	Type	Description
Tracking Number	String	NZ Post tracking number
Client ID	String	NZ Post Client ID
Client Secret	String	NZ Post Client Secret

Outputs

Name	Type	Description
Found Tracking?	Boolean	Whether the tracking information was found True / False
Status	String	Tracking status: Ready for Shipment, Delivered, In Transit, Problem with Delivery, Returning to Sender, Ready for Pickup
Status Description	String	Detailed description of the tracking status
Event Description	Sgring	Detailed description of the tracking event
Shipped Date	String	The date of the shipment. Format: YYYY-MM-DDThh:mm:ss
Last Event Date	String	The date of the last tracking event. Format: YYYY-MM-DDThh:mm:ss
Tracking Info	Object	All the tracking data returned from NZ Post
Tracking URL	String	NZ Post tracking URL
Activity History	List	List of all the tracking events. See the example below

📘
Tracking Status
NZ Post API returns a status code for each tracking event. DG maps this status code to one of the predefined statuses. E.g. 8 - Ready for Shipment.
DG scans all the tracking events to identify whether there is an event with status code that shows the parcel is returning back to the sender.

Statuses mapping

Ready for Shipment: [8, 13, 997, 1013, 5000]

Returning to Sender: [67, 578, 5350]

In Transit: [13, 32, 35, 55, 56, 57, 58, 59, 77, 78, 80, 85, 95, 142, 143, 144, 145, 146, 147, 148, 200, 202, 201, 203, 546, 552, 553, 554, 555, 559, 560, 561, 562, 571, 580, 584, 585, 586, 587, 588, 590, 591, 595, 1014, 1060, 1080, 1081, 1146, 5002, 5007, 5015, 5016, 5017, 5018, 5019, 5020, 5021, 5023, 5024, 5028, 5040, 5041, 5042, 5043, 5044, 5045, 5064, 5186, 5187, 5188, 5192, 5193, 5194, 5195, 5196, 5199, 5200, 5201, 5202, 5203, 5204, 5205, 5206, 5278, 5279, 5280, 5281, 5282, 5283, 5284, 5285, 5286, 5288, 5290, 5291, 5292, 5294, 5295, 5297, 5304, 5305, 5306, 5307, 5308, 5309, 5310, 5311, 5312, 5313, 5314, 5315, 5316, 5317, 5319, 5320, 5321, 5322, 5323, 5324, 5325, 5326, 5327, 5328, 5330, 5331, 5334, 5336, 5340, 5341, 5346, 5347, 5353, 5355, 5356, 5357, 5359, 5360, 5361, 5362, 5363, 5364, 5365, 5366, 5367]

Ready for Pickup: [141, 149, 5046, 5351, 5352]

Problem with Delivery: [42, 50, 51, 52, 53, 54, 60, 61, 62, 63, 542, 544, 547, 548, 549, 550, 556, 558, 564, 589, 596, 597, 1054, 9999, 5299, 5300, 5301, 5318, 5337, 5349, 5369, 5370]

Delivered: [22, 5022, 5207]