↑↓ selectEnter openEsc close

    1. Elbuz
    2. Delivery services in Elbuz

    FedEx API in Elbuz: waybill from an order, label, courier and statuses

    5 min readUpdated

    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

    1. Sign in to developer.fedex.com with your FedEx account and create an organization in “My Projects”.
    2. “Add shipping accounts” → “+ Add Account”: the FedEx account number and the payer address.
    3. “+ Create API Project”: select Ship API, Track API and Pickup API, name the project and choose the shipping countries.
    4. 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”.

    FieldWhat 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” blockCompany, 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
    FedEx connection form: API credentials, FedEx account number, default service, sandbox switch and sender block
    1User and Password
    2FedEx account number
    3Default service
    4Sandbox environment
    5Sender block
    1. User and Password — the API Key and Secret Key of the developer.fedex.com project.
    2. FedEx account number — the account the waybills are created under.
    3. Default service — the FedEx service used when an order does not specify one.
    4. Sandbox environment — when on, requests go to the FedEx test environment.
    5. 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

    ServiceWhen
    FedEx PriorityDefault; a FedEx domestic service in Poland
    FedEx Priority ExpressA FedEx domestic service in Poland
    FedEx International PriorityShipping abroad: delivery by end of day, usually in 1–3 business days
    FedEx Economy SelectAccording 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

    FieldSourceWhat to check
    Last name, First name, Phone, E-MailOrderPhone is required
    Postcode, City, Street, House, ApartmentThe order's delivery address: the whole address goes in “Street”, “House” and “Apartment” are emptyStreet, house and apartment together — up to 35 characters; Elbuz truncates anything longer
    Country (ISO code: DE, FR, IT, ES…)The order's delivery countryNot recognized — the sender's country
    Total weight, kgWeight of the order's productsNo weight on the products either — 1 kg is sent; rounded to 0.1 kg
    Length, Width, Height, cmEmptySent only if all three are filled in
    Return delivery (recipient)“Money” if the order is unpaid and payment is on deliverySet “Not required”: FedEx cash on delivery isn't connected
    UPS waybill creation form: recipient, address and shipment parameters
    1Recipient country (ISO code)
    2Total weight, kg
    3Length / Width / Height
    4Cash on delivery: Not required
    5Create waybill button
    1. Recipient country — two-letter ISO code, e.g. DE.
    2. Total weight of the parcel in kilograms.
    3. Parcel dimensions: length, width and height in centimetres.
    4. Cash on delivery for the recipient is set to Not required.
    5. 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”

    1. 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.
    2. FedEx creates the shipment. The tracking number goes into “Delivery service: number”, and you see “Waybill created, No.‹number›”.
    3. 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.

    1. 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”.
    2. In the “Notification settings” block, open “Delivery statuses” (and “Order statuses”, “Payment statuses” if needed).
    3. The FedEx codes from the table below are already in the “Code (name) on site (API)” column; add your own comma-separated.
    FedEx codes for the “Delivery statuses” window
    Your delivery statusFedEx codesState in “Shipments”
    Awaiting senderOC — FedEx has received the shipment dataCreated
    On the wayPU — picked up, IT — in transit, AR, AF, DP — sortingIn transit
    At customsCC, CP, CD — customs clearanceIn transit
    Handed to courierOD — out for deliveryIn transit
    DeliveredDLDelivered, polling stops
    RefusedRS — return to senderRefused

    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

    Common problems
    What you seeWhyWhat 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
    1. Create an API project and keysdeveloper.fedex.com
    2. Enter the keys, account number and senderExternal services and integrations → FedEx
    3. Enter the FedEx status codesSame place, “Notification settings”
    4. Create a waybill and print the labelOrder card, “Delivery” section
    5. Order a courierView waybill

    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