Carrier - New Zealand Post Troubleshooting Tips

Overview

If you are receiving an error messages related to New Zealand Post shipments, the article provides the troubleshooting tips to help you resolve the issues.

Error messages

data.shipment.ship_to address is invalid

What does it mean

The error indicates that the recipient's address provided for the shipment is either invalid, incorrect, missing, or nonexistent.

How to solve

Generally, our response will include the suggestion address, such as data.shipment.ship_to.address is invalid, the correct address might be 133 MAIN STREET, METHVEN ... ... Please update your ship_to address and try again. You can use the suggested address and attempt to process the shipment again.
If you're uncertain about the validity of the address, use New Zealand Post's Address and Postal Code Finder service to verify its correctness.

Admin UI

If you are using AfterShip Shipping app to process shipments, you can correct the Recipient address of the order once you have verified the validity of the address after opting for one of the suggested resolution methods above in the AfterShip Shipping admin.

Go to Orders > Awaiting Shipment dashboard in the AfterShip Shipping admin.
Search or select an order that requires address correction from the list.
Upon selection of the order, an order detail side panel will open.

Navigate to the Recipient section where you will find receiver's available information synced from the eCommerce platform.
Click Edit to access the recipient contact information configuration window. You can modify the address there.



For the API users

If you are using AfterShip Shipping API to process shipments, you can correct the Recipient address of the order once you have verified the validity of the address opting for one of the suggested resolution methods above by first modifying the shipment.ship_to address information of the payload.

data.shipment.ship_to is too long, maximum length is 40

What does it mean

The error indicates that the combined length of the address fields for the recipient (street1 and street2) exceeds the allowed limit of 40 characters.

How to solve

To meet the required limit of 40 characters for the address information, try abbreviating street names or terms (e.g., "Street" to "St.").
Remove unnecessary details from the address that do not impact the delivery of the shipment.
If you're uncertain about the validity of the address, use New Zealand Post's Address and Postal Code Finder service to verify its correctness.

data.shipment.ship_from address is invalid

What it means

The error indicates that the shipper's address provided for the shipment is either invalid, incorrect, missing, or nonexistent.

How to solve

Generally, our response will include the suggestion address, such as data.shipment.ship_from.address is invalid, the correct address might be 133 MAIN STREET, METHVEN ... ... Please update your ship_from address and try again. You can use the suggested address and attempt to process the shipment again.
If you're uncertain about the validity of the address, use New Zealand Post's Address and Postal Code Finder service to verify its correctness.

Admin UI

If you are using AfterShip Shipping app to process shipments, you can correct the Shipper's address (Ship from Location) of the order once you have verified the validity of the address after opting for one of the suggested resolution methods above in the AfterShip Shipping admin.

Go to Settings in the AfterShip Shipping admin.
Select Ship from locations.
Here you can add new locations or modify the existing ones. Click Add location to add and save new locations.
Click the {...} icon to edit and save the existing locations.



Once the ship from location is modified, the same will reflect in the order under Ship from section.



For the API

If you are using AfterShip Shipping API to process shipments, you can correct the Shipper's address of the order once you have verified the validity of the address opting for one of the suggested resolution methods above by first modifying the shipment.ship_from address information of the payload.

Updated on: 10/10/2024