Skip to content

UPS Shipping Connector

The merchantCENTRAL Shipment UPS connector enables full integration of the UPS Shipping REST API into Microsoft Dynamics 365 Business Central. You can create UPS shipping labels, void shipments, generate return labels, and track shipments directly from Business Central β€” without needing to use the UPS portal.

What Can the UPS Connector Do?

Feature Description
:material-label-outline: Single Labels Create shipping labels for individual shipments
:material-label-multiple-outline: Bulk Labels Process multiple shipments sequentially in a single run
:material-undo: Return Labels Create return labels for your customers (UPS Return Service)
:material-close-circle-outline: Void Shipment Void created shipments at UPS
:material-refresh: Label Recovery Retrieve previously created labels again
:material-package-variant: Multi-Parcel Shipments with multiple packages (individual tracking numbers)
:material-earth: International International shipments with customs documents (Commercial Invoice)
:material-image: Flexible Formats Labels in GIF, PNG, ZPL, EPL, or SPL
:material-shield-check: Value Added Services Saturday delivery, signature, declared value, and more

Quick Start in 5 Steps

Step 1: Have Your UPS Developer Credentials Ready

You will need the following:

  • Client ID β€” from the UPS Developer Portal
  • Client Secret β€” from the UPS Developer Portal
  • Account Number β€” your 6-character UPS Shipper Number

Where Do I Get Credentials?

Register at the UPS Developer Portal at developer.ups.com. There you create an app and receive the Client ID and Client Secret. Your Account Number (Shipper Number) can be found on your UPS invoices or in the UPS business customer portal.

Step 2: Open Setup and Configure

  1. In Business Central, open the search (++alt+q++) and enter UPS Shipment Setup
  2. Enter the Client ID, Client Secret, and Account Number
  3. Enter your Shipper Address
  4. Select your Default Service (e.g., UPS Standard)

β†’ Detailed guide: Initial Setup

Step 3: Test Connection

Click Test Connection. On success, an OAuth Access Token is requested and the connection is confirmed.

Step 4: Create Your First Label

  1. Open the Shipment Labels list in the merchantCENTRAL Dashboard
  2. Click Create Label
  3. Select UPS as the shipping provider
  4. Fill in the recipient details and click Create

β†’ Detailed guide: Creating Labels

Step 5: Print the Label

The created label is stored as GIF, PNG, or ZPL in Business Central and can be printed immediately.

Supported UPS Services

Code Service Coverage
11 UPS Standard Europe (2–5 business days)
07 UPS Express Worldwide (next business day)
65 UPS Express Saver Europe (next business day, more economical)
54 UPS Express Plus Worldwide (earliest possible delivery)
08 UPS Expedited Worldwide (2–5 business days)
70 UPS Access Point Economy Delivery to UPS Access Point
96 UPS Worldwide Express Freight Freight shipments worldwide

β†’ Detailed description: UPS Services

Technical Details

Property Value
API UPS Shipping REST API (JSON)
API Version v2409
Authentication OAuth 2.0 Client Credentials
Token Validity ~4 hours (with automatic refresh)
Production URL https://onlinetools.ups.com
Sandbox URL https://wwwcie.ups.com
Label Formats GIF, PNG, ZPL, EPL, SPL
Label Sizes 4Γ—6 inches, 4Γ—8 inches
Weight Unit Kilograms (KGS)
Dimension Unit Centimeters (CM)
Max. Weight 70 kg per package

Further Topics