Clarity Connect integration
UPS SAP Business One Integration
Ship SAP Business One deliveries with UPS without re-typing addresses, and get tracking numbers, labels and freight costs back on the delivery, with Clarity Connect between the two.
What moves between UPS and SAP Business One
Business One knows what is being shipped and to whom; UPS returns what the shipment costs, the label to stick on the box and the 1Z number to track it by. The integration carries the delivery out to UPS and brings those results back onto the Business One document, where sales, customer service and finance can all see them.
UPS
Where rates, labels and tracking come from
- Rates and time in transit
- Shipments and labels
- Tracking numbers
- Tracking events
- Pickups
SAP Business One
Where orders and deliveries are recorded
- Sales orders
- Deliveries
- Shipping types
- Tracking number on the document
- Freight charges
SAP Business One to UPS mapping
Business One names from SAP's SDK and Service Layer documentation; UPS API names as UPS's API specifications give them. Discovery settles service codes, packaging and account rules.
| SAP Business One | UPS | Direction |
|---|---|---|
| DeliveryNotes: ship-to address, packages, weights | Ship API shipment request | Business One to UPS |
| Shipping type on the document | UPS service level | Mapped once in set-up |
| Tracking number field (TrackNo) | Package tracking number (1Z) | UPS to Business One |
| Freight on the delivery | Rating API charge | UPS to Business One |
| Ship-to address | Address Validation – Street Level (US and Puerto Rico) | Checked before shipping |
| Order or delivery status | Track Alert events | UPS to Business One |
How the UPS link runs
A delivery in Business One, a shipment at UPS
When a delivery is added in Business One, Connect sends its ship-to address, packages and weights to the UPS Ship API under your UPS account. UPS answers with a shipment ID, a tracking number for each package and the label as an encoded image in the format you print, such as ZPL or EPL for thermal printers or GIF.
Tracking numbers and freight back on the document
Connect writes the tracking number to the delivery's tracking number field in Business One and can add the shipping charge as a freight line, using the cost from UPS's Rating API. Invoices raised from the delivery then carry the right freight without anyone copying it from the UPS site.
Tracking events without polling
UPS's Track Alert API pushes tracking events to a webhook as they happen, so nobody has to keep checking package status. Connect can record delivery or exception events against the Business One 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.
UPS's OAuth APIs, and what Business One has built in
UPS retired its old access-key authentication in 2024, and every UPS API now requires OAuth 2.0. A Business One shop shipping under its own account uses the client-credentials flow, which returns a bearer token for calls to the Ship, Rating and Tracking APIs. Any older UPS link that still uses an access key has stopped working and needs replacing.
Business One itself records how an order ships, through shipping types, and has a tracking number field on its sales documents, but it does not print UPS labels or fetch UPS rates in the core product. SAP's 2020 introduction to Business One lists UPS and FedEx among the preconfigured templates in its Integration Hub, so ask your SAP partner what that covers before scoping a custom build.
Searchers also ask about SAP Business ByDesign. There, the Manage Outbound Deliveries web service can write a tracking ID, tracking URL and carrier onto an outbound delivery, so the same UPS flow applies with a different SAP interface.
How Clarity Connect runs it
Clarity Connect is Clarity's integration platform. It keeps a lasting connection between Business One and UPS and runs each flow, such as deliveries to shipments or tracking events back to orders, as its own task. Connect can run on a server behind your firewall next to Business One and call UPS outbound, so the ERP stays off the internet. If UPS doesn't answer, the job is retried instead of lost. Clarity has built more than 3,000 integrations on Connect; demos are 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
Our UPS link stopped working in 2024. Why?
UPS stopped accepting access keys in 2024 and now requires OAuth 2.0 for all of its APIs. An integration built on access keys has to be rebuilt on OAuth.
Which label formats does UPS return?
The Ship API returns the label as an encoded image. UPS's specification lists GIF, ZPL, EPL and SPL as the supported formats for package labels.
Does it use our negotiated UPS rates?
It can. The Rating API returns negotiated rates when the request asks for them and the shipper account is authorized for them, alongside the standard charges.
Can it validate addresses before we ship?
Yes, for US and Puerto Rico addresses, through UPS's street-level Address Validation API.
Related resources
Connect UPS and SAP Business One
Tell us how you pack, label and charge for shipping today. A Clarity business analyst will map the deliveries, services and freight rules with your team before anything is built.
Book a demo