Lição: Pacientes e Cadastros
Esta lição prepara você para operar o módulo de Pacientes do Sistema Rabi do zero: cadastrar um paciente completo, buscar registros, vincular convênios, anexar documentos e consultar o histórico. O cadastro de paciente é a base de quase todos os outros módulos, por isso precisa estar sempre correto e atualizado.
🟢 Todo o conteúdo desta lição está EM PRODUÇÃO — pode usar como uso real. Inclui o limite de anexo de 50 MB por arquivo (junho/2026).
1. Objetivo do módulo e onde fica
O módulo de Pacientes é o cadastro central de todos os pacientes da clínica: dados pessoais, contato, endereço, documentos, convênios e histórico. Agendamento, Prontuário, Financeiro e Faturamento usam esse cadastro como base.
- Menu: Pacientes (barra lateral).
- Rota principal:
/portal/pacientes - URL completa (produção):
http://app.rabisistemas.com.br/portal/pacientes
1.1. Telas do módulo
| Tela | Rota | Para que serve |
|---|---|---|
| Lista de pacientes | /portal/pacientes | Listar, buscar e acessar pacientes |
| Novo paciente | /portal/pacientes/criar | Formulário de cadastro |
| Editar paciente | /portal/pacientes/:id/editar | Alterar dados do cadastro |
| Detalhes / histórico | /portal/pacientes/:id | Ver cadastro completo, documentos e histórico |
2. Lista de pacientes
A lista (/portal/pacientes) exibe todos os pacientes cadastrados.
2.1. Busca e filtros
O campo de busca no topo localiza pacientes por Nome (parcial), CPF (com ou sem pontuação) ou Celular (com ou sem formatação). Os resultados são filtrados em tempo real conforme a digitação.
✅ Novo — jul/2026 Busca global (#456): agora é possível encontrar o paciente por parte do nome, telefone, e-mail ou CPF. Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
2.2. Colunas da tabela
| Coluna | Descrição |
|---|---|
| Nome | Nome completo do paciente |
| CPF | CPF formatado; exibe "Estrangeiro" quando aplicável |
| Data Nasc. | Data de nascimento (dd/mm/aaaa) |
| Celular | Número de celular para contato |
| Endereço de e-mail | |
| Status | Status atual do paciente |
2.3. Status do paciente
| Status | Descrição |
|---|---|
| Aguardando | Cadastrado, aguardando primeiro atendimento/confirmação |
| Confirmado | Agendamento confirmado para o paciente |
| Cancelado | Atendimento/agendamento cancelado |
| Atendido | Já foi atendido |
| Em Atendimento | Em atendimento no momento |
| Acolhido | Recebido na recepção (check-in feito) |
| Remarcado | Agendamento remarcado |
| Pendente | Pendência administrativa ou financeira |
| Pago | Situação financeira regularizada |
| Parcialmente Pago | Pagamento parcial registrado |
2.4. Ações por paciente
- Editar — abre o formulário de edição (
/portal/pacientes/:id/editar). - Ver detalhes — abre a visualização completa e o histórico (
/portal/pacientes/:id).
3. Cadastrar novo paciente (passo a passo)
Acesse /portal/pacientes/criar ou clique em "Novo Paciente" na lista.
3.1. Dados pessoais
| Campo | Obrigatório? | Validação / Observação |
|---|---|---|
| Nome | Obrigatório | Nome completo |
| CPF | Obrigatório* | Validação de CPF. *Não exigido se marcado como Estrangeiro. |
| Nome social ✅ Novo — 05/10/2026 | Opcional | Nome pelo qual a pessoa quer ser chamada. As telas mostram "NOME SOCIAL (nome civil)" e o nome social vai automaticamente no campo Nome Social da guia/XML TISS. Também aparece no agendamento/acolhimento e na criação rápida da Autorização. |
| RG | Opcional | Documento de identidade |
| UF Emissor | Opcional | Estado emissor do RG |
| Data de Nascimento | Obrigatório | Formato dd/mm/aaaa |
| Sexo | Opcional | Masculino, Feminino ou outro |
| Estado Civil | Opcional | Solteiro, Casado, Viúvo etc. |
| Estrangeiro | Opcional | Marque quando o paciente não possui CPF brasileiro (dispensa o CPF) |
| Foto | Opcional | Upload de foto de perfil |
✅ Novo — ago/2026 Proteção do cadastro (#592): os dados pessoais do paciente (nome, CPF etc.) passaram a ficar bloqueados para edição nas telas — proteção do cadastro contra alterações indevidas. Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
3.2. Contato
| Campo | Obrigatório? | Validação / Observação |
|---|---|---|
| Opcional | Endereço para comunicações | |
| Telefone | Opcional | Telefone fixo |
| Celular | Obrigatório | Validação de telefone/celular; principal canal de contato |
3.3. Endereço
| Campo | Obrigatório? | Validação / Observação |
|---|---|---|
| CEP | Opcional | Validação de CEP; ao informar, preenche os campos abaixo automaticamente |
| Logradouro | Opcional | Rua, avenida etc. |
| Número | Opcional | Número do imóvel |
| Complemento | Opcional | Apartamento, bloco, sala etc. |
| Bairro | Opcional | Bairro do endereço |
| Cidade | Opcional | Cidade do endereço |
| Estado | Opcional | UF do estado |
✅ Novo — ago/2026 No agendamento online (serviço online), o endereço completo do paciente passou a ser exigido para agendar (correção em produção em 12/08/2026). Mantenha o endereço do cadastro completo para evitar bloqueio no agendamento online.
3.4. Informações complementares
| Campo | Obrigatório? | Observação |
|---|---|---|
| Responsável | Opcional para adulto; obrigatório para menor de idade ✅ Novo — 29/09/2026 | Responsável legal (menores ou dependentes). Desde 29/09/2026, no paciente menor de idade — idade calculada pela Data de Nascimento — o sistema exige o responsável legal: nome, CPF e parentesco. |
| Pessoa de Contato | Opcional | Lista de pessoas de contato vinculadas ao paciente |
| Observações | Opcional | Anotações administrativas ou clínicas |
3.5. Sequência completa
- Abra o formulário: "Novo Paciente" ou
/portal/pacientes/criar. - Preencha os dados pessoais (Nome, CPF, Data de Nascimento são obrigatórios; marque Estrangeiro se não houver CPF).
- Informe o contato (Celular é obrigatório).
- Preencha o endereço começando pelo CEP (autopreenche o restante).
- Adicione informações complementares (responsável, contatos, observações).
- Se quiser, vincule convênio/plano/carteira e anexe documentos.
- Clique em "Salvar". O paciente fica disponível imediatamente para agendamentos e atendimentos.
4. Convênio do paciente
Você pode vincular um ou mais convênios ao cadastro. Essa informação vira o padrão sugerido ao criar agendamentos.
- No cadastro/edição, localize a seção Convênio / Plano / Carteira.
- Selecione o Convênio (operadora).
- Selecione o Plano (as opções são filtradas pelo convênio escolhido).
- Informe o Número da Carteira do paciente naquele convênio.
- Salve.
| Campo | Obrigatório? | Descrição |
|---|---|---|
| Convênio | Opcional | Operadora de saúde (ex.: Unimed, Bradesco Saúde) |
| Plano | Opcional | Plano contratado dentro da operadora |
| Número da Carteira | Opcional | Identificação do paciente junto à operadora. ✅ Novo — 05/10/2026 aviso não bloqueante de carteirinha duplicada ou com número quase igual (no paciente e no agendamento); a carteira repetida só barra no mesmo convênio. |
✅ Novo — ago/2026 Recuperação de carteirinhas (#308): carteirinhas excluídas (soft-delete) passaram a ser listáveis para recuperação — uma carteirinha removida por engano pode ser restaurada. Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
Ao agendar, o convênio vinculado é sugerido automaticamente; o operador pode trocá-lo no formulário do agendamento.
5. Documentos do paciente
É possível anexar documentos digitalizados ao cadastro. Tipos suportados: CPF, RG e Outros (laudos, receitas, documentos de convênio etc.). Formatos aceitos: PDF, JPG, PNG.
- No cadastro/edição, localize a seção Anexos (final do formulário).
- Para cada tipo, arraste e solte o arquivo na área indicada ou clique para abrir o seletor.
- Selecione o arquivo e aguarde a conclusão do upload.
- Salve o cadastro.
🟢 Limite de anexo: 50 MB por arquivo (desde junho/2026). Permite anexar exames e laudos em alta resolução sem compactar.
Na tela de detalhes (/portal/pacientes/:id), os documentos anexados aparecem listados com opções de visualizar e remover.
⚠️ LGPD: dados de saúde são sensíveis. CPF, RG e documentos contêm dados pessoais — garanta que apenas usuários autorizados tenham acesso. O paciente pode solicitar exclusão de dados conforme a LGPD.
6. Histórico do paciente
Na tela de detalhes (/portal/pacientes/:id), o histórico completo é registrado automaticamente a cada interação e é de leitura:
| Seção | Conteúdo |
|---|---|
| Agendamentos anteriores | Todos os agendamentos: data, profissional, especialidade e status |
| Atendimentos realizados | Atendimentos concluídos, vinculados ao prontuário |
| Dados financeiros | Cobranças, pagamentos, valores pendentes e situação financeira |
| Documentos | Arquivos e anexos vinculados ao cadastro |
As evoluções clínicas ficam no módulo de Prontuário Eletrônico, acessível a partir dos detalhes do paciente.
6.1. Novo Atendimento (atendimento sem agendamento) ✅ Novo — 26/10/2026
No Histórico do paciente, o botão Novo Atendimento abre um atendimento sem passar pela agenda. Desde 23/10/2026 a janela foi refeita e preenche-se nesta ordem:
- Unidade — já vem escolhida se a clínica só tiver uma.
- Colaborador responsável — só aparecem os vinculados à unidade.
- Convênio — os da unidade que o paciente tem ativos, mais os particulares.
- Carteirinha — só aparece se o paciente tiver mais de uma.
- Data do Atendimento — não aceita data futura.
- Serviço — só os que o convênio atende (marcados com Utiliza).
Se o serviço pede autorização prévia, abre a janela "Serviço pede autorização prévia" com Voltar e Prosseguir sem autorização — neste caso a autorização será exigida no pré-faturamento.
A guia agora sai igual à de um atendimento agendado: valor do convênio pela mesma regra do Farol, produtos e taxas da composição incluídos, retorno no prazo com o mesmo profissional sai zerado, status já entra Em Atendimento e "criado por" é quem está logado. (Antes saía com o valor do cadastro e sem a composição.)
| Mensagem que bloqueia | O que fazer |
|---|---|
| "A data do atendimento não pode ser futura." | Use a data de hoje ou uma passada; atendimento futuro se marca na agenda. |
| "O convênio escolhido não atende esta unidade." | Escolha um convênio que atenda a unidade (a lista já mostra só os da unidade; se faltar, confira o cadastro do convênio). |
| "O convênio não atende o serviço X." | Marque Utiliza para o serviço na aba Serviços do convênio, ou escolha outro serviço. |
| "O colaborador responsável não está vinculado a esta unidade." | Escolha um colaborador da unidade ou confira o vínculo dele com a unidade em Configurações › Colaboradores. |
| "A unidade não tem nenhum local (sala) ativo cadastrado." | Cadastre ou ative um local (sala) da unidade. |
| "O paciente não tem carteirinha ativa deste convênio. Cadastre o convênio no paciente antes de criar o atendimento." | Inclua o convênio/carteirinha no cadastro do paciente. No Particular a carteirinha é criada sozinha. |
| Atendimento no prazo de retorno com outro profissional | É bloqueado, como no agendamento: use o mesmo profissional (vira retorno zerado) ou aguarde o fim do prazo. |
Permissão: quem usa a janela precisa de Convênio – Visualizar (as listas de convênio e de serviço dependem dela).
7. Integrações do módulo
| Módulo | Como usa o cadastro de paciente |
|---|---|
| Agendamento | O paciente é selecionado ao agendar; convênio e contato são herdados automaticamente. |
| Prontuário | O prontuário é vinculado ao ID do paciente; evoluções, receitas e laudos ficam associados. |
| Financeiro | Cobranças e lançamentos são vinculados ao paciente; o histórico financeiro é acessível pelo cadastro. |
| Faturamento | Guias de convênio referenciam o número de carteira e o plano do cadastro. |
8. Permissões necessárias
Modelo atual: papel (Role) + 4 ações fixas por módulo — VIEW, CREATE, UPDATE, DELETE. Para o módulo Pacientes:
| Ação do usuário | Permissão necessária |
|---|---|
| Ver lista, detalhes e histórico | VIEW |
| Cadastrar novo paciente | CREATE |
| Editar cadastro / anexar documentos | UPDATE |
| Excluir paciente | DELETE |
Níveis: NONE < VIEW < CREATE < UPDATE < DELETE.
🟢 ENTREGUE (set/2026) ✅ Novo — set/2026: as permissões granulares (#395) entraram em produção em 15/09 — permissões finas por funcionalidade/ação, além dos 4 níveis por módulo (ver lição de Segurança). Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
9. Erros comuns e como resolver
| Situação | Causa provável | Solução |
|---|---|---|
| Não consigo salvar sem CPF | Paciente estrangeiro sem marcar a opção | Marque "Estrangeiro" — o CPF deixa de ser exigido. |
| Salvar bloqueado por campo faltando | Falta Nome, Data de Nascimento ou Celular | Preencha os obrigatórios: Nome, CPF (ou Estrangeiro), Data de Nascimento e Celular. |
| Endereço não preencheu sozinho | CEP inválido ou incompleto | Confira o CEP; preencha manualmente se necessário. |
| Upload de documento falhou | Arquivo acima de 50 MB ou formato não aceito | Use PDF/JPG/PNG até 50 MB. |
| Paciente não aparece na busca | Nome/CPF/celular digitado diferente do cadastro | Use a busca global (#456) por parte do nome, telefone, e-mail ou CPF; confira a grafia. |
| Plano não lista opções | Convênio ainda não selecionado | Selecione primeiro o convênio; o plano é filtrado por ele. |
10. Novidades de setembro/2026 ✅ Novo — set/2026
Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
- Mesclar cadastros duplicados (#546) — ENTREGUE: agora é possível unificar dois cadastros do mesmo paciente. Você escolhe o cadastro principal, que mantém os dados pessoais, e o histórico (agendamentos, atendimentos, financeiro) dos dois é preservado no cadastro unificado — fim dos duplicados que espalhavam o histórico.
- Áreas de Demandas (#362) — ENTREGUE: canal de demandas do paciente — o próprio paciente abre um chamado para a clínica (solicitações, dúvidas, pendências), que passa a acompanhar e responder pela área de demandas.
- Confirmação de dados por SMS (#361) e avisos parametrizados (#360) — comunicação com o paciente ampliada.
✅ em produção desde 28/09/2026 LGPD do paciente (épico #596) — no SERVIDOR em produção desde 28/09/2026: anonimização (#598) — pelo administrador; troca nome, CPF, RG, telefone, e-mail e endereço por valores anonimizados, preservando prontuário e histórico clínico (retenção CFM) —, exportação/portabilidade (#599) — pelo administrador/DPO, em JSON estruturado (cadastro, agendamentos, prontuário, autorizações, orçamentos, faturamento), com log —, consentimento (#600) — termo eletrônico com data, versão e 4 consentimentos específicos, revogação individual; para paciente menor de idade, exige o responsável legal (nome, CPF e parentesco) — e log de acesso ao prontuário (#601) — consulta restrita a Admin/DPO. Ainda não há tela própria no sistema da clínica para anonimizar, exportar ou registrar consentimento: são ações administrativas — o pedido do titular é encaminhado ao time Rabi/administrador (DPO). Na tela, desde 29/09/2026: os campos do responsável legal (nome, CPF, parentesco) no cadastro do paciente menor de idade, exigidos pela idade calculada da data de nascimento. Também em 28/09: as listas de pacientes não trazem mais pacientes inativados. (MFA do login, #602: a exigência automática foi testada e retirada em 29/09 — ver lição de Segurança.)
✅ Novo — out/2026 Novidades de outubro/2026 (01–13/10) — conferidas no código de produção em 13/10/2026:
- Nome social (05/10) — ver a tabela 3.1.
- Carteirinha: aviso não bloqueante de duplicada/quase igual; repetida só barra no mesmo convênio.
- Aba Orçamentos do paciente: o valor que aparecia 100 vezes maior foi corrigido.
- A UF do endereço informada no agendamento passa a ficar salva; nas listas, o telefone aparece só como texto.
- Quem alterou primeiro (#640): se outra pessoa gravou o cadastro depois que a sua tela abriu, aparece "Este registro foi alterado por outra pessoa. Recarregue a tela antes de alterar." — nada é gravado por cima.
- Retorno: o histórico de atendimentos do paciente é o que o sistema usa para o retorno automático (#645): mesmo serviço, mesmo convênio e mesmo profissional dentro do prazo de retorno do convênio = retorno sem cobrança.
✅ Novo — 15/10/2026 Novidades de 13–15/10/2026 — conferidas no código de produção em 15/10/2026:
- UF do endereço passa a ser gravada pelo cadastro e pelo agendamento (14/10).
- Aba Agendamentos do paciente: mostra "Atendido com pendência" (antes aparecia "Status Desconhecido").
- Elegibilidade TISS (#619): o chip "Elegível" / "Não elegível" fica no quadro do convênio do agendamento e do acolhimento (não no cadastro do paciente); o resultado da última verificação fica gravado na carteira. Só aparece com a integração TISS ativa na operadora.
- Portal do paciente (Serviços Online): o paciente só altera ou exclui os próprios contatos, convênios, carteirinha e anexos; o código de verificação é de uso único, vale 10 minutos e aceita no máximo 5 tentativas erradas (depois é preciso pedir outro); só paciente ou colaborador da clínica acessa as rotas do portal; nos horários disponíveis, o portal mostra só o nome do profissional (sem CPF, e-mail ou telefone).
- Histórico de atendimentos do paciente: até 1000 por consulta.
- Demandas (chamados): novo layout do detalhe, com tema escuro (15/10).
- Anexos: continuam aceitando imagens e PDF até 50 MB ("Tipo de arquivo inválido. Apenas imagens e PDFs são permitidos.").
Novidades de 15–23/10/2026 ✅ Novo — 23/10/2026
Conferidas no código de produção em 23/10/2026.
- A mesclagem de pacientes (duplicados) foi redesenhada — confira o novo layout no seu ambiente antes de treinar.
- Para as receitas controladas (22/10), o paciente precisa de CPF (estrangeiro: passaporte) e endereço com UF e CEP; Retinoides e Talidomida pedem também data de nascimento e sexo, e Talidomida, telefone — ver Receitas e SNCR.
- O Pareto por Cidades e Bairros (21/10) mostra "Não identificado" para paciente sem endereço completo — mais um motivo para completar o cadastro.
Pontos-chave
- O cadastro fica em
/portal/pacientes; criar em/portal/pacientes/criar. - Campos obrigatórios: Nome, CPF (dispensado se Estrangeiro), Data de Nascimento e Celular — e, desde 29/09/2026, o responsável legal (nome, CPF, parentesco) quando o paciente é menor de idade. O resto é opcional.
- Marcar "Estrangeiro" dispensa o CPF.
- O CEP autopreenche o endereço; a busca global (#456, jul/2026) aceita parte do nome, telefone, e-mail ou CPF.
- Anexos: PDF/JPG/PNG até 50 MB por arquivo.
- O cadastro é a base de Agendamento, Prontuário, Financeiro e Faturamento; convênio vinculado é sugerido no agendamento.
- Dados de saúde são sensíveis (LGPD); acesso restrito a usuários autorizados.
- Novidades de ago/2026: dados pessoais bloqueados para edição nas telas (#592) — proteção do cadastro — e carteirinhas excluídas listáveis para recuperação (#308).
- Novidades de set/2026: mesclar cadastros duplicados (#546) — o principal mantém os dados pessoais e o histórico é preservado — e Áreas de Demandas (#362) — o paciente abre chamado para a clínica. LGPD (épico #596 — ✅ no servidor em produção desde 28/09/2026, sem tela própria: pedido ao time Rabi/DPO): anonimização (#598, preserva prontuário), portabilidade em JSON (#599), consentimento (#600) e log de acesso ao prontuário (#601); na tela desde 29/09, o responsável legal obrigatório do menor de idade.
- Permissões: Role + VIEW/CREATE/UPDATE/DELETE.
- ✅ Novo — 05/10/2026 Nome social (telas mostram "NOME SOCIAL (nome civil)"; vai na guia/XML) e aviso não bloqueante de carteirinha duplicada — a carteira repetida só barra no mesmo convênio.
- ✅ Novo — 15/10/2026 Desde 13–15/10: UF do endereço gravada pelo cadastro e pelo agendamento; "Atendido com pendência" na aba Agendamentos; no portal, o paciente só mexe nos próprios dados e o código de verificação aceita 5 tentativas; a elegibilidade TISS aparece no agendamento/acolhimento (não no cadastro).
- ✅ Novo — 26/10/2026 Novo Atendimento (sem agendamento, no Histórico do paciente) refeito em 23/10: ordem Unidade → Colaborador → Convênio → Carteirinha → Data (não futura) → Serviço (só com Utiliza); a guia sai igual à de um atendimento agendado (valor pela regra do Farol, composição incluída, retorno zerado, status Em Atendimento); exige Convênio – Visualizar.
O que a prova vai cobrar
- Reconhecer os campos obrigatórios do cadastro (Nome, CPF, Data de Nascimento, Celular), o efeito de marcar "Estrangeiro" e que o menor de idade exige o responsável legal (desde 29/09/2026).
- Saber que o CEP autopreenche o endereço e quais critérios a busca aceita (parte do nome, telefone, e-mail ou CPF — busca global #456).
- Conhecer o limite de anexo de 50 MB e os formatos aceitos.
- Entender que o cadastro alimenta os outros módulos e que o convênio é herdado no agendamento.
- Aplicar cuidados de LGPD para dados sensíveis do paciente — e saber que anonimização, portabilidade e consentimento estão no servidor desde 28/09/2026, mas são pedidos ao time Rabi/administrador (DPO), sem tela própria.
- Novidades de set/2026: mesclar cadastros duplicados (#546) — qual cadastro mantém os dados pessoais e o que acontece com o histórico — e os chamados do paciente / Áreas de Demandas (#362).
- ✅ Novo — 05/10/2026 Onde o nome social aparece (telas e guia/XML) e que o aviso de carteirinha duplicada não bloqueia (só barra carteira repetida no mesmo convênio).
- ✅ Novo — 15/10/2026 As proteções do portal do paciente (só os próprios dados; código de verificação com 5 tentativas; profissional exibido só pelo nome) e onde aparece o chip de elegibilidade TISS (agendamento e acolhimento).
- ✅ Novo — 26/10/2026 Novo Atendimento sem agendamento: ordem dos campos, que a data não pode ser futura, que só aparecem serviços com Utiliza, o que acontece com serviço que pede autorização prévia (Prosseguir sem autorização → exigida no pré-faturamento) e que a guia sai com o mesmo valor de um atendimento agendado.