United Parcel Service (UPS)

United Parcel Service (UPS) bietet inländische und internationale Seeverkehrsdienstleistungen auf dem Land- und Luftweg in über 220 Ländern an.

IMPORTANT
Ab Juni 2024 können Adobe Commerce-Händler nicht mehr mit der aktuellen UPS-Integration arbeiten. Dies liegt daran, dass die von der nativen Adobe Commerce-Integration verwendeten United Parcel Service-APIs (UPS) derzeit das erforderliche OAuth 2.0-Sicherheitsmodell nicht unterstützen. Weitere Informationen zu dieser Änderung finden Sie unter Migrationshandbuch für den Zugriffsschlüssel für Entwicklerportal
.
Händler sollten ein Qualitäts-Patch-Update auf ihren Speicher anwenden, um von der SOAP-API zur RESTful-API zu migrieren, die OAuth 2.0-Authentifizierungsprotokolle unterstützt.
NOTE
UPS kann dimensionale Gewichtung verwenden, um einige Versandraten zu bestimmen. Adobe Commerce unterstützt jedoch nur die gewichtsbasierte Berechnung der Versandkosten.

Schritt 1: Öffnen Sie ein UPS-Versandkonto.

Um diese Versandmethode Ihren Kunden anzubieten, müssen Sie zunächst ein Konto bei UPS eröffnen.

