A funcionalidade de captura do código postal pelo endereço permite que o sistema localize automaticamente o CEP (código postal) com base nas informações do endereço preenchido pelo usuário. Isso facilita o processo de cadastro e reduz erros no preenchimento manual do CEP.
Objetivo #
- Simplificar a experiência do usuário no preenchimento de formulários.
- Garantir maior precisão e consistência nos dados de endereço.
- Reduzir erros de entrega causados por CEPs incorretos.
Pré-Requisitos #
- Plataforma Soulmkt configurada com a API de consulta de endereços habilitada.
- Conexão ativa com o serviço externo de validação de endereço (ex: Correios, API local, ou outro serviço integrado).
- Campos obrigatórios de endereço disponíveis no formulário (Rua, Número, Bairro, Cidade, Estado).
Fluxo de Uso #
- O usuário acessa o formulário de cadastro ou checkout.
- Preenche os campos de endereço (Rua, Número, Bairro, Cidade e Estado).
- Ao confirmar os dados ou sair do campo de endereço, o sistema:
- Envia os dados para o serviço de consulta.
- Recebe como retorno o CEP correspondente.
- Preenche automaticamente o campo de CEP no formulário.
- Caso não seja encontrado um CEP válido, o sistema exibe mensagem de alerta para que o usuário revise os dados.
Configurações no Admin #
- Ativar/Desativar a Captura Automática: opção disponível em Sistema → Configurações → Localização do cliente.
- API Key/Token: inserir chave de acesso fornecida pelo serviço de CEP.
- Mensagens Personalizadas: configurar aviso para casos de falha ou ausência de CEP correspondente.


Observações Técnicas #
- A consulta de CEP pode variar conforme a base utilizada (nacional ou internacional).
- Em caso de múltiplos resultados para o mesmo endereço, o sistema exibirá o mais preciso com base nos campos preenchidos.
- Recomendado validar se todos os campos obrigatórios de endereço estão preenchidos antes da consulta automática.
Se tiver qualquer dificuldade ou dúvida, entre em contato com nossa equipe de suporte. Estamos sempre à disposição para ajudar!