InPost shipping and parcel lockers
The InPost shipping module adds two shipping methods for addresses in Poland: InPost Paczkomat (parcel locker) and InPost Courier. A shopper who chooses the parcel locker picks one from a list of the lockers nearest to their postcode, on the classic checkout and on the block checkout. No InPost account or API token is needed for this.
The module does not create shipments or print labels. Tracking with a ShipX token is in Polski PRO.
Enabling
Section titled “Enabling”- Go to Polski > Modules and turn on InPost shipping and parcel lockers (group “Checkout and Orders”). It is off by default.
- Go to WooCommerce > Settings > Shipping, open a zone that covers Poland and add InPost Paczkomat, InPost Courier or both.
Method settings
Section titled “Method settings”Each method has its own settings in the zone:
| Setting | Description | Default |
|---|---|---|
| Method title | The name the shopper sees at checkout | InPost Paczkomat / InPost Courier |
| Cost | Shipping cost | 0 |
| Tax status | Taxable or None | Taxable |
| Free shipping from | The method is free when the order subtotal after coupons reaches this amount, counted the same way as WooCommerce Free shipping. Empty: always charge the cost | empty |
| Maximum cart weight (kg) | The method is not offered above this weight. Empty: no limit | empty |
Both methods are offered only when the shipping country is Poland.
Choosing a parcel locker
Section titled “Choosing a parcel locker”When InPost Paczkomat is the selected rate, a Parcel locker field and a picker appear:
- The postcode from the checkout address is filled in, and the picker lists up to 10 nearest parcel lockers with address, location description and opening hours.
- The shopper can type another postcode and search again.
- Clicking a locker saves its code. With another rate selected, the field is hidden and not required.
On the block checkout the field sits under “Additional order information”; on the classic checkout the picker sits under the InPost Paczkomat rate in the order summary.
Validation
Section titled “Validation”When the order is placed, the locker code is checked:
- an empty code, or one that does not look like an InPost code, stops the order with an error,
- a code InPost does not know stops the order with “That parcel locker was not found”,
- if InPost cannot be reached, the order goes through and gets an order note asking you to check the code before shipping.
Where the locker shows
Section titled “Where the locker shows”The locker code and address are saved on the order (_polski_inpost_locker, _polski_inpost_locker_address) and shown:
- in the admin order screen, under the shipping address,
- in customer and admin emails (HTML and plain text),
- in My Account on the order page, and on the thank-you page.
InPost Points API
Section titled “InPost Points API”Locker searches go from your server, not from the shopper’s browser, to the public InPost Points API (api-pl-points.easypack24.net). Only a postcode or a locker code is sent. Results are cached for 12 hours, and searches are limited to 30 per minute per IP address. The REST route the picker uses is GET /wp-json/polski/v1/inpost/points?postcode=81-001 (or ?code=GDY144M).
Limits
Section titled “Limits”- No map: the InPost map widget needs a token tied to your domain from InPost Manager, so the picker is a list.
- No shipments, labels or tracking in the free plugin.
Uninstall
Section titled “Uninstall”Deleting the plugin (without the keep-data option) removes the method settings, the methods from shipping zones and the cached locker data. Saved locker codes on orders stay.