UPS

What it does

Create shipments, print labels and cancel them with UPS directly from a shipping order, without leaving the WMS.

How it works

• Once the plugin is configured, UPS is available as a carrier on a shipping order: create the shipment, print the package labels, and cancel it if you have to. Cancelling a shipment can't be undone.
• Labels come back in the format you pick: GIF, ZPL, EPL or SPL. PDF isn't offered, because UPS's shipping API doesn't accept it.
• A default service covers shipping orders that don't name a UPS service level themselves.
• Customs treatment follows the destination territory, not the country on the address. Addresses that read as domestic EU but sit outside the EU customs union, such as the Canary Islands stored under Spain, get full customs documentation. Azores and Madeira sit outside the EU VAT territory but inside the customs union, so they need no forms, and Monaco counts as inside through France.
• Customs values are set once for the whole account. The HS code, country of origin, currency, reason for export and Incoterms apply to every product on every declaration, because there's no per-product customs data yet.
• Delivery tracking is off by default. UPS's published API doesn't say which of its tracking statuses means "delivered", so the WMS doesn't poll for it until that's confirmed. While tracking is off, UPS orders aren't held waiting for a delivery poll.

How to set it up

1. Activate the plugin under Plugins → Carriers.
2. Under Connection, enter the OAuth2 Client ID and Client Secret from your UPS developer account, plus your UPS Account Number. That's your shipper number, and it's the account your shipments are billed to.
3. Leave Environment on CIE (test) until UPS confirms your production access. Switching it to Production makes every shipment real and billable.
4. Under Sender, add the email and phone number UPS should send as the shipment's sender. Under Labels, pick your label format.
5. Under Notifications, decide whether UPS emails the recipient with shipment status updates.
6. If you ship internationally, set the Customs defaults: HS code, country of origin, currency, reason for export and Incoterms.

Important notes

• The plugin arrives switched off and pointed at CIE (test). Nothing reaches UPS for real until you activate it and move the environment to Production.
• Check the customs defaults before your first international shipment. One wrong HS code goes onto every declaration.
• Leave Delivery Tracking off unless support tells you otherwise. Turning it on makes UPS orders wait in In Shipping for a delivery poll.

💡 Tip: inside the application, each plugin's configuration page has an Integration Guide button with the detailed technical walk-through.