DokumentationCommerceCommerce-Wissensdatenbank

UPS Migration der Versandmethode zur Integration von SOAP auf RESTful API

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

Erstellt für:

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

Dieser Artikel enthält einen Patch zum Beheben von Problemen bei der Migration der Versandmethode von SOAP zu RESTful API für Adobe Commerce 2.4.4 - 2.4.6-pX.United Parcel Service (UPS)

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 Entwicklerportal), um die Gesamtsicherheit zu erhöhen, um Betrug zu reduzieren und erweiterte API-Funktionen bereitzustellen.

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

Ab Juni 2024 können Adobe Commerce-Händler nicht mehr mit unserer aktuellen UPS -Integration interagieren. Daher veröffentlichen wir diesen Hotfix, mit dem Adobe Commerce 2.4.4+/2.4.5+/2.4.6±Händler auf die neuesten UPS REST APIs migrieren können.

Dieses Problem wird in Adobe Commerce/Magento Open Source-Version 2.4.7 behoben und die Fehlerbehebung wird auch in der Beta-Version 2.4.7 vom Oktober 2023 enthalten sein.

Betroffene Produkte und Versionen

Adobe Commerce über 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 hat ein Sicherheits-Update für ihre API veröffentlicht.

Wenn Sie über eine Europäische Union verfügen (andere Herkunft kann dasselbe Problem aufweisen) wie der Ursprung der Sendung, führt dies in der UPS REST -Anfrage zu einem Fehler:
"Eine Sendung darf nicht als Maßeinheit KGS/IN, LBS/CM oder OZS/CM verwendet werden."

Lösung

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

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.

Patch

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

Für Versionen 2.4.4, 2.4.4-pX:

Für Versionen 2.4.5, 2.4.5-pX:

Für Versionen 2.4.6, 2.4.6-pX:

Anwenden des Pflasters

Entpacken Sie die Datei und finden Sie Anweisungen unter Anwenden eines von Adobe bereitgestellten Composer-Patches in unserer Support-Wissensdatenbank.

Ermitteln, ob die Patches angewendet wurden

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

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

  1. Installieren Sie den Quality Patches Tool.

  2. Führen Sie den Befehl aus:

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

  3. Die Ausgabe sollte in etwa so angezeigt werden, bei der AC-9363 den Status Angewandt 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