ACP2E-4156: a validação do endereço de entrega da API REST ignora a configuração do atributo Admin

Última atualização: 23 de junho de 2026

Criado para:

Experienced
Admin
Developer

O patch ACP2E-4156 corrige o problema em que a validação do endereço de remessa na API REST não adere à configuração de atributo definida em Administração. Este patch está disponível quando o Quality Patches Tool (QPT) 1.1.80 está instalado. A ID do patch é ACP2E-4156. Observe que esse problema está programado para ser corrigido no Adobe Commerce 2.4.9.

Produtos e versões afetados

O patch foi criado para a versão do Adobe Commerce:

Adobe Commerce (todos os métodos de implantação) 2.4.8-p4

Compatível com as versões do Adobe Commerce:

Adobe Commerce (todos os métodos de implantação) 2.4.8 - 2.4.8-p5

NOTE

O patch pode se tornar aplicável a outras versões com as novas versões do Quality Patches Tool. Para verificar se o patch é compatível com a sua versão do Adobe Commerce, atualize o pacote 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

Na API REST, a validação do endereço de entrega não respeita as configurações do atributo de endereço do cliente definidas no Administrador.

Etapas a serem reproduzidas:

Vá para Stores > Attributes > Customer Address no painel Admin.
Abra o atributo com o código de atributo firstname.
Em Attribute Properties, defina:
1. Input Validation: Somente Comprimento.
2. Minimum Text Length: 1.
3. Maximum Text Length: 20.
Acesse a loja e adicione o produto de teste ao carrinho.
Envie uma solicitação de API REST a /rest/default/V1/guest-carts/cartId/shipping-information para adicionar ou atualizar informações de envio com um valor de firstname com mais de 20 caracteres.

Resultados esperados:

Um erro é retornado indicando que o valor firstname excede o limite de comprimento configurado.

Resultados reais:

As informações de envio do carrinho de compras foram atualizadas com êxito com o valor firstname enviado na solicitação de API REST.

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.

Leitura relacionada

Para saber mais sobre Quality Patches Tool, consulte:

Quality Patches Tool: uma ferramenta de autoatendimento para patches de qualidade no guia Ferramentas.

recommendation-more-help

commerce-operations-help-tools