UPS Migration de l’intégration des méthodes de livraison de SOAP à RESTful API

NOTE
Si vous avez téléchargé l’un des trois correctifs de cet article avant le 6 juin 2024 : si vous rencontrez ce problème en raison des mesures Metric System/SI (kilogrammes et centimètres) non utilisées, vous devez réappliquer l’un de ces nouveaux correctifs mis à jour publiés dans cet article pour votre version 2.4.4+/2.4.5+/2.4.6+ de Adobe Commerce. de nouveau, car sinon vous ne pourrez pas sélectionner les Metric System/SI mesures de kilogrammes et de centimètres dans les méthodes d’expédition UPS de Admin configuration. Ces nouveaux correctifs sont compatibles avec les correctifs publiés précédemment. Ce problème sera corrigé définitivement dans le cadre de la prochaine version d’Adobe Commerce 2.4.7-p1 prévue pour le 11 juin 2024.
NOTE
Si vous avez téléchargé l’un des trois correctifs de cet article avant le 10 octobre 2023, vous devez réappliquer l’un de ces correctifs publiés dans cet article pour votre version 2.4.4+/2.4.5+/2.4.6+ d’Adobe Commerce/Magento Open Source, car vous ne pourrez pas sélectionner et configurer des méthodes d’expédition spécifiques UPS dans le Admin configuration et vous devrez tous les activer. Ces nouveaux correctifs sont compatibles avec les correctifs publiés précédemment.

Cet article fournit un correctif pour résoudre les problèmes liés à la migration de l’intégration de la méthode de livraison United Parcel Service (UPS) de SOAP à RESTful API pour Adobe Commerce 2.4.4 - 2.4.6-pX.

Selon les dernières mises à jour du modèle de sécurité UPS API, UPS a mis en oeuvre un modèle de sécurité OAuth 2.0 pour tous les APIs (plus de détails disponibles dans le UPS Guide de migration des clés d’accès au portail du développeur) afin d’améliorer la sécurité globale afin de réduire la fraude et de fournir des fonctionnalités API améliorées.

Cette modification a un impact sur l’implémentation actuelle de l’intégration des méthodes de livraison UPS dans Adobe Commerce et nécessite que nous corrigions notre implémentation actuelle et que nous migrions de SOAP API vers RESTful API pour pouvoir prendre en charge les protocoles d’authentification OAuth 2.0.

À compter de juin 2024, les marchands Adobe Commerce ne pourront pas traiter avec notre intégration UPS actuelle. Nous publions donc ce correctif qui permet à Adobe Commerce 2.4.4+/2.4.5+/2.4.6.6+ de migrer vers le dernier UPS REST APIs.

Ce problème sera corrigé dans Adobe Commerce/Magento Open Source version 2.4.7 et le correctif sera également inclus dans la version 2.4.7-beta2 d’octobre 2023.

Produits et versions concernés

Adobe Commerce sur l’infrastructure cloud et sur site, et Magento Open Source :

  • 2.4.4
  • 2.4.4-pX
  • 2.4.5
  • 2.4.5-pX
  • 2.4.6
  • 2.4.6-pX

Causes

Le UPS a publié une mise à jour de sécurité pour son API.

Si vous avez une origine européenne (d’autres origines peuvent rencontrer le même problème) que l’origine de l’envoi, cela provoquera une erreur dans la requête UPS REST :
"Une expédition ne peut pas avoir un KGS/IN ou LBS/CM ou OZS/CM comme unité de mesure."

Solution

Utilisez les correctifs ci-joint suivants, en fonction de votre version d’Adobe Commerce/de Magento Open Source :

Pour résoudre le problème dans les versions 2.4.4+, 2.4.5+ et 2.4.6+, vous devez appliquer le correctif correspondant à votre version d’Adobe Commerce/Magento Open Source ci-dessous.

Correctif

Utilisez les correctifs ci-joint suivants, en fonction de votre version d’Adobe Commerce/de Magento Open Source :

Pour les versions 2.4.4, 2.4.4-pX :

Pour les versions 2.4.5, 2.4.5-pX :

Pour les versions 2.4.6, 2.4.6-pX :

Comment appliquer le correctif

Décompressez le fichier et reportez-vous à la section Comment appliquer un correctif de compositeur fourni par Adobe dans notre base de connaissances de support pour obtenir des instructions.

Comment déterminer si les correctifs ont été appliqués

Étant donné qu’il n’est pas possible de vérifier facilement si le problème a été corrigé, vous pouvez vérifier si le correctif a bien été appliqué. Cela utilise (exemple : AC-9363) comme correctif à vérifier.

Pour ce faire, procédez comme suit :

  1. Installez le Quality Patches Tool.

  2. Exécutez la commande :

    code language-bash
    vendor/bin/magento-patches -n status |grep "9363|Status"
    
  3. Vous devriez voir une sortie similaire à celle-ci, où AC-9363 renvoie l’état Appliqué :

    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