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.

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.

Goods can be exempted from shipping charges entirely with the Doprava zdarma toggle on the product set.

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?