New Zealand Post Shipping for WooCommerce

$79.00 / year

Offer shipping rates from the NZ Post API

Connect New Zealand Post Account to WooCommerce and Automatically Ship Orders

New Zealand Post offers you premium shipping services and our NZ Post shipping plugin for WooCommerce allows you to receive shipping rates automatically. Your WooCommerce store must have NZ Dollars as standard currency and a base state in New Zealand. Typically it uses mm and kg units. Its global availability enables the calculation of prices for domestic and international parcels.

 

PLEASE NOTE: This plugin is the product of OPMC and is not associated with New Zealand Post. New Zealand Post is not able to assist with any support or inquiries on this product.  Any customer service requests must be directed only to OPMC.

 

NEW PROCESS: Customer only needs to provide a valid NZ Post Account Number (TPID) for assistance. If customer doesn’t have an NZ Post Account number, please call the NZ POST National Call Center for assistance with query on – 0800 501 501
or email NZ Post Sales leads – leads@nzpost.co.nz

The New Zealand Post Group offers services to help New Zealand run, connecting people, businesses and communities. This plugin lets you offer New Zealand Post rates to your customers which are pulled directly from their API.

When a customer enters their shipping information, the cost of the order’s shipping is calculated using the weight and dimensions of the product(s). This returns the correct shipping rate for the customer.Save time manually calculating shipping costs and avoid unexpected shipping costs.

The extension requires that your store uses NZ Dollars currency and New Zealand as the base country. It primarily works with mm and kg, but other units can be converted automatically.Setting up box sizes

 

Calculate domestics and international shipping rates for NZ packages.

NZ Post can calculate rates worldwide, or domestic:

DOMESTIC INTERNATIONAL
  • ParcelPost
  • ParcelPost Fast
  • ParcelPost Tracked
  • Courier
  • International Express Courier
  • International Economy Courier
  • International Air
  • International Economy

Add handling fees or offer shipping discounts

Easily adjust the pricing of your shipping rates from the plugin’s settings. Increase the costs for each service by a dollar or percentage amount.

 

Specify custom box sizes

Specify the size, maximum weight and dimensions of the boxes you use to ship products. Items will automatically be added to these boxes depending on their dimensions or weight.

Create and Print Labels and Track Parcels with NZ Post Shipping APIs 

NZ Post Shipping APIs integration can do the following operations based on your subscription type:

Multiple Shipping Options on Checkout Page

Multiple shipping options for customers based on location, area and volume.

Nearby Collection Points

Gives customers options for nearby collection points.

Tracking Made Easy for Customers

Customers can track orders from within their WooCommerce Account and checkout screen

Shipping Details on Order detail pages for Merchants

Merchants can print labels and track orders from within order detail pages.

At Woocommerce.opmc.com.au, we want to ensure that you are 100% happy with your purchase.

  • If you have technical or sales queries, do not hesitate get in touch with us
  • If after you attempted to resolve issues with Support staff and feel the product(s) you purchased does/do not the best fit your requirements, we want to make things right.

Our policy offers a full refund within 30 days of your date of purchase. We’d love to know what went wrong and how we can improve, so please include details about the reason for your refund request if you reach out to us directly.

Woocommerce.opmc.com.au and our payment process submit the refund immediately and make every attempt to process the refund as quickly as possible. Your financial institution can take up to 20 days for the refund to reflect in your bank account/card.

PLEASE NOTE: This plugin is the product of OPMC and is not associated with New Zealand Post. New Zealand Post is not able to assist with any support or inquiries on this product.  Any customer service requests must be directed only to OPMC.

New Zealand Post is a premium shipping method which let you get shipping rates from the New Zealand Post API. It requires that your store uses NZ Dollars for it’s currency and a base country of New Zealand. The extension primarily works with mm and kgs, but other units can be converted automatically.

This extension can calculate quotes worldwide as it handles both domestic and international parcels.

The API, and the built in box-packer, require that your non-virtual products have weights and dimensions set. 
 

Installation

  1. Upload the plugin folder to the ‘/wp-content/plugins/’ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Thats it – you can now configure the plugin.

API & Debug 

Go to: WooCommerce > Settings > Shipping > New Zealand Post. Select API Type from NZ Post API Type drop-down. We recommend using Shipping Option V2 API because it is the latest version of New Zealand Post API. Here is the process of integrating all of the following APIs:

