Balikobot Shipping App

By balikobot

0+ active installationsVersion 0.1.1

One pickup point map at checkout for Zásilkovna, PPL, GLS, DPD and Balíkovna. Labels and handover for every order in the Balikobot Portal.

Description

Ship your WooCommerce orders with the main Czech carriers from one place. Your customers choose a pickup point on one map at checkout. You print labels and hand parcels over in the Balikobot Portal, without retyping a single address.

What this plugin adds to your shop

  • One pickup point map for all your carriers, in place of a separate widget for each
  • Works in the classic checkout and in the Checkout block
  • Opens from a button in a dialog, or sits directly in the checkout
  • Shows only for the shipping methods you mark as pickup point methods
  • Saves the chosen point on the order, so the label is ready
  • Nothing to paste into the shop: the plugin finds your widget by the shop’s web address

What you get with Balikobot

This plugin is one part of Balikobot. The rest runs in the Balikobot Portal, a web app your shop connects to in a few clicks. The Portal works without the plugin. Install the plugin when you want the pickup point map at checkout.

  • Orders arrive from WooCommerce on their own, filtered by the order statuses you choose
  • Shipping labels for Zásilkovna (Packeta), PPL, GLS, DPD and Balíkovna from one screen
  • Handover manifests, and shipment data sent to the carrier at the time you set
  • Rules that match each WooCommerce shipping method to a carrier service
  • Order status in WooCommerce changes as the shipment moves
  • Several shops in one account
  • Your own carrier contracts, or better prices through Balikobot contracts

Get started

  1. Create a Balikobot account: https://www.balikobot.cz/woocommerce/
  2. Connect your shop in the Portal. You approve the connection in WooCommerce, with no API keys to copy.
  3. Add your carriers and choose which shipping methods offer a pickup point.
  4. Install this plugin. The map appears at checkout.

Balikobot is a paid service. This plugin is free and has no locked features.

Source code

The Checkout block script in blocks/build/ is compiled from blocks/src/, which ships with the
plugin. To rebuild it, run npm install && npm run build in the blocks/ directory.

External services

This plugin connects to services operated by Balikobot s.r.o. (https://www.balikobot.cz/). Without
them there is no pickup point picker.

Balikobot widget host

The widget files are hosted by Balikobot on Google Cloud Storage, under
https://storage.googleapis.com/bb-dist-prod/widget/. Google only hosts the files: Google Cloud
terms https://cloud.google.com/terms, Google Cloud privacy notice
https://cloud.google.com/terms/cloud-privacy-notice.

  • Your server downloads widget/v1/config.json, which names the Balikobot Portal API address,
    before it calls the Portal API (see below). The request carries only WordPress’s standard user
    agent, which includes the site address.
  • The customer’s browser loads the widget script widget/v1/balikobot-widget.js on the checkout
    page. When the customer opens the picker, the browser also loads the picker page, the map tiles
    (OpenStreetMap data) and the street search index from the same host. The picker page address
    carries the widget id, the shop’s web address and the checkout language. Like any web request,
    these requests reveal the customer’s IP address and browser to the host.

Balikobot Portal API

The Portal API (https://portal-api.balikobot.com) tells the plugin which widget belongs to the shop
and returns the pickup points.

  • Your server calls GET /api/widgets/resolve and GET /api/widgets/{id}/config to learn which
    widget belongs to this shop and which shipping methods offer a pickup point. Both requests send
    this shop’s web address (the Site Address from Settings > General) and nothing else. They run when
    the cart or checkout page loads, when an order is placed, and on the Balikobot settings screen.
  • When the customer opens the picker, their browser requests the pickup points and their details.
    These requests send the widget id, the shop’s web address, the destination country and the name
    of the chosen shipping method, along with the customer’s IP address like any web request. They send no cookies and no customer name, address or contact details.
  • If the customer allows it, the browser’s location is used to centre the map. It stays in the
    browser and is not sent.

The pickup point the customer picks is posted back to your shop and saved on the order.

Terms of use: https://www.balikobot.cz/wp-content/uploads/2026/08/Vseobecne-obchodni-podminky-2026_EN.pdf
Privacy policy: https://www.balikobot.cz/wp-content/uploads/2026/08/Zasady-ochrany-osobnich-udaju-Balikobot-s.%E2%80%85r.%E2%80%85o._CZ.pdf
All legal documents: https://www.balikobot.cz/dokumenty/

Installation

  1. In WordPress admin, open Plugins > Add New Plugin and search for “Balikobot”.
  2. Install and activate the plugin. WooCommerce must be active.
  3. Open WooCommerce > Settings > Shipping > Balikobot. The Connection row shows whether the Portal knows this shop.
  4. Choose how the map opens: from a button in a dialog, or directly in the checkout.

FAQ

Do I need a Balikobot account?

Yes. The plugin shows the map that your Balikobot account sets up. Without an account with this shop connected, it does nothing.

Does the plugin print labels?

No. Labels, manifests and carrier handover happen in the Balikobot Portal. The plugin adds the pickup point map to your checkout and saves the chosen point on the order.

Which carriers does the map cover?

Zásilkovna (Packeta), PPL, GLS, DPD and Balíkovna. More carriers are in development.

Do I need my own contracts with carriers?

You can connect your own contracts. For some carriers Balikobot can arrange a contract for you.

Can I use Balikobot without this plugin?

Yes. The Portal imports orders and prints labels without it. The plugin is for shops that offer pickup points.

The map does not show at checkout. What should I check?

Open WooCommerce > Settings > Shipping > Balikobot. “Not connected” means the Portal has no widget for this shop’s web address. Then check in the Portal that the shipping method is marked as a pickup point method.

Where do I choose which shipping methods offer a pickup point?

In the Balikobot Portal, not in WordPress. The plugin reads the list from the Portal each time the
checkout page loads.

The picker failed to load for a customer. Can they still order?

Every other shipping method is unaffected. A pickup point method needs a chosen point, so the
customer sees a message saying the picker could not be loaded, and can try again or choose a
different shipping method.

Does it work with the Checkout block and High-Performance Order Storage?

Yes. Both are declared compatible, and the chosen point is saved the same way on either checkout.

Screenshots

Changelog

0.1.1

  • Every function, class, constant, option, hook, script handle and CSS class has a unique prefix.
  • No admin notice when the shop is not connected; the Plugins screen links to the settings instead.
  • Classic checkout: an order with a pickup point method can no longer be placed without a chosen point.
  • Classic checkout: a point chosen and then abandoned for another shipping method is not saved on the order.
  • The External services section lists every service the plugin connects to.

0.1.0

  • First release: classic and Blocks checkout, order meta, admin, customer and email display.
  • The widget and the pickup-point shipping methods come from the Balikobot Portal.
  • The picker can open in a dialog or be shown inline in the checkout.
  • Checkout stays usable when the picker cannot load, and the customer is told why.