Black November: −35% on all modules until 30 November Black November: −35% until 30 November Choose a module

Get in touch
WooCommerce

Czech Couriers: Balíkovna & Česká pošta for WooCommerce

Balíkovna, Balík Na poštu and Balík Do ruky for WooCommerce: the official Česká pošta map at checkout, parcels and labels through the B2B API, cash on delivery, tracking for the buyer.

Download Free
Pro · one-year licence Staging copies are included. The more sites, the cheaper each one
Compatibility
WordPress 6.2+ · WooCommerce 7.0+ · PHP 7.4+ · language: English, Czech
Licence
a site + a staging copy, annual
Trial
7 days, no card, one per site
Updated
19.11.2026
Or all 509 Pro modules with All Access — 3 244 UAH / year ≈ €66

What Free has,
and what Pro adds

The free version works with no time limit. Pro adds the rest of the features in the table.

Feature Free Pro
Balíkovna (point or box), Balík Na poštu and Balík Do ruky as zone delivery methods ✔ ✔
Fixed price, free from an order amount, free-shipping coupons, weight limit ✔ ✔
The official Česká pošta map on the classic and the block checkout ✔ ✔
Point list with search, nearest to the buyer's post code first, full screen on phones ✔ ✔
Server-side point check; no order without a point and a mobile number ✔ ✔
Point on the order, in e-mails, on the thank-you page and in My account, HPOS ✔ ✔
Parcel data and PDF label through the B2B API from the order screen ✔ ✔
Cash on delivery (dobírka) for the payment methods you choose ✔ ✔
Parcel numbers typed in by hand from Podání Online ✔ ✔
Tracking and parcel status for the buyer, e-mail with the parcel number ✔ ✔
English and Czech interface ✔ ✔
Prices per weight for each method — ✔
Parcels sent automatically at an order status — ✔
Bulk parcels and all labels in one PDF — ✔
Insured value (udaná cena) — ✔
Hourly status sync and Completed on delivery — ✔
Updates from catcode.com.ua — ✔

What it looks like

The official Balíkovna map at checkout
The official Česká pošta map at checkout: address search, point details with opening hours and the “Vybrat Balíkovnu” button.
The point list on a phone
On a phone the picker opens full screen with the list first: points and boxes near the buyer’s post code, a 16 px search field.
The Česká pošta box on the order
On the order: service, point with its code, parcel number, status, PDF label and status refresh.

Key points

Checkout

The methods are shown for Czech addresses only. When the buyer chooses Balíkovna or Balík Na poštu, the point picker appears under the delivery method, and only then.

Parcels from the order

The order screen has a Česká pošta box: service and point with its code, weight, cash on delivery and insured value, the “Send to Česká pošta” button, and after sending the number, status, PDF label and status refresh.

The point on the order and tracking

The chosen point is read again on the server from the Česká pošta point service.

The trial starts when you ask

A fresh install is the free version, nothing switches on by itself. The “Try Pro for 7 days” button → e-mail → the key right in the window and by e-mail.

One key — a site and a staging copy

Moving the site? Unlink the licence on the old domain and activate it on the new one yourself. A staging copy (staging., dev.) works with the same key and does not take a site slot. For studios — keys for 5 or 25 sites, or unlimited.

Technical requirements

  • WordPress 6.2+, WooCommerce 7.0+ (HPOS, classic and block checkout), PHP 7.4+.
  • For parcels through the API, a Česká pošta contract with B2B API access.
  • Interface language: English and Czech.

Version history

v1.0.0 Current 19.11.2026

Balíkovna, Balík Na poštu and Balík Do ruky, the official Česká pošta map and the point list on the classic and the block checkout, server-side point check, parcels and labels through the…

Frequently bought with Czech Couriers: Balíkovna & Česká pošta

All Access Need more? All modules (509) under one licence, new ones are added automatically. 3 244 UAH≈ €66 Learn more →

Full module description

Czech Couriers: Balíkovna & Česká pošta for WooCommerce adds three Česká pošta delivery methods to your shop: Balíkovna (pickup point or box), Balík Na poštu (post office) and Balík Do ruky (to the address). The buyer picks the point in the official Česká pošta map or in the list next to it; you send the parcel data from the order screen through the B2B API and print the label. The buyer sees the parcel number and the parcel status in the account and the e-mails. Made for shops selling in the Czech Republic; the plugin speaks English and Czech.

What you need from Česká pošta. The map, the point on the order and tracking of a number you type in work without a contract. Sending parcel data and printing labels through the API need a Česká pošta contract and its B2B API access: the API token and the secret key are generated in Pošta Online → B2B profile management, the technological number and the post code of the submission post office are in the contract.

Checkout

The methods are shown for Czech addresses only. When the buyer chooses Balíkovna or Balík Na poštu, the point picker appears under the delivery method, and only then. The button opens the official Česká pošta map with address search, “Moje poloha” and opening hours. Balíkovna boxes can be left out of the map with one setting.

Next to the map there is a list tab: search by town, street, post code or name, accents optional, starting with the points near the buyer’s post code. The list comes from a copy of the Česká pošta point list that the plugin refreshes once a day. On a phone the picker opens full screen with the list first; the search field is 16 px, so the phone does not zoom in.

Parcels from the order

The order screen has a Česká pošta box: service and point with its code, weight, cash on delivery and insured value, the “Send to Česká pošta” button, and after sending the number, status, PDF label and status refresh. Orders shipped with another method can be sent as Balík Do ruky. Without the B2B API you type the number from Podání Online into the order, and the buyer gets the same tracking.

The point on the order and tracking

