Campo: Pessoa/Empresa

O campo do tipo Pessoa/Empresa permite selecionar uma pessoa física (CPF) ou jurídica (CNPJ) previamente cadastrada no workspace ou preencher automaticamente seus dados ao informar um documento válido. Esse campo facilita o preenchimento de informações com rapidez e precisão, sendo útil em cadastros, formulários e tarefas.

Além disso, é possível ativar a funcionalidade de preenchimento automático de endereço com base no CNPJ, tornando o processo ainda mais prático e completo.

Funcionamento básico

  • Permite inserir CPF ou CNPJ para preencher dados de pessoas ou empresas.
  • O endereço não é preenchido automaticamente, a menos que a opção específica seja ativada.

Como configurar

  1. No menu esquerdo, vá até a seção “Configurações”.
  2. Acesse “Categorias” e selecione a categoria desejada.
  3. Vá em “Campos” e clique em “Criar”.
  4. Dê um nome curto ao seu campo (com até 31 caracteres; a referência será preenchida automaticamente).
  5. Defina o label do seu campo — aqui você pode inserir um nome mais longo e descritivo.

    ⚠️ Atenção: O nome exibido no formulário será sempre o definido no campo "Label".

  6. Selecione o tipo “Pessoa/Empresa”. Configuração do campo Pessoa/Empresa

Busca e preenchimento automático

  • Ao inserir um CNPJ válido, o sistema realiza a busca automática dos dados da empresa.
  • Se o preenchimento de endereço estiver ativado, o campo vinculado será preenchido com os dados retornados.
  • Caso seja inserido um CPF válido, os dados relacionados à pessoa física também podem ser preenchidos automaticamente.

Ativação de endereço

  • Um switch chamado "Ativar preenchimento de endereço" estará disponível nas configurações do campo.
  • Quando ativado, será exibido um seletor com o rótulo "Campo de Endereço", onde você deve escolher um campo de endereço previamente criado.
  • ⚠️ É obrigatório que o campo de endereço já exista para poder vinculá-lo.
  • Se desativado, o preenchimento automático do endereço não será realizado.
Visualização do campo Pessoa/Empresa preenchido

Funcionamento na prática

Quando o preenchimento automático estiver habilitado e um campo de endereço tiver sido selecionado:

  • Ao digitar um CNPJ válido, o sistema buscará os dados públicos vinculados.
  • Se houver informações de endereço, o campo de endereço vinculado será automaticamente preenchido com:
    • Logradouro
    • Número
    • Bairro
    • Cidade
    • Estado
    • CEP

Exemplo de uso

  • Selecionar um cliente e preencher automaticamente seus dados.
  • Vincular uma empresa a um processo e popular os campos com base no CNPJ.
  • Preencher formulários de cadastro de maneira ágil e precisa.

Resultado esperado

Visualização do campo Pessoa/Empresa preenchido