UPS Live Shipping (REST)¶

Das UPS Live Shipping (REST) Plugin ermöglicht die Live-Berechnung von Versandkosten über die offizielle UPS REST API (OAuth 2.0) direkt im Shopware 5 Checkout.

• Plugin installieren
• Plugin aktivieren
• Allgemeine Einstellungen
• API Konfiguration
• Versandarten zuordnen
• Gewicht & Splitting
• Fallback Einstellungen
• Debug & Logging

Plugin installieren¶

Installieren Sie das Plugin über den Shopware Plugin Manager.

Plugin aktivieren¶

Klicken Sie auf das Symbol, um das Plugin zu aktivieren.

Allgemeine Einstellungen¶

• 1) Shop wählen
  Wählen Sie den entsprechenden Shop.

• 2) Plugin aktivieren
  Aktiviert die UPS Live-Versandberechnung.

• 3) Modus
  Auswahl zwischen:

• Sandbox (Testumgebung)

• Production (Livebetrieb)

• 4) Client ID
  Client ID aus dem UPS Developer Portal.

• 5) Client Secret
  Client Secret aus dem UPS Developer Portal.

• 6) Shipper Number
  UPS Kundennummer (empfohlen bei ausgehandelten Preisen).

• 7) API Timeout
  Timeout in Sekunden für die UPS API-Anfrage.

• 8) Absenderland
  ISO-Code des Versandlandes (z.B. DE).

• 9) Absender-PLZ
  Postleitzahl des Versandlagers.

• 10) Preis-Auswahl

• Standardpreise erzwingen
• Ausgehandelte Preise erzwingen

• Ausgehandelte Preise falls verfügbar

• 11) Einstellungen speichern

Versandarten zuordnen¶

Jede Shopware Versandart muss einem UPS Service zugeordnet werden.

Hierfür wird das Attribut:

welo_ups_service_id

verwendet.

Beispiele:

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

Ohne Service-ID kann keine Berechnung erfolgen.

Gewicht & Splitting¶

UPS erlaubt maximal 70kg pro Paket.

Das Plugin erkennt automatisch höhere Gesamtgewichte und teilt diese in mehrere Pakete auf.

Beispiele:

Einstellungen:

• 1) Standardgewicht
  Wird genutzt, wenn ein Artikel kein Gewicht besitzt.

• 2) Mindestgewicht
  Untergrenze für die Berechnung.

• 3) Max-Gewicht pro Paket
  Standard: 70kg.

• 4) Einstellungen speichern

Fallback Einstellungen¶

Wenn der Kunde nicht eingeloggt ist oder keine vollständige Adresse vorliegt:

• 1) Fallback Zielland
  Standardland für Gäste.

• 2) Fallback Ziel-PLZ
  Standard-PLZ für Gäste.

• 3) Ersatz-Versandkosten
  Wird genutzt, falls die UPS API nicht erreichbar ist.

• 4) Einstellungen speichern

Hinweis:
Wenn der Kunde im Warenkorb ein anderes Land oder eine PLZ auswählt, wird diese dynamisch für die Berechnung verwendet.

Debug & Logging¶

• 1) Debug aktivieren
  Aktiviert detaillierte Log-Ausgaben.

• 2) Logs beinhalten:

• Gewicht
• Service-Code
• Cache-Key
• Payload an UPS
• Raw API Response
• Fehlercodes

• API Exceptions

• 3) Einstellungen speichern

Alle Logs sind mit [UPS] gekennzeichnet.