Connecting UPS

allverto creates UPS labels via the official UPS interface (Shipping API). Billing is via your UPS account number – you bring your own UPS contract.

#Before you start

• a UPS account with account number (shipper number, 6 characters, shown on your UPS invoices),
• a user in the UPS Developer Portal (developer.ups.com) with access to this account number,
• an app in the Developer Portal with the products Authorization (OAuth) and Shipping, linked to your account number. The app shows you the Client ID and Client secret.
• For international shipments, the Sender address needs a Phone number.

#Creating an app in the UPS Developer Portal

1. Sign in at developer.ups.com with your UPS account.
2. Choose Create Application and link it to your UPS account number.
3. Add the products Authorization (OAuth) and Shipping.
4. Copy the Client ID and Client Secret from the app details.

#Step by step

1. Open Shipping → Settings → Carriers and fill in the Sender address.
2. Click Connect carrier and choose UPS.
3. Enter a name in allverto and choose the Default product: UPS Standard, UPS Express Saver, UPS Express or UPS Expedited.
4. Enter the UPS account number, Client ID and Client secret.
5. Choose the Label format (PDF 10 × 15 cm, PDF on A4 or ZPL for Zebra printers).
6. Test mode uses the UPS test environment (CIE). The test labels are invalid.
7. Click Test login and then Connect.

#Cancelling

You cancel UPS shipments under Shipping → Shipments by right-clicking → Cancel shipment…, as long as UPS hasn't picked up the parcel yet. If this is no longer possible, allverto reports “The shipment can no longer be cancelled”.

#International and customs

For destinations outside the EU, allverto transmits the commercial invoice electronically to UPS: item, quantity, value, customs tariff number and country of origin from the item (Shipping & customs). With a PDF label, the UPS commercial invoice is attached as an additional page after the label. With ZPL you print it separately.

#Frequently asked questions

#“UPS rejects the login”

Client ID or client secret is wrong, or the app isn't activated for the test environment or the live system. Check the app in the Developer Portal.

#“The UPS account number is invalid or not approved for this app”

The account number isn't linked to the app. Add it to the app in the Developer Portal.

#Is there an end-of-day closing?

Not necessary with UPS: UPS receives the shipment data immediately when the label is created. You can still get a manifest (PDF) of the parcels since the last closing on the account via Manage → End-of-day closing (manifest).