How to create a Carrier Account with New Zealand Post
In order to create a Carrier Account with New Zealand Post in the system, you will need to obtain an API key. You can obtain the API keys by requesting them from your account manager in NZ Post.
Your email should be as follows:
Hi NZ Post Team,
I need to set up my account <insert account code> with NZ Post so that I may consign with my new FMS partner MachShip. Can you please advise what my client ID and secret should be?
Once the API keys are provided, you can then create the carrier account and fill out the following specific options:
Account Number - The account number would have been provided to you when your account was set up.
Client ID and Client Secret - API keys provided by the carrier
Despatch Home Location - set this to be the major despatch location for your account. Please enter a suburb in this field and select from the typeahead/dropdown. For example:
Site Code and Pricing Account Code - these would have been provided to you when your account was set up.
Consignment Prefix - this can be any 3-letter prefix you desire
Reference Pools - Reference pools are utilised by MachShip to maintain a count on connotes, manifests and item numbers. The reference pool will ensure that each of those numbers is unique from what we have sent to the carrier previously. More information can be obtained on reference pools here. NZ Post requires the creation of just 1 reference pool for the Connote number.
To create the reference pool, select the Create Carrier Reference Pool button at the bottom of the page.
If you are creating a new account, then the Reference Pools will be set to the following fields:
Pool Name - Set as NZ Post Connote Ref Pool <Account Code>
Minimum Value - 1
Maximum Value - 999999 (that is six 9's)
Next Value - 1
Cyclical - No
It will appear as below:
Once created, it will appear in the drop-down as below:
Ratecard:
Unlike other carriers, MachShip hits the NZ Post' API in order to obtain pricing. As such, there is no need to upload your individual rate card; all you will need to do is upload the ratecard in the format below:
Notes:
- Set your Account Code in the Account(Ratecard) section/column.
- Add the services provided to you by the NZ Post Team
| Carrier | Ratecard | Service | From Zone | To Zone | Reciprocal | Cubic Conversion | Basic | Minimum | Break Type | Item Type | Break From | Break To | Price |
| NZ_POST | CPOLP | N | 250 | 0 | 0 | WEIGHT | 0 | 0 |
Once this is completed, you will be able to create quotes, consignments, and generate jobs with NZ Post.
Related Articles
How to create a Carrier Account with Post Haste New Zealand
In order to create a Carrier Account with Post Haste in the system, you will need to obtain an API key. You can obtain the API keys by requesting them from your account manager in Post Haste NZ or by contacting phg-systems@posthaste.co.nz. Your email ...How to create a Carrier Account with TGE New Zealand
When looking to set up a new account with TGE New Zealand you will need to contact their IT department and advise them that you are looking to despatch your account through MachShip. Their team can be contacted at bruce.toetuu@teamglobalexp.co.nz. ...How to create a Carrier Account with PBT New Zealand
In order to create a Carrier Account with PBT NZ in the system, you will need to obtain an API token. You can get the token by requesting it from your account manager in PBT. You can send them the following email: Hi PBT NZ Team, I need to set up my ...How to create a Carrier Account with Bascik New Zealand
When looking to set up a new account with Bascik you will need to contact their IT department and advise them that you are looking to despatch your account through MachShip. Their team can be contacted at support@bascik.co.nz. Please CC: ...How to create a Carrier Account with Australia Post
In order to create a Carrier Account with Australia Post, you will need to obtain an API key. This can be accessed by going to the link below and filling out the form. https://developers.auspost.com.au/apis/st-registration You will need to sign up ...