Perimattic
Brandnata + FedExLogistics & ops

FedEx surcharges traced back to the orders and SKUs behind them

Brandnata connects to FedEx through API keys from your FedEx Developer Portal projects, plus invoice data exported from FedEx Billing Online, in about 5 minutes. The connection is read-only by default, and FedEx data is reconciled with every other channel you connect in one dashboard.

Brandnata's FedEx integration combines tracking from FedEx's Basic Integrated Visibility API with invoice detail from FedEx Billing Online. Fuel, residential delivery, address correction and other surcharges are allocated to the order and SKU on each tracking number, so you can see which products, regions and channels push your FedEx bill above the quoted rate.

Brandnata Marketplace & Operations dashboard showing courier SLA, shipping cost and returns by channel
OAuth API keys and Billing Online export
Connection
Adjusted weekly by FedEx
Fuel surcharge
Invoiced cost per tracking number
Profit basis
What you can connect

Everything FedEx sends into Brandnata

Tracking status and estimated delivery dates refresh several times a day, well inside FedEx's limit of 1,400 transactions per 10 seconds per project. Charges update each time you add a FedEx Billing Online export, since invoices arrive after parcels ship.

Brandnata

Tracking & delivery estimates

Status, scan events and the estimated delivery date or window for each tracking number, from the Basic Integrated Visibility API.

Invoice line items

Freight and every other charge on your FedEx invoices, from Billing Online downloads in CSV, XML or Excel.

Fuel surcharge

The fuel charge on each shipment, which FedEx adjusts weekly from diesel prices for Ground and jet fuel prices for express services.

Residential & address fees

Residential delivery and address correction charges, matched to the customer address on the original order.

How Brandnata uses it

How Brandnata uses FedEx data

FedEx invoices arrive after the parcel ships, which is why store reports usually miss them. Brandnata matches each invoiced tracking number to its order from Shopify, Amazon or WooCommerce, splits surcharges onto the SKUs shipped and sets delivery performance beside refunds, so contribution margin includes the whole FedEx cost.

A team reviewing reconciled sales and performance data together

FedEx data feeds Brandnata's anomaly alerts and AI agent suggestions. The connection itself only reads data and never changes anything in FedEx.

Key capabilities

What you can do with FedEx in Brandnata

Specific, FedEx-native use cases, not a generic list that applies to every connector the same way.

Surcharges by SKU

Bulky or awkward products attract extra charges. Brandnata totals invoiced surcharges per SKU, showing which items cost far more to ship than their weight alone suggests.

Quoted rate against invoiced cost

FedEx says rate quotes are estimates that can differ from the invoice. Brandnata compares the shipping estimated or charged at checkout with the final invoiced amount for every order.

Address quality by channel

Address correction charges are grouped by storefront and marketplace, pointing to the checkouts that send FedEx incomplete or wrong addresses.

Late deliveries and refunds

Compare FedEx's estimated delivery date with the delivered scan, then check whether late orders carry more refunds, support tickets or one-star reviews.

How it compares

Where Brandnata + FedEx fits

Other ways teams currently piece this data together, and where each one runs out of reach.

ApproachCoverageWhere it falls short
Brandnata + FedEx · this pageInvoiced freight and surcharges allocated to orders and SKUs, with FedEx delivery performance next to refunds and marginN/A
FedEx Billing Online (native) Invoices, payments, disputes and downloadable invoice detail for each accountCharges are listed by tracking number and invoice, with no link to the order value, product margin or sales channel behind them
Parcel audit services Invoice checks against your rate agreement and disputes for overcharged shipmentsBuilt to recover billing errors, not to show whether an order or SKU made money once shipping was paid
Spreadsheets Billing Online CSVs matched to order exports by tracking numberWeekly fuel changes and charges that land on a later invoice make a monthly sheet hard to keep accurate
Connected ecosystem

FedEx works alongside every other connector

Data from FedEx doesn't sit in isolation, it's matched against orders, customers and spend from every other platform you connect, so the full picture shows up automatically.

FedEx
Reconciled with
FAQ

FedEx integration FAQs

FedEx details on this page were last checked against FedEx's own documentation on .

How do I connect FedEx to Brandnata?

Sign in to the FedEx Developer Portal, create a project and link your FedEx account; only your organization's administrator can add accounts. Tracking through Basic Integrated Visibility needs a project of its own. Paste each project's API key and secret key into Brandnata, then export invoice detail from FedEx Billing Online as CSV and upload it.

What are the FedEx API rate limits?

Each FedEx Developer Portal project can make 1,400 transactions in any 10-second span, and the Basic Integrated Visibility tracking API allows 100,000 calls a day, with up to 30 tracking numbers per request. API keys are exchanged for an OAuth token that lasts one hour. Brandnata batches tracking requests to stay well under both limits.

How often does the FedEx fuel surcharge change?

Every week. FedEx sets the fuel surcharge from a weekly national diesel price for FedEx Ground and FedEx Home Delivery, and from a weekly jet fuel price for express and other package services. FedEx can change the percentages and trigger points without notice, so Brandnata reads the fuel charge from each invoice instead of assuming one fixed rate.

Why is my FedEx invoice higher than the rate quote?

Rate quotes are estimates. FedEx's Rates and Transit Times documentation says quotes may differ from the invoiced amount, and the invoice also carries any surcharges that applied, such as residential delivery or address correction. Brandnata lines up every invoice line with its order, showing which surcharge made the difference and which SKUs or addresses trigger it most.

Does this work for FedEx accounts outside the US?

Yes. The FedEx Developer Portal assigns sandbox accounts based on the locations you choose when creating a project, and FedEx Billing Online is offered country by country, though menus and download options vary by region. Brandnata reads tracking for any account linked to your project and accepts invoice exports from any market's Billing Online.

Should I connect FedEx directly if ShipStation already has my FedEx labels?

Yes, if you ship on your own FedEx account number. ShipStation stores the label price at the moment of purchase, while surcharges FedEx applies afterwards appear only on FedEx's invoice. With both connected, Brandnata uses ShipStation for the label and FedEx Billing Online for the amount you were finally billed.

Can Brandnata create shipments or pay invoices in FedEx?

No. Brandnata only reads tracking through your project's API keys and the invoice data you upload. It doesn't create shipments or labels, schedule pickups, pay invoices or open billing disputes, even when your FedEx project includes APIs that could. Delete the project in the FedEx Developer Portal whenever you want to stop access.

Get started

Connect FedEx in about 5 minutes

Connects through API keys from your FedEx Developer Portal projects, plus invoice data exported from FedEx Billing Online. Read-only to start, with your first reconciled numbers within a day.