Learn Mokapen

Shipping (Orders)

The Shipping page under Settings → Sales → Orders defines geographic zones and the logic for calculating shipping cost on orders (and, where enabled, on the portal cart). Without zones, the cost on the order typically stays manual. With zones, Mokapen can propose or update the amount based on destination country, cost type (fixed or by weight) and free-shipping threshold.

On a single order the operational block (address, country, cost) is described in the Orders guide. For automatic discounts see Discounts.

Where it is and who can edit

Path: Organization settings → Sales → Orders card → Shipping.

• Member (and above) — can create, edit and delete zones.
• Requires the Orders app with a suitable Premium plan (same requirement as the Orders area).

Zones do not apply to quotes as a first-class block: the focus is orders (and related cart flows).

What a zone is

Each zone has:

• Title and description (internal / informative labels).
• Countries — one or more country codes, or All countries (ALL) or Rest of world (ROW).
• Cost type:
  • Fixed — amount + currency for the zone.
  • Weight — tiers (weight range + unit + amount + currency). Order weight typically comes from quantity × catalog weight of products on lines.
• Free shipping (optional) — amount threshold (+ currency): above that threshold the cost becomes zero.

The list shows zone, cost (and a «free» badge if configured) and associated countries. From the ⋯ menu: edit or delete.

Create and edit a zone

1. Click New zone.
2. Fill title, countries, cost type and amounts/tiers.
3. If needed, enable free shipping and set the threshold.
4. Save. Repeat for your commercial areas (e.g. «Italy», «EU», «Rest of world»).

Avoid ambiguous overlaps between zones (same country in two zones with different rules): order matching uses destination country; define a clear hierarchy (specific countries + ROW as fallback).

How it applies on the order

On the order full page (not the compact side panel) open the Shipping block:

• set destination country, address and goods recipient data;
• Mokapen can calculate the cost via zone AJAX (info_zone_ajax) from country (+ weight if configured);
• if the free-shipping threshold triggers, cost goes to zero;
• you can still edit the cost manually when there are no zones or you need an override.

The amount (shipping_amount) is added to the order total after line items and VAT on lines. When syncing to Fatture in Cloud it can be exported as a dedicated line.

Weight zones: catalog prerequisite

If you use the weight type, catalog products must have weight filled in. Without weight on product lines, tier calculation may be zero or incomplete. Services typically do not contribute to weight.

Recommended process

1. List real destinations (Italy / EU / outside EU).
2. Create zones with simple fixed costs; switch to weight only if the carrier tariff requires it.
3. Set free-shipping thresholds consistent with your margin.
4. Fill weights on shippable products.
5. Run a test order: change country and check cost + totals + (if you use it) FiC sync.

Use cases

• Ecommerce / portal — zones aligned with the cart: the customer sees costs consistent with the CRM order.
• B2B domestic + export — domestic zone with low fixed cost; ROW by weight or high flat fee.
• Pickup only — no zones; shipping cost always 0 or manual «pickup at site».

FAQ

Q: Why is the cost not calculated automatically?

A: Check that zones exist, destination country matches, and (if weight) products have catalog weight. Otherwise enter the cost manually.

Q: Is shipping tied to organization locations?

A: No. Locations are mainly for HR; here you configure customer destination zones.

Q: Does it apply to quotes?

A: Zone settings are focused on orders (and related cart). Quotes do not use this block as the primary delivery document.

Q: Is shipping cost subject to VAT like line items?

A: It enters order totals as shipping amount; fiscal detail on the invoice depends on how you export/sync it (e.g. dedicated FiC line). Check your org sync flow.