Comprehensive InPost Paczkomaty & Courier Integration Guide in Webito
InPost is Poland’s leading logistics operator and the global pioneer of Automated Parcel Lockers (Paczkomaty). With an extensive network of more than 22,000 self-service 24/7 parcel machines across Poland, over 85% of Polish online consumers prefer collecting their e-commerce orders from a nearby Paczkomat locker rather than waiting for home courier deliveries.
The Webito InPost Paczkomaty & Kurier plugin connects natively to the official InPost ShipX API v1, offering:
- Automated locker code selection (e.g.
WAW01A,KRA02M) and geolocation picker integration - Real-time dimensional tier classification (Gabaryt A, B, and C)
- Automated shipping label creation in standard PDF or Zebra thermal ZPL formats
- Live parcel tracking checkpoints and webhooks
1. InPost Dimensional Sizing Tiers (The Gabaryt System)
InPost strictly categorizes parcel locker shipments into three volume templates. Webito’s built-in sizing engine automatically computes the optimal Gabaryt tier from your products' dimensions (L x W x H) and weight:
| Dimensional Template | Maximum Dimensions (H × W × L) | Maximum Weight | Optimal Product Fit | Standard Base Rate |
|---|---|---|---|---|
| Gabaryt A (Small) | 8 × 38 × 64 cm (80 × 380 × 640 mm) | 25 kg | Books, cosmetics, jewelry, phone cases, small apparel | 13.99 PLN |
| Gabaryt B (Medium) | 19 × 38 × 64 cm (190 × 380 × 640 mm) | 25 kg | Footwear, electronics, folded sweaters, kitchenware | 16.99 PLN |
| Gabaryt C (Large) | 41 × 38 × 64 cm (410 × 380 × 640 mm) | 25 kg | Winter coats, backpacks, appliances, multi-item cartons | 19.99 PLN |
Important
Maximum Weight Restriction:
All InPost Paczkomaty locker compartments have a hard physical weight ceiling of 25 kg. Orders exceeding 25 kg are automatically routed to the door-to-door courier service (inpost_courier_standard).
2. Merchant Setup & ShipX API Credentials
To configure InPost on your Webito storefront:
- Register your merchant account in the InPost Parcel Manager (
manager.paczkomaty.pl). - Navigate to the API tab to retrieve your unique Organization ID and API Bearer Token.
Configuration Parameters in Webito:
| Admin Parameter Name | System Key | Required? | Description & Context | Production Example |
|---|---|---|---|---|
| Organization ID | organizationId | Yes | Your corporate account identifier in InPost ShipX | 778899 |
| ShipX API Token | apiToken | Yes (Secret) | Confidential Bearer token for authenticating ShipX calls | shipx_token_live_abc123 |
| Default Drop-off Paczkomat | defaultDispatchPoint | No | Locker code where your warehouse drops off parcels | KRA010 |
| Fallback Gabaryt Size | defaultTemplate | No | Default size if product dimensions are missing | small |
| Shipping Label Format | labelFormat | No | Label output type: pdf (standard A4/A6) or zpl (thermal rolls) | pdf |
| Sandbox Environment | sandbox | No | Connects to sandbox-api-shipx-pl.easypack24.net for testing | true / false |
3. Dispatch & Tracking Lifecycle Architecture
mermaidsequenceDiagram autonumber actor Customer as Shopper participant Storefront as Webito Storefront participant Plugin as InPost Plugin participant ShipX as InPost ShipX API participant Locker as Paczkomat Machine Customer->>Storefront: Selects Paczkomat (e.g. WAW01A) & completes order Storefront->>Plugin: dispatch(orderData, template: 'small') Plugin->>ShipX: POST /v1/organizations/{org_id}/shipments ShipX-->>Plugin: Generates tracking number (62...) & PDF waybill Storefront->>Storefront: Prints label & attaches to parcel Storefront->>Locker: Drops off parcel at local locker (KRA010) ShipX->>Plugin: Status update: dispatched_by_sender Locker->>Customer: SMS / Push: "Parcel ready for pickup with QR code" Customer->>Locker: Opens locker door via InPost Mobile App & takes parcel ShipX->>Plugin: Final delivery status: delivered
4. Tracking Status Mapping & Error Handling
| ShipX Checkpoint | Webito Status | Meaning & Merchant Action |
|---|---|---|
created | pending | Consignment registered; shipping label ready for printing. |
dispatched_by_sender | pending | Merchant deposited the parcel into the drop-off locker. |
collected_from_sender | in_transit | InPost courier picked up the package from merchant or locker. |
taken_by_courier | in_transit | Package is in the courier's delivery van on the final leg. |
ready_for_pickup | in_transit | Package placed inside target Paczkomat locker. 48-hour pickup clock begins. |
delivered | delivered | Recipient collected the parcel and closed the locker door. Order completed. |
returned_to_sender | returned | Recipient failed to collect parcel within 48 hours; return in progress. |