Pessoa/Empresa
Configure campos de pessoa/empresa com preenchimento automático por documento
O campo do tipo Pessoa/Empresa é utilizado para registrar informações cadastrais de pessoas físicas (CPF) ou jurídicas (CNPJ) em formulários, tarefas e telas do ENSPACE.
Ele permite selecionar dados previamente estruturados no workspace ou preencher automaticamente informações ao informar um CNPJ válido, vinculando nome, documentos e endereço de forma rápida e padronizada.
Quando usar este campo
Utilize o campo Pessoa/Empresa quando precisar capturar dados cadastrais completos de pessoas ou empresas.
Ele é ideal para:
- Cadastro de clientes, fornecedores ou parceiros comerciais
- Vinculação de empresas a processos, contratos ou pedidos
- Preenchimento automático de razão social e endereço via CNPJ
- Formulários de onboarding que exigem dados jurídicos ou pessoais
- Qualquer contexto que exija CPF ou CNPJ como identificador principal
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 Pessoa/Empresa funciona como um seletor inteligente de dados cadastrais vinculados a um documento principal.
O usuário informa um CNPJ válido e o sistema consulta dados públicos para preencher automaticamente os subcampos relacionados (razão social, nome fantasia, endereço). Para CPF, o preenchimento automático não está disponível devido a limitações legais de acesso a dados de pessoa física.
As configurações aplicadas podem alterar diretamente a experiência de preenchimento:
- O toggle de preenchimento automático de endereço vincula um campo de endereço existente.
- O campo Visualizar define como os dados cadastrais serão apresentados na tabela de itens.
- Os subcampos aninhados podem ser reordenados, removidos ou complementados, exceto o CNPJ que é fixo.
Configurações específicas
O campo Pessoa/Empresa possui recursos adicionais para controlar preenchimento automático, exibição e estrutura de subcampos. Todas as configurações abaixo são opcionais e ficam disponíveis na seção Configurações Específicas ao selecionar o tipo Pessoa/Empresa.
Preenchimento automático de endereço
| Configuração | Descrição |
|---|---|
| Ativar preenchimento de endereço | Quando ativado, o campo adiciona dados de endereço vinculados ao CNPJ consultado. Exibe o seletor Campo de Endereço para vinculação. |
| Campo de Endereço | Seletor disponível quando o preenchimento automático está ativo. Define qual campo de endereço previamente criado será preenchido automaticamente com os dados retornados pela consulta de CNPJ. |
Formato de exibição
| Configuração | Descrição |
|---|---|
| Visualizar | Expressão de formatação que define como os dados cadastrais serão exibidos na tabela de itens. Utiliza chaves {{}} para referenciar subcampos. Exemplo: {{cnpj}} - {{razao_social}}. |
Subcampos (Aninhado)
Define a estrutura de subcampos que compõem o cadastro de pessoa/empresa:
| Configuração | Descrição |
|---|---|
| Campos Disponíveis | Lista de subcampos predefinidos que podem ser reordenados, removidos ou complementados com novos campos adicionados via botão Adicionar. |
| CNPJ | Subcampo fixo e obrigatório. Não pode ser removido, reordenado nem desabilitado. Serve como identificador principal da consulta automática. |
Modal de edição de subcampo
Ao clicar em editar um subcampo da lista, um modal é aberto com as seguintes configurações:
| Configuração | Descrição |
|---|---|
| Campo | Dropdown com as predefinições disponíveis: CPF, Nome, Nome Fantasia, Nome da Empresa. |
| Obrigatoriedade | Define se o subcampo deve ser preenchido obrigatoriamente. |
| Bloquear Campo | Quando ativo, torna o subcampo somente leitura. Útil para campos preenchidos automaticamente (ex: razão social via CNPJ) que não devem ser editados manualmente. |
| Transformadores de Texto | Aplica transformações automáticas ao conteúdo do subcampo (ex: uppercase, trim). |
| Máscaras | Adiciona máscaras de formatação ao subcampo (ex: CPF - 999.999.999-99). |
Como configurar
Crie um novo campo
Acesse Configurações > Categorias > Campos e clique em Criar.
Preencha as informações básicas
Defina o nome do campo, a referência técnica, o rótulo visível (Label) e selecione o tipo Pessoa/Empresa.
Configure os subcampos
Na seção Configurações Específicas, revise os Campos Disponíveis no grupo Aninhado. Reordene, remova ou adicione subcampos conforme a necessidade. Edite cada subcampo para definir obrigatoriedade, bloqueio, transformadores e máscaras.
Ative o preenchimento automático de endereço (opcional)
Habilite o toggle Ativar preenchimento de endereço e selecione um Campo de Endereço previamente criado na categoria.
Defina o formato de exibição
No campo Visualizar, configure a expressão de resumo para exibição na tabela de itens, utilizando chaves {{}} para referenciar os subcampos.
Salve o campo
Após salvar, o campo poderá ser utilizado em formulários, tarefas e telas.
Comportamento dos dados
Algumas alterações feitas no campo afetam apenas novos preenchimentos:
- Adicionar ou remover subcampos não altera registros já salvos em itens anteriores.
- Ativar ou desativar o preenchimento automático de endereço não modifica endereços já preenchidos em registros antigos.
- Alterar a obrigatoriedade ou o bloqueio de um subcampo não retroage em registros existentes.
- O preenchimento automático de endereço ocorre apenas no momento da digitação do CNPJ; registros já salvos não são atualizados automaticamente se o CNPJ for alterado posteriormente na base pública.
- Os dados anteriores só serão alterados caso sejam editados novamente.
Boas práticas
- Utilize o preenchimento automático de endereço vinculado a um campo de endereço da mesma categoria para garantir que a estrutura de localização esteja disponível.
- Ative Bloquear Campo em subcampos preenchidos automaticamente via CNPJ (ex: razão social) para evitar edição acidental e manter a integridade dos dados consultados.
- Configure o campo Visualizar com documento e nome para facilitar a identificação na tabela de itens.
- Mantenha o subcampo CNPJ visível e obrigatório quando a consulta automática for o fluxo principal de preenchimento.
- Adicione máscaras de CPF e CNPJ nos subcampos correspondentes para padronizar a digitação e evitar formatos inválidos.