Schritt 2: UPS für Ihren Store aktivieren

  1. Wechseln Sie auf der Admin-Seitenleiste zu Stores > Settings>Configuration.

  2. Wählen Sie im Bedienfeld auf der linken Seite unter Sales die Option Delivery Methods.

  3. Erweitern Sie Erweiterungsauswahl im Abschnitt UPS .

  4. Setzen Sie Enabled for Checkout auf Yes.

  5. Gehen Sie für ein UPS REST-Konto (Standard) wie folgt vor:

    • Geben Sie Ihre UPS-Anmeldedaten ein: UPS ClientID als User ID, UPS Client Secret als Password.

    • Setzen Sie Mode auf Live , um Daten über eine sichere Verbindung an das UPS Versandsystem zu senden. (Im Entwicklungsmodus werden keine Daten über eine sichere Verbindung gesendet.)

    • Überprüfen Sie die Gateway URL , die zum Senden von Anforderungen erforderlich ist. Verwenden Sie eine Sandbox-URL (https://wwwcie.ups.com/) für den Testmodus und eine Produktions-URL für Live-Anfragen (https://onlinetools.ups.com). Stellen Sie sicher, dass Sie die entsprechenden Endpunkte für jede Anfrage mit dem angegebenen Host verwenden.

    • Überprüfen Sie die Tracking URL , die zum Abrufen der Tracking-Informationen erforderlich ist. Verwenden Sie eine Sandbox-URL (https://wwwcie.ups.com/) für den Testmodus und eine Produktions-URL für Live-Anfragen (https://onlinetools.ups.com). Stellen Sie sicher, dass Sie die entsprechenden Endpunkte für jede Anfrage mit dem angegebenen Host verwenden.

    • Setzen Sie Origin of the Shipment auf die Region, aus der die Sendung stammt.

    • Wenn Sie Sondertarife mit UPS haben, setzen Sie Enable Negotiated Rates auf Yes und geben Sie die sechsstellige Shipper Number ein, die Ihnen von UPS zugewiesen wurde.

    • Setzen Sie Live Account auf einen der folgenden Werte:

      • Yes - Führt UPS im Produktionsmodus aus und bietet UPS als Versandmethode für Ihre Kunden an. Stellen Sie sicher, dass Sie die richtigen Endpunkte unter Gateway-URL und Tracking-URL verwenden.
      • No - Führt UPS in einem Testmodus aus. Stellen Sie sicher, dass Sie die richtigen Endpunkte unter Gateway-URL und Tracking-URL verwenden.
    note note
    NOTE
    Der standardmäßige United Parcel Service-Typ ist für die Einstellung geplant. Verwenden Sie für neue Konfigurationen den Standardtyp United Parcel Service REST . Der REST-Typ ist auch erforderlich, um Versandbezeichnungen zu generieren.

    Für Version 2.4.7 wird UPS Type entfernt, da die Typen UPS und UPS XML für die Einstellung geplant sind und UPS REST die Standardeinstellung ist. Die von der nativen Adobe Commerce-Integration verwendeten United Parcel Service-APIs (UPS) werden vorübergehend nicht mehr unterstützt, da das OAuth 2.0-Sicherheitsmodell derzeit nicht unterstützt wird.
    note important
    IMPORTANT
    UPS stellt die Unterstützung von HTTP ein, die in der aktuellen Standardeinstellung (Systemwert) verwendet wird. Deaktivieren Sie das Kontrollkästchen Use system value und ändern Sie die URL für HTTPS. Beispiel: https://www.ups.com/using/services/rave/qcostcgi.cgi
  6. Geben Sie für Title den Namen dieser Versandoption ein, wie er beim Checkout angezeigt werden soll.

    Standardmäßig ist dieses Feld auf United Parcel Service gesetzt.

    UPS aktivieren {width="600" modal="regular"}

Schritt 3: Container-Beschreibung ausfüllen

  1. Setzen Sie Packages Request Type auf einen der folgenden Werte:

    • Use origin weight (few requests)
    • Divide to equal weight (one request)
  2. Geben Sie für Container den typischen Verpackungstyp an, der für die Verbringung verwendet wird:

    • Customer Packaging
    • UPS Letter Envelope
    • Customer Supplied Package
    • UPS Tube
    • PAK
    • UPS Express Box
    • UPS Worldwide 25 kilo
    • UPS Worldwide 10 kilo
    • Pallet
    • Small Express Box
    • Medium Express Box
    • Large Express Box
  3. Setzen Sie Weight Unit auf das System, mit dem Sie die Produktgewichtung messen.

    Das von UPS unterstützte Gewichtungssystem ist je nach Land unterschiedlich. Im Zweifelsfall fragen Sie UPS, welches Gewichtssystem Sie verwenden sollten. Zu den Optionen gehören:

    • LBS
    • KGS
  4. Setzen Sie Destination Type auf einen der folgenden Werte:

    • Residential - Die meisten Ihrer Sendungen sind geschäftlich an Verbraucher (B2C).
    • Commercial - Die meisten Ihrer Sendungen sind geschäftlich (B2B).
  5. Geben Sie die vom Träger zulässige Maximum Package Weight ein.

  6. Setzen Sie Pickup Method auf einen der folgenden Werte:

    • Regular Daily Pickup
    • On Call Air
    • One Time Pickup
    • Letter Center
    • Customer Counter
  7. Geben Sie die vom Träger zulässige Minimum Package Weight ein.

    Container-Beschreibung {width="600" modal="regular"}

Schritt 4: Einrichten von Bearbeitungsgebühren

Die Bearbeitungsgebühr ist optional und erscheint als zusätzliche Gebühr, die zu den UPS Versandkosten hinzukommt. Wenn Sie eine Bearbeitungsgebühr einbeziehen möchten, gehen Sie wie folgt vor:

  1. Setzen Sie Calculate Handling Fee auf eine der folgenden Methoden:

    • Fixed
    • Percent
  2. Um festzustellen, wie die Bearbeitungsgebühr angewendet wird, setzen Sie Handling Applied auf einen der folgenden Werte:

    • Per Order
    • Per Package
  3. Geben Sie den Betrag des zu ladenden Handling Fee ein.

    Um einen Prozentsatz einzugeben, verwenden Sie das Dezimalformat. Geben Sie beispielsweise "0.25"für 25 % ein.

    Bearbeitungsgebühr {width="600" modal="regular"}

Schritt 5: Angeben der zulässigen Methoden und der entsprechenden Länder

  1. Wählen Sie für Allowed Methods jede UPS Versandmethode aus, die für Ihre Kunden verfügbar sein soll.

    Die Methoden werden beim Checkout unter UPS angezeigt. Um mehrere Methoden auszuwählen, halten Sie die Strg-Taste (PC) oder die Befehlstaste (Mac) gedrückt und klicken Sie auf jede Option.

  2. Wenn Sie die Option Kostenloses Versand über UPS bereitstellen möchten, legen Sie die kostenlosen Versandoptionen fest:

    • Setzen Sie Free Method auf die Methode, die Sie für den kostenlosen Versand verwenden möchten. Wenn Sie keinen kostenlosen Versand über UPS anbieten möchten, wählen Sie None.

    • Um einen Mindestbestellbetrag zu verlangen, der für einen kostenlosen Versand mit UPS qualifiziert ist, setzen Sie Enable Free Shipping Threshold auf Enable. Geben Sie dann den Mindestwert in Free Shipping Amount Threshold ein.

  3. Ändern Sie bei Bedarf die Displayed Error Message.

    Dieses Textfeld enthält eine Standardmeldung, Sie können jedoch eine andere Meldung eingeben, die angezeigt werden soll, wenn UPS nicht verfügbar ist.

    Zulässige Methoden {width="600" modal="regular"}

  4. Setzen Sie Ship to Applicable Countries auf einen der folgenden Werte:

    • All Allowed Countries - Kunden aus allen in Ihrer Store-Konfiguration angegebenen Ländern können diese Bereitstellungsmethode verwenden.
    • Specific Countries - Wenn Sie diese Option auswählen, wird die Liste Zu bestimmten Ländern verschicken angezeigt. Wählen Sie jedes Land in der Liste aus, in dem diese Versandmethode verwendet werden kann.
  5. Setzen Sie Show Method if Not Applicable auf einen der folgenden Werte:

    • Yes - Listet alle verfügbaren UPS Versandmethoden während des Checkout auf, einschließlich Methoden, die nicht für den Versand gelten.
    • No - Listet nur die UPS Versandmethoden auf, die für die Sendung gelten.

    Anwendbare Länder {width="600" modal="regular"}

  6. Um eine Protokolldatei mit den Details zu UPS-Sendungen aus Ihrem Speicher zu erstellen, setzen Sie Debug auf Yes.

  7. Geben Sie für "Sort Order"eine Zahl ein, um die Sequenz zu bestimmen, in der UPS angezeigt wird, wenn es beim Checkout mit anderen Versandmethoden aufgeführt wird.

    0 = first, 1 = second, 2 = third usw.

  8. Klicken Sie auf Save Config.

Schritt 6: Einrichten der Versandstammadresse

  1. Stellen Sie sicher, dass Ihre Store-Informationen abgeschlossen sind.

  2. Wechseln Sie in der Seitenleiste Admin zu Stores > Settings>Configuration.

  3. Erweitern Sie im linken Bereich den Eintrag Sales und wählen Sie Shipping Settings aus.

  4. Erweitern Sie Erweiterungsauswahl Origin auf der Seite und konfigurieren Sie die Lieferursprungsadresse.

    Verkaufskonfiguration - Optionen für Lieferursprungsadressen {width="600" modal="regular"}

  5. Klicken Sie auf Save Config.

NOTE
Commerce erklärt UPS bei der Berechnung der Versandkosten den vollen Bestellpreis nicht. Dieses Verhalten kann nicht geändert werden.
recommendation-more-help
dacea746-44a9-4368-b3fb-3bcff64c6be1