↑↓ selectEnter openEsc close

    1. Elbuz
    2. Delivery services in Elbuz

    Apaczka in Elbuz: waybills for multiple carriers under one contract

    5 min readUpdated

    Through Apaczka, Elbuz creates an InPost, DPD, DHL, GLS or other carrier parcel from the order card at Apaczka prices. It prints the label and updates the parcel status every 10 minutes.

    When you need this:

    • You have no carrier contract — parcels go under Apaczka's contract and prices.
    • The customer collects at a point — the carrier's point code goes into the waybill.
    • The customer pays on delivery — COD is set automatically, and Apaczka transfers the money to your account.

    Where to start: create an App ID and App Secret in the Apaczka panel → enter them in the Apaczka record in Elbuz.

    What Apaczka does in Elbuz

    • Waybill from an order — with the service chosen in the connection, to an address or a carrier point, with COD.
    • Label — a PDF from the order card or from “Shipments”.
    • Courier pickup — together with the waybill if the connection is set to “Courier picks up”; later — for DPD services, if Apaczka has enabled API pickups for you.
    • Canceling a waybill — until the carrier picks up the parcel.
    • Parcel statuses — every 10 minutes; your code table drives the parcel state and the order status.

    How to connect the Apaczka API

    Where to get the App ID, App Secret and service ID

    1. Sign in to the Apaczka panel and open “Ustawienia” (settings) → “API”.
    2. Create an API application and copy the App ID and App Secret.
    3. Find out the ID of the service you'll ship with: each service is a carrier plus a delivery method, for example a DPD parcel to an address.

    Each account has its own list of services, which Apaczka returns via the API (service_structure). If you don't know the service ID, ask Apaczka support. How to create the keys is described in the Apaczka API documentation.

    Apaczka charges parcels to a prepaid balance (“Moje konto” → “Doładuj konto”, i.e. My account → Top up) or invoices you if you've switched to postpaid (Apaczka PRO).

    Where to enter the keys in Elbuz

    Where: “External services and integrations”, “Delivery” group → the “Apaczka.pl” record.

    Apaczka.pl setup form: App ID and App Secret, service ID, parcel handover, COD bank account and sender block
    1User and Password
    2Default Apaczka service ID
    3Parcel handover
    4Bank account for cash on delivery
    5Sender
    1. User and Password — the App ID and App Secret from the Apaczka panel.
    2. Default Apaczka service ID — the service used when a waybill is created.
    3. Parcel handover — how the parcel gets to the carrier (here: you drop it off at a point).
    4. Bank account for cash on delivery — IBAN for COD payouts; leave empty to use the account's own.
    5. Sender — company, contact person, address, phone and e-mail; phone and e-mail are required.
    FieldWhat to enter
    “User”App ID
    “Password”App Secret
    “Default Apaczka service ID”the service ID; without it the waybill won't be created
    “Parcel handover”“I drop off at a point” (default) or “Courier picks up”. With “Courier picks up”, the courier is ordered together with the waybill: Elbuz takes the nearest day and window Apaczka offers for your postcode
    “Bank account for cash on delivery (IBAN, empty — from the account)”the account Apaczka transfers COD to; empty — the account from your Apaczka settings
    “Sender” blockname, contact person, postcode, city, street, house, phone, email; all except the contact person and house are required
    “Active”turn on

    “Token”, “API server URL” and “API ver” are left empty for Apaczka. There is no “Save” button: each field change is saved right away. After saving, the App Secret shows as dots; an empty field doesn't erase it.

    Elbuz has no test environment for Apaczka: every waybill is a real parcel at Apaczka rates. The keys aren't checked when you save; the first waybill will show any error.

    How to create an Apaczka waybill from an order

    The order's delivery method must be “Apaczka.pl”.

    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

    Waybill form for Apaczka.pl, filled in from order PLDOC-4
    1Recipient address
    2Carrier pickup point (code)
    3Total weight and dimensions
    4Shipment description
    1. Recipient address — taken from the order; postcode, city and street are filled in.
    2. Carrier pickup point (code) — fill in only for delivery to a point; empty for courier delivery.
    3. Total weight and dimensions — weight is pre-filled; length, width and height are entered by hand.
    4. Shipment description — pre-filled from the order's products.
    FieldFilled in from the startWhat to check
    “Last name”, “First name”, “Phone”, “E-Mail”the customer from the ordername — up to 50 characters; without a phone the waybill won't be created
    “Postcode”, “City”, “Street”, “House”, “Apartment”the delivery address from the order, “House” and “Apartment” emptyfor address delivery, postcode, city and street are required
    “Carrier pickup point (code)”the point the customer chose, if the order has onea point code of the carrier whose service is in the connection; with a code, the address is optional
    “Total weight, kg”product weight × quantityif empty, 1 kg goes into the waybill
    “Length”, “Width”, “Height”, cmemptyif empty, 30 × 20 × 10 cm is sent
    “Shipment description”the product category, or the list of products if there is noneApaczka receives 50 characters; if empty — “Towar” (goods)
    “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 form takes the service and sender from the connection; you can't choose another carrier for a single parcel. The order number goes into the parcel comment; the recipient is always in Poland.

    Amounts in the form are in złoty. If the order is in another currency, correct the COD amount manually. Apaczka transfers COD to your account within 1–10 business days (Apaczka terms).

    What happens after “Create waybill”

    • Apaczka creates a parcel order.
    • The carrier's parcel number goes into the “Delivery service: number” field, and you see “Waybill created, No.‹number›”. If the carrier hasn't assigned a number yet, the field holds the Apaczka order number; the label and courier pickup work with it too.
    • A second waybill for the same order won't be created: “Waybill already exists: ‹number› — skipped.”
    • If Apaczka refuses, you see “Error: Apaczka:” with the reason; the form values are saved in the order.
    • With “Courier picks up” and no Apaczka pickup window for the sender's postcode — “Error: Apaczka: no courier pickup window…”, no waybill. Switch to “I drop off at a point” or check the postcode.

    Waybills 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” → print button; or “Shipments” → row → “Print waybill”. The label opens as a PDF in a new tab; the App Secret never reaches the browser.

    Elbuz prints labels only for waybills created from Elbuz. For a number entered in the order manually, the tab shows “print error: Apaczka: order id is unknown…”.

    Ordering a courier through Apaczka

    With “Courier picks up”, no separate courier order is needed: the request goes with the waybill. The “Order a courier” button is for parcels created with “I drop off at a point”.

    Apaczka accepts API pickups only for DPD services, and only after Apaczka support enables them for your account (Apaczka documentation). For other carriers, order the courier in the Apaczka panel.

    1. In “View waybill”, check “Pickup date”: it's set to tomorrow, and on Friday and weekends to Monday.
    2. Leave “Pickup from” and “to” empty — Elbuz takes the first window Apaczka offers for the sender's postcode.
    3. Click “Order a courier” → “Courier ordered” and the request number, if Apaczka returned one.

    Canceling a waybill

    Where: order card → “View waybill” → “Delete waybill”; or “Shipments” → row → “Delete waybill”. You need the right to create waybills.

    1. Confirm “Delete waybill ‹number› at the carrier?”.
    2. Apaczka cancels the order, the number and tracking link disappear from the card → “Waybill deleted. You can ship the order again.”

    You can cancel until the carrier picks up the parcel. After that Apaczka refuses, and Elbuz shows “The carrier did not delete the waybill:” with its reason; the number stays in the order. Elbuz doesn't offer deletion for a parcel that tracking already shows as in transit, at a point or delivered.

    After cancellation, Apaczka no longer returns the label for this parcel. If you need the label, download it before canceling.

    Apaczka parcel statuses

    Elbuz asks Apaczka 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 status text is as the carrier gave it.

    Apaczka status codes

    Apaczka maps the statuses of all carriers to one list, and Elbuz uses that status as the code. Elbuz enters the codes from the table below into “Delivery statuses” itself.

    Where: Apaczka connection → “Notification settings” → “Delivery statuses”, the “Code (name) on site (API)” column. Several codes — comma-separated.

    Your delivery statusApaczka codeWhat it means
    “Awaiting sender”NEWthe order is created
    “On the way”PICKUP, IN_TRANSITthe parcel is picked up and on its way, out for delivery or at a point
    “Delivered”DELIVERED, DELIVERED_NO_SYSTEMdelivered; Elbuz stops asking Apaczka
    “Refused”RETURNED_TO_SHIPPERreturned to the sender

    Don't enter EXCEPTION, CANCELLED, CORRECTION or UNKNOWN: such parcels will be “Unknown” under the “Problems” filter. The list of statuses is in the Apaczka documentation.

    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›”.

    Until DELIVERED is entered under “Delivered”, Elbuz keeps asking Apaczka about a delivered parcel for the full 60 days.

    What stays in the Apaczka panel

    • Topping up the balance, invoices, the COD account — in your Apaczka account settings.
    • Courier for carriers other than DPD, and parcels abroad — in the Apaczka panel.

    The “Track on carrier site” button in “Shipments” answers for Apaczka with “This carrier has no public tracking page.”

    Scenarios

    First connection

    Situation. The store is just opening and has no carrier contracts.

    What to do. Sign up with Apaczka, top up the balance, create API keys and find out the service ID. Enter everything in the connection together with the sender's address, phone and email.

    What you get. The very first waybill from Elbuz is a real parcel at Apaczka prices.

    Parcel to a pickup point

    Situation. The connection has a delivery-to-point service, and the customer chose a point on the website.

    What to do. In the form, check “Carrier pickup point (code)”. The code must belong to the service's carrier.

    What you get. The parcel goes to the point; you can leave the recipient's address empty.

    COD to your own account

    Situation. COD money should go to a separate store account.

    What to do. Enter the IBAN in the connection's COD bank account field.

    What you get. Every COD waybill from Elbuz goes out with this account.

    What to do when something goes wrong

    Common problems
    What you seeWhyWhat to do
    “The delivery service is not connected: fill in its API settings…” in the waybill window The App Secret isn't entered or “Active” is off Enter the App ID and App Secret, turn on “Active” (where to enter them)
    “Error: Apaczka service ID is required (API settings)” The service ID isn't entered Fill in “Default Apaczka service ID” (service ID)
    “Error: sender address, phone and email are required (API settings)” The name, postcode, city, street, phone or email is empty in the “Sender” block Fill in the sender in the connection
    “Error: address or pickup point is required for recipient” There is neither a recipient address nor a point code Enter the address or “Carrier pickup point (code)”
    “Error: Apaczka:” with a refusal Apaczka didn't accept the order: wrong keys, a service not on your account, or a point code of another carrier Check the keys, service ID and balance in the Apaczka panel
    “print error: Apaczka: order id is unknown…” The number was entered in the order manually, not created from Elbuz Print the label in the Apaczka panel
    A refusal on “Order a courier” The service isn't DPD, or API pickups aren't enabled for the account Order the courier in the Apaczka panel or ask support to enable API pickups (courier pickup)
    Apaczka parcels are “Unknown” in “Shipments” The Apaczka code isn't entered in “Delivery statuses” Enter the codes (status codes)

    FAQ

    How much does the Apaczka integration cost?

    Elbuz charges nothing for waybills or statuses. Parcels are paid to Apaczka at its prices — from the balance or by invoice.

    Can I choose a carrier for a single parcel?

    No: all waybills from Elbuz use the service from the connection. For another carrier, use the Apaczka panel or a direct carrier connection, for example DPD Polska.

    Can I test the integration without real parcels?

    No: Elbuz works only with live Apaczka. Create the first waybill for a test order and cancel it with the “Delete waybill” button before the parcel is picked up.

    Can I cancel a waybill from Elbuz?

    Yes, until the carrier picks up the parcel: “View waybill” → “Delete waybill” (canceling).

    Why does the status in Elbuz lag behind Apaczka?

    Elbuz asks Apaczka 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”; waybill and courier — the “Delivery waybill creation” window; parcels — “Shipments”
    Prepare
    an Apaczka account with a topped-up balance, App ID and App Secret, a service ID

    A waybill can be created only for an order the user can see under the “Data scope” setting.

    1. Create an App ID and App SecretApaczka panel → Ustawienia → API
    2. Enter the keys, service ID and sender addressExternal services and integrations → Apaczka.pl
    3. Enter the status codesSame place, “Notification settings”
    4. Create a waybillOrder card, “Delivery” section
    5. Print the label“View waybill” or “Shipments”
    6. Cancel the waybill if needed“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