Poczta Polska Integration (eNadawca)

The Poczta Polska module connects WooCommerce orders to Poczta Polska tracking. You enter the waybill number on the order, and the plugin builds the emonitoring link and pulls the current carrier status into the order screen, the customer order page and the shipping emails.

Requirements

Polski PRO requires: Polski (free) v1.6.0+, WordPress 6.4+, WooCommerce 8.0+, PHP 8.1+. An eNadawca login and password are also required, and the Order fulfillment module has to be enabled in Polski > Modules.

Configuration

The Poczta Polska credentials are stored in the polski_pro_shipping option and are written through the PRO settings REST endpoint polski-pro/v1/settings. A dedicated shipping screen in wp-admin is planned but has not shipped yet, so today the values are set through that endpoint or by updating the option directly.

Key	Description
poczta_enabled	Turns the Poczta Polska provider on
poczta_login	Login for the eNadawca system
poczta_password	Password for the eNadawca system

You can obtain the access credentials by registering in the eNadawca system at poczta-polska.pl.

The option also accepts poczta_environment, poczta_default_service and poczta_cod_bank_account. Nothing reads them in this release, they are reserved for the unreleased label code covered under Labels and parcel machines below.

The provider counts as available only when poczta_enabled is on and both the login and the password are filled in. The emonitoring lookup itself is a public request, but the plugin does not call it until the credentials are in place.

Entering a tracking number

1. Open an order in WooCommerce > Orders
2. Below the shipping address, find the Shipment Tracking section
3. Set Carrier to Poczta Polska
4. Paste the waybill number into Tracking number
5. Leave Tracking URL empty to have it generated, or enter your own link to override it
6. Update the order

The generated link uses this format:

https://emonitoring.poczta-polska.pl/?numer={number}

Live tracking

Once the order has a carrier and a number, the Shipment Tracking box shows a Live preview with the carrier status and the shipment history read from the emonitoring service. The response is cached for 10 minutes, so opening the order repeatedly does not query Poczta Polska on every page load.

Refresh live tracking clears that cache for the order and reloads the screen with a fresh lookup. Use it when the parcel has just moved and the box still shows the previous event.

Where the tracking appears

Place	What is shown
Orders list	A Tracking column with the carrier and the number
Order screen	The Shipment Tracking box with live status, history and the refresh button
My account > Orders	A Track shipment row action
Order details and customer emails	A tracking box with status, carrier, number and a Track shipment button

The fulfillment module also adds the Packed, Shipped and Delivered bulk actions to the orders list, which is how the status side of a Poczta Polska shipment is driven.

Labels and parcel machines

Label generation and parcel machine search are written but not connected. PocztaPolskaProvider::generateLabel() and the pickup point lookup exist in the code, but nothing in wp-admin or the checkout reaches them, so there is no Generate label button, no bulk label action and no label download, and the waybill number is created in eNadawca (or another Poczta Polska tool) and pasted into the order by hand.

Technical requirements

Live tracking uses ordinary HTTPS requests, so no extra PHP extension is needed for what this module does today. Only the label code that nothing calls would need the PHP SOAP extension (ext-soap). You can check whether it is active:

phpinfo(); // Look for the "soap" section

Most PHP hosting providers have SOAP enabled by default.