↑↓ selectEnter openEsc close

    1. Elbuz
    2. Delivery services in Elbuz

    Wysyłam z Allegro in Elbuz: labels and statuses for Allegro orders

    4 min readUpdated

    Elbuz creates a “Wysyłam z Allegro” label (Allegro's shipping service) for an Allegro order. The recipient, point and cash on delivery come from the order; you enter the weight and dimensions.

    When you need this:

    • You process Allegro orders in Elbuz — create the label from the order card, without Sales Center.
    • The buyer chose a pickup point or parcel locker on Allegro — the carrier and point are already in the order.
    • You ship under your own InPost or DPD contract — Elbuz still tracks the number added to the Allegro order.

    Where to start: connect your Allegro account and turn on the “Wysyłam z Allegro” record.

    What Wysyłam z Allegro does in Elbuz

    • A label from an Allegro order — the sender, recipient, pickup point and cash on delivery come from Allegro.
    • PDF printing — from the order card and from the “Shipments” register.
    • Parcel statuses — every 10 minutes, also for numbers added to the order outside Elbuz.
    • No separate key — it uses the access of the Allegro account that already imports your orders.

    How to connect: your Allegro account instead of a key

    You don't need a separate key. Elbuz uses the access of the Allegro account that already imports your orders; how to connect it is covered in the article on connecting Allegro.

    Where: “External services and integrations” → “Delivery” group → “Wysyłam z Allegro”.

    1. Make sure “Active” is on.
    2. Leave the “Token” field empty: it's only for a manual sandbox token together with “Sandbox environment”.
    Setup window for the Wysyłam z Allegro delivery service
    1Active
    2Hint: no separate key is needed
    3Token (empty)
    1. Active — switches the delivery service on.
    2. The hint explains that no separate key is needed: the connected Allegro account is used.
    3. Token — left empty; it is only for a manual sandbox token.

    Sender address

    Elbuz doesn't set the sender address: Allegro takes it from the Wysyłam z Allegro address book in Sales Center. Allegro uses the default address, or the courier pickup address if there's no default.

    Delivery type in the order

    A label is created for an order with the “Wysyłam z Allegro” delivery type. To have it set automatically, map Allegro's delivery methods to “Wysyłam z Allegro” in the “Delivery types” window of the Allegro import template. Otherwise, choose the delivery type in the order card manually.

    How to create a label for an Allegro order

    Where: order card → “Delivery type” = “Wysyłam z Allegro” → “Delivery” section → “Create waybill” (“Edit waybill” if the form has been opened before).

    The form has no recipient or cash on delivery fields: Allegro takes them from the order. Elbuz calculates “Total weight, kg” from the order's products and uses 1 kg if there's no weight. Enter the dimensions yourself, otherwise the ones Allegro suggested stay.

    Waybill window for Wysyłam z Allegro with shipment parameters
    1Data taken from the Allegro order
    2Total weight, kg
    3Length, Width, Height
    4Create waybill (not pressed)
    1. The recipient, pickup point and cash on delivery come from the Allegro order; the sender comes from the Allegro address book.
    2. Total weight of the parcel in kilograms.
    3. Parcel dimensions: length, width and height in centimetres.
    4. Button that creates the waybill in Allegro.

    What happens after “Create waybill”

    1. Elbuz checks that the order doesn't have a number yet: a double click won't create a second label.
    2. It gets a ready shipment template from Allegro: the sender from the address book, the recipient, pickup point and cash on delivery from the order.
    3. It adds the weight, the dimensions you entered and the Elbuz order number as a reference; the label format is PDF.
    4. It sends the create command and waits up to 15 seconds for Allegro to complete it.
    5. It writes the carrier's number to the “Delivery service: number” field and stores the Allegro shipment ID separately — printing works by it.

    If Allegro hasn't assigned a carrier number yet, the field holds the Allegro shipment ID. Printing and statuses work with it too. The “Shipment description” isn't sent to Allegro.

    Limits, cash on delivery and payment

    Allegro Delivery limits
    DestinationDimensionsWeight
    Parcel locker or pickup pointS 8 × 38 × 64, M 19 × 38 × 64, L 41 × 38 × 64 cmup to 20 kg
    Courierup to 120 × 60 × 60 cm, sum of sides up to 220 cmup to 31.5 kg

    Other carriers have their own limits. Cash on delivery is up to 6,000 zł; the money arrives through Allegro Finance no later than two business days after delivery.

    Allegro charges for the label by non-cash payment after the service is provided and issues an invoice. Under your own carrier contract, you pay the carrier directly.

    Printing and canceling a label

    “Print” next to the number in “View waybill” or “Print waybill” in “Shipments” opens an A4 PDF label with a cut line. Elbuz downloads it from Allegro itself.

    Elbuz can't print a label for a number created outside Elbuz: it has no shipment ID. Print such a label in Wysyłam z Allegro.

    You can't cancel a label from Elbuz — only in Wysyłam z Allegro. Allegro doesn't cancel Allegro One parcels, or parcels already picked up by the courier or dropped off at a parcel locker.

    How Elbuz tracks the parcel

    Every 10 minutes, Elbuz finds the carrier of the number in the Allegro order and gets the latest parcel status from Allegro. This also tracks numbers you added to the Allegro order outside Elbuz.

    Conditions: the order came from Allegro, the number was added to it in Allegro and is in the “Delivery service: number” field, and the delivery type is “Wysyłam z Allegro”. Elbuz polls the parcel until the order is 60 days old or while it's in a checked status.

    Elbuz enters the Allegro codes from the table below into the “Delivery statuses” window of the “Wysyłam z Allegro” 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.

    Allegro codes for the “Delivery statuses” window
    Elbuz delivery statusAllegro codeWhat it means
    Awaiting senderPENDINGwaiting to be shipped
    On the wayIN_TRANSITin transit
    Handed to courierRELEASED_FOR_DELIVERYthe courier is delivering to the recipient
    At destinationAVAILABLE_FOR_PICKUP, NOTICE_LEFTwaiting at the pickup point; the courier left a notice
    DeliveredDELIVEREDhanded over or picked up at the point
    RefusedRETURNEDreturned to the sender

    The ISSUE code means the parcel was refused or lost — check it in Wysyłam z Allegro. Allegro doesn't return the history of parcels older than 60 days.

    For Allegro, the “Track on carrier site” button reports that there's no public page. The buyer sees the status on the śledzenie paczki (parcel tracking) page.

    Scenarios

    Ship an Allegro order under Allegro's contract

    The order came from Allegro with the “Wysyłam z Allegro” delivery type. Open “Create waybill”, enter the weight and dimensions, and click “Create waybill”. Print the label from the card or from “Shipments”.

    Ship under your own contract and track in Elbuz

    You created the label on the carrier's website and added the number to the Allegro order. Enter the same number in the order's “Delivery service: number” field in Elbuz — the status will come through Allegro.

    What to do when something goes wrong

    Common problems
    What you seeWhyWhat to do
    “Error: Allegro: the order did not come from Allegro (no Allegro order id)” The order wasn't created by an Allegro import Choose another delivery service for this order (delivery type)
    “Error: Allegro: account is not connected (no token)” The Allegro account isn't connected, or its access has expired Reconnect the account (connecting Allegro)
    “Error: Allegro: empty delivery proposal” Allegro didn't return a shipment template for this order Check the order in Sales Center: whether it's canceled or already shipped
    “Error: Allegro: shipment is still being created (IN_PROGRESS)” Allegro didn't create the shipment within 15 seconds Check in Wysyłam z Allegro: if there's a label, enter its number in the order manually
    The print tab shows “print error: Allegro: shipment id is unknown for …” The number wasn't created in Elbuz Print the label in Wysyłam z Allegro (printing)
    The state in “Shipments” is “Unknown” Allegro's codes aren't entered in “Delivery statuses” Enter the codes from the table (statuses)

    FAQ

    How much does Wysyłam z Allegro cost in Elbuz?

    Elbuz doesn't charge anything. You pay Allegro for the label at its rates, or the carrier under your own contract (payment).

    Can I create an Allegro label for an order from my website?

    No, only for orders that came from Allegro: Allegro builds the shipment template from its own order.

    Can I change the pickup point in Elbuz?

    No, Elbuz doesn't send the pickup point: Allegro takes it from the buyer's order.

    Why doesn't a status arrive for a number I entered manually?

    The number must also be added to the order in Allegro: that's where Elbuz looks for the carrier. Also check that the delivery type is “Wysyłam z Allegro”.

    Can I call a courier from Elbuz?

    No, there's no courier call button for Wysyłam z Allegro. Order a pickup in Wysyłam z Allegro.

    Where to find it and who has access

    Menu
    Account → System settings → Other settings → External services and integrations → Delivery → Wysyłam z Allegro
    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 connected Allegro account; the sender address in the Wysyłam z Allegro settings
    1. Connect your Allegro accountAllegro import template
    2. Set the sender addressSales Center → Wysyłam z Allegro
    3. Create a labelOrder card, “Delivery” section
    4. Print the label“View waybill” or “Shipments”

    Related topics

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free