Skip to content

Powered by Grav CMS + Helios Theme

Shipping carriers

Live carrier rates, the boxes an order packs into, the labels you buy and print, and the tracking that follows a parcel to the door.

Shipping carriers

What the shipping add-on does, what it needs, and the screens it adds to the KahunaCart admin.

Getting started

Install the add-on, paste a Shippo key, switch your carriers on, fill in some boxes, bind a method to a service and buy your first label.

Carriers and services

What a carrier aggregator is, what a carrier account is, where each one lives, and how a shipping method binds to one service.

Boxes and packing

The box catalogue, how the packer chooses a box, dimensional weight and its divisor, and how to check the packing before a customer is charged for it.

Rates at checkout

What a customer sees when a carrier prices a method, what happens when the carrier is slow or down, and the fallback method that carries the order.

Labels

Buying a label, the six states one can be in, opening and reprinting it, voiding inside the ninety-day window, and buying automatically once an order is paid.

Tracking

The inbound webhook and the poll behind it, the seven tracking statuses, the delivery log, and the email a customer gets when a parcel arrives.

Customs

International parcels: what a customs declaration needs, where each fact comes from, the store-wide answers, and what a courier refuses without.

Settings reference

Every config key in kahunacart-shipping.yaml with its default and what changing it does, grouped as the settings screen groups them.

Selling in more than one currency

Why a carrier account has its own currency, what happens to quotes and labels when it is not the cart's, and what the customs form says.

Developers

The aggregator driver contract, how to write another driver, and every route, MCP tool, CLI command, job, table and event the shipping add-on registers.