Polkurier.pl for OpenCart — Polish couriers, pickup points and labels

Polkurier.pl for OpenCart 4.x, 3.x and 2.3 adds delivery in Poland through the Polkurier courier aggregator to the checkout: up to eight methods, each one a carrier of your Polkurier account, to the address or to a pickup point of that carrier. The price is either fixed or the live Polkurier valuation of the cart.

What you need from Polkurier. A polkurier.pl account with a signed agreement for the API and a token generated in the panel (Ustawienia → Token API). The carriers you see in the module are the ones connected to your account.

What the buyer sees

At checkout there are the delivery methods with your titles and prices. For a “pickup point” method a point chooser appears under it: the button of the official Polkurier map and a list search by town, street, post code or point code. The order cannot be placed without a point, a point that takes no cash on delivery rejects an order paid on delivery, and after the choice the order carries the address of the point. The server checks the chosen point with Polkurier, so it cannot be swapped by a request from the browser.

What the admin gets

Extensions → Shipping → Polkurier.pl: the Delivery methods, Account and sender, Shipments, Automation and Licence tabs. On the Account and sender tab you enter the account ID and the token and press “Save and check the connection”: the module loads the carriers, bank accounts and parcel templates of your account. The token is stored encrypted and is never put back into the form.

Up to eight methods: for each you choose a carrier from the list of your account, the kind (to the address or to a pickup point), the title at checkout, the countries, the weight limit and the amount from which delivery is free. The price is fixed, the live Polkurier valuation (for the default parcel size and the cart weight, with a markup in per cent and a fixed fallback amount when Polkurier does not answer) or, in Pro, by weight bands with a cash-on-delivery surcharge. Polkurier counts in zloty: for the live price to work the shop needs the PLN currency.

The order page gets a Polkurier panel: the carrier, the size and weight of the parcel and the pickup mode: “I hand it in myself” or “first available courier visit”. The button creates the shipment in Polkurier with the recipient address split into street, house and flat; below it are the Polkurier order number, the carrier waybill number, the status and the price. You download the label as a PDF and refresh the status with a button. When the address has no house number or the order has no phone, the module says so and invents nothing: the operator types the data into the panel.

The shipment list (the “Shipment list” button in the settings) shows all waybills with their statuses. In Pro it gets bulk actions: create shipments for the selected orders, print all labels in one PDF, order a collective courier pickup for a chosen date and hours and get the handover protocol. On the Automation tab Pro creates a shipment when an order reaches the status you chose, refreshes statuses every hour and moves the order to a status you chose after delivery, and the buyer gets an e-mail with the shipment number.

Cash on delivery is Pro: orders with the chosen payment methods go to Polkurier with the cash-on-delivery amount in zloty, and you choose the return of the collected money on the Shipments tab: to a bank account (the account can be taken from your Polkurier account), by postal order or to the Polkurier money box, with a return time of S, 1D, 4D or 16D. In Free a shipment from a cash-on-delivery order is not created: the panel explains why right away. Pro also cancels a shipment from the order page, keeps the parcel templates of the account and adds the cash-on-delivery surcharge at checkout.

How it works, step by step

1. Install the archive for your OpenCart version and switch the Polkurier.pl shipping on.
2. On the Account and sender tab enter the account ID, the token and the sender details, then press “Save and check the connection”.
3. On the Delivery methods tab choose the carriers, the kind (address or point), the price and the countries.
4. Make sure the shop has the PLN currency and try the checkout: a “pickup point” method asks for a point.
5. On an order press “Create shipment”, download the label and refresh the status.
6. In Pro switch on automatic shipments by status and the hourly status sync.

Under the hood

• Polkurier API version 1.14; the account ID and the token are stored encrypted, the token never reaches the log.
• Carrier codes come from your account (available_carriers), not from a fixed list: new carriers appear in the module without an update.
• The live price is one valuation request for all methods, with the result cached briefly; Polkurier counts in zloty and the price is converted to the shop currency at the shop rate.
• The point map is the official Polkurier widget, its token is cached; when the map is unavailable the list search stays.
• Polkurier takes the street, the house number and the flat number separately while an OpenCart address is one line: the number is picked out of the address, and when none is found the operator types it into the panel.
• For pickup-point orders without a payment address (typical in OpenCart 4) the address of the point itself is the recipient address.
• The Polkurier limit is 500 requests per 60 seconds from one IP: point search and valuation are cached, but on shared hosting the limit is shared with other shops.
• Statuses are pulled by polling: the API has no webhooks.
• OpenCart events, no core edits; updating the module keeps the account, the token and the methods. Interface in English and Polish.

How to install

1. Extensions → Installer: upload the archive for your version without renaming it (OpenCart 4: cc_polkurier.ocmod.zip, 3.x: cc_polkurier-oc3.ocmod.zip, 2.3: cc_polkurier-oc23.ocmod.zip).
2. For 3.x and 2.3: Extensions → Modifications → Refresh.
3. Extensions → Extensions → Shipping → Polkurier.pl: install and edit.
4. Enter the account ID and the token, fill in the sender, save and check the connection.
5. For Pro: paste the key or start the trial on the Licence tab.