Elbuz works with the FedEx API through your key. The waybill, label and courier are done from the order card; parcel statuses update every 10 minutes.
When you need this:
- You ship from Poland or another EU country — address and country come from the order, no FedEx Ship Manager needed.
- You need the label right away — the PDF opens from the order card or from “Shipments”.
- Pickup from your address — request a FedEx courier from the waybill.
- “Where's my parcel?” — the FedEx status shows in the order and the parcel register.
Where to start: create an API project on developer.fedex.com → enter the keys in Elbuz.
What FedEx does in Elbuz
- Connection — API Key, Secret Key, FedEx account number and the FedEx test environment.
- Waybill from an order — recipient, address, weight and dimensions are filled in automatically.
- Label — a PDF within 12 hours of creating the waybill.
- Courier pickup — pickup date and hours; FedEx replies with a confirmation code.
- Parcel statuses — every 10 minutes; your code table drives order status changes.
How to connect the FedEx API: keys and account number
Where to get the FedEx API Key and Secret Key
- Sign in to developer.fedex.com with your FedEx account and create an organization in “My Projects”.
- “Add shipping accounts” → “+ Add Account”: the FedEx account number and the payer address.
- “+ Create API Project”: select Ship API, Track API and Pickup API, name the project and choose the shipping countries.
- Copy the keys: test keys on the “Test Key” tab, live keys on “Production key”.
FedEx shows the Secret Key only once. If you lose it, generate a new one and enter it in Elbuz.
The FedEx certification page requires label validation for the Ship API, including in Europe. Test labels and the Label Cover Sheet are sent to label@fedex.com; validation takes about 3 business days.
What to enter in Elbuz
Where: External services and integrations → Delivery → “FedEx”.
| Field | What to enter |
|---|---|
| “Active” | On — otherwise the FedEx waybill won't open |
| “User” | the project's API Key |
| “Password” | the project's Secret Key |
| “FedEx account number” | the 9-digit account FedEx charges for waybills and the courier |
| “Default service” | The service for all waybills (which to choose) |
| “Sandbox environment” | Turn on for test keys, turn off for live keys |
| “Sender” block | Company, contact person, ISO country code (empty — PL), postcode, city, street, house, phone, email. This is the sender address on the waybill and the pickup address |
| “Company” | Your company, if each has its own FedEx account; a company record takes priority over the general one |
1
User and Password2
FedEx account number3
Default service4
Sandbox environment5
Sender block- User and Password — the API Key and Secret Key of the developer.fedex.com project.
- FedEx account number — the account the waybills are created under.
- Default service — the FedEx service used when an order does not specify one.
- Sandbox environment — when on, requests go to the FedEx test environment.
- Sender — the company and address the parcels are shipped from.
The form saves itself as soon as you change a field. After saving, “Password” shows dots, and an empty field doesn't erase the key.
Elbuz doesn't check the keys when you save. The first waybill shows a key error: “FedEx OAuth: ‹FedEx text›”.
Which service to choose
| Service | When |
|---|---|
| FedEx Priority | Default; a FedEx domestic service in Poland |
| FedEx Priority Express | A FedEx domestic service in Poland |
| FedEx International Priority | Shipping abroad: delivery by end of day, usually in 1–3 business days |
| FedEx Economy Select | According to the FedEx reference, UK only; don't choose it for Poland |
There is one service for all waybills; you can't change it in the waybill form. If you ship both within Poland and abroad, switch the service before the waybill.
FedEx test environment
Turn on “Sandbox environment”, enter the keys from the “Test Key” tab and the test account number FedEx issues with the test key. Waybills go to the FedEx sandbox, with no real shipment. Before going live, turn the switch off and enter the live keys and account number.
How to create a FedEx waybill from an order
The general steps for all carriers are in how to create a waybill from an order.
Where: an order card with the “FedEx” delivery method → “Delivery” section → “Create waybill”.
What the form fills in itself and what to check
| Field | Source | What to check |
|---|---|---|
| Last name, First name, Phone, E-Mail | Order | Phone is required |
| Postcode, City, Street, House, Apartment | The order's delivery address: the whole address goes in “Street”, “House” and “Apartment” are empty | Street, house and apartment together — up to 35 characters; Elbuz truncates anything longer |
| Country (ISO code: DE, FR, IT, ES…) | The order's delivery country | Not recognized — the sender's country |
| Total weight, kg | Weight of the order's products | No weight on the products either — 1 kg is sent; rounded to 0.1 kg |
| Length, Width, Height, cm | Empty | Sent only if all three are filled in |
| Return delivery (recipient) | “Money” if the order is unpaid and payment is on delivery | Set “Not required”: FedEx cash on delivery isn't connected |
1
Recipient country (ISO code)2
Total weight, kg3
Length / Width / Height4
Cash on delivery: Not required5
Create waybill button- Recipient country — two-letter ISO code, e.g. DE.
- Total weight of the parcel in kilograms.
- Parcel dimensions: length, width and height in centimetres.
- Cash on delivery for the recipient is set to Not required.
- Create waybill sends the request to UPS (not pressed during capture).
The order number goes into the waybill as the customer reference, up to 30 characters. The sender pays — from your FedEx account, with your own packaging; the ship date is today. The “Shipment description” field isn't sent to FedEx.
The form remembers changed values in the order: open it again and they're still there.
What happens after “Create waybill”
- Elbuz checks the data before it goes to FedEx. If the account number or sender address is missing, you get a message with the reason, for example “Error: FedEx account number is required (API settings)”; the waybill isn't created.
- FedEx creates the shipment. The tracking number goes into “Delivery service: number”, and you see “Waybill created, No.‹number›”.
- If FedEx refuses, the window shows its text with the code in brackets, and the order stays without a number.
To get a tracking link in the order, fill in “Tracking link” in the “FedEx” delivery method, for example https://www.fedex.com/fedextrack/?trknbr= (delivery methods).
The waybill is created right away and charged at the FedEx rate. You can't cancel or change it from Elbuz — only in FedEx, and only until the parcel is handed to the courier. After canceling, clear “Delivery service: number” in the order to create a new one.
How to print a FedEx label
Where: order card → “View waybill” → print icon; or “Shipments” → row → “Print waybill”.
The label opens in a new tab: a PDF on half a Letter-size sheet. FedEx keeps the label link for 12 hours. After that the tab shows “print error: FedEx: the label link has expired (12 hours) — reprint it in FedEx Ship Manager”, so print the label right after the waybill.
Elbuz doesn't print a waybill whose number was entered in the order manually: only waybills created from Elbuz have a label link.
How to order a FedEx courier
Where: order card → “View waybill” → the “Courier pickup” block.
- “Pickup date” — the next business day by default.
- “Pickup from” and “to” — if empty: 10:00–17:00.
- “Parcels, pcs” and “Total weight, kg” — how much to collect.
“Order a courier” → “Courier ordered #‹code›”. The FedEx confirmation code is saved in the order; the pickup address is the connection's “Sender” block. For today, FedEx accepts a request until the cutoff time for your postcode.
How Elbuz tracks FedEx parcels
Every 10 minutes Elbuz asks FedEx about parcels — up to 100 waybills per run. It tracks orders from the last 60 days and orders in the marked statuses until the parcel reaches the “Delivered” state. The FedEx status code and text show in the order and in “Shipments”.
In “Shipments”, FedEx supports “Print waybill”, “SMS to recipient” and “Track on carrier site” — the fedex.com page with the parcel number.
How to change order statuses by FedEx codes
Elbuz enters the FedEx codes in “Delivery statuses” itself. A code that isn't in the table gives the “Unknown” state in “Shipments”, and the order status doesn't change on it.
- In the FedEx connection, open the “Order statuses for which to check the parcel status with the delivery service” block. Mark the statuses in which an order awaits delivery, for example “Shipped”.
- In the “Notification settings” block, open “Delivery statuses” (and “Order statuses”, “Payment statuses” if needed).
- The FedEx codes from the table below are already in the “Code (name) on site (API)” column; add your own comma-separated.
| Your delivery status | FedEx codes | State in “Shipments” |
|---|---|---|
| Awaiting sender | OC — FedEx has received the shipment data | Created |
| On the way | PU — picked up, IT — in transit, AR, AF, DP — sorting | In transit |
| At customs | CC, CP, CD — customs clearance | In transit |
| Handed to courier | OD — out for delivery | In transit |
| Delivered | DL | Delivered, polling stops |
| Refused | RS — return to sender | Refused |
Without code DL next to “Delivered” in “Delivery statuses”, the parcel never reaches the “Delivered” state. Elbuz keeps asking about it after delivery, using up the limit of 100 waybills per run.
Leave the exception codes DE, SE and DD out of the table: such a parcel will be “Unknown”, and you'll notice it. The codes are from the FedEx event reference. How the three status tables work is explained in the article on automatic order status changes.
Scenarios
A risk-free first connection
Create a project on developer.fedex.com, enter the test keys and test account, turn on “Sandbox environment”. Create a waybill on your own order and print the label. If everything is fine, switch to the live keys.
Daily shipping to Germany
“Default service” — FedEx International Priority. From each order — “Create waybill”, print the label right away, and at the end of the day one “Courier pickup” with the number of parcels and total weight.
Orders close by themselves
Mark the “Shipped” status in the connection. Enter code DL next to “Delivered” in both “Delivery statuses” and “Order statuses”. Once the parcel is delivered, the order moves to “Delivered”, and Elbuz stops asking about it.
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 Secret Key isn't entered or “Active” is off | Fill in “Password” and turn on “Active” (what to enter) |
| “FedEx OAuth: …” | FedEx didn't accept the keys: test keys with the sandbox off or vice versa, or an old Secret Key | Check the key pair and the “Sandbox environment” switch (test environment) |
| “FedEx account number is required (API settings)” | “FedEx account number” is empty | Enter the 9-digit account number |
| “sender address and phone are required (API settings)” | The “Sender” block is missing the name, street, city, postcode or phone | Fill in “Sender” in the connection |
| “name and phone are required for recipient” or “address is required for recipient” | The order has no recipient name, phone, street, city or postcode | Add them in the waybill form |
| “cash on delivery is not supported for FedEx yet — choose «without COD»” | “Return delivery (recipient)” is set to “Money” | Choose “Not required” |
| “FedEx: the label link has expired…” | More than 12 hours have passed since the waybill was created | Print the label in FedEx Ship Manager |
| A FedEx parcel is “Unknown” in “Shipments” | The FedEx code isn't in the “Delivery statuses” window | Add the code (FedEx codes) |
FAQ
How much does the FedEx integration in Elbuz cost?
Elbuz charges nothing for FedEx waybills, labels or statuses. You pay FedEx for delivery and the courier under your own contract.
Can I ship FedEx from outside Poland?
Yes, from any EU country: enter the country code in the “Sender” block's country field. Elbuz doesn't send customs data, so shipments stay within the EU.
Can I send FedEx with cash on delivery from Elbuz?
No, FedEx cash on delivery isn't connected: a waybill with “Money” is rejected. Leave “Not required” or arrange such a parcel in FedEx.
How do I cancel a FedEx waybill?
Only in FedEx, before the courier collects the parcel. Then clear “Delivery service: number” in the order (after creation).
Can I choose a FedEx service for a single waybill?
No, there is one service for all — “Default service” in the connection. Switch it before a waybill of another type.
Why doesn't the FedEx status change the order status?
The order status isn't marked in the connection, or the FedEx code isn't in the table. Mark the status and enter the codes (FedEx codes).
Where to find it and who has access
- Menu
- Account → System settings → Other settings → External services and integrations → Delivery → FedEx
- 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
- Prepare
- a FedEx account (9 digits) and a project on developer.fedex.com with the Ship, Track and Pickup APIs
- Create an API project and keysdeveloper.fedex.com
- Enter the keys, account number and senderExternal services and integrations → FedEx
- Enter the FedEx status codesSame place, “Notification settings”
- Create a waybill and print the labelOrder card, “Delivery” section
- Order a courierView waybill
Related topics
- If you need to see all parcels from all carriers in one list — Shipments.
- If you also ship UPS — UPS in Elbuz: the waybill form is the same.
- If your store is in Germany and works with DHL Paket — DHL Paket in Elbuz.
- If you want to compare ways to create a waybill — waybill from an order.
