Shipping & Zones

How shipping works

Shopvo uses a Zones → Methods → Rates model:

1. Zone — a group of countries/regions (e.g. "Europe", "United States", "Worldwide").
2. Method — a shipping option within a zone (e.g. "Standard", "Express").
3. Rate — the price rule for a method (flat, free, weight-based, or price-based).

At checkout, Shopvo looks up the customer's country, finds the matching zone, and presents all active shipping methods for that zone.

Creating shipping zones

Go to Settings → Shipping → New Zone. Give the zone a name and select the countries it covers. A country can only belong to one zone — the most specific match wins.

Create a "Rest of World" zone last and add all remaining countries to catch any destination not covered by a more specific zone.

Shipping methods & rate types

Inside each zone, add one or more shipping methods. For each method, choose a rate type:

Tax zones

Tax configuration is separate from shipping zones. Go to Settings → Taxesto create tax zones and set the applicable rate (e.g. 20% VAT for the EU zone).

Taxes are calculated at checkout based on the customer's shipping address country and added to the order total.

Inventory sources (multi-location)

If you fulfil orders from multiple warehouses or locations, go to Settings → Inventory Sources and add each location with its name, address, and country.

Shopvo allocates inventory from the optimal source based on the customer's location and available stock at each source.

BOX NOW locker delivery

BOX NOW is a Greek locker-based delivery network. Customers choose a pickup point at checkout instead of providing a home address. The parcel is delivered to the locker and the customer collects it at their convenience.

Setup:

1. Register as a merchant at boxnow.gr and obtain your API key.
2. In Shopvo Admin → Settings → Shipping, open a zone and add a method of type BOX NOW Locker.
3. Enter the Delivery Cost, your BOX NOW API Key, and choose Environment (test / live).
4. Save. At checkout the customer will see a searchable locker map.

The selected locker (lockerId, name, address, coordinates) is persisted on the order as pickupPointData and visible in the order detail view.

Locker data is fetched live from the BOX NOW API and cached for 15 minutes per site to minimise latency. The endpoint is GET /api/storefront/box-now/lockers?siteId={id}.

Live shipping quotes

You can expose live shipping rates to customers via the Storefront API endpoint:

POST /api/storefront/{siteId}/shipping-quotes
{
  "items": [...],
  "address": { "country": "US", "state": "CA", "zip": "90210" }
}

The response returns all available shipping methods with their prices for the given address. This is used automatically by the built-in checkout; you can also call it from a headless frontend.