Elbuz creates a GLS Poland parcel in your ADE Plus account right from the order card, prints the label, orders a courier and updates the status every 10 minutes. No retyping the recipient address in ADE.
When you need this:
- You ship in Poland under a GLS contract — recipient, address, weight and COD come from the order.
- The customer collects at a point — the GLS ParcelShop id goes into the waybill.
- No regular pickup — order a courier for the right date from the same waybill.
Where to start: ask GLS for WebAPI access → enter the ADE login in the GLS record.
What GLS Poland does in Elbuz
- Parcel from an order — to an address or a GLS ParcelShop, with COD, one at a time or in bulk.
- Label — a PDF, one label per A4 sheet.
- Courier pickup — for a date, with the number of parcels.
- Deleting a parcel — while it is in “Przygotowalnia”.
- Parcel statuses — from GLS Track&Trace every 10 minutes; your code table drives the parcel state and the order status.
Shipment confirmation and changing a parcel are done in ADE Plus.
How to connect GLS: ADE Plus and Track&Trace
What access you need from GLS
- ADE Plus login and password with WebAPI access. GLS turns on WebAPI for a user separately. Without it, sign-in is rejected with the reason “Użytkownik nie posiada dostępu do usług WebAPI” (the user has no access to WebAPI services).
- GLS Track&Trace API user — for statuses. Your GLS representative issues it; there is no sign-up on the developer portal.
GLS takes the sender address from your ADE Plus account profile: you don't enter it in Elbuz. WebAPI is described in the ADE Plus help, Track&Trace at developer.gls-poland.com.
Where to enter the access in Elbuz
Where: “External services and integrations”, “Delivery” group → the “GLS (Польша)” (GLS Poland) record.
1
User and Password2
Sender address hint3
GLS Track&Trace API login4
Sandbox environment- User and Password — the ADE Plus account login and password.
- The hint says the sender address is taken from the GLS account profile.
- GLS Track&Trace API login — the password for it goes into the Token field.
- Sandbox environment switch for test mode.
| Field | What to enter |
|---|---|
| “User”, “Password” | the ADE Plus login and password |
| “GLS Track&Trace API login” | the Track&Trace user; its password goes in the “Token” field |
| “Sandbox environment” | turn on for GLS test access; turn off for real work |
| “Active” | turn on |
If the Track&Trace user isn't entered, Elbuz tries to get statuses with the ADE login. “API server URL” and “API ver” are left empty for GLS.
There is no “Save” button: each field change is saved right away. After saving, the password and “Token” show as dots; an empty field doesn't erase them.
The “Service directories” block shows how many GLS ParcelShop points Elbuz knows. The list is shared by all stores and updated once a day; the “Update directories” button only checks how fresh it is.
How to create a GLS parcel from an order
The order's delivery method must be “GLS (PL)”. With the “GLS” method, the “Create waybill” link doesn't appear.
Where: order card → “Delivery” → “Create waybill”. If the form has been opened before, the link is called “Edit waybill”.
What the form fills in itself and what to check
1
Street and house2
GLS ParcelShop (id)3
Shipment description4
Cash on delivery: Money- Street and house number go to GLS as a single line.
- GLS ParcelShop (id) stays empty for delivery to the address.
- Shipment description is filled in from the order items.
- Cash on delivery from the recipient is set to Money.
| Field | Filled in from the start | What to check |
|---|---|---|
| “Last name”, “First name” | the customer from the order | GLS receives 40 characters |
| “Phone”, “E-Mail” | from the order | GLS requires a phone for ParcelShop delivery |
| “Postcode”, “City”, “Street”, “House” | the delivery address from the order, “House” empty | street and house go to GLS as one line, up to 40 characters; “Apartment” isn't sent to GLS |
| “GLS ParcelShop (id)” | the point the customer chose, if the order has one | a point id — the parcel goes to the ParcelShop; under the field are suggestions of points in the recipient's city |
| “Total weight, kg” | product weight × quantity | if empty, 1 kg goes into the parcel |
| “Shipment description” | the product category, or the list of products if there is none | GLS receives 25 characters |
| “Return delivery (recipient)” | “Money” for the order total if the order is unpaid and the payment is cash on delivery; otherwise “Not required” | paid by card but the payment isn't marked — set “Not required” |
The GLS form has no dimensions or declared value. Amounts are in złoty: if the order is in another currency, correct the COD amount manually. GLS sets its COD limit per customer.
The order number is printed on the label as a reference, up to 25 characters. The recipient is always in Poland.
ParcelShop suggestions come from the shared list of points. If there is no list, there are no suggestions either — enter the point id from the GLS map, and the parcel is still created.
What happens after “Create waybill”
- The parcel appears in ADE Plus under “Przygotowalnia” (preparation). Elbuz requests the label right away — that's how GLS assigns the parcel number.
- The parcel number goes into the “Delivery service: number” field, and you see “Waybill created, No.‹number›”. If GLS hasn't assigned a number yet, the field holds the ADE shipment number.
- A second parcel for the same order won't be created: “Waybill already exists: ‹number› — skipped.”
- If GLS refuses, you see “Error:” with the reason; the form values are saved in the order.
Parcels for dozens of orders at once — “Create waybill (shipping)” in the order list; more in bulk waybills.
Label and courier pickup
Where: order card → “View waybill”. At the top are “Status:” with GLS's text and the print button; below is “Courier pickup”. The window asks GLS for the status every time.
The print button opens the PDF label in a new tab, one label per A4 sheet. In “Shipments”, GLS labels print one at a time: row → “Print waybill”.
Ordering a GLS courier
You need this if your contract has no regular pickup.
- In “View waybill”, check “Pickup date”: it's set to tomorrow, and on Friday and weekends to Monday.
- Enter “Parcels, pcs” — how many parcels the courier collects.
- Click “Order a courier” → “Courier ordered”.
You don't choose pickup hours with GLS — the form has no “Pickup from” and “to” fields. GLS returns no request number; Elbuz asks GLS to email a request confirmation. GLS accepts one request per date, with pickup no earlier than the next business day.
Deleting a parcel
Where: order card → “View waybill” → “Delete waybill”; or “Shipments” → row → “Delete waybill”. You need the right to create waybills.
- Confirm “Delete waybill ‹number› at the carrier?”.
- GLS removes the parcel from “Przygotowalnia”, the number and tracking link disappear from the card → “Waybill deleted. You can ship the order again.”
You can delete only a parcel in “Przygotowalnia”. Once the shipment is confirmed in ADE Plus, the GLS API has no deletion: Elbuz shows “The carrier did not delete the waybill:” with the GLS response.
GLS parcel statuses
Elbuz asks GLS Track&Trace about each parcel every 10 minutes, up to 100 parcels per run. It tracks orders from the last 60 days and orders in the marked statuses. All parcels are visible in “Shipments”; the GLS status text is in Polish.
GLS status codes
Elbuz determines the parcel state from your code table and enters the GLS codes from the table below itself. A GLS event code looks like “3.124”; Elbuz takes the number before the dot — “3”.
Where: GLS connection → “Notification settings” → “Delivery statuses”, the “Code (name) on site (API)” column. Several codes — comma-separated.
| Your delivery status | GLS code | What it means |
|---|---|---|
| “Awaiting sender” | 0 | GLS has the parcel data; the parcel may or may not have been handed over |
| “On the way” | 1, 2 | left the sorting center, arrived at a center or a ParcelShop |
| “Handed to courier” | 11 | will be delivered today |
| “Delivered” | 3 | delivered; Elbuz stops asking GLS |
| “Refused” | 5 | returned to the sender |
Code 4 is “not delivered” for various reasons: the recipient wasn't there or refused to pay COD. Don't enter it anywhere: such parcels will be “Unknown” under the “Problems” filter, so you won't miss them.
GLS also sets code 3 when a parcel is delivered to a ParcelShop (3.124). Elbuz sees only “3”, so it treats the parcel as delivered as soon as it reaches the point. The full list of codes is at developer.gls-poland.com.
To have the order or payment status change by itself, fill in “Order statuses” and “Payment statuses” the same way. Mark order statuses in the “Order statuses for which to check the parcel status with the delivery service” block. The change is written to the order history: “Delivery status has changed: ‹code› ‹text› #‹number›”.
What stays in ADE Plus
- Shipment confirmation (potwierdzenie nadania) — the list of parcels the courier collects. Elbuz doesn't create it: parcels stay in “Przygotowalnia” and are confirmed in ADE Plus. GLS doesn't allow canceling a confirmation.
- Changing a parcel — in ADE Plus; from Elbuz you can only delete a parcel before the shipment is confirmed and create it again.
- Shipping abroad — Elbuz creates GLS parcels only for recipients in Poland.
The “Track on carrier site” button in “Shipments” answers for GLS with “This carrier has no public tracking page.”
Scenarios
First connection
Situation. You have a GLS contract and have been entering parcels into ADE Plus manually.
What to do. Ask your GLS representative to turn on WebAPI for your ADE login and issue a Track&Trace user. Enter both and the status codes, then create a parcel from the first order.
What you get. The parcel appears in “Przygotowalnia” in ADE Plus with a number, and its state shows in “Shipments”.
The customer chose a GLS ParcelShop
Situation. The customer wants to collect the parcel at a point near home.
What to do. In the form, pick a point from the suggestions under “GLS ParcelShop (id)” or enter the id from the GLS map. Check the recipient's phone.
What you get. The parcel goes to the ParcelShop, not to the address.
The day's shipments
Situation. 20 orders, courier on request.
What to do. Create parcels in bulk and print the labels. Confirm the shipment in ADE Plus, then order a courier for tomorrow for 20 parcels.
What you get. The courier collects the parcels from the confirmation list, and statuses arrive in Elbuz by themselves.
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…” in the waybill window | The ADE password isn't entered or “Active” is off | Enter the ADE Plus login and password, turn on “Active” (where to enter it) |
| The order card has neither “Create waybill” nor “Edit waybill” | The delivery method is “GLS”, not “GLS (PL)” | Change the delivery method to “GLS (PL)” |
| “Error: GLS: login/password is not configured” | The ADE login or password isn't entered — only “Token” is filled in | Fill in “User” and “Password” |
| “Error:” with a WebAPI sign-in refusal | GLS hasn't turned on WebAPI for your ADE login | Have GLS enable WebAPI access for the login (GLS access) |
| “Error: postcode is required for recipient” (or name, city, street) | The order has no recipient address or name | Enter them in the waybill form |
| “View waybill” shows no status, and “Shipments” shows “Not tracked” | GLS provides statuses to the Track&Trace user, and it isn't entered or the password in “Token” is wrong | Get the user from your GLS representative and enter the login and password (connection fields) |
| GLS parcels are “Unknown” in “Shipments” | The GLS code isn't entered in “Delivery statuses” — or it's code 4, “not delivered” | Enter the codes (status codes); sort out code 4 with the recipient |
FAQ
How much does the GLS integration cost?
Elbuz charges nothing for parcels, courier pickup or statuses. You pay GLS for parcels under your own contract.
Where do I set the sender address for GLS?
In your ADE Plus account profile. GLS takes it from there for every parcel from Elbuz.
Why is a parcel from Elbuz sitting in “Przygotowalnia”?
That's by design: Elbuz creates the parcel and label, and you confirm the courier list in ADE Plus (shipment confirmation).
Why the “Token” field if I enter a login and password?
“Token” holds the Track&Trace user's password — separate access for statuses. The ADE Plus login and password go in “User” and “Password”.
Can I ship GLS abroad?
No: in a parcel from Elbuz, the recipient is always in Poland. Arrange international shipments in ADE Plus.
Why does the status in Elbuz lag behind GLS?
Elbuz asks GLS every 10 minutes and takes up to 100 parcels per run. “View waybill” shows the current status.
Where to find it and who has access
- Menu
- Account → System settings → Other settings → External services and integrations → Delivery
- Other ways in
- Directories → Documents → Shipments → “Delivery services”; order card → “Delivery” section
- Access right
- connection — “API & access tokens”; parcel and courier — the “Delivery waybill creation” window; statuses — “Shipments”
- Prepare
- a contract with GLS Poland, an ADE Plus login with WebAPI access, a Track&Trace API user
A parcel and courier can be arranged only for an order the user can see under the “Data scope” setting.
- Get WebAPI and Track&Trace accessGLS representative
- Enter the ADE login and the Track&Trace userExternal services and integrations → GLS
- Enter the GLS status codesSame place, “Notification settings”
- Create a parcelOrder card, “Delivery” section
- Delete the parcel if needed“View waybill” or “Shipments”
- Confirm the shipmentADE Plus
Related topics
- If you need to see parcels from all carriers in one list — Shipments.
- If you need parcels for dozens of orders — bulk waybills.
- If you don't have your own GLS contract — Apaczka ships GLS parcels under its own.
- If you ship with another carrier — how to create a waybill from an order.
