How to set up Mainfreight 2Home

Overview

Starshipit is now integrated with Mainfreight 2Home in New Zealand. With Mainfreight 2Home, you can deliver directly to your customer’s door. This service is the ideal solution for delivering medium to large items to homes or businesses. It’s perfect for:

• Retail businesses delivering to homes
• Online retailers shipping from their warehouse
• Distributors
• Individuals with one-off goods to move

Mainfreight 2Home is available as a domestic courier option when shipping from New Zealand.

Before you begin

To integrate Mainfreight 2Home with your Starshipit account, you’ll need a Mainfreight account. If you don’t have one, please get in touch with your Mainfreight account manager. To complete the setup, you will need the following information issued by Mainfreight:

• Your Mainfreight Account Code
• Your Housebill

Prefix Registration
The alpha prefix must be registered with Mainfreight in advance. If you did not receive it during your onboarding with Mainfreight, please get in touch with your Mainfreight account manager to obtain your registered prefix.

Housebill Format
The Housebill requires an alpha prefix followed by numeric characters.

• The alpha prefix must be between 2 to 4 characters.
• The numerical section must be at least 3 and no more than 12 characters.
• The total length of the Housebill, including the prefix, must not exceed 14 characters.

Here are some examples of Housebill formats:

Valid ✅

The numeric section following the prefix (e.g. ABC) must start and end with a one for a valid format.

• ABC101
  The alpha prefix is 3 characters, the numerical section is 3 characters and starts/ends with a one.
• AB1001
  The alpha prefix is 2 characters, the numerical section is 4 characters and starts/ends with a one.

Invalid ❌

The numeric section following the prefix (e.g. ABC) must not start with zero for a valid format.

• A2B389939
  The alpha prefix is only 1 character and an invalid alpha value follows the 2.
• 1272829BC
  The alpha prefix should be at the front of the Housebill.
• ABC000001
  The alpha prefix is 3 characters which is valid, however, the numerical section starts with zero, making this invalid.
• ABCD10000000001
  The alpha prefix is 4 characters, the numerical section is 11 characters and starts/ends with a one which is valid, however, the total length of the Housebill exceeds 14 characters, making this invalid.

Setting up your Mainfreight 2Home account in Starshipit

1. In Starshipit, navigate to Settings > Couriers > Add a new courier.
2. Set the shipping country as New Zealand.
3. Select Mainfreight in the list of couriers.
4. Tick the Enabled box.
5. Enter your Mainfreight Account Code and Housebill.
6. Click Save.

Add your product codes

Finally, add the product codes you’d like to use for Mainfreight:

1. In the same Mainfreight settings page from above, scroll down to the Add product codes section.
2. Select a product code (e.g. M2H) from the Add New Product Code list.
3. Click Add to save the product code.
   
4. To designate a product code as your default, tick the Default checkbox.

Other relevant information

You can learn more about Mainfreight2Home shipping services here.