CBX Woo Shipping — how it works
CBX Woo Shipping puts The Frozen Food Courier® on your WooCommerce checkout: it checks whether we deliver to the customer’s address and prices the delivery from our live rate card. This page shows a shop manager how to set it up and run it. It is one of the CBX plugins, built on CBX Platform, the first working release of Cibarix™.
WooCommerce shipping in one minute
- Shipping zones are areas you define by country, province or postcode. WooCommerce uses the first zone in your list that matches the address and ignores the rest.
- Shipping methods sit inside each zone: Flat Rate, Free Shipping, Local Pickup, or a plugin such as this one. Each can offer a rate.
The customer sees every rate in their matched zone and picks one. If no method offers a rate, they cannot check out, so something must always cover every address you sell to.
What the plugin does, and what it doesn’t
- It prices from the rate card. The plugin pulls TFFC’s rate card each day by itself, with a built-in copy to fall back on. You never type in prices.
- It only quotes. It does not book collections, email customers, or cancel, refund or delete orders. Getting the order to TFFC is the job of the CBX Woo Connector or your existing process.
- It fails safe. If something unexpected goes wrong, it adds no TFFC rate for that cart and your other methods keep working. Customers never see an error.
For an address we serve, the customer sees options that start with your method reference (default “TFFC Serviced”): Delivery inside the region you ship from, Road or Road (via Cape Town) to other regions, and Air or Air via Cape Town where you offer air. These are all TFFC services, not rival couriers. A restricted-area postcode still gets a price, with a note that the courier may decline after the order. The customer never picks a delivery date.
Where to find everything
- Store-wide settings and tools: Cibarix™ → Shipping in your WordPress admin.
- Per-zone settings: WooCommerce → Settings → Shipping, open a zone, then Edit on the TFFC Shipping method.
| Tab in Cibarix™ → Shipping | What it is for |
|---|---|
| Flow | A picture of how your setup fits together, with a warning if something is likely to go wrong. |
| Dashboard | The rate-card data in force, update status, errors, and buttons to test the connection or email a diagnostic to TFFC. |
| Configuration | All store-wide settings, saved with one Save settings button. |
| Lookup | Test an address: do we deliver there, in which zone, at what base rate. |
| Logs | Every shipping decision, searchable by order number. |
| Help · Status | A short summary · a system check and self-test. |
Two things trip people up. The Configuration tab fills in only for an Administrator login; a Shop Manager sees it empty. And the Settings link beside the plugin in your Plugins list opens an older copy of the settings, not the Cibarix™ screen.
Getting it live
- In WooCommerce → Settings → Shipping, open a zone and choose Add shipping method → TFFC Shipping. The plugin works out South African postcodes itself, so most stores use one broad South Africa zone.
- If you already have zones per area, add TFFC Shipping inside each of them. A broad TFFC zone below them would never be reached.
- Click Edit on the method and go through the per-zone settings with TFFC.
- Check the Flow tab, then try a few addresses in Lookup.
There is no “enable” switch in the plugin: use WooCommerce’s own toggle in the zone’s method list. Wording, promotions and VAT are yours; where and how you ship is agreed with TFFC; technical fields stay as TFFC set them.
The per-zone settings
Where and how you ship (agreed with TFFC)
- Home base (ship from): Cape Town or Gauteng. Left on none, the zone is priced as shipping from Gauteng. A store with more than one depot ticks them under Depots, and each customer gets the cheapest one.
- Home zone postcode: where you are collected from.
- Shipping methods offered: Road and Air (default), Road only, or Air only.
- Inter-city transfer and Waived transfer routes: whether the customer pays the long-haul leg. With Waive all or any waived route, an amber notice lists the lanes you cover and their rates. Your customers pay the last-mile only, but TFFC still invoices you the full delivery, and each such order gets a private note saying what you covered.
- Own-fleet last-mile style, Pallet shipping class and Shipping classes TFFC must quote: a cart with an item in a pallet or must-quote class gets “Request a quote” instead of a price.
How it reads and behaves (yours)
- Method reference (short) and Show estimated boxes: how the option reads at checkout.
- A product without a weight: such a product would count as 0 kg and make a heavy cart look light. Quote (default) offers “Request a quote” instead; Price prices on the products that have a weight. Without a quote form the cart is priced either way. The Logs tab names the products to fix.
- Tax status: your VAT position on shipping. Agree it with your accountant.
- Shipping classes handled by other plugins and Off-network destinations: when TFFC steps aside (see “Working alongside other couriers”).
- Shipping promotions and Shipping subsidy: see below.
Unserviced postcodes seen lists addresses customers tried that we don’t cover yet: press Report these to TFFC to send them. Leave Consolidation hub code and Coverage-gap report form URL as TFFC set them.
The store-wide settings
These are on the Configuration tab. Saving a pricing setting makes open carts re-price on their next load, so nobody checks out on an old quote.
TFFC connection (leave to TFFC)
Receive plugin updates and report check-ins to TFFC and Install TFFC updates automatically are both on by default; keep them on. WordPress then installs new versions of this plugin only, never your other plugins, each checked against TFFC’s signature first. Recent plugin updates shows when it last changed. Leave TFFC endpoint URL blank (it is built in) and Shared HMAC secret as TFFC left it.
Quote requests (agreed with TFFC)
This decides what happens when we can’t price a cart online: an address outside our network, a pallet, or an item that must be quoted. Quote form provider starts on None: no quote and no TFFC rate for those carts. “Request a quote” appears only once you pick Forminator form and enter the Quote form page URL; the customer then reaches your form with their cart and address filled in. If another courier covers areas we don’t, leave it on None.
Messages, audit note and cart weight (yours)
- Quote message fields and Shipping discount notice: the wording customers see. Leave blank for the default. Also show the saving adds the old amount, such as “was R300”.
- Shipping audit note: a private order note of what TFFC quoted, flagging any coupon or plugin that cut it afterwards. Keep Only when a third party overrode our rate: it is your evidence in a billing dispute.
- Show cart weight to customers: shows the cart weight against the 60 kg included per delivery, and any surcharge.
Promotions, subsidy and adjustments (yours)
These change what the customer pays. You still owe TFFC the full base rate, and it is recorded on the order.
- Shipping promotions (store-wide here, and per zone): up to five rules that waive or discount shipping, for example free over a cart value, only under a weight, for certain customer roles, or for or without certain products, categories or shipping classes. The customer gets the cheapest match.
- Shipping subsidy (per zone): you cover a percentage of the cart value (excluding VAT), down to a minimum fee; a fee already below it is left alone. Defaults: 10% and R120. Agree the numbers with TFFC first.
- Store shipping adjustment: Absorb to reduce, or Uplift to add (for example packaging), by a percentage or fixed amount.
Only one applies: a subsidy that lowers the fee, else the best promotion, else the adjustment.
Order statuses and diagnostics
- TFFC delivery statuses (off by default; agree with TFFC, as they tie into the CBX Woo Connector): adds Dispatch Ready → Scheduled → In Transit → Out for Delivery → Delivered or Failed, plus Rescheduled and Cancelled, with order-list buttons. Under Statuses to use, all are ticked except In Transit; a status can’t be unticked while orders are in it. They stand down if another order-status plugin is active.
- Dispatch Ready date box: on by default (see “Day to day”).
- Test mode and Logging level: leave to TFFC. Field-code markers: click a “?” to show short codes on each field, and quote one when you use Send feedback or contact us.
Working alongside other couriers
Many stores send dry goods with another courier. Two per-zone settings share the checkout:
- Shipping classes handled by other plugins: if every item in the cart is in a class you tick here, TFFC adds no rate and steps aside. A mixed cart is priced entirely by TFFC, because the cold chain carries the whole order. Items with no class count as TFFC’s.
- Off-network destinations: Add no rate — another courier handles it steps aside outside our network. The default, Offer “Request a quote”, also adds no rate until quote requests are set up.
Wherever TFFC steps aside, another method in that zone must cover the cart. Plugins often run beside ours:
| Plugin | What it does |
|---|---|
| Bob Go (formerly uAfrica) | Live rates from several South African couriers and lockers. |
| The Courier Guy | Door-to-door and locker delivery. |
| Flexible Shipping (Octolize) | Rate tables by weight or value, often for dry goods. |
| Shipping Zones by Drawing (Arosoft) | Delivery areas drawn on a map. |
Worked example: ACME’s local wine
ACME (a made-up store) keeps its wine in Stellenbosch, where a local driver delivers it for a flat R300, or free on bigger orders. Everything else ships with TFFC.
- Create a shipping class Wine and assign it to the wine.
- Create a Stellenbosch zone by postcode, above the broad South Africa zone.
- In it, add TFFC Shipping with Wine ticked under Shipping classes handled by other plugins, plus WooCommerce’s Flat Rate (R300) and Free Shipping (ACME’s threshold).
- Leave Wine unticked in the broad zone, so wine going elsewhere is priced by TFFC.
A wine-only cart to Stellenbosch now shows only the local rates; a wine-and-groceries cart gets a TFFC rate. WooCommerce shows every method in a zone, though, so the local Flat Rate can also appear on that mixed cart. To hide it there, ask your developer or use a conditional-shipping plugin.
Map-drawing zone plugins
A drawn zone charges a flat or by-distance price, so it can’t reproduce TFFC’s pricing by weight, road or air. If you ship only with TFFC, our method alone gives the most accurate rates. Talk to us before drawing an area to match ours.
Day to day: orders and Dispatch Ready
Dispatch Ready is the day an order is ready to leave. It is stamped automatically when an order moves into a dispatch status (such as TFFC Dispatch Ready), or you set it in the Dispatch Ready box on the order. The CBX Woo Connector reads it and sends it to TFFC.
- Switch the box off and the Connector no longer finds the date by itself; it must be pointed at your own date field.
- The Connector sends at “Processing” by default, before Dispatch Ready. To send the date, make your dispatch status its trigger.
- An automatic stamp just after midnight can read as the day before.
Private order notes explain each order’s shipping. When the fee was changed, the totals show a TFFC full shipping row: what you owe us.
Background work and timing
The plugin is built so that it never slows your store down. A checkout price is worked out on your own server from the rate card already stored there, so a quote never waits on a call to us.
- Rate card: refreshed once a day in the background. A price or coverage change reaches your checkout at the next refresh, not the instant we make it. The Dashboard shows which rate-card data is in force.
- Plugin updates and the store check-in ride WordPress’s own twice-daily update schedule; the log clean-up runs daily.
- Quiet stores: these tasks use WordPress’s scheduler (WP-Cron), which runs only when someone visits your site. On a quiet store they can run late. An external cron keeps them on time: see Quiet stores on the CBX Woo Connector page.
- Orders and delivery updates are the CBX Woo Connector’s job, and the same page explains when an order reaches us and why its status does not always change instantly.
When something looks wrong
- Lookup: enter a postcode, suburb or town, a weight and an origin, and press Validate. You get the zone, the base rate (before your promotions or adjustments) and a pin on the service-area map.
- Logs: search an order number to see how its rate was built. Each calculation has a reference like “R-…”, also kept on the order’s shipping line. Entries are kept 14 days by default (Keep log entries for; always enter a number). Clear log cannot be undone.
- Dashboard and Status: check the rate-card data is current. Run dry-run tests a sample rate safely; Run live round-trip does a real update check and may leave you on the older settings page.
- Still stuck? Contact us with the field code or calculation reference.
On block checkout, rates work, but the cart-weight indicator, discount notice, restricted-area notice and quote gate appear only on the classic checkout. Watch the quote gate: a customer could place an order on the R0 “Request a quote” line, so keep an eye on those orders.
Need a price the checkout can’t give? Request a quote. See also our developer pages and all CBX integrations.
