VibeFox NZ Post for Adobe Commerce

Overview

VibeFox NZ Post adds an NZ Post shipping method to Magento Open Source and Adobe Commerce for stores that send parcels from New Zealand. Customers see a live NZ Post rate for their address and parcel at the shipping step of checkout, or your fixed price per country and cart weight.

It suits New Zealand stores that ship within the country (CourierPost and ParcelPost services) and abroad. The module calculates shipping rates at checkout. It does not create shipping labels, book pickups, track parcels or let customers choose a pick-up point, PO Box or parcel locker.

Key features

Live NZ Post rates: domestic and international prices from the NZ Post ShippingOptions API 2.0. The cheapest service NZ Post returns is used, or only the service codes you list. Surcharges and mandatory add-ons such as rural delivery are included, and the customer sees the name of the priced service.

Contract rates: with your NZ Post business account number, international requests return your account rates.

Fixed prices as the fallback: a price per country with optional weight columns (up to 1, 2, 3, 5 kg and over 5 kg), per order or per item, plus a fallback cost. Used when live rates are not set up or NZ Post gives no rate.

NZD and GST handling: NZ Post prices in NZD are converted to your base currency with your rate, and Magento shows them in the customer's currency. Domestic prices can be taken including or excluding 15% GST, so GST is not charged twice when your store taxes shipping.

Fast checkout: rates are cached for 1 hour and failed requests for 10 minutes. The access token is cached and renewed automatically. API errors never reach the customer.

Shipping rules: minimum and maximum cart weight, minimum order amount, free shipping from an order amount and the countries you ship to. Magento cart price rules with free shipping make the price 0.

Service with the order: the NZ Post service and price of a live rate are saved with the order and shown on the admin order page and in the customer's order view.

Standard Magento settings: all settings are on the standard Delivery Methods configuration page, with sections for the NZ Post API, the parcel, fixed prices and availability, settings per website, encrypted Client Secret and auth code, and a debug log viewer.

Requirements

Magento Open Source or Adobe Commerce 2.4.6 to 2.4.9 (your own server or Adobe Commerce on cloud infrastructure; not Adobe Commerce as a Cloud Service), PHP 8.1 to 8.4. Live rates need NZ Post API access (Client ID and Client Secret). Rates within New Zealand also need an NZ Post business account. Fixed prices work without them. A VibeFox license key from vibefox.net (one key per domain).