UPS Live Shipping (REST)¶

The UPS Live Shipping (REST) plugin enables live calculation of shipping costs via the official UPS REST API (OAuth 2.0) directly in the Shopware 5 checkout.

• Install Plugin
• Activate Plugin
• General Settings
• API Configuration
• Assign Shipping Methods
• Weight & Splitting
• Fallback Settings
• Debug & Logging

Install Plugin¶

Install the plugin via the Shopware Plugin Manager.

Activate Plugin¶

Click the icon to activate the plugin.

General Settings¶

• 1) Select shop
  Select the corresponding shop.

• 2) Activate plugin
  Activates the UPS live shipping calculation.

• 3) Mode
  Choose between:

• Sandbox (test environment)

• Production (live operation)

• 4) Client ID
  Client ID from the UPS Developer Portal.

• 5) Client Secret
  Client Secret from the UPS Developer Portal.

• 6) Shipper Number
  UPS customer number (recommended for negotiated rates).

• 7) API Timeout
  Timeout in seconds for the UPS API request.

• 8) Origin country
  ISO code of the shipping country (e.g. DE).

• 9) Origin ZIP code
  ZIP code of the shipping warehouse.

• 10) Price selection

• Force standard rates
• Force negotiated rates

• Negotiated rates if available

• 11) Save settings

Assign Shipping Methods¶

Each Shopware shipping method must be assigned to a UPS service.

The following attribute is used for this:

welo_ups_service_id

Examples:

• 65 → UPS Worldwide Saver
• 11 → UPS Standard
• 07 → UPS Express

Without a service ID, no calculation can take place.

Weight & Splitting¶

UPS allows a maximum of 70 kg per package.

The plugin automatically detects higher total weights and splits them into multiple packages.

Examples:

Settings:

• 1) Default weight
  Used when an item has no weight.

• 2) Minimum weight
  Lower limit for the calculation.

• 3) Max weight per package
  Default: 70 kg.

• 4) Save settings

Fallback Settings¶

If the customer is not logged in or no complete address is available:

• 1) Fallback destination country
  Default country for guests.

• 2) Fallback destination ZIP code
  Default ZIP code for guests.

• 3) Fallback shipping cost
  Used if the UPS API is not reachable.

• 4) Save settings

Note:
If the customer selects a different country or ZIP code in the cart, this is dynamically used for the calculation.

Debug & Logging¶

• 1) Activate debug
  Enables detailed log output.

• 2) Logs include:

• Weight
• Service code
• Cache key
• Payload to UPS
• Raw API response
• Error codes

• API exceptions

• 3) Save settings

All logs are marked with [UPS].