Dados obrigatórios: o que a clínica precisa configurar para cada módulo funcionar
Como funcionam as políticas de campos obrigatórios do cadastro de cliente (CPF, endereço, e-mail etc.) por contexto (venda, NFS-e, boleto, contrato, assinatura) — níveis soft e hard, travas de integração, política da matriz vs da clínica.
A tela de Dados Obrigatórios define quais campos do cadastro de cliente são obrigatórios em cada contexto do sistema. É a “política de completude” da clínica: o mínimo que o cadastro precisa ter para que determinadas coisas funcionem (vender, emitir nota, cobrar boleto, gerar contrato, assinar digitalmente).
Este guia explica como o sistema decide “esse campo é obrigatório”, como ajustar a política da sua clínica, e quando mexer (e quando não mexer).
Como abrir
Configurações → Dados Obrigatórios (rota
/app/dados-obrigatorios).
A tela tem 5 abas (uma por contexto) + uma seção de políticas.
Os 5 contextos
Cada contexto representa um “momento” do sistema que precisa de dados específicos:
| Contexto | Quando é exigido | O que precisa ter no cadastro |
|---|---|---|
| Venda | Ao lançar venda que gera NFS-e automática | CPF, nome completo, endereço |
| NFS-e | Ao emitir nota fiscal de serviço | CPF ou CNPJ, endereço, e-mail (recibo) |
| Boleto | Ao gerar boleto pelo Asaas | CPF, endereço completo, e-mail |
| Contrato | Ao gerar contrato (PDF) | Nome completo, CPF, endereço |
| Assinatura | Ao enviar pra assinatura digital | Nome, CPF, e-mail |
O contexto Avaliação (agendamento da avaliação) é o sexto, mas ainda não tem enforcement — o sistema não bloqueia agendamento por falta de dado, mas pode vir a bloquear no futuro.
Os 3 níveis de exigência
Para cada campo em cada contexto, você pode exigir:
- Off (desligado) — o campo não é obrigatório nesse contexto. Se faltar, o sistema não avisa e a ação prossegue.
- Soft (recomendado) — o sistema avisa que o campo está faltando, mas deixa a ação prosseguir. Para confirmar, o operador clica em “ok, prosseguir mesmo assim”.
- Hard (bloqueante) — o sistema bloqueia a ação até o campo ser preenchido. Sem o campo, não dá pra vender / emitir / cobrar.
Use hard para o que é fiscal/legal (CPF para NFS-e). Use soft para o que é comercial (e-mail para follow-up). Use off para o que não afeta o contexto.
O que trava cada contexto
Algumas integrações travam o nível de exigência no hard automaticamente. Por exemplo:
- NFS-e automática (quando ativada) — exige CPF, endereço, etc. no contexto Venda em nível hard. Você não consegue desligar.
- Boleto Asaas — exige CPF, endereço completo, e-mail no contexto Boleto em nível hard.
- Assinatura digital — exige e-mail (pra onde vai o link) e CPF (pra quem assina) em hard.
Essas travas aparecem na tela marcadas como “Exigido por [integração]” e ficam em cinza — você não consegue reduzir, só aumentar a exigência.
Política da matriz vs da clínica
A política de obrigatoriedade tem duas camadas:
- Política da matriz (grupo / rede) — definida pelo time de produto / corporativo. É o piso que vale pra todas as clínicas da rede. Você não pode reduzir abaixo do que a matriz definiu.
- Política da clínica — você (gerente da clínica) pode endurecer a regra do seu lado. Por exemplo, se a matriz diz “CPF é soft para Venda”, você pode mudar pra “CPF é hard para Venda” na sua clínica.
Na tela, os campos que vêm da matriz aparecem com o badge “Definido pela matriz” e ficam em cinza. Você só consegue aumentar a exigência, não diminuir.
Como ajustar a política da sua clínica
- Abra a aba do contexto que quer ajustar (ex.: “Boleto”).
- Para cada campo, escolha o nível:
- Off — desmarca.
- Soft — “recomendado” / aviso.
- Hard — “obrigatório” / bloqueia.
- Salvar no rodapé da página.
- A política entra em vigor imediatamente.
O sistema mostra o piso da matriz em cinza (não editável pra baixo) e a sua escolha atual logo abaixo (editável).
O que acontece na prática
Cenário 1 — Venda sem CPF:
- Política: CPF é hard para Venda (porque a clínica emitirá NFS-e automática).
- Recepcionista lança venda no PDV sem CPF no cadastro.
- Sistema bloqueia com mensagem: “CPF é obrigatório para concluir a venda. Preencha o cadastro do cliente antes de continuar.”
- Recepcionista vai na ficha do cliente, preenche CPF, volta ao PDV, finaliza.
Cenário 2 — Venda sem e-mail (e e-mail é soft):
- Política: e-mail é soft para Venda.
- Recepcionista lança venda no PDV sem e-mail.
- Sistema avisa: “E-mail não cadastrado. Sem e-mail, o cliente não recebe recibo nem pesquisa de satisfação. Deseja continuar mesmo assim?”
- Recepcionista confirma → venda prossegue.
Boas práticas
- Comece com a política da matriz. Não endureça sem motivo — cada endurecimento é uma fricção adicional para a operação.
- Endureça o que é fiscal/legal. CPF, CNPJ, endereço — tudo que vai pra documento emitido tem que estar correto.
- Deixe soft o que é comercial. E-mail, telefone secundário, profissão — bom ter, mas não trava.
- Revise 1x por trimestre. Quando a clínica começa a usar um módulo novo (ex.: assinatura digital), os requisitos mudam.
- Comunique a mudança. Quando endurecer uma regra, avise a equipe — senão vão reclamar “o sistema não deixa eu vender”.
Quando NÃO mexer
- Não desative a trava de integração (NFS-e, Asaas, etc.) — o sistema não permite pela UI, mas tentar via suporte para “driblar” causa nota fiscal rejeitada ou boleto não registrado.
- Não reduza a política da matriz — a tela não permite pela UI.
- Não confie só no aviso (soft) para o que é fiscal. Use hard — o soft só avisa, e o operador pode confirmar sem querer.
Quem pode mexer
- Ver a política: leitura de configuração.
- Ajustar política da clínica: permissão
config.geral(geralmente restrita a gerentes e administradores). - Alterar política da matriz: só o time de produto / corporativo (não editável pela clínica).
Perguntas rápidas
Configurei e o sistema continua deixando a venda prosseguir sem o campo. Você provavelmente configurou soft (aviso) e o operador está confirmando o aviso. Para bloquear de verdade, mude pra hard.
A política da minha clínica está cinza / não consigo mexer. A regra está travada por uma integração (NFS-e, Asaas, etc.) ou definida pela matriz. Não dá pra reduzir — só aumentar.
Configurei um campo como hard mas os agendamentos antigos estão sem o campo. A política vale para novas ações. Para corrigir cadastros antigos, use a lista de clientes filtrando por “sem CPF” (ou outro campo) e atualize manualmente — ou peça ajuda ao suporte para um script de correção.
Posso ter uma política diferente por clínica (rede/franquia)? Sim — cada clínica tem a sua política. A política da matriz é o piso comum.
Como sei se a clínica tem o módulo X ativo? Vá em Minha Empresa → aba Sistema e procure “Recursos ativos” ou pergunte ao suporte.
Dúvidas sobre como definir a política certa para a sua clínica, ou sobre como preencher cadastros antigos? Chame o suporte pelo WhatsApp — a gente ajuda a montar e auditar.
Precisa de ajuda?
Nossa equipe de suporte está pronta para te ajudar com qualquer dúvida.
Falar com suporte