DocumentazioneCommerceKnowledge base di Commerce

Migrazione dell'integrazione del metodo di spedizione UPS da SOAP a RESTful API

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

Creato per:

  • Sviluppatore
NOTE
Se hai caricato una delle tre patch di questo articolo prima del 6 giugno 2024: se stai affrontando questo problema a causa delle Metric System/SI misurazioni (chilogrammi e centimetri) non utilizzate, devi riapplicare una di queste nuove patch aggiornate ora pubblicate in questo articolo per la tua versione 2.4.4+/2.4.5+/2.4.6+ di Adobe Commerce/Magento Open Source ancora una volta, perché altrimenti non potrai selezionare le Metric System/SI misurazioni di chilogrammi e centimetri nei metodi di spedizione UPS Admin configuration. Queste nuove patch sono compatibili con le patch rilasciate in precedenza. Questo problema verrà risolto definitivamente nell'ambito della prossima versione di Adobe Commerce 2.4.7-p1 pianificata per il 11 giugno 2024.
NOTE
Se hai caricato una delle tre patch di questo articolo prima del 10 ottobre 2023, devi riapplicare una di queste patch ora pubblicata in questo articolo per la tua versione 2.4.4+/2.4.5+/2.4.6+ di Adobe Commerce/Magento Open Source ancora una volta, altrimenti non potrai selezionare e configurare specifici UPS metodi di spedizione in Admin configuration e dovrai avere tutti abilitati. Queste nuove patch sono compatibili con le patch rilasciate in precedenza.

Questo articolo fornisce una patch per risolvere i problemi relativi alla migrazione dell'integrazione del metodo di spedizione United Parcel Service (UPS) da SOAP a RESTful API per Adobe Commerce 2.4.4 - 2.4.6-pX.

In base agli ultimi aggiornamenti al modello di sicurezza UPS API, UPS ha implementato un modello di sicurezza OAuth 2.0 per tutti i APIs (ulteriori dettagli disponibili nella UPS Guida alla migrazione della chiave di accesso al portale per sviluppatori) per migliorare la sicurezza complessiva al fine di ridurre le frodi e fornire funzionalità API avanzate.

Questa modifica influisce sull'implementazione corrente del metodo di spedizione UPS in Adobe Commerce e richiede la correzione dell'implementazione corrente e la migrazione da SOAP API a RESTful API per supportare i protocolli di autenticazione OAuth 2.0.

A partire da giugno 2024, i commercianti Adobe Commerce non saranno in grado di negoziare con l'integrazione UPS corrente, pertanto stiamo rilasciando questo hotfix, che consente ai commercianti Adobe Commerce 2.4.4+/2.4.5+/2.4.6+ di migrare all'ultima UPS REST APIs.

Questo problema verrà risolto nella versione 2.4.7 di Adobe Commerce/Magento Open Source e la correzione verrà inclusa anche nella versione 2.4.7-beta2 di ottobre 2023.

Prodotti e versioni interessati

Adobe Commerce su infrastruttura cloud e on-premise e Magento Open Source:

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

Cause

UPS ha rilasciato un aggiornamento di sicurezza per il suo API.

Se si dispone dell'Unione europea (altre origini potrebbero riscontrare lo stesso problema) come origine della spedizione, si verificherà un errore nella richiesta UPS REST:
"Una spedizione non può avere come unità di misura KGS/IN, LBS/CM o OZS/CM."

Soluzione

Utilizza le seguenti patch allegate, a seconda della versione di Adobe Commerce/Magento Open Source in uso:

Per risolvere il problema nelle versioni 2.4.4+, 2.4.5+ e 2.4.6+, è necessario applicare la patch corrispondente alla versione di Adobe Commerce/Magento Open Source in uso.

Patch

Utilizza le seguenti patch allegate, a seconda della versione di Adobe Commerce/Magento Open Source in uso:

Per le versioni 2.4.4, 2.4.4-pX:

Per le versioni 2.4.5, 2.4.5-pX:

Per le versioni 2.4.6, 2.4.6-pX:

Come applicare il cerotto

Decomprimi il file e vedi Come applicare una patch del compositore fornita dall'Adobe nella Knowledge Base di supporto per le istruzioni.

Come stabilire se i cerotti sono stati applicati

Considerando che non è possibile verificare facilmente se il problema è stato corretto, è possibile verificare se la patch è stata applicata correttamente. In questo modo viene utilizzata (esempio: AC-9363) come patch da controllare.

A tale scopo, procedere come segue:

  1. Installa Quality Patches Tool.

  2. Esegui il comando:

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

  3. Dovresti vedere un output simile a questo, dove AC-9363 restituisce lo stato Applicato:

    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