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

NOTE
Se você tiver carregado algum dos três patches deste artigo antes de 6 de junho de 2024: Se estiver enfrentando esse problema por causa da Metric System/SI medições (quilogramas e centímetros) não sendo usadas, você deve reaplicar um desses patches novos e 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, você não poderá selecionar a variável Metric System/SI medições de quilogramas e centímetros no UPS métodos de envio na Admin configuration. 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 do Adobe Commerce 2.4.7-p1 planejada para 11 de junho de 2024.
NOTE
Se você tiver carregado algum dos três patches deste artigo antes de 10 de outubro de 2023, você deve reaplicar um desses patches agora publicados neste artigo para a 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 e configurar patches específicos UPS métodos de envio na Admin configuration, e você precisará ter todos eles habilitados. Esses novos patches são compatíveis com os patches lançados anteriormente.

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

De acordo com as últimas atualizações do UPS API Modelo de segurança, UPS implementou um OAuth 2.0 modelo de segurança para todos APIs (Mais detalhes disponíveis na UPS Guia de migração da chave de acesso do portal do desenvolvedor) para aumentar a segurança geral, a fim de reduzir a fraude e API recursos.

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

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

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

A variável UPS liberou um atualização de segurança para seus API.

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

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 veja Como aplicar um patch de compositor fornecido pelo Adobe na nossa base de conhecimento 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. Instale 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, em que AC-9363 retorna a variável  Aplicado  Status:

    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