Migrazione dell’integrazione del metodo di spedizione UPS da SOAP all’API RESTful
Nota: Se hai caricato una delle tre patch di questo articolo prima del 6 giugno 2024: Se stai riscontrando questo problema a causa delle misurazioni del Sistema di metriche/SI (chilogrammi e centimetri) non utilizzati, 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, altrimenti non potrai selezionare le misurazioni del Sistema di metriche/SI di chilogrammi e centimetri nei metodi di spedizione UPS nella configurazione amministratore. 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.
Nota: 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, perché altrimenti non potrai selezionare e configurare specifici metodi di spedizione UPS nella Configurazione amministratore e dovrai averli 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 UPS (United Parcel Service) da SOAP all’API RESTful per Adobe Commerce 2.4.4 - 2.4.6-pX.
A partire da giugno 2024, i commercianti di Adobe Commerce non saranno in grado di negoziare con l'integrazione corrente del gruppo di continuità, pertanto stiamo rilasciando questo hotfix, che consente ai commercianti di Adobe Commerce 2.4.4+/2.4.5+/2.4.6+ di migrare alle API REST del gruppo di continuità più recenti.
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 a ottobre 2023.
Descrizione description
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
Il gruppo di continuità ha rilasciato un aggiornamento di sicurezza per la propria API.
Se si dispone di Unione europea (altre origini potrebbero riscontrare lo stesso problema) come origine della spedizione, si verificherà un errore nella richiesta REST UPS:
"L'unità di misura di una spedizione non può essere KGS/IN, LBS/CM o OZS/CM."
Risoluzione resolution
In base agli ultimi aggiornamenti del modello di sicurezza API di UPS, UPS ha implementato un modello di sicurezza OAuth 2.0 per tutte le API (maggiori dettagli sono disponibili nella Guida alla migrazione della chiave di accesso al portale per sviluppatori di UPS) 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 di correggere l’implementazione corrente e di migrare dall’API SOAP all’API RESTful per supportare i protocolli di autenticazione OAuth 2.0.
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 propria versione di Adobe Commerce/Magento Open Source, di seguito.
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 da 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 caso, come patch da controllare viene utilizzato (esempio: AC-9363).
Per eseguire questa operazione, procedere come segue:
-
Installare lo strumento Patch di qualità.
-
Esegui il comando:
vendor/bin/magento-patches -n status |grep "9363|Status" -
Dovresti vedere un output simile a questo, dove AC-9363 restituisce lo stato Applicato:
code language-none ║ 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
Dopo l’applicazione della patch
Passaggio 1: creare un'app UPS nel Portale per sviluppatori UPS
Per utilizzare l’API REST UPS, devi creare un’app nel Portale per sviluppatori UPS per generare le credenziali richieste (ID client e Segreto client). Segui questi passaggi:
-
Accedi al Portale per sviluppatori UPS
- Passa a https://developer.ups.com/.
- Utilizzare le credenziali dell'account UPS per accedere. Se non disponi di un account, fai clic sul pulsante Registrati per crearne uno.
-
Crea una nuova applicazione
- Dopo aver effettuato l'accesso, accedere al dashboard e fare clic su Crea applicazione.
- Specifica un nome per l'applicazione (ad esempio, Integrazione con Adobe Commerce UPS).
-
Selezionare le API richieste
-
Quando richiesto, durante il processo di creazione dell’app seleziona le API che l’app utilizzerà. Assicurati di includere:
- Tariffa API: per il recupero delle tariffe di spedizione.
- API Time in Transit: per le stime dei tempi di consegna.
- Qualsiasi altra API pertinente alle tue esigenze di spedizione (ad esempio, API di tracciamento, se applicabile).
-
-
Imposta autorizzazioni
- Assicurati che l’app disponga delle autorizzazioni necessarie abilitate per le API selezionate.
- Questa operazione viene in genere eseguita durante la creazione dell’app, ma puoi rivedere e aggiornare le autorizzazioni in un secondo momento nelle impostazioni dell’app.
-
Genera credenziali
- Dopo aver creato l'app, passa alla sezione Credenziali.
- Copia ID client e Segreto client. Questi verranno utilizzati per configurare l’integrazione REST del gruppo di continuità in Adobe Commerce.
- Nota: proteggi queste credenziali e non condividerle pubblicamente.
-
Verifica app
- Utilizza gli strumenti di test di UPS Developer Portal per verificare che l’app funzioni correttamente e che possa recuperare i dati dalle API selezionate.
Passaggio 2: configurare UPS REST in Adobe Commerce
Una volta ottenuti l'ID client e il segreto client, procedere con la configurazione dell'integrazione REST del gruppo di continuità in Adobe Commerce.
Assicurarsi di selezionare Tipo UPS = "United Parcel Service REST".