The chosen point is read again on the server from the Česká pošta point service. The order is refused when a point method has no point, the point is closed or of the wrong kind, or the buyer gave no mobile number (Česká pošta sends the pickup code by SMS). The buyer’s address fields are never rewritten in the browser, and the address saved in the buyer’s account stays theirs.

The point is stored on the order (HPOS compatible), optionally written into the shipping address, and shown on the thank-you page, in My account and in the e-mails. As soon as the order has a parcel number, the buyer gets an e-mail with the tracking link. My account shows the number, the link to the Česká pošta tracking page and the current parcel status; the order list has a “Sledovat zásilku” button. The status comes from the public Česká pošta tracking service and is refreshed when the buyer opens the order.

Settings

WooCommerce → Czech Couriers: enter the API token, the secret key, the technological number and the post code of the submission post office, save and click “Check the connection”. The secret key is stored encrypted and never shown in the form again. The same page holds the parcel prefixes your contract allows, the cash on delivery service, the account for cash on delivery and the label form.

Checkout settings: boxes in the map, “Download now” for the point list, the payment methods sent as cash on delivery for the order total, the weight of a product without weight, a note on the parcel, the point written into the shipping address, the e-mail with the parcel number and the parcel status in My account.

What Pro adds

Prices per weight. For each delivery method, bands of “up to kg = price”: the first band that fits the cart weight gives the price.

Automatic parcels. The parcel data goes to Česká pošta as soon as the order reaches the status you choose; the API call runs in the background, the checkout never waits for it.

Bulk actions. In the orders list: send parcels for the selected orders and print all labels in one PDF.

Insured value. Udaná cena (service 7) on the parcels, for the value of the goods in the order.

Status sync. Every hour the plugin checks the parcel states, writes changes to the order notes and, if you want, marks the order Completed once Česká pošta reports the delivery. Plugin updates come from catcode.com.ua.

Limitations

  • Parcel data and labels need a Česká pošta contract and B2B API access; without them the map, the point on the order and tracking of a number typed in by hand still work.
  • The Česká pošta API has no call that withdraws parcel data: a parcel not handed over at the counter is simply not used, and “Remove” takes it off the order so you can send a new one.
  • Parcel prefixes come from your contract: if Česká pošta answers INVALID_PREFIX, set the prefixes you are allowed in the settings.
  • The methods are shown for Czech addresses only; Balíkovna needs the buyer’s mobile number.
  • PPL, DPD and Zásilkovna are not part of this plugin; it covers Česká pošta and Balíkovna only.

How it works, step by step

  1. Install and activate the plugin (WooCommerce must be active).
  2. WooCommerce → Settings → Shipping → your Czech Republic zone → add the methods marked “(Czech Couriers)” and set their prices.
  3. The buyer chooses Balíkovna or Balík Na poštu, picks the point in the map or the list and places the order.
  4. To send parcels through the API: WooCommerce → Czech Couriers — API token, secret key, technological number, submission post code, “Check the connection”.
  5. On the order click “Send to Česká pošta” and print the label; the buyer gets an e-mail with the parcel number.
  6. In Pro switch on prices per weight, automatic parcels, insured value and the status sync.

Under the hood

  • The Česká pošta point map (b2c.cpost.cz/locations) opens in an iframe in the buyer’s browser; the shop server checks the chosen point by its id and downloads the full list of Balíkovna points and post offices once a day for the search list.
  • Česká pošta B2B API (b2b.postaonline.cz), only with your access: connection check, parcel data, labels. Requests are signed with HMAC-SHA256 as Česká pošta requires.
  • Parcel status from the public Česká pošta tracking service (ParcelHistory); the buyer’s link opens postaonline.cz.
  • The secret key is stored encrypted in the database and never sent back to the form.
  • Sent to Česká pošta with a parcel: the order number, weight, cash on delivery amount and insured value, the sender data from the settings, the buyer’s name, phone, e-mail and address or the chosen point.

Installation

  1. Plugins → Add New → Upload Plugin: choose the zip and activate.
  2. WooCommerce → Settings → Shipping: add the “(Czech Couriers)” methods to your Czech Republic zone.
  3. WooCommerce → Czech Couriers: B2B API access and sender data, “Check the connection”.
  4. For Pro: paste the licence key or start the trial in “Pro licence” on the same page.

Questions
about the module

Didn't find the answer? Message us on Telegram and we'll reply within a business day.

@catcode_support Setup, compatibility, activation
Is this an official Česká pošta plugin?

No, it is an independent integration by CatCode. Česká pošta and Balíkovna are products of Česká pošta, s.p.; the plugin is not affiliated with or endorsed by Česká pošta.

Do I need a Česká pošta contract?

Not for the checkout: the Balíkovna map, the point on the order and tracking of a number you type in work without one. Sending parcel data and printing labels through the API need a contract and its B2B API access.

Does it work with the block checkout?

Yes, the map and the list work on both the classic and the block WooCommerce checkout.

Is cash on delivery supported?

Yes. The payment methods you tick in the settings are sent as dobírka for the order total, with the cash on delivery service of your contract.

Česká pošta refuses the parcel with INVALID_PREFIX

The parcel prefix is not allowed for your technological number and submission post office. Set the prefixes your contract allows in the settings or ask your Česká pošta business contact.

How do I cancel a parcel?

The Česká pošta API has no call that withdraws parcel data: a parcel not handed over at the counter is not used. "Remove" takes it off the order so you can send a new one.

What happens when the trial ends?

Pro switches off and the free part keeps working: the delivery methods, the map and the list, parcels from the order screen, tracking for the buyer.

How many sites does a key cover?

One key works on two sites: the shop and its staging copy.

Not quite what you are looking for?

We build custom modules for WordPress, WooCommerce, OpenCart and Shopify. Tell us about the task and we'll prepare an estimate.

Order a custom module