NZ Post offers a range of services across NZ Post, CourierPost and Pace.
The NZ Post integration includes the international services only, for Domestic you need to set up CourierPost.
N.B You can use your existing CourierPost API credentials for NZ Post, you do not need to generate new ones.
N.B An account number starting with a 9 can be used for Domestic and International.
An account number starting with a 5 can only be used for International.
To integrate NZ Post with StarShipIT, you need:
- NZ Post Account Number
- NZ Post an API key
- NZ Post API secret
The first two should have been given by NZ Post when you opened your Business Account. If you do not have a Business Account apply for one Here
Request API Key via NZ Post Developer Centre
Complete the registration form in the NZ Post Developer Centre page, click on the 'Register for Commercial Access" button:- https://www.nzpost.co.nz/business/developer-centre
Once completed you will receive a verification email. Proceed to verify the account, you will then receive an API key from NZ Post within 2 days.
1. Add your account details in StarShipIT
Go to Settings > Carrier > add new > NZ Post > Options tab
Tick Enable NZ post
Complete only your Account number
Tick "Print International Labels using API"
Go To the New API tab.
Complete the two first lines with your StarShipIT Password and StarShipIT Username
Complete the Client ID & secret fields with your API information
2. Test your Account
In the New API tabs you will find a Test button. Press this button and if it returns valid accounts you are good to go.
Note: You will find a Test account link on the option tab. This will not work.
3. Add new Product codes
- Go to Settings > Carrier > NZ Post Setting > Option Tab
- Select your new Product Code in the Dropdown menu
- Click Add
- The new product code is now added.
If the test returns invalid accounts
- Double check the credentials and check for incorrect spaces
- Contact Support@StarShipIT.com