New Zealand Post

New Zealand Post is the mainstream package/freight and delivery service for New Zealand. You can connect your NZ Post account to ShipStation so you can create NZ Post labels for your parcels.

See the attachments at the end of this article for a list of the countries and shipping codes available for NZ Post, as well as a list of NZ Post shipping services and codes.

New Zealand Post Integration Requirements

Connection Requirements:

  • An active account with New Zealand Post

  • New Zealand Post Account Number

  • New Zealand Post Site ID (Ask your NZ Post account manager if you don't have this information.)

  • New Zealand Post Username and Password for exclusive use with a ShipStation account

NZ Post requires a unique username not associated with any other Third-Party Shipping Platform.

When you signed up with New Zealand Post, you may also have signed up with eShip, New Zealand Post’s free shipping software. You cannot use the same username you have already with eShip or any other shipping platform with ShipStation.

You must create a second, brand-new username with New Zealand Post and have it linked to our client_id. Once you have done that, you can connect to our platform with those new credentials.

To create a new username specific to ShipStation, please email techsupport@nzpost.co.nz with this text:

Hello! May I please have a username configured for Parcel Label usage on the ShipStation client_id for my account number of [enter your account number here]. Thank you!

Please contact ShipStation support if NZ Post requests the ShipStation Client ID.

A unique number that serves as part of an API call that lets apps identify one another as being legitimate for sharing information. For example, ShipStaton may use a client_id with a carrier to retrieve and share shipping rates.

Connect a New Zealand Post Account to ShipStation

To connect your NZ Post account to ShipStation:

  1. Click the Add a Provider Account button.

    Carriers section with an arrow pointing to Add a Carrier Account button.
  2. Select the New Zealand Post tile and click Connect.

    NZ_Post-tile.png
  3. Enter your New Zealand Post Username and Password, and choose an Account Nickname for you to identify the carrier account in ShipStation.

  4. Click Connect.

Disable any New Zealand Post services you do not plan to use.

Once you have connected your account to ShipStation, New Zealand Post will send a list of ALL available services back to ShipStation, regardless of your contract availability.

Please disable any service that you do not plan to use. To enable or disable services in ShipStation, go to Settings > Shipping > Carriers and Fulfillment Settings > New Zealand Post. See our Edit Services and Package Types article for more details.

New Zealand Post Available Features

ShipStation's integration with NZ Post supports the following standard features:

Additional Features for New Zealand Post

ShipStation's integration with NZ Post allows for the following additional features:

Feature

Description

Manifesting is part of the label generation process

When you create a label, ShipStation sends the manifest along with label generation.

The carrier integration can be used to create domestic shipping labels.

The carrier integration can be used to create international shipping labels.

ShipStation will submit international customs information electronically to the carrier.

The carrier integration can be used to create domestic return labels.

ShipStation will display estimated shipping rates for the carrier based on the connected account information and shipment details.

Additional carrier insurance can be purchased through ShipStation.

Shipping labels created for this carrier will include a tracking number that can be used to view the shipment status on the carrier's tracking website. Tracking may not be available for all shipping services.

When tracking is available, ShipStation will automatically track the shipment status and update the tracking status on the Shipments tab. This feature allows for other advanced ShipStation features like delayed notifications and the Branded Tracking Page.

ShipStation can perform an End of Day process for the carrier and creates an End of Day PDF file that can be printed and provided to the carrier. The End of Day process can be mandatory or optional, based on the carrier and your account with them. The file may or may not be submitted electronically, see End of Day (Electronic).

ShipStation can print the store's logo on shipping labels created for this carrier. Label branding may not be available for all shipping services.

ShipStation can include information that will be displayed on the label as a label message. Label messages may not be available for all shipping services.

The carrier integration can be used to create multi-package shipments, where multiple individual packages are linked together into a single shipment record with a master tracking number.

You can connect this carrier integration to ShipStation multiple times using different account information, and choose which account will be used to create each shipment.

New Zealand Post Limitations

  • Voiding labels in ShipStation does not actually “void” with NZ Post. You will not be charged until the label is scanned.

Troubleshooting Tips for New Zealand Post

Here are some common issues, potential causes, and troubleshooting tips.

Issue

How to troubleshoot or resolve

New Zealand does not have state designations and instead uses greater City/Town areas to categorise. To successfully create a label for a Domestic Shipment, the Town + PostCode combination must match.

These resources may help you find successful Town + Post Code combinations:

Address & Layout Guide | New Zealand Post

Standards & Guides | New Zealand Post

Developer Portal | New Zealand Post

Error: This account is not set up to render the requested label type. Please contact support. (Generic). (400, 06d986a2-5a4e-47c3-8c30-0b62a1bbf797)

What it means: Your CourierPost username is not linked to ShipStation's Client ID.

What to do:

  • Email this text to New Zealand Post techsupport@nzpost.co.nz with your specific info:

    Hello! May I please have a username configured for Parcel Label usage on the ShipStation client_id for my account number of [enter your account number]? Thank you!

  • The NZ Post team should have ShipStation's client ID, but if they request it our support team can help you.

A unique number that serves as part of an API call that lets apps identify one another as being legitimate for sharing information. For example, ShipStaton may use a client_id with a carrier to retrieve and share shipping rates.

The carrier integration can be used to create domestic shipping labels.

The carrier integration can be used to create international shipping labels.

ShipStation will submit international customs information electronically to the carrier.

The carrier integration can be used to create domestic return labels.

ShipStation will display estimated shipping rates for the carrier based on the connected account information and shipment details.

Additional carrier insurance can be purchased through ShipStation.

Shipping labels created for this carrier will include a tracking number that can be used to view the shipment status on the carrier's tracking website. Tracking may not be available for all shipping services.

When tracking is available, ShipStation will automatically track the shipment status and update the tracking status on the Shipments tab. This feature allows for other advanced ShipStation features like delayed notifications and the Branded Tracking Page.

ShipStation can perform an End of Day process for the carrier and creates an End of Day PDF file that can be printed and provided to the carrier. The End of Day process can be mandatory or optional, based on the carrier and your account with them. The file may or may not be submitted electronically, see End of Day (Electronic).

ShipStation can print the store's logo on shipping labels created for this carrier. Label branding may not be available for all shipping services.

ShipStation can include information that will be displayed on the label as a label message. Label messages may not be available for all shipping services.

The carrier integration can be used to create multi-package shipments, where multiple individual packages are linked together into a single shipment record with a master tracking number.

You can connect this carrier integration to ShipStation multiple times using different account information, and choose which account will be used to create each shipment.