How to set up NZ Post International

Supported features

NZ Post International's integration with Starshipit supports the following features:

Feature Supported
Ships From NZ & AU
Domestic Shipping Grey Cross.svg
International Shipping Blue tick.svg
Estimated Rates Blue tick.svg
Returns Blue tick.svg
Insurance/Warranty Grey Cross.svg
Dangerous Goods Grey Cross.svg
Alcohol Delivery Grey Cross.svg
Signature Required Grey Cross.svg
Authority to Leave Grey Cross.svg

Overview

  • Starshipit's integration with NZ Post allows you to use all of Starshipit's features including generation of packing slips and shipping labels, auto-correction of addresses, branded tracking and notifications and many more.
  • This article outlines setting up NZ Post International on your Starshipit account.

How it works

Starshipit is fully integrated with NZ Post services including their domestic, international and express offerings. These three services are represented as three different couriers in Starshipit:

  • NZ Post Domestic
  • NZ Post International
  • NZ Post Express

To use any of these couriers on Starshipit, you will need to request commercial access to the NZ Post API.

Setting up NZ Post

1. Request commercial access to use NZ Post with Starshipit

To use NZ Post with Starshipit, you must have commercial access to the NZ Post API.

  • If you already have commercial access:
    Please contact our support team. Our team will liaise with NZ Post on your behalf to request your respective API Key (Client ID) and API Secret (Client Secret).
  • If you don't have commercial access:
    Please follow the steps in this page to apply for commercial access for use with Starshipit. Once this is complete, you’ll still need to contact our support team so we can obtain API credentials on your behalf.

  Note

The process to request commercial access only needs to be completed once if you are setting up all three couriers in Starshipit and using the same account number for all three.

2. Enter your API details in Starshipit

Typically, this setup will be completed by the Starshipit team on your behalf. However, if you already have your API Key and API Secret and wish to complete the setup yourself, follow the steps below:

  1. Go to Settings > Couriers > Add New Courier > NZ Post International.
  2. Tick Enable NZ Post International.
  3. Enter your Account Number, Client ID, and Client Secret.
  4. Set your Default Export Type.
  5. Click Save.

3. Add your product codes

Once Starshipit has confirmed NZ Post International is available on your account, you should check that your preferred services are available in the courier settings.

  1. Go to Settings > Couriers > NZ Post International > Settings.
  2. Select your new Product Code in the Drop-down menu.
  3. Click Add.
  4. The new product code is now added.

Troubleshooting

Error: The test returns invalid accounts

Please carefully review the credentials you have entered and check for any possible errors or incorrect spaces. If you are still experiencing issues, please reach out to our support team for further assistance.

Other relevant information for you

To know more about NZ Post's eShip services, click here

For more information on NZ Post eShip and Starshipit, click here

Want to deliver great shipping experiences?

Start a 30-day free trial or book a demo with one of our shipping experts

Was this article helpful?
0 out of 2 found this helpful

We're sorry you didn't find this helpful - please help improve this article!

We're always looking for ways to get it right.Please help others by submitting your feedback here