Elbuz creates an InPost shipment from the order: the locker comes from the address, the tracking number lands in the order, the label prints from the card.
When you need this:
- Buyers pick a locker on the website or marketplace — the point code from the address fills the form.
- Payment on delivery — the cash-on-delivery (pobranie) amount is the order amount.
- The parcel doesn't fit a locker — the same entry ships it by InPost courier.
- Where is the parcel — the InPost status updates every 10 minutes in the order and “Shipments”.
Where to start: a ShipX token from Manager Paczek → token and organization ID into Elbuz.
What InPost can do in Elbuz
- A shipment from the order — to a locker or by courier, with cash on delivery and declared value.
- Locker selection — by the point code in the order address or with the “Province” → “City” → “InPost point” lists.
- PDF label — from the order card and from the “Shipments” register, without signing in to Manager Paczek.
- Parcel statuses — every 10 minutes; an order in a marked status moves to your status by itself.
How to connect InPost: ShipX token and organization ID
Where to get the ShipX token and organization ID
The token gives Elbuz access to your organization in InPost: shipments, labels and points. You create it in Manager Paczek.
- Sign in to Manager Paczek and open “Moje Konto” (My account).
- Check that your company details and invoice details are filled in: without them the token isn't created.
- On the API tab, expand “API ShipX” and click “Generuj” (Generate). Lockers alone don't need a contract number; for the courier, InPost asks for the client number from the courier contract.
- Copy the token with the “Pokaż token” (Show token) button. The organization ID appears on the “Ustawienia organizacji” (Organization settings) tab.
InPost's step-by-step guide with pictures — instrukcja konfiguracji API ShipX (PDF, in Polish).
Where to enter the token in Elbuz
Where: “External services and integrations” → “Delivery” group → InPost.
- Turn on “Active”.
- Paste the token into the “Token” field. A saved key is shown as dots; an empty field doesn't erase it.
- Enter the “Organization ID” in the “InPost (ShipX) parameters” block. Without it, no shipment is created.
- Choose the “Sending method”: “Parcel locker (Paczkomat)”, “Courier pickup (dispatch order)” or “Drop-off point (POP)”. With “Default (from the contract)”, InPost uses the method from your contract.
1
Token2
Organization ID3
Sending method4
Sandbox environment- Token — the organization token is entered here and shown as dots once saved.
- Organization ID — the ID from the Parcel Manager account.
- Sending method — how parcels are handed over; the default comes from the contract.
- Sandbox environment — switch for testing against the InPost test environment.
The form saves itself on every field change; there's no “Save” button. The token isn't checked on save: the first waybill will show a key error.
“Sandbox environment” switches Elbuz to the ShipX sandbox. It needs a separate token from Sandbox Manager; sandbox parcels don't go anywhere.
Elbuz gets the list of lockers itself, no key needed. The “Service directories” table in the entry shows how many points there are and when they were updated; updates run nightly.
How to ship an order with InPost
Where: order card → “Delivery type” = InPost → “Delivery” section → “Create waybill” (“Edit waybill” if the form was opened before).
The form takes the recipient, amount and weight from the order. You only need to check the point, size and cash on delivery.
1
Shipping method2
InPost point3
Parcel size4
Return delivery (recipient)5
Create waybill button- Shipping method — Parcel locker (Paczkomat) is selected.
- InPost point — province, city and pickup point lists.
- Parcel size — sizes A, B and C; B is selected.
- Return delivery (recipient) — cash on delivery amount collected from the recipient.
- Create waybill — sends the request to InPost (not pressed here).
Locker: point and size
Elbuz looks for a locker code in the order address (like KRA01A or POP-WAW762) and matches it against the InPost directory. If found, the province, city and point are already selected in the form.
If not, choose the point with the “Province” → “City” → “InPost point” lists. The list has only working points that hand out parcels.
| Size | Dimensions with packaging | Weight |
|---|---|---|
| A | 8 × 38 × 64 cm | up to 25 kg |
| B (default) | 19 × 38 × 64 cm | up to 25 kg |
| C | 41 × 38 × 64 cm | up to 25 kg |
For a locker, the recipient's phone and e-mail are required: InPost sends the pickup code there. Elbuz trims the phone to 9 digits and drops the +48 code.
InPost courier to an address
Choose “InPost courier”: instead of the point, an “Address” block appears (“City”, “Postcode”, “Street”, “House”) along with the dimensions “Length, cm”, “Width, cm”, “Height, cm”. Without dimensions, Elbuz sends 30 × 20 × 10 cm.
Under the contract, the InPost courier takes a parcel up to 50 kg, with the longest side up to 120 cm and the sum of sides up to 220 cm. The recipient must be in Poland.
Cash on delivery and declared value
“Return delivery (recipient)” is set to “Money” if the order isn't paid and payment is on delivery. The amount is the order amount without currency conversion: if the order isn't in złoty, enter the amount in zł in the “Amount” field.
Cash on delivery to a locker is up to 5,000 zł. InPost transfers the money to the account from the contract or Manager Paczek within five business days after payment.
“Declared cost” in zł is the amount InPost insures the parcel for, at its rates.
What happens after “Create waybill”
- Elbuz checks that the order doesn't have a number yet: a double click won't create a second waybill.
- It sends the shipment to InPost and waits up to 12 seconds for the tracking number: InPost doesn't assign it right away.
- It writes the number to the “Delivery service: number” field, and the “Create waybill” link disappears from the card.
If there's no number after 12 seconds, the order gets InPost's internal shipment ID — a short number. Statuses and printing work with it too.
The form remembers what you entered in the order: close the window and the values stay. To create waybills for several orders at once, use “Create waybill (shipping)” in the order list; the point comes from the address, and the size is B.
Label printing and cancellation
“Print” next to the number in the waybill view, or “Print waybill” in “Shipments”, opens the PDF label. Elbuz downloads it from InPost itself: the token never reaches the browser, and you don't need to sign in to Manager Paczek.
InPost labels print one at a time: printing several with one button works only for Nova Poshta.
You can't cancel or change an InPost shipment from Elbuz. Cancel it in Manager Paczek and clear the number in the order's “Delivery service: number” field by hand — then you can create the waybill again.
How Elbuz tracks an InPost parcel
Every 10 minutes Elbuz asks InPost about parcel states — up to 100 waybills per pass, starting with those not checked for the longest time. InPost returns the status name in Polish, as on its website: «Umieszczona w automacie Paczkomat (odbiorczym).» (placed in the pickup Paczkomat).
Elbuz enters the InPost codes from the table below into the “Delivery statuses” window of the InPost entry itself — by them “Shipments” shows “At pickup point”, “Delivered” or “Refused”. A code not in the table gives the “Unknown” state. How to mark the order statuses that change by themselves — see the article on carrier statuses.
| Elbuz delivery status | InPost codes | State in “Shipments” |
|---|---|---|
| Awaiting sender | created, confirmed | Created |
| Picked | dispatched_by_sender, taken_by_courier, dispatched_by_sender_to_pok | Created |
| On the way | adopted_at_sorting_center, sent_from_sorting_center, adopted_at_target_branch | In transit |
| Handed to courier | out_for_delivery, out_for_delivery_to_address | In transit |
| At destination | ready_to_pickup, ready_to_pickup_from_pok, pickup_reminder_sent | At pickup point |
| Delivered | delivered | Delivered |
| Refused | rejected_by_receiver, returned_to_sender, pickup_time_expired | Refused |
Codes are entered comma-separated in the “Code (name) on site (API)” column; a cell holds up to 80 characters, so use the main codes, not all 53.
1
Code (name) on site (API)2
At destination3
Delivered- Code (name) on site (API) — the InPost status codes that Elbuz maps to each delivery status.
- At destination — the parcel is ready for pickup: ready_to_pickup, ready_to_pickup_from_pok and pickup_reminder_sent.
- Delivered — only the delivered code is mapped to this status.
Elbuz polls a parcel until the order is 60 days old or while it's in a marked status; a code from the “Delivered” state stops polling earlier. The order, delivery and payment status changes only in orders with marked statuses; for the rest, only the parcel state is updated.
A parcel waits 48 hours in a locker and 72 in a PaczkoPunkt. After 36 hours InPost reminds the recipient; if it isn't picked up, the parcel goes back to the sender.
In “Shipments”, the “Track on carrier site” button opens inpost.pl/sledzenie-przesylek with the parcel number, and “SMS to recipient” opens a message window for the customer.
Scenarios
Daily orders to lockers
The buyer chooses a locker on the website, and the point code arrives in the order address. Check the orders in the list → “Create waybill (shipping)”: waybills are created in bulk with size B. Print the labels from “Shipments”.
Cash-on-delivery orders
The order isn't paid and payment is on delivery — the form sets “Money” and the order amount by itself. When the buyer picks up the parcel, the state in “Shipments” becomes “Delivered”, and InPost transfers the money under the contract.
A large parcel by courier
Choose “InPost courier”, check the address, enter the weight and dimensions. Remember the courier limit: up to 50 kg and 220 cm for the sum of sides.
What to do when something goes wrong
| What you see | Why | What to do |
|---|---|---|
| “The delivery service is not connected: fill in its API settings…” | The InPost entry has no token, or “Active” is off | Enter the token and turn the entry on (where to enter the token) |
| “Error: organization_id is required (API settings)” | The organization ID isn't entered | Get it in Manager Paczek, the “Ustawienia organizacji” tab (where to get it) |
| “Error: email is required for recipient (parcel locker)” | The order has no recipient e-mail, and the locker needs one | Enter the e-mail in the form's “E-Mail” field (locker) |
| “Error: target_point is required (parcel locker)” | No point is selected, and the locker code in the address wasn't recognized | Choose “Province” → “City” → “InPost point” (locker) |
| The “Province” and “InPost point” lists are empty | The point directory hasn't been updated for more than three days | Write to Elbuz support: without the directory you can't choose a locker point |
| The state in “Shipments” is “Unknown” | InPost returned a code that isn't in the table, or the code was deleted from “Delivery statuses” | Add the code to the right status (statuses) |
FAQ
How much does the InPost integration cost?
Elbuz charges nothing for shipments, labels and statuses. You pay InPost for shipments at its price list or under your contract.
Do I need a contract with InPost?
For lockers, the token is created in a Manager Paczek account with your company details. For the courier, InPost asks for the client number from the courier contract (ShipX token).
Why is there a short number in the order instead of a tracking number?
InPost didn't assign the number within 12 seconds, so Elbuz saved the internal shipment ID. Statuses and printing work with it too (after creation).
Can I call an InPost courier from Elbuz?
No, there's no courier call button for InPost. How you hand over parcels is set by the “Sending method” in the InPost entry; courier pickup is ordered in Manager Paczek.
Can I send an InPost parcel abroad?
No, Elbuz creates InPost shipments only for recipients in Poland.
Statuses come in Polish — is that expected?
Yes, the status name comes from InPost. Elbuz shows the state in “Shipments” and your delivery status in the interface language, by code (InPost codes).
Where to find it and who has access
- Menu
- Account → System settings → Other settings → External services and integrations → Delivery → InPost
- Other entry points
- Directories → Documents → Shipments → “Delivery services”; order card → “Delivery” section
- Access right
- connection — “API & access tokens”; waybill — “Delivery waybill creation”; parcels — “Shipments”
- Prepare
- a Manager Paczek account with your company details; for the courier — a contract with InPost
- Create a ShipX token and get the organization IDManager Paczek
- Enter the token and organization IDExternal services and integrations → InPost
- Enter InPost codes in “Delivery statuses”Same place, “Notification settings”
- Create a shipmentOrder card, “Delivery” section
- Print the labelView waybill or “Shipments”
Related topics
- If you want to see parcels of all services in one list — the “Shipments” register.
- If the order came from Allegro and must ship with an Allegro label — Wysyłam z Allegro in Elbuz.
- If you need waybills for dozens of orders — waybills in bulk.
- If the order status should change by itself with the parcel status — carrier statuses.
