Endereço

Configure campos de endereço com adaptação por país

O campo do tipo Endereço é utilizado para registrar informações completas de localização em formulários, tarefas e telas do ENSPACE.

Ele agrupa dados como rua, número, complemento, bairro, cidade, estado, país e CEP em um único campo composto — com adaptação automática da estrutura e dos rótulos conforme o país selecionado.

Quando usar este campo

Utilize o campo Endereço quando precisar capturar localizações completas e estruturadas.

Ele é ideal para:

• Cadastro de endereço de clientes e fornecedores (nacionais ou internacionais)
• Registro de local de entrega, atendimento ou correspondência
• Localização de eventos, obras ou visitas técnicas
• Pontos de coleta, filiais ou unidades operacionais
• Qualquer informação de localização que exija múltiplos subcampos organizados

Informações básicas do campo

Todo campo no ENSPACE possui quatro informações básicas que são definidas no momento da criação:

• Nome do campo — nome interno utilizado nas configurações da categoria. Possui limite de 31 caracteres. Não é necessariamente o nome exibido para o usuário final.
• Rótulo Visível (Label) — nome exibido para os usuários em formulários, tarefas e telas. Possui limite de 255 caracteres. Pode ser mais descritivo que o nome interno e pode ser alterado posteriormente sem impactar automações ou referências técnicas.
• Referência técnica — identificador técnico do campo, gerado automaticamente em formato snake_case. É utilizado em expressões, variáveis, fluxos, automações e referências internas.
• Descrição — descrição interna para adicionar contexto ao campo. Ajuda configuradores a entenderem a finalidade do campo e auxilia recursos de IA do ENSPACE durante pesquisas e interpretações automáticas.

Como o campo funciona

O campo Endereço funciona como um agrupamento estruturado de subcampos de localização vinculados a um país base.

O usuário seleciona o país e preenche os subcampos correspondentes. Quando um CEP ou ZIP Code válido é digitado, o sistema consulta a base de dados do país e preenche automaticamente os demais campos (rua, bairro, cidade, estado), reduzindo erros de digitação e agilizando o cadastro.

As configurações aplicadas podem alterar diretamente a experiência de preenchimento:

• O país selecionado determina quais subcampos são exibidos e seus rótulos.
• O campo Visualizar define como o endereço completo será apresentado na tabela de itens.
• O preenchimento automático depende da disponibilidade de base de dados para o país escolhido.

Configurações específicas

O campo Endereço possui recursos adicionais para controlar estrutura, localização e exibição. Todas as configurações abaixo são opcionais e ficam disponíveis na seção Configurações Específicas ao selecionar o tipo Endereço.

País e estrutura

Os subcampos exibidos no grupo Aninhado adaptam-se conforme o país selecionado:

• BRA: CEP, País, Rua, Número, Complemento, Bairro, Cidade, Estado.
• USA: ZIP Code, Country, Number, Street, Complement, City, State, ZIP+4 (Optional).
• Outros: Endereço linha 1, Endereço linha 2, Cidade, Estado/Provincia, CEP, País.

Formato de exibição

Como configurar

Comportamento dos dados

Algumas alterações feitas no campo afetam apenas novos preenchimentos:

• Alterar o país selecionado não modifica a estrutura de endereços já salvos em registros antigos.
• O preenchimento automático por CEP/ZIP ocorre apenas para Brasil e Estados Unidos.
• Modificar a expressão do campo Visualizar reflete imediatamente na tabela de itens, mas não altera o valor armazenado.
• Os dados anteriores só serão alterados caso sejam editados novamente.

Boas práticas

• Utilize BRA ou USA quando a maioria dos endereços for destes países, aproveitando o preenchimento automático por CEP/ZIP.
• Utilize Outros quando a empresa atua em múltiplos países ou em país não listado, garantindo flexibilidade de preenchimento manual.
• Configure o campo Visualizar com subcampos obrigatórios ou de alta relevância para evitar exibição incompleta na tabela de itens.
• Combine o campo Endereço com o campo Relacionamento Simples quando for necessário vincular o endereço a uma base de clientes ou locais pré-cadastrados.