AC-15210: Migração da integração do USPS das APIs de ferramentas da Web para as novas APIs RESTful USPS
O patch AC-15210 faz a transição da integração existente das APIs de ferramentas da Web do Serviço Postal dos Estados Unidos (USPS) no Adobe Commerce para as APIs REST do USPS recém-introduzidas. Este patch está disponível quando o Quality Patches Tool (QPT) 1.1.70 está instalado. A ID do patch é AC-15210.
Produtos e versões afetados
O patch foi criado para a versão do Adobe Commerce:
- Adobe Commerce e Magento Open Source (todos os métodos de implantação) 2.4.6-p3 - 2.4.8
magento/quality-patches para a versão mais recente e verifique a compatibilidade na Quality Patches Tool: página Procurar patches. Use a ID do patch como palavra-chave de pesquisa para localizar o patch.Problema
No momento, a Adobe Commerce está usando APIs de Ferramentas da Web para integrar-se aos recursos de envio de USPS.
O USPS desativará suas APIs herdadas de Ferramentas da Web em 25 de janeiro de 2026. Atualmente, essas APIs oferecem suporte a serviços como higiene de endereço, rastreamento de pacotes, prova de entrega, programação de coleta, formulários aduaneiros, verificação de taxa, padrões de serviço, informações sobre instalações postais e locais de depósito de encomendas.
As versões 2.4.6, 2.4.7 e 2.4.8 do Adobe Commerce usam APIs de ferramentas da Web do USPS para integração de envio pronta para uso. Após a data da aposentadoria, essas integrações deixarão de funcionar, a menos que sejam migradas para as novas APIs REST do USPS.
Solução
Para continuar usando a integração do USPS além de janeiro de 2026, os clientes do Adobe Commerce nas versões 2.4.6, 2.4.7 e 2.4.8 são necessários para instalar o patch AC-15210.
Aplicar o patch
Para aplicar patches individuais, use os links a seguir, dependendo do método de implantação:
- Adobe Commerce ou Magento Open Source local: Quality Patches Tool > Uso no guia Quality Patches Tool.
- Adobe Commerce na infraestrutura em nuvem: Atualizações e patches > Aplicar patches no guia do Commerce na infraestrutura em nuvem.
Depois de aplicar o patch, atualize a configuração da Transportadora de remessa Commerce USPS para integrar às novas APIs USPS. Para obter instruções, consulte o tópico Descontinuação das ferramentas da Web do USPS no Guia de Experiência de Lojas e Compras.
Leitura relacionada
Para saber mais sobre Quality Patches Tool, consulte:
- Quality Patches Tool: uma ferramenta de autoatendimento para patches de qualidade no guia Ferramentas.