Mudando a máscara de CEP no Magento 2

Neste rápido tutorial vamos ver como modificar a máscara de CEP no Magento 2.

O módulo final para alterar a máscara de CEP de endereços nacionais estará disponível no final do artigo.

Por padrão, ao selecionar o país Brasil em um campo de endereço no Magento 2, o usuário é obrigado a digitar o CEP no formato 12345-123, caso contrário verá a mensagem de CEP inválido.

Esta validação de CEP é feita de forma dinâmica baseada em regras definidas em módulos internos do core do Magento.

Como alterar a máscara de CEP no Magento

Para realizar esta alteração precisaremos criar um novo módulo Magento 2 e depois adicionar um arquivo para sobrescrever a máscara existente para o país BR.

Para fins deste exemplo, o módulo criado será o Magenteiro_CepBrasil.

Onde a máscara de CEP é definida

As máscara de CEP são definidas no módulo Magento_Directory, em um arquivo XML localizado em <Magento_Directory>/etc/zip_codes.xml.

Lá podemos rapidamente encontrar o pattern que queremos modificar:

Como podemos ver, é no patern_2 que se encontra a expressão regular que valida o CEP Brasileiro obrigado que o caractere – seja adicionado.

Sobrescrevendo a máscara de CEP

Sendo assim, tudo que precisamos fazer é adicionar o arquivo app/code/Magenteiro/CepBrasil/app/etc/zip_codes.xml com a nova expressão:

Em expressões regulares, ao adicionarmos o ? após um caractere faz com que ele seja opcional. Desta forma, nossa validação de CEP passará a aceitar o CEP com ou sem –.

Bem simples não é mesmo?

Download do Módulo pronto

Se quiser, você pode fazer download do módulo inteiro. Basta informar seu nome e e-mail. O módulo será enviado pra você num instante

Também odeio spam. Seu e-mail estará seguro só comigo. e só mando coisas relacionadas a Magento.

Fontes relacionadas:
Documentação Magento 2 (Em Inglês)

• Sobre
• Últimos Posts

Ricardo Martins

É desenvolvedor web há 16 anos e um dos primeiros certificados pela Magento no Brasil. Instrutor de mais de 11 cursos Magento (os principais no magenteiro.com/cursos) com mais de 14 mil alunos de 105 países, é também criador do módulo PagSeguro Transparente, usado em mais de 12 mil lojas.

Últimos posts por Ricardo Martins (exibir todos)

• Você precisa testar esta plataforma de e-commerce - 9 de fevereiro de 2026
• A hora de montar o seu OnlyFans chegou! Veja 8 ideias pra começar o seu. - 4 de dezembro de 2024
• Vida longa ao Magento 1. Conheça o Maho. - 4 de outubro de 2024