United Parcel Service (UPS)

United Parcel Service (UPS) bietet inländische und internationale Verschiffen auf dem Land- und Luftweg in mehr als 220 Länder an.

IMPORTANT
Ab Juni 2024 können Adobe Commerce-Händler keine Transaktionen mehr mit der aktuellen UPS-Integration durchführen. Dies liegt daran, dass die von der nativen Adobe Commerce-Integration verwendeten United Parcel Service (UPS)-APIs derzeit das erforderliche OAuth 2.0-Sicherheitsmodell nicht unterstützen. Weitere Informationen zu dieser Änderung finden Sie im Handbuch zur Migration des Zugriffsschlüssels für das Entwicklerportal.
Händler sollten ein Qualitäts-PatchUpdate auf ihren Store anwenden, um von der SOAP-API zur RESTful-API zu migrieren, die OAuth 2.0-Authentifizierungsprotokolle unterstützt.
NOTE
UPS kann Dimensional Weight 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 Shop aktivieren

  1. Navigieren Sie in Admin Seitenleiste zu Stores > Settings>Configuration.

  2. Wählen Sie im Bedienfeld links unter Sales die Option Delivery Methods aus.

  3. Erweitern Sie Erweiterungsauswahl den Abschnitt UPS .

  4. Legen Sie Enabled for Checkout auf Yes fest.

  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

    • Stellen Sie Mode auf Live ein, um Daten über eine sichere Verbindung an das UPS Versandsystem zu senden. (Der Entwicklungsmodus sendet keine Daten über eine sichere Verbindung.)

    • Überprüfen Sie die Gateway URL, die zum Senden von Anfragen 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 für jede Anfrage mit dem angegebenen Host die entsprechenden Endpunkte verwenden.

    • Überprüfen Sie die Tracking URL, die zum Abrufen von 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 für jede Anfrage mit dem angegebenen Host die entsprechenden Endpunkte verwenden.

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

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

    • Legen Sie Live Account auf eine der folgenden Einstellungen fest:

      • 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 - UPS wird im Testmodus ausgeführt. Stellen Sie sicher, dass Sie die richtigen Endpunkte unter Gateway-URL und Tracking-URL verwenden.
    note note
    NOTE
    Der Standardtyp Einheitlicher Paketdienst ist für die Einstellung geplant. Verwenden Sie für neue Konfigurationen den standardmäßigen United Parcel Service REST. Der REST-Typ ist auch erforderlich, um Versandkennzeichnungen zu generieren

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

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

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

Schritt 3: Container-Beschreibung ausfüllen

  1. Legen Sie Packages Request Type auf eine der folgenden Einstellungen fest:

    • Use origin weight (few requests)
    • Divide to equal weight (one request)
  2. Geben Sie Container den typischen Verpackungstyp an, der für den Versand 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. Legen Sie Weight Unit auf das System fest, das Sie zum Messen des Produktgewichts verwenden.

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

    • LBS
    • KGS
  4. Legen Sie Destination Type auf eine der folgenden Einstellungen fest:

    • Residential - Die meisten Ihrer Sendungen gehen vom Business-to-Consumer-Segment (B2C).
    • Commercial - Die meisten Ihrer Sendungen gehen von Business zu Business (B2B).
  5. Geben Sie die vom Provider erlaubten Maximum Package Weight ein.

  6. Legen Sie Pickup Method auf eine der folgenden Einstellungen fest:

    • Regular Daily Pickup
    • On Call Air
    • One Time Pickup
    • Letter Center
    • Customer Counter
  7. Geben Sie die vom Provider erlaubten 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 hinzugerechnet wird. Wenn Sie eine Bearbeitungsgebühr einbeziehen möchten, gehen Sie wie folgt vor:

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

    • Fixed
    • Percent
  2. Um zu bestimmen, wie die Bearbeitungsgebühr angewendet wird, Handling Applied Sie eine der folgenden Einstellungen ein:

    • Per Order
    • Per Package
  3. Geben Sie den Betrag der zu belastenden Handling Fee ein.

    Verwenden Sie das Dezimalformat, um einen Prozentsatz einzugeben. Geben Sie beispielsweise 0.25 für 25 % ein.

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

Schritt 5: Zugelassene Methoden und anwendbare Länder angeben

  1. Wählen Sie Allowed Methods jede UPS Versandart, die Ihren Kunden zur Verfügung steht.

    Die Methoden werden beim Auschecken unter UPS angezeigt. Zur Auswahl mehrerer Methoden halten Sie die Strg-Taste (PC) bzw. die Befehlstaste (Mac) gedrückt und klicken auf die einzelnen Optionen.

  2. Wenn Sie über UPS eine Option Kostenloser Versand bereitstellen möchten, legen Sie die Optionen für den kostenlosen Versand fest:

    • Legen Sie Free Method auf die Methode fest, 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 geeignet 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 ist mit einer Standardmeldung vorbelegt, Sie können jedoch eine andere Nachricht eingeben, die angezeigt werden soll, wenn UPS nicht mehr verfügbar ist.

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

  4. Legen Sie Ship to Applicable Countries auf eine der folgenden Einstellungen fest:

    • All Allowed Countries - Kunden aus allen Ländern die in Ihrer Store-Konfiguration angegeben sind, können diese Versandmethode verwenden.
    • Specific Countries - Wenn Sie diese Option wählen, wird die Liste Versand an bestimmte Länder angezeigt. Wählen Sie jedes Land in der Liste aus, in dem diese Versandmethode verwendet werden kann.
  5. Legen Sie Show Method if Not Applicable auf eine der folgenden Einstellungen fest:

    • Yes - Listet alle verfügbaren UPS Versandmethoden während des Checkouts auf, einschließlich der Methoden, die nicht für die Sendung 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 der UPS-Sendungen aus Ihrem Geschäft zu erstellen, setzen Sie Debug auf Yes.

  7. Geben Sie Sort Order eine Zahl ein, um die Reihenfolge zu bestimmen, in der UPS angezeigt wird, wenn sie beim Checkout mit anderen Versandmethoden aufgelistet wird.

    0 = First, 1 = Second, 2 = Third usw.

  8. Klicken Sie auf Save Config.

Schritt 6: Versandursprungsadresse einrichten

  1. Vergewissern Sie sich, dass Ihre Store-Informationen vollständig sind.

  2. Navigieren Sie in Admin-Seitenleiste zu Stores > Settings>Configuration.

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

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

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

  5. Klicken Sie auf Save Config.

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