How to create a Carrier Account with Booths New Zealand

How to create a Carrier Account with Booths New Zealand

In order to create a Carrier Account with Booth's NZ in the system, you will need to obtain an API token. You can obtain the token by requesting them from your account manager in Booths. Their team can also be contacted at reuben.bidlake@booths.co.nz. Please cc integrations@machship.com in your email.

Your email should be as follows:

Hi  Team,

I need to set up my account <insert account code> with Booth's NZ so that I may consign with my new FMS partner MachShip. Can you please advise the account's API token? Can you please also advise what my consignment prefix should be?


Once the API token and prefix 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.

Token - API token provided by the carrier

Consignment Prefix - This will be the prefix received in the above email from the carrier.

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. Booths NZ 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 Booth's NZ Couriers 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:
Test:
Once the account has been set up and all of the rates have been added, you will need to run a test to ensure that upon go-live, everything will run successfully. To do this, create a consignment - please make Reference 1, Reference 2,  and the delivery special instructions THIS IS A TEST. Once this has been created, please manifest the consignment to the carrier. If you experience any issues, please contact support@machship.com.

If you receive a successful manifest message from MachShip then please send an email to reuben.bidlake@booths.co.nz and advise them that you are starting to despatch your Booth's NZ account through MachShip and that you would like to receive verification on the test file and permission to start to trade. 

Advise the carrier team of the consignment number and request that they should cancel this to ensure that you are not charged. Please cc integrations@machship.com on this email so we can help if required. 

On confirmation from the carrier team that the setup is validated, you are free to begin to consign.

    • Related Articles

    • 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 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 ...

    • 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 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 ...