Skip to content
A
For administrators
Running the administration — content, users, e-shop, invoicing and settings
E-shop / Carriers and shipping tariffs

Carriers and shipping tariffs#

Three screens forming one whole: carriers (who delivers), shipping tariffs (for how much and where) and regions (to which areas).

Find them under Eshop → Nastavení eshopu → Doprava.

Carriers#

Who delivers the goods — the postal service, a courier, personal collection. On a carrier you set:

Setting What it does
Name what the customer sees in the cart
Send email notifies the customer when the parcel is handed over

Shipping tariffs#

This is where the price is decided. A tariff belongs to one carrier and one region.

A tariff doubles as a pickup point

For personal collection the tariff also carries an address and coordinates — Václavské náměstí, Praha 1. Each branch can therefore be its own tariff, and the customer picks between them in the cart.

A tariff can also carry several branches at once — controlled by its Use of branches field (None / All / One region only / Pick individually). Branches are still added by hand on the tariff — the system does not pull them in automatically from the carrier.

Creating a tariff#

  1. přidat in Tarify dopravy.
  2. Pick the carrier and the region.
  3. For personal collection, fill in the address and coordinates.
  4. Save, then set the prices — see Payment methods.

Shipping regions#

The areas you deliver to. Each can have different tariffs and prices.

A region without a tariff means an undeliverable order

When a customer's address falls in a region with no tariff, they have nothing to pick in the cart and cannot complete the order. After adding a region, always add at least one tariff.

Delivery countries#

On a shipping region you choose, in the Země doručení (delivery countries) field, the countries its tariffs deliver to. Checkout then offers the customer only the tariffs that deliver to the country of their delivery address. If a customer still submits an order with a tariff for another country, they are told to choose different shipping or change the address.

Field Behaviour
countries selected (e.g. Czechia) the region's tariffs are offered only for delivery to these countries
nothing selected the country is not checked — the tariffs are offered for any address

Shipping abroad? Create a region for each country

Every country needs at least one region with that country selected and a tariff. Otherwise a customer with an address there has nothing to choose from.

Buying in a second currency#

For a customer to buy goods in, say, euros, all of the following must be in place:

  1. The product set has a price in that currency. The price is entered separately and is not converted by an exchange rate (see Price lists and VAT).
  2. A shipping region exists whose Země doručení (delivery countries) cover the customer's address, for example Slovakia. A region with no countries selected is offered for any address.
  3. That region has a tariff with a price in that currency.
  4. The payments have a price in that currency. The shipping price is entered in the price table together with the payment method, so the shipping and payment pair must have a price in euros (see Payment methods).

If any of this is missing, the customer has nothing to choose from. If only the goods price is missing, the item in the cart is marked Not available in this currency and the checkout returns the customer to the cart. After adding a new currency, therefore, go through a test order with an address in that country.

External carrier pickup points (Zásilkovna, Balíkovna, PPL)#

Besides your own branches (above), a tariff can also offer a choice from an entire external carrier network — a Zásilkovna Z-box, a Balíkovna branch, or a PPL ParcelShop/ParcelBox. The customer picks the point right in the cart, in the carrier's own window (widget); the system never syncs the carrier's network into its own database and never creates the shipment itself — it just takes over whatever the customer picked and saves it on the order.

Option in the "Pickup point driver" field Needs a key
Zásilkovna (Packeta) yes
Balíkovna (Česká pošta) no
PPL ParcelShop/ParcelBox yes

Setting up the carrier#

  1. Open the carrier under Přepravci (editovat).
  2. Pick a carrier in the Pickup point driver field.
  3. If the driver needs a key (see the table above), fill in the Driver configuration field as apiKey[value] — see the walkthroughs below for where to get the key.
  4. Save.

Turning it on for a tariff#

  1. On the carrier, open the Tarify tab and edit the tariff.
  2. Turn on the Carrier pickup point (widget) toggle.
  3. Save.

Mutually exclusive with your own branches

The Carrier pickup point (widget) toggle and the Use of branches field (set to anything other than "Not used") cannot be turned on at the same time — saving is refused with "'Carrier pickup point (widget)' and 'Use of branches' are mutually exclusive…" and the tariff stays unsaved. Set Use of branches to "Not used" before turning the widget on.

Getting a key#

Zásilkovna (Packeta)

  1. Register for free at https://client.packeta.com/cs/registration/choose-type.
  2. Log in to the client zone at https://client.packeta.com/ and open the Support section.
  3. Copy the first 16 characters of the "API Password" — that is the widget key. The rest of the password is a secret server-side key and does not belong in the driver configuration.

PPL

  1. You need a PPL customer account.
  2. Request access at https://klient.ppl.cz/widgetadmin to get a key in the form ak_….
  3. The key is tied to a domain whitelist set in the PPL administration — for development/testing, add localhost to the whitelist too.

Balíkovna

No key is needed — just pick the driver and save.

A missing key means an unfinishable tariff

Without a valid key, the storefront shows a "this shipping method is currently unavailable" notice on the tariff instead of the "Choose pickup point" button. The customer has to pick a different tariff — until you add the key, nobody can complete an order through this tariff.

Where to look#

The chosen point (carrier, code, address) shows up on the order detail and can be copied into the carrier's own system on dispatch — see Objednávky. In the admin the pickup point can also be picked or changed afterwards (on the map, or by typing it in manually) — see the Pickup point section on the Objednávky page.

🔴 The shipping price is set elsewhere#

The most common stumbling block: the price is not on the tariff, it is in the price table where it combines with the payment method. The system prices shipping and payment together — every pair has its own price and can be switched off.

See Payment methods.

Free shipping#

Set as an amount threshold on the shipping–payment pair, separately for each combination and currency.

The threshold applies per currency

"Free from 2,000" in the local currency means nothing for an order in euros. After adding a currency, go through the thresholds again — otherwise shipping in euros is always charged, or always free.

Besides the threshold there is the Doprava zdarma toggle on the product set. One such set in the order is enough and shipping is free for the whole order — both in the offer at checkout and in the saved order.

A price entered by hand in the admin stays

When you edit an order in the admin and entered the shipping price by hand, the toggle does not overwrite it.

Weight#

Tariffs often depend on parcel weight, summed from the weights of the product sets in the cart.

A set with no weight drags down the whole parcel

Zero weight on one item lowers the sum and the parcel can fall into a cheaper band. Fill the weight in on every set.

Before going live with shipping#

Walk a test order for every region you serve:

  1. Do the expected carriers appear in the cart?
  2. Is the price right?
  3. Does the free-shipping threshold work?
  4. Is at least one payment method offered with each shipping option?

Cookie settings