Campos personalizáveis de pacientes
Como criar, ativar e usar campos extras no cadastro, edição e check-in de pacientes
Os campos personalizáveis de pacientes permitem que cada clínica colete informações extras no cadastro sem depender de um formulário fixo para todos os cenários.
Esse recurso é útil quando sua equipe precisa registrar dados como:
- Convênio secundário
- Cidade de origem
- Responsável financeiro
- Número interno de prontuário
- Preferência de contato
Apenas usuários com permissão de gestão da clínica podem criar, editar, ativar ou remover esses campos em Configurações > Pacientes e prontuário.
Antes de começar
- O recurso é configurado por clínica.
- Depois de ativado, os campos aparecem nos fluxos de cadastro, edição e check-in do paciente.
- Campos marcados como obrigatórios bloqueiam o salvamento enquanto estiverem vazios.
- A seção fica em Pacientes e prontuário, junto com outras preferências do cadastro de pacientes.
Como ativar o recurso
- Acesse Configurações > Pacientes e prontuário.
- Localize a seção Campos personalizáveis de pacientes.
- Ative o controle Habilitar recurso.
Quando o recurso estiver ligado, a clínica passa a exibir a lista de campos configurados e o botão Novo campo.
Como criar um novo campo
- Na seção Campos personalizáveis de pacientes, clique em Novo campo.
- Preencha as informações do campo.
- Salve para disponibilizá-lo nos formulários do paciente.
O que cada opção significa
| Campo | Como usar |
|---|---|
| Nome do campo | Texto exibido para a equipe no formulário |
| Chave técnica | Identificador interno usado para salvar o valor |
| Tipo | Define se o campo será texto, seleção, data ou número |
| Placeholder | Dica opcional exibida dentro do campo |
| Obrigatório | Exige preenchimento antes de salvar |
| Ativo | Controla se o campo aparece ou fica oculto |
Tipos disponíveis
| Tipo | Quando usar |
|---|---|
| Texto | Informações livres, como observação curta ou código interno |
| Select | Opções fechadas, como unidade, origem ou convênio |
| Data | Datas específicas, como validade ou data de referência |
| Número | Valores numéricos simples |
Em campos do tipo Select, informe uma opção por linha. O sistema elimina duplicidades e exige pelo menos uma opção válida.
Onde os campos aparecem depois
Depois de salvos e ativados, os campos passam a aparecer automaticamente em:
- Novo paciente
- Editar paciente
- Check-in
Os valores preenchidos ficam vinculados ao paciente, então podem ser atualizados sempre que necessário nesses mesmos fluxos.
Como editar, ocultar ou remover um campo
Na lista de campos configurados, você pode:
- Editar para ajustar nome, placeholder, tipo ou obrigatoriedade
- Desativar para esconder temporariamente o campo sem removê-lo da configuração
- Remover para excluir o campo da lista ativa da clínica
Evite trocar a chave técnica depois que o campo já estiver em uso. Na prática, a nova chave passa a ser tratada como outro campo, e os valores antigos deixam de aparecer automaticamente no formulário.
Regras e limites importantes
- Cada clínica pode ter até 20 campos personalizados.
- Cada campo do tipo Select pode ter até 20 opções.
- A chave técnica deve usar letras minúsculas, números e
_, começando por letra. - A chave técnica pode ter até 48 caracteres.
- O nome do campo pode ter até 60 caracteres.
- O placeholder pode ter até 80 caracteres.
- Cada valor preenchido pelo paciente pode ter até 255 caracteres.
Boas práticas
- Use desativar antes de remover um campo que ainda pode voltar a ser usado.
- Prefira nomes claros para a equipe, mesmo que a chave técnica seja mais curta.
- Evite criar campos muito parecidos entre si, para não confundir o preenchimento.
- Se o campo vai alimentar exportações ou integrações, defina a chave técnica com cuidado e mantenha esse padrão.
Exemplo prático
Uma clínica quer registrar como cada paciente prefere receber lembretes. O administrador pode criar:
- Nome do campo: Preferência de contato
- Chave técnica:
preferencia_contato - Tipo: Select
- Opções:
- Ligação
- Obrigatório: Sim
Depois disso, toda a equipe verá esse campo no cadastro, na edição e no check-in do paciente.