DokumentationCommerceCommerce-Wissensdatenbank

Migration der Integration der Versandmethode von SOAP nach RESTful API UPS

Last update: Mon Dec 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler
NOTE
Wenn Sie vor dem 6. 2024 eines der drei Patches aus diesem Artikel hochgeladen haben: Wenn dieses Problem auftritt, weil die Metric System/SI (Kilogramm und Zentimeter) nicht verwendet werden, sollten Sie eines dieser neuen, aktualisierten Patches, die jetzt in diesem Artikel veröffentlicht wurden, für Ihre Version 2.4.4+/2.4.5+/2.4.6+ von Adobe Commerce/Magento Open Source erneut anwenden, da Sie andernfalls die Metric System/SI von Kilogramm und Zentimeter in den UPS Versandmethoden in der Admin configuration nicht auswählen können. Diese neuen Patches sind mit den zuvor veröffentlichten Patches kompatibel. Dieses Problem wird in der kommenden Adobe Commerce-Version 2.4.7-p1, die für den 11. 2024 geplant ist, dauerhaft.
NOTE
Wenn Sie vor dem 10. Oktober 2023 eines der drei Patches aus diesem Artikel hochgeladen haben, sollten Sie eines dieser Patches, die jetzt in diesem Artikel veröffentlicht wurden, für Ihre Version 2.4.4+/2.4.5+/2.4.6+ von Adobe Commerce/Magento Open Source erneut anwenden, da Sie andernfalls bestimmte UPS Versandmethoden in der Admin configuration nicht auswählen und konfigurieren können und Sie alle aktivieren müssen. Diese neuen Patches sind mit den zuvor veröffentlichten Patches kompatibel.

Dieser Artikel enthält einen Patch zur Behebung von Problemen mit der Migration der United Parcel Service (UPS) Versandmethodenintegration von SOAP zu RESTful API für Adobe Commerce 2.4.4 - 2.4.6-pX.

Gemäß den neuesten Aktualisierungen des UPS API Sicherheitsmodells hat UPS ein OAuth 2.0 Sicherheitsmodell für alle APIs implementiert (weitere Details finden Sie im UPS Handbuch zur Migration des Zugriffsschlüssels für das Entwicklerportal), um die Gesamtsicherheit zur Betrugsreduzierung zu verbessern und erweiterte API bereitzustellen.

Diese Änderung wirkt sich auf unsere aktuelle Implementierung der UPS Versandmethode in Adobe Commerce aus und erfordert, dass wir unsere aktuelle Implementierung beheben und von SOAP API zur RESTful API migrieren, um OAuth 2.0 Authentifizierungsprotokolle unterstützen zu können.

Ab Juni 2024 Adobe Commerce-Händler keine Transaktionen mit unserer aktuellen UPS-Integration mehr durchführen. Daher veröffentlichen wir diesen Hotfix, der es Händlern von Adobe Commerce 2.4.4+/2.4.5+/2.4.6+ ermöglicht, zur neuesten UPS REST APIs zu migrieren.

Dieses Problem wird in Adobe Commerce/Magento Open Source Version 2.4.7 behoben und die Korrektur wird auch in die 2.4.7-Beta2-Version vom Oktober 2023 aufgenommen.

Betroffene Produkte und Versionen

Adobe Commerce auf Cloud-Infrastruktur und On-Premise und Magento Open Source:

  • 2,4,4
  • 2.4.4-pX
  • 2,4,5
  • 2,4,5-pX
  • 2,4,6
  • 2.4.6-pX

Ursachen

Die UPS veröffentlichten ein Sicherheits-Update für ihre API.

Wenn Sie in der Europäischen Union (andere Ursprünge können dasselbe Problem aufweisen) wie Origin der Sendung haben, führt dies zu einem Fehler in der UPS REST:
"Eine Sendung darf keine KGS/IN- oder LBS/CM- oder OZS/CM-Einheit als Maßeinheit haben."

Lösung

Verwenden Sie je nach Adobe Commerce-/Magento Open Source-Version die folgenden angehängten Patches:

Um das Problem in den Versionen 2.4.4+, 2.4.5+ und 2.4.6+ zu beheben, müssen Sie den entsprechenden Patch auf Ihre Version von Adobe Commerce/Magento Open Source unten anwenden.

Fleck

Verwenden Sie je nach Adobe Commerce-/Magento Open Source-Version die folgenden angehängten Patches:

Für die Versionen 2.4.4, 2.4.4-pX:

Für die Versionen 2.4.5, 2.4.5-pX:

Für die Versionen 2.4.6, 2.4.6-pX:

Anbringen des Pflasters

Entpacken Sie die Datei und Sie in unserer SupportWissensdatenbank die Anleitung „So wenden Sie einen Composer-Patch von Adobe an“.

Wie man feststellt, ob die Patches angewendet wurden

Da es nicht einfach möglich ist, zu überprüfen, ob das Problem behoben wurde, sollten Sie überprüfen, ob der Patch erfolgreich angewendet wurde. Hierbei wird (Beispiel: AC-9363) als zu überprüfender Patch verwendet.

Sie können dies tun, indem Sie die folgenden Schritte ausführen:

  1. Installieren Sie Quality Patches Tool.

  2. Führen Sie den Befehl aus:

    code language-bash 
    vendor/bin/magento-patches -n status |grep "9363|Status"

  3. Es sollte eine ähnliche Ausgabe angezeigt werden, bei der AC-9363 den Status Angewendet zurückgibt:

    code language-bash 
    ║ Id            │ Title                                                        │ Category        │ Origin                 │ Status      │ Details                                          ║ ║ N/A           │ ../m2-hotfixes/AC-9363_USPS_Ground_Advantage_shipping_method_COMPOSER_patch.patch      │ Other           │ Local                  │ Applied     │ Patch type: Custom
recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a