RateFinder API

Recommended: We recommend using new ShippingOptions V2 API. Please contact NZ Post to obtain an account for ShippingOptions V2 API.

  1. API Key - NZ Post will provide you with an API key after you signup for their API services. Enter this here - it is required.
  2. Debug Mode - Tick the checkbox to log API requests and responses for the cart and checkout pages. Useful for troubleshooting.
  3. Domestic shipping surcharge - Add surcharge amount per order if any.
  4. International shipping surcharge - Add surcharge amount per order if any.
  5. Click Save changes to store settings
PLEASE NOTE:  When you need the advice of  NZ Post on any NZ Post account-related issue, Please specify to NZ Post that you are using Plugin for WooCommerce for their understanding. This would help them understand to resolve your issue quickly.


Shipping Option API


Recommended: We recommend using new ShippingOptions V2 API. Please contact NZ Post to obtain an account for ShippingOptions V2 API.

This Shipping option is for existing customers of NZ Post with active API Access:
  1. Signin to your account Developer Resource Center here 
  2. Click Public portal and you’ll be redirected to another page.
  3. Navigate to Shipping Options API or search for ShippingOptions API in the search bar and click on it
  4. On the top right corner, click on Request access button.
  5. Select Production version from API instance and Standard in SLA tier.
  6. Read and accept Terms and Conditions.
  7. Now go to the Application drop-down field and follow these steps.

Creating New Application

  1. In Application field, click create a new application. 
  2. Enter any name for your application.
  3. Select the following:
    •  Resource Owner Grant
    •  Client Credentials Grant 
    • Refresh Token and Automatically register the URIs for API Notebook and API Console
  4. And click create.
  5. You'll come back to the previous popup and now click Request Access.
  6. You’ll get a notification message in your email and also in the application tab here from NZ Post.
  7. Click the name of your Application. 
  8. Now, you can see Client ID and Client Secret in this tab.

Adding credentials to Shipping Option API 


Client ID - Copy and paste Client ID from the application you have created. 
Client Secret - Available in application also copy and paste from there. 
Username -  Enter username or email address of your NZ Post account 
NZ Post Account Number and Site code -  Enter your NZ Post account number or (TPID) and NZ Post Site Code provided by New Zealand Post. If you doesn’t have it, please call the NZ POST National Call Center for assistance with query on – 0800 501 501 or email NZ Post Sales leads – leads@nzpost.co.nz 
 Enable auto-generate Shipping Options Label - Enable to generate shipping labels on checkout
Enable Sandbox Mode - Enable Sandbox for API testing
Debug Mode - Enabling this will show you debugging information on your cart and checkout pages.
Domestic shipping surcharge - Add surcharge amount per order if any.
International shipping surcharge - Add surcharge amount per order if any
Save Changes - Click Save changes to store settings. Always store settings after making any change.   



Shipping Option V2 API 


NZ Post Account Number and Site code -  Enter your NZ Post account number or (TPID) and NZ Post Site Code provided by New Zealand Post. If you doesn’t have it, please call the NZ POST National Call Center for assistance with query on – 0800 501 501 or email NZ Post Sales leads – leads@nzpost.co.nz 
 Enable auto-generate Shipping Options Label - Enable to generate shipping labels on checkout
Enable Sandbox Mode - Enable Sandbox for API testing
Debug Mode - Enabling this will show you debugging information on your cart and checkout pages.
Domestic shipping surcharge - Add surcharge amount per order if any.
International shipping surcharge - Add surcharge amount per order if any
Save Changes - Click Save changes to store settings. Always store settings after making any change.   


Configuration

  1. Go toWooCommerce > Settings > Shipping.
  2. Select your Shipping Zone that you want to add the method to, and press the Add shipping method + button on the right
    Add shipping method
  3. Select New Zealand Post from the dropdown and press Add shipping method:
    screen-shot-2016-10-07-at-11-09-04-am
  4. Click on the New Zealand Post method to configure the settings:
    • Method Title – Name the shipping method. This will be visible by customers.
    • Origin Postcode – This should be set to the postcode from which you will ship. It is sent to the NZ Post API. It should match with the Postcode / Zip specified in WooCommerce => Settings => Gereral => Store Address.

 

Note: The store address specified in general WooCommerce setting is an important part that affects several WooCommerce features, so it should be mentioned correctly. The user should also make sure that their store address is available in NZ Post API database. If not, then they must request to get their store address added into NZ Post API database

 

    • Method Availability –  This setting lets you narrow down the countries which can get quotes. Leave set to All Countries to have it available for all customers.
    • Rates and Services – These settings control the services and rates you offer customers.
      • Parcel Packing Method – See below.
      • Offer Rates – Choose to return all rates (user will get the choice) or just return a single rate.
      • Services – Here you can rename, and re-order, NZ Post shipping rates.
  1. Add shipping method.

 

Parcel Packing Method

There are 2 packing methods with NZ Post; each affects the parcels you send to the API.

Pack items individually (Default)

Each item in your cart (non virtual) will be sent to the NZ Post API. Quotes for all items will be combined for the final cost.

Pack into boxes with weights and dimensions (Recommended)

Items will be packed into pre-defined boxes and sent to the API. We recommend this option. See box-packing below for more information on this.

Box-Packing

The box packer included with this shipping method lets you group items into packages of which you define the height, width, length, weight and max-weight. The packing is mainly volume based, but does also consider item sizes too.

The box packer is volume based. This will in most cases provide good results, but will never be as accurate as a real person packing a box (see BIN Packing Problem) therefore it is important you understand that packing results are as accurate as they can be and any anomalies should be accepted.

Setting up box sizes

Within the settings, look for the boxes setting. Click ‘add box’ to set up the boxes dimensions:

  1. Outer dimensions are used for parcel dimensions and are passed to the API.
  2. Inner dimensions are used for packing, and items will be fit within these.
  3. Box weight is the weight of the actual box, and will be added to the weight of the contents.
  4. Max weight is the maximum weight your box can hold. This includes contents weight and box weight.
Box Settings
Box Settings

How the calculation works

The packer does the following:

  1. Finds boxes which fit the items being packed (uses H x W x D).
  2. Packs all fitting items into boxes (using volume).
  3. The largest box which fits 100% of items is used *or* use the highest % packed box, and then pass unpacked items back (and repeat the process)
  4. Unpackable items are packed alone, using the item dimensions.
  5. All packed boxes are returned.

Customer Usage

Customers will get quotes (after inputting their address) from two places;

  • The cart page – by using the shipping calculator
  • The checkout page – by filling in the shipping and billing forms
Rates can be selected by customers as normal.

Troubleshooting

No rates returned/no rates available

    1. Enable debug mode to see debugging information on the cart page. This will often reveal the problem.
    2. Check your products have sizes and weights set – without this the calculation cannot be performed.
    3. Check your store’s base country is New Zealand and that you are using NZ Dollars (from WooCommerce > Settings > General).
    4. The store address specified in general WooCommerce setting is an important part that affects several WooCommerce features, so it should be mentioned correctly. The user should also make sure that their store address is available in NZ Post API database. If not, then they must request to get their store address added into NZ Post API database.
    5. The plugin works correctly when both the store address and buyers shipping address details match an address within the NZ Post address database. However, when the address does not exist in the NZ Post database, or the address is entered in the wrong format, the plugin does not work.
      If the buyer finds that shipping options are not coming up, then he can directly search his shipping address on NZ Post address locator here: https://www.nzpost.co.nz/tools/postshop-kiwibank-locator/. Then, they can retry and specify exactly as its appearing in the address locator search result.
    6. The plugin needs to be able to talk to NZ Post API. For this it uses wp_remote_post which makes use of fsockopen/CURL.
By purchasing the New Zealand Post Shipping for WooCommerce plugin, you will be able to gain access to a downloadable .zip file. When you purchase this plugin, you are assigned an account and license key. This gives you access to one year of premium support and updates.

Basic Setup:

  1. Purchase the New Zealand Post Shipping for WooCommerce to get started.
  2. Download the .zip file to your device.
  3. On your website, Go to: WordPress Admin > Plugins > Add New to upload the file you downloaded with Choose File.
  4. Activate the plugin in Plugins > Installed Plugins.
If you have a question about our New Zealand Post Shipping for WooCommerce plugin, please feel free to contact our support team.

Reviews

There are no reviews yet.

Be the first to review “New Zealand Post Shipping for WooCommerce”

Your email address will not be published. Required fields are marked *