Elbuz creates an ORLEN Paczka parcel from an order: the locker or point code comes from the order, the PDF label prints from the card, and Elbuz checks the parcel status every 10 minutes.
When you need this:
- Customers pick up parcels from lockers and ORLEN gas stations — the point from the order is already in the waybill form.
- The order has no point code — the recipient's city points appear under the field.
- You ship many parcels a day — call an ORLEN Paczka courier from “View waybill”.
Where to start: get a PartnerID and PartnerKey → enter them and the sender address in Elbuz.
What ORLEN Paczka does in Elbuz
- A parcel from an order — to a parcel locker, an ORLEN gas station or a partner point.
- Point suggestions — a list of points in the recipient's city right under the code field.
- PDF label — from the order card and from the “Shipments” register.
- Courier pickup — in the time window ORLEN Paczka offers for your postcode.
- Parcel statuses — every 10 minutes; an order in a checked status moves to your status automatically.
How to connect ORLEN Paczka: PartnerID and PartnerKey
Where to get a PartnerID and PartnerKey
ORLEN Paczka opens its API to business customers under a contract. Fill in the form on the Integracja z ORLEN Paczka page, and a representative will contact you.
- Production credentials arrive by email when the contract is activated.
- Test environment credentials are separate; your opiekun handlowy (account manager) provides them.
- The PartnerKey is the same as your WebTrucker password: if you change the password, update it in Elbuz too.
Where to enter the credentials in Elbuz
Where: “External services and integrations” → “Delivery” group → “ORLEN Paczka”.
- Turn on “Active”.
- Enter the PartnerID in “User” and the PartnerKey in “Password”.
- Choose the “Default size (S, M, L)”.
- Fill in the “Sender” block: company name, postcode, city, street, building, phone and email. All seven fields are required; the address is printed on the label.
1
User (PartnerID) and Password (PartnerKey)2
Default size (S, M, L)3
Sender block- User and Password hold the PartnerID and PartnerKey issued by the ORLEN Paczka sales representative.
- Default size sets the parcel size (S, M or L) that new waybills start with.
- The Sender block holds the company name, address, phone and e-mail printed as the sender on waybills.
The form saves itself whenever a field changes. The credentials aren't checked when saved: the first waybill will show an error.
“Sandbox environment” switches Elbuz to the ORLEN Paczka test server; parcels from it aren't shipped and can't be tracked on the ORLEN website. Elbuz downloads the list of points itself every night — it's the “ORLEN Paczka points” row in the “Service directories” table.
Parcel size
| Size | Dimensions | Weight |
|---|---|---|
| S | 8 × 38 × 60 cm | up to 20 kg |
| M (default) | 19 × 38 × 60 cm | up to 20 kg |
| L | 41 × 38 × 60 cm | up to 20 kg |
The waybill form fills in the size from the carrier record itself. For a parcel of another size, choose it in the form's “Size (max. dimensions, cm)” field — you don't need to change the carrier record.
How to ship an order to an ORLEN Paczka point
Where: order card → “Delivery type” = “ORLEN Paczka” → “Delivery” section → “Create waybill” (“Edit waybill” if the form has been opened before).
The form takes the recipient and the point from the order. ORLEN Paczka delivers only to points, so the waybill won't be created without a point code.
1
ORLEN Paczka point (code)2
Size (max. dimensions, cm)3
Create waybill- The pickup point code the parcel is delivered to, taken from the order.
- The size of this parcel; by default it comes from the carrier connection record.
- Create waybill sends the request to ORLEN Paczka (not pressed while capturing).
Pickup point
If the customer chose a point on the website, its code is already in the “ORLEN Paczka point (code)” field. If not, and the order has a city, start typing: a list of that city's points with code, type and address appears under the field.
There are four point types: parcel locker (APM), ORLEN gas station (PKN), staffed point (PPP) and PointPack partner point (PPK). There are over 15,000 of them, including 8,000 lockers.
Recipient
First name, last name and phone are required. Elbuz removes spaces and symbols from the phone and drops the leading 48 from an 11-digit number — 9 digits must remain. First and last name — up to 30 characters.
ORLEN Paczka sends the pickup code by SMS or email, so it's better not to delete the email.
ORLEN Paczka stopped accepting cash on delivery on January 2, 2025, and parcel insurance on December 4, 2024. That's why the form has no “Return delivery (recipient)”, and orders paid on delivery go without cash on delivery — both one at a time and in bulk.
What happens after “Create waybill”
- Elbuz checks that the order doesn't have a number yet and that the credentials, sender and point are filled in.
- It creates the parcel in ORLEN Paczka with the size from the form and the order number.
- It writes the parcel number to the “Delivery service: number” field.
ORLEN Paczka doesn't receive the weight or description from the form. If the selected point is closed, ORLEN replaces it with an active one itself: the waybill is created, and the “Waybill created” window shows the new point's code.
The parcel must be handed over to the ORLEN Paczka network within 14 days, otherwise the label is canceled automatically.
Printing and canceling a label
“Print” next to the number in “View waybill” or “Print waybill” in “Shipments” opens the PDF label. Elbuz downloads it from ORLEN Paczka itself; the credentials never reach the browser.
Drop the parcel off at an ORLEN Paczka point during its opening hours or hand it to a courier. PointPack points only hand out parcels.
You can't cancel a parcel from Elbuz — only in your ORLEN Paczka account, before it's handed over. After canceling, clear the number in the “Delivery service: number” field to create the waybill again.
How to call an ORLEN Paczka courier
Where: order card → “View waybill” → “Courier pickup” block.
- Check the “Pickup date” — by default, the next business day.
- You can leave the “Pickup from” and “to” hours empty: Elbuz takes the window ORLEN Paczka offers on that date for the sender's postcode.
- Click “Order a courier”.
The pickup address is the “Sender” block of the carrier record. ORLEN Paczka returns a request number: it appears in the message and is saved to the order; the result is written to the order log. If there's no window on that date — “no courier pickup for ‹date›”, choose another date.
How Elbuz tracks the parcel
Every 10 minutes, Elbuz asks ORLEN Paczka about parcel states, one parcel at a time. ORLEN returns a status code and a name in Polish.
Elbuz enters the ORLEN Paczka codes from the table below into the “Delivery statuses” window of the “ORLEN Paczka” record itself — “Shipments” shows the parcel state by them. A code outside the table gives the state “Unknown”. How the code windows work is covered in the article on carrier statuses.
| Elbuz delivery status | ORLEN Paczka codes | What it means |
|---|---|---|
| Picked | 210, 240 | dropped off at a point or locker; picked up by the courier |
| At destination | 620, 690, 695 | ready for pickup; at the point; SMS sent to the recipient |
| Delivered | 1000 | picked up by the customer |
| Refused | 709, 750, 900 | not picked up in time; returning to the sender |
Code 201 means a canceled parcel. ORLEN Paczka uses the same codes during a return, and Elbuz reads only the code — so during a return, the state in “Shipments” may repeat the parcel's journey. ORLEN doesn't return history older than 90 days.
A parcel waits for the recipient for 3 business days, in a locker — 72 hours. Then it goes back to the sender at the sender's expense.
“Track on carrier site” in “Shipments” opens orlenpaczka.pl/sledz-paczke with the parcel number — you can give the customer the same link.
Scenarios
The customer chose a locker on the website
The locker code arrives in the order. Open “Create waybill”, check the recipient, click “Create waybill” and print the label. Drop the parcel off at an ORLEN Paczka point.
Evening courier pickup
Create waybills for all of the day's parcels. In one of them, open “View waybill” and call a courier for tomorrow without hours — ORLEN Paczka will offer a window itself.
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 record has no password (PartnerKey), or “Active” is off | Enter the credentials and turn on the record (where to enter them) |
| “Error: sender address, phone and email are required (API settings)” | At least one field in the “Sender” block is empty | Fill in all seven sender fields (sender) |
| “Error: ORLEN Paczka pickup point is required for recipient” | No point code is set | Choose a point from the list under the field (pickup point) |
| “Error: name is required for recipient” or “phone is required for recipient” | The order has no recipient name or phone | Add them in the form (recipient) |
| “Error: ORLEN Paczka: ‹code› ‹description›” | ORLEN Paczka rejected the parcel; the reason is in the description | Fix the data according to the error text and create the waybill again |
| The state in “Shipments” is “Unknown” | ORLEN Paczka codes aren't entered in “Delivery statuses” | Enter the codes (statuses) |
FAQ
How much does the ORLEN Paczka integration cost?
Elbuz doesn't charge anything for parcels, labels or statuses. You pay ORLEN Paczka for parcels under your contract.
Can I ship ORLEN Paczka to the customer's address?
No, ORLEN Paczka delivers only to points: parcel lockers, ORLEN gas stations and partner points.
Can I choose a size for a single parcel?
Yes: in the waybill form — the “Size (max. dimensions, cm)” field. By default, it has the size from the carrier record (size).
How long does a parcel wait at the point?
A few days, then ORLEN Paczka returns it to the sender (storage periods).
How can the customer track the parcel?
On the orlenpaczka.pl/sledz-paczke page, using the parcel number from the “Delivery service: number” field.
Where to find it and who has access
- Menu
- Account → System settings → Other settings → External services and integrations → Delivery → ORLEN Paczka
- Other entry points
- Directories → Documents → Shipments → “Delivery services”; order card → “Delivery” section
- Access right
- connection — “API & access tokens”; waybill and courier — “Delivery waybill creation”; parcels — “Shipments”
- Prepare
- a contract with ORLEN Paczka, a PartnerID and PartnerKey, a sender address with phone and email
- Get a PartnerID and PartnerKeyORLEN Paczka, contract
- Enter the credentials, size and senderExternal services and integrations → ORLEN Paczka
- Create a parcelOrder card, “Delivery” section
- Print the label, call a courierView waybill
Related topics
- If you need parcels from all carriers in one list — the “Shipments” register.
- If the customer needs cash on delivery — InPost in Elbuz or Poczta Polska in Elbuz.
- If the order status should change automatically with the parcel status — carrier statuses.
- If you need waybills for dozens of orders — waybills in bulk.
