Como realizar Endereço obrigatório no cadastro de proprietários

Visão geral

A funcionalidade de endereço obrigatório permite configurar o ERP Imobiliárias para exigir o preenchimento completo das informações de endereço nos cadastros de proprietários. Quando ativada, a validação é aplicada na inclusão manual, na edição de cadastros existentes, nas importações de dados por arquivo e nos cadastros realizados via integração por API, garantindo a integridade da base de dados da imobiliária.

Quando usar este artigo

Utilize este artigo quando a imobiliária desejar ativar a obrigatoriedade de endereço no cadastro do proprietário, compreender o comportamento do sistema nos diferentes pontos de entrada de dados ou orientar a equipe sobre os campos obrigatórios.

Sintoma ou cenário

Cadastros de proprietários salvos sem endereço ou com dados de localização incompletos.
Inconsistências cadastrais que geram dificuldades operacionais, fiscais ou no envio de repasses.
Necessidade de padronizar a entrada de dados em novos cadastros, importações por arquivo ou integrações via API.

Benefício para o usuário ou operação

Elimina o retrabalho de correção manual de cadastros com dados de endereço ausentes.
Assegura maior conformidade fiscal e precisão na emissão de documentos.
Garante que integrações por API e rotinas de importação por arquivo gravem apenas cadastros completos.
Oferece controle à imobiliária, permitindo ativar ou desativar a validação a qualquer momento.

Onde acessar / contexto de uso

Acesse Clientes e Colaboradores > Configurações (ou utilize o atalho do ícone de engrenagem no menu correspondente).

Pré-requisitos (Antes de começar)

Permissão de acesso ao menu de configurações do módulo de clientes e colaboradores no ERP Imobiliárias.
Revisão prévia das planilhas de importação de proprietários para garantir que contenham os dados de endereço completos.
Alinhamento técnico com a equipe responsável por integrações via API, assegurando o envio de todos os campos de endereço nas requisições.

Causas prováveis

Cadastros com informações incompletas ocorrem porque a trava de obrigatoriedade de endereço vem desabilitada por padrão no ERP Imobiliárias. Sem essa validação ativa, o sistema permite salvar registros com campos de endereço em branco ou parcialmente preenchidos por usuários ou integrações.

Como fazer ou corrigir

Como ativar a obrigatoriedade de endereço

No menu principal, acesse Clientes e Colaboradores > Configurações.
Clique na Engrenagem de configuração ao lado direito superior.
Localize e marque o campo Exigir preenchimento de endereço no cadastro do proprietário.
Clique em Salvar para aplicar a alteração.

Comportamento do sistema com a validação ativa

Após salvar a configuração, o ERP Imobiliárias passará a validar as informações de endereço da seguinte forma:

Bloqueio de salvamento: Se um cadastro de proprietário for submetido com campos de endereço pendentes, o sistema exibirá um alerta e destacará os campos obrigatórios na tela.
Abrangência de entrada: A validação é aplicada simultaneamente a novos cadastros manuais, edições de registros existentes, importações de dados por arquivo e requisições via API.
Cadastros antigos: Registros já existentes no sistema sem endereço não são bloqueados automaticamente de forma retroativa. A validação será exigida no momento em que o cadastro do proprietário for aberto para edição e salvo.

Resultado esperado

Os novos cadastros e edições de proprietários serão salvos na plataforma exclusivamente com as informações de endereço completas, apresentando mensagem de alerta e bloqueio de tela caso algum campo obrigatório fique em branco.

Quando escalar

Escalone o atendimento ao Suporte ERP Imobiliárias caso a opção de configuração esteja ativada e salva, mas o sistema continue permitindo a gravação de cadastros de proprietários sem endereço, ou se ocorrer erro impeditivo ao tentar salvar a alteração no menu de configurações.

Informações para escalonamento

Ponto de entrada em que ocorreu a falha (cadastro manual, edição, importação por arquivo ou chamada via API).
Nome completo ou identificador do proprietário afetado.
Arquivo utilizado na importação ou código retornado na integração por API (se aplicável).
Captura de tela inteira da mensagem de erro ou do comportamento do sistema.
Data e horário da tentativa de gravação.

Regras importantes / Observações

Campos Obrigatórios: Com a trava ativa, o sistema exige o preenchimento de: Logradouro, Número, CEP, Bairro, Cidade, UF e País.
Endereços sem Numeração: Para locais ou imóveis sem número específico, informe a sigla S/N no campo Número.
Perfis Afetados: A validação aplica-se estritamente aos cadastros com perfil de Proprietário e Proprietário + Locatário. Não afeta perfis exclusivos de Locatário, Fiador, Corretor e Fornecedor.
Ativação Opcional: A funcionalidade permanece desativada por padrão e pode ser habilitada ou desabilitada a qualquer momento pela imobiliária.

Problemas comuns e como resolver

Problema: O arquivo de importação de proprietários é rejeitado com erro de validação.

Causa provável: O arquivo possui registros com dados de endereço em branco ou incompletos.

Ação recomendada: Revise a planilha de importação, preencha as colunas de endereço completas para todos os proprietários (utilizando S/N na ausência de número) e execute a importação novamente.

Problema: A integração via API retorna erro ao tentar cadastrar ou atualizar proprietários.

Causa provável: O sistema integrado não está enviando todos os parâmetros de endereço exigidos na requisição.

Ação recomendada: Oriente a equipe técnica responsável pela API a ajustar a integração para enviar todos os campos obrigatórios de logradouro, número, CEP, bairro, cidade, UF e país.

Problema: Proprietários cadastrados antes da ativação continuam sem endereço na base de dados.

Causa provável: A ativação do parâmetro não atualiza automaticamente os dados retroativos sem intervenção na tela.

Ação recomendada: Esse é o comportamento padrão. O ERP Imobiliárias aplicará a trava individualmente no momento em que a imobiliária acessar e salvar a edição de cada cadastro antigo.

Dúvidas relacionadas (FAQ)

P: A ativação da trava de endereço é feita automaticamente no sistema?

R: Não. A funcionalidade permanece desativada por padrão e deve ser habilitada manualmente pela imobiliária no menu de configurações.

P: O que deve ser preenchido no campo Número para cadastros que não possuem numeração?

R: Informe a sigla S/N (sem numeração) no campo Número para que a validação reconheça o preenchimento correto.

P: A validação de endereço afeta o cadastro de locatários e fornecedores?

R: Não. A obrigatoriedade é restrita aos perfis de Proprietário e Proprietário + Locatário. Locatários exclusivos, fiadores, corretores e fornecedores não são impactados.

P: É possível desativar a obrigatoriedade do endereço após a ativação?

R: Sim. A imobiliária pode desmarcar a opção em Clientes e Colaboradores > Configurações a qualquer momento para desativar a validação.

Palavras-chave de busca

endereço obrigatório proprietário, exigir endereço cadastro, validação de endereço, preencher endereço proprietário, Exigir preenchimento de endereço, Clientes e Colaboradores Configurações, ERP Imobiliárias, Suporte ERP Imobiliárias