AC-15210: Migrazione dell’integrazione USPS dalle API degli strumenti web alle nuove API USPS RESTful
La patch AC-15210 cambia l’integrazione delle API degli strumenti web USPS (United States Postal Service) esistenti in Adobe Commerce con le API REST USPS di nuova introduzione. Questa patch è disponibile quando è installato Quality Patches Tool (QPT) 1.1.70. L’ID della patch è AC-15210.
Prodotti e versioni interessati
La patch è stata creata per la versione di Adobe Commerce:
- Adobe Commerce e Magento Open Source (tutti i metodi di distribuzione) 2.4.6-p3 - 2.4.8
magento/quality-patches alla versione più recente e verificare la compatibilità nella pagina Quality Patches Tool: Cerca patch. Utilizza l’ID patch come parola chiave di ricerca per individuare la patch.Problema
Adobe Commerce sta attualmente utilizzando API degli strumenti Web per l'integrazione con le funzionalità di spedizione USPS.
USPS ritirerà le API legacy degli strumenti web il 25 gennaio 2026. Queste API supportano attualmente servizi come l’igiene degli indirizzi, il tracciamento dei pacchetti, la prova di consegna, la pianificazione del ritiro, i moduli doganali, il controllo della tariffa, gli standard di servizio, le informazioni sull’impianto postale e le posizioni degli armadi di consegna pacchi.
Le versioni 2.4.6, 2.4.7 e 2.4.8 di Adobe Commerce utilizzano le API degli strumenti web USPS per l’integrazione preconfigurata con il servizio di spedizione. Dopo la data di ritiro, queste integrazioni cesseranno di funzionare a meno che non siano migrate alle nuove API REST USPS.
Soluzione
Per continuare a utilizzare l’integrazione USPS oltre gennaio 2026, i clienti Adobe Commerce nelle versioni 2.4.6, 2.4.7 e 2.4.8 devono installare la patch AC-15210.
Applicare la patch
Per applicare singole patch, utilizzare i collegamenti seguenti, a seconda del metodo di distribuzione utilizzato:
- Adobe Commerce o Magento Open Source on-premise: Quality Patches Tool > Utilizzo nella guida di Quality Patches Tool.
- Adobe Commerce su infrastruttura cloud: Aggiornamenti e patch > Applica patch nella guida Commerce su infrastruttura cloud.
Dopo l’applicazione della patch, aggiorna la configurazione del corriere marittimo Commerce USPS per integrarla con le nuove API USPS. Per istruzioni, vedere l'argomento Strumenti Web USPS obsoleti nella Guida agli acquisti e ai negozi.
Lettura correlata
Per ulteriori informazioni su Quality Patches Tool, vedere:
- Quality Patches Tool: strumento self-service per patch di qualità nella guida degli strumenti.