DocumentaçãoCommerceKB do Commerce

Migração da integração do método de envio UPS de SOAP para RESTful API

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

Criado para:

  • Desenvolvedor
NOTE
Se você carregou algum dos três patches deste artigo antes de 6 de junho de 2024: se estiver com este problema por causa das Metric System/SI medidas (quilogramas e centímetros) não estarem sendo usadas, reaplique um desses novos patches atualizados agora publicados neste artigo para a sua versão 2.4.4+/2.4.5+/2.4.6+ do Adobe Commerce/Magento Open Source mais uma vez, caso contrário, não será possível selecionar as Metric System/SI medidas de quilogramas e centímetros no 8} métodos de envio no Admin configuration. UPS Esses novos patches são compatíveis com os patches lançados anteriormente. Este problema será corrigido permanentemente no escopo da próxima versão 2.4.7-p1 do Adobe Commerce planejada para 11 de junho de 2024.
NOTE
Se você carregou algum dos três patches deste artigo antes de 10 de outubro de 2023, reaplique um desses patches agora publicados neste artigo para sua versão 2.4.4+/2.4.5+/2.4.6+ do Adobe Commerce/Magento Open Source mais uma vez, caso contrário, você não poderá selecionar e configurar métodos de envio específicos do UPS no Admin configuration e terá que habilitar todos eles. Esses novos patches são compatíveis com os patches lançados anteriormente.

Este artigo fornece uma correção para resolver problemas com a migração da integração do método de envio United Parcel Service (UPS) do SOAP para o RESTful API para Adobe Commerce 2.4.4 - 2.4.6-pX.

De acordo com as últimas atualizações do Modelo de Segurança do UPS API, o UPS implementou um modelo de segurança do OAuth 2.0 para todos os APIs (Mais detalhes disponíveis no UPS Guia de Migração da Chave de Acesso ao Portal do Desenvolvedor) para aprimorar a segurança geral e reduzir fraudes e fornecer recursos API aprimorados.

Essa alteração afeta nossa implementação de integração do método de envio UPS atual no Adobe Commerce e requer que corrijamos nossa implementação atual e migremos de SOAP API para RESTful API para dar suporte aos protocolos de autenticação OAuth 2.0.

A partir de junho de 2024, os comerciantes do Adobe Commerce não poderão fazer transações com nossa integração atual do UPS. Portanto, estamos lançando este hotfix, que permite que os comerciantes do Adobe Commerce 2.4.4+/2.4.5+/2.4.6+ migrem para o UPS REST APIs mais recente.

Esse problema será corrigido no Adobe Commerce/Magento Open Source versão 2.4.7 e a correção também será incluída na versão 2.4.7-beta2 em outubro de 2023.

Produtos e versões afetados

Adobe Commerce na infraestrutura em nuvem e no local, 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

Causas

O UPS lançou uma atualização de segurança para o API.

Se você tiver a União Europeia (outras origens podem enfrentar o mesmo problema) como Origem da Remessa, isso causará um erro na solicitação UPS REST:
"Uma remessa não pode ter KGS/IN, LBS/CM ou OZS/CM como sua unidade de medida."

Solução

Use os seguintes patches anexados, dependendo da sua versão do Adobe Commerce/Magento Open Source:

Para resolver o problema nas versões 2.4.4+, 2.4.5+ e 2.4.6+, você deve aplicar o patch correspondente à versão do Adobe Commerce/Magento Open Source abaixo.

Correção

Use os seguintes patches anexados, dependendo da sua versão do Adobe Commerce/Magento Open Source:

Para as versões 2.4.4, 2.4.4-pX:

Para as versões 2.4.5, 2.4.5-pX:

Para as versões 2.4.6, 2.4.6-pX:

Como aplicar o patch

Descompacte o arquivo e consulte Como aplicar um patch de compositor fornecido pelo Adobe em nossa base de dados de suporte para obter instruções.

Como saber se os patches foram aplicados

Considerando que não é possível verificar facilmente se o problema foi corrigido, talvez você queira verificar se o patch foi aplicado com sucesso. Isso usa (Exemplo: AC-9363) como o patch a ser verificado.

Você pode fazer isso executando as seguintes etapas:

  1. Instalar o Quality Patches Tool.

  2. Execute o comando:

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

  3. Você deve ver uma saída semelhante a esta, onde AC-9363 retorna o status Aplicado:

    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