What moves between FedEx and SAP
People looking for this page run SAP Business One or SAP Business ByDesign in roughly equal numbers, so it covers both. The FedEx side is identical; only the SAP interface differs.
SAP decides what leaves the warehouse and for whom. FedEx supplies the price, the label and the tracking number. The integration posts each delivery to FedEx once, stores what FedEx returns on the SAP delivery document, and keeps watching the shipment until it arrives.
FedEx
Where shipments are rated, labelled and tracked
- Ship API
- Rates and Transit Times API
- Address Validation API
- Integrated Visibility (tracking)
- Pickup Request API
SAP Business One / ByDesign
Where deliveries and freight are recorded
- Deliveries (outbound deliveries)
- Ship-to addresses
- Tracking number and carrier
- Freight charges
- Sales orders
FedEx to SAP record mapping
FedEx API names from developer.fedex.com; Business One names from SAP's SDK documentation; ByDesign names from its web service documentation. Discovery confirms services, packaging and account rules.
| FedEx | SAP Business One | SAP Business ByDesign | Direction |
|---|---|---|---|
| Ship API request | DeliveryNotes (delivery) | Outbound delivery | SAP to FedEx |
| Tracking number and label | Tracking number field (TrackNo); label as an attachment (Attachments2) | Tracking ID and tracking URL; label as an attachment | FedEx to SAP |
| Rates and Transit Times API | Freight (additional expenses) | Freight cost, recorded as a note on the delivery | FedEx to SAP |
| Service type | Shipping type | Carrier and shipping details | Mapped once in set-up |
| Address Validation API | Ship-to address | Ship-to address | Checked before shipping |
| Integrated Visibility events | Order or delivery status | Order or delivery status | FedEx to SAP |
How the FedEx link runs
From an SAP delivery to a FedEx label
Connect picks up each new delivery, from Business One's delivery documents or ByDesign's outbound deliveries, and sends the address, packages and service to the FedEx Ship API. FedEx returns the tracking number and the label, as a PDF or PNG for laser printers or ZPLII or EPL2 for thermal ones; a multi-piece shipment gets a master tracking number plus one per package.
Tracking and carrier details written to SAP
In Business One, the tracking number goes into the delivery's tracking number field and freight can be added as an additional expense. In ByDesign, the Manage Outbound Deliveries web service updates the tracking ID, tracking URL, carrier and gross weight on the outbound delivery.
Delivery status after the box leaves
FedEx's Basic Integrated Visibility, formerly the Track API, answers status requests by tracking number. For US accounts, Advanced Integrated Visibility pushes in-transit updates to a webhook instead. Connect can attach delivered or exception events to the SAP order and pass them on to your store or customer portal.
See Clarity Connect move an order
Watch an online order travel into the ERP and its status come back in our Clarity Connect demo, or book a live walkthrough on your own systems.
FedEx Web Services are being wound down
FedEx's REST APIs replaced its older SOAP Web Services. FedEx retired the tracking and address-validation Web Services in 2024, moved the rest of Web Services to maintenance-only support on July 1, 2026, and is switching off the Web Services test environment on December 31, 2026. An SAP link still built on Web Services should be moved to the REST APIs, which sign in with OAuth 2.0: an API key and secret key exchanged for a bearer token that lasts 60 minutes.
On the SAP side, Business One is reached through its Service Layer or DI API, and ByDesign through web services switched on in a communication arrangement. Business One does not print FedEx labels in its core product, and SAP's ByDesign documentation expects carrier data to arrive through an interface set up by the customer or a solution partner. SAP's 2020 introduction to Business One does list FedEx among the preconfigured templates in its Integration Hub, so check what your SAP partner already offers.
How Clarity Connect runs it
Clarity Connect is Clarity's integration platform. It holds a persistent connection between SAP and FedEx and runs each flow as a separate task: deliveries to shipments as they are created, tracking updates as they arrive or on a schedule. If FedEx or SAP is unreachable, Connect keeps the job in its retry queue rather than dropping it. Clarity has built more than 3,000 integrations on the platform; see it working in the Clarity Connect video playlist.
Discovery
A Clarity business analyst documents the data fields and workflows each system can share and which ones you need.
Tasks and mapping
Each flow becomes a Connect task, such as orders to the ERP or stock to the store, set to run in real time or on a schedule.
Testing
Orders and updates are run end to end, including the return trip of statuses back to the customer-facing system.
Live, with a dashboard
Queues and scheduled tasks show in Connect's Hangfire dashboard. A job whose target is offline is retried 10 times, every 30 minutes, and can be re-queued once the cause is fixed.
Clarity Connect is sold as a SaaS subscription at $599 a month or as a one-time license at $15,000 with no ongoing fees, and larger projects are priced to scope. See pricing.
Questions
Does this work with both Business One and ByDesign?
Yes. The FedEx calls are the same. Business One deliveries are read and updated through the Service Layer; ByDesign outbound deliveries through its Query and Manage Outbound Deliveries web services.
Our FedEx integration uses Web Services. Do we need to change it?
Yes, plan for it. FedEx moved Web Services to maintenance-only support on July 1, 2026 and turns off the test environment on December 31, 2026. New work should use FedEx's REST APIs.
Which label formats can we print?
The Ship API returns PDF or PNG labels for plain paper and ZPLII or EPL2 for Zebra and Eltron thermal printers, as a URL or an encoded image.
Can FedEx push tracking updates to us?
For US-based accounts, yes, through Advanced Integrated Visibility webhooks. Elsewhere, Connect requests status by tracking number on a schedule.
Related resources
Connect FedEx and SAP
Tell us which SAP you run and how your team ships with FedEx today. A Clarity business analyst will map the deliveries, services and freight with you before anything is built.
Book a demo
