Lição: Agenda e Agendamento

Esta lição prepara você para operar o módulo de Agenda do Sistema Rabi do zero: criar e confirmar agendamentos, acolher pacientes, gerar orçamentos e autorizações, bloquear horários e usar fila de espera e encaixe. Ao final, você deve conseguir executar as tarefas do dia a dia da recepção sem depender de ajuda.

1. Objetivo do módulo e onde fica

O módulo de Agendamento é a agenda médica central da clínica. Nele, a recepção e os profissionais gerenciam consultas, exames e procedimentos, controlando o fluxo do paciente da marcação até o atendimento.

• Menu: Agendamento (na barra lateral do sistema).
• Rota principal: /portal/agenda
• URL completa (produção): http://app.rabisistemas.com.br/portal/agenda

1.1. Telas do módulo

2. Visualização da agenda

A agenda principla organiza os agendamentos de forma visual. Você pode alternar os modos de visualização e filtrar o que aparece.

2.1. Modos de visualização

• Por dia — todos os agendamentos do dia corrente, por horário.
• Por semana — agendamentos distribuídos nos dias da semana.

2.2. Filtros disponíveis

• Profissional — filtra por médico, fisioterapeuta ou outro colaborador.
• Especialidade — exibe apenas uma especialidade.
• Local do agendamento — filtra por sala, consultório ou unidade.

Use as setas de navegação para avançar/recuar dias e semanas sem selecionar datas manualmente.

✅ Novo — ago/2026 No board de Agendamento, a coluna "Autorizações" foi renomeada e dividida em pendentes e aprovadas (#543). Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

3. Status do agendamento

Cada agendamento tem um status, identificado por cor na grade. Conhecer os status é essencial: a prova cobra o significado de cada um.

✅ Novo — jul/2026 O agendamento remarcado passou a usar a cor do status normal na grade (#457). Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

✅ Novo — ago/2026 O status "Pendente" (#375) foi ENTREGUE: é o status intermediário usado enquanto faltar orçamento/autorização. Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização. Também de agosto/2026: agendamento cancelado ou não comparecido NÃO conta mais como uso da autorização (#522), e a idade do paciente passou a ser exibida em anos, meses e dias (#520).

4. Criar um novo agendamento (passo a passo)

Acesse /portal/agenda/criar ou clique em "Novo Agendamento" na agenda.

4.1. Campos de data e horário

4.2. Paciente e dados do atendimento

✅ Novo — ago/2026 Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização:

• Quantidade de serviços (#537): campo de quantidade de serviços no agendamento e no atendimento.
• Previsão de estoque (#521): o sistema mostra a previsão de estoque disponível na data do agendamento, por item.
• Bloqueio de serviço por convênio (#376): o convênio pode bloquear serviços específicos.
• Avisos visuais na grade (#377): a grade exibe avisos visuais.
• Anexos (#574): o agendamento traz os anexos do orçamento/autorização e permite upload.

4.3. Sequência completa

1. Abra o formulário: "Novo Agendamento" ou /portal/agenda/criar.
2. Defina Data, Hora início e Hora fim.
3. Busque e selecione o Paciente por nome ou CPF. Se não estiver cadastrado, cadastre-o antes no módulo de Pacientes.
4. Informe Especialidade, Profissional e Tipo (Normal/Encaixe); complete convênio/plano/local/equipamentos se aplicável.
5. Confira a Lista de Contatos do paciente exibida no formulário.
6. Se necessário, anexe arquivos em Documentos / Anexos (pedidos, guias, laudos).
7. Clique em "Salvar". O agendamento aparece na agenda com status Aguardando.

4.4. Orçamento e autorização obrigatórios (parametrizável) ✅ Novo — jul/2026

Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

• Orçamento obrigatório (#373): conforme parametrização, o agendamento passa a exigir orçamento.
• Autorização obrigatória (#374): conforme parametrização, o agendamento passa a exigir autorização do convênio.

4.5. Bloqueio e prazo de retorno ✅ Novo — jul/2026

Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

• Bloqueio de retorno (#414): o sistema controla o retorno do paciente conforme o prazo configurado.
• Prazo de retorno configurável (#415): o prazo de retorno pode ser configurado por convênio e por serviço.

4.6. Guard de edição não salva ✅ Novo — jul/2026

Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização. Ao sair de uma tela com alterações não salvas, o sistema pede confirmação antes de descartar (guard de edição, #401/#404) — evita perder o preenchimento do formulário por clique acidental.

5. Confirmar agendamentos

A tela de Confirmação (/portal/agenda/confirmacao) permite confirmar consultas rapidamente, sem abrir cada uma.

1. Acesse Agendamento › Confirmação ou /portal/agenda/confirmacao.
2. A tela lista os agendamentos com status Aguardando.
3. Use os filtros de data, profissional e especialidade para localizar.
4. Marque as caixas de seleção de um ou mais agendamentos.
5. Clique em "Confirmar". O status muda para Confirmado.

Também dá para confirmar individualmente pela grade ou pela edição (/portal/agenda/:id/editar). Ao confirmar, o sistema pode gerar um lançamento financeiro automático, conforme a configuração da clínica.

6. Acolhimento e check-in

O Acolhimento (/portal/agenda/acolhimento) é o registro da chegada do paciente. Após o check-in, ele entra na fila de atendimento do profissional.

6.1. Fluxo completo

1. O paciente chega e se apresenta na recepção.
2. A recepcionista acessa /portal/agenda/acolhimento.
3. Localiza o paciente na lista do dia (busca por nome ou CPF).
4. Clica no agendamento para abrir o check-in (/portal/agenda/acolhimento/:id/checkin).
5. Confere os dados e clica em "Realizar Check-in".
6. O status muda para Acolhido e o paciente entra na fila do profissional.
7. O profissional chama o próximo da fila; o status passa a Em Atendimento.

A tela de acolhimento exibe, por agendamento do dia: nome do paciente, horário, profissional e especialidade, status atual e convênio.

7. Orçamentos

A tela de Orçamentos (/portal/agenda/orcamento) permite orçar procedimentos antes de virarem agendamento.

7.1. Criar

1. Acesse Agendamento › Orçamentos ou /portal/agenda/orcamento.
2. Clique em "Novo Orçamento" (/portal/agenda/orcamento/criar).
3. Selecione o paciente e informe os procedimentos.
4. Informe valores (formato R$ 1.234,56) e convênio, se aplicável.
5. Salve. O orçamento fica listado com status pendente.

7.2. Reabrir e converter

• Reabrir cancelado: localize na lista, clique em "Reabrir", ajuste e salve.
• Converter em agendamento: localize o orçamento aprovado, clique em "Converter em Agendamento"; o formulário abre com os dados preenchidos. Defina data, horário e profissional e salve.

8. Bloqueio de agenda

O Bloqueio (/portal/agenda/bloqueio) marca horários como indisponíveis, impedindo novos agendamentos. Use para feriados, férias/folga do profissional, reuniões e manutenção de equipamento.

1. Acesse Agendamento › Bloqueio de Agenda.
2. Clique em "Novo Bloqueio".
3. Selecione o profissional e o local a bloquear.
4. Informe data, horário de início e horário de fim.
5. Adicione uma descrição/motivo (ex.: "Reunião", "Folga").
6. Salve. O período aparece na agenda com indicação de indisponibilidade.

9. Autorizações de convênio

A tela de Autorizações (/portal/agenda/autorizacao) registra pedidos de autorização de procedimentos junto às operadoras.

1. Acesse Agendamento › Autorizações (/portal/agenda/autorizacao).
2. Clique em "Nova Autorização" (/portal/agenda/autorizacao/criar).
3. Selecione o paciente e o convênio.
4. Informe os procedimentos (código TUSS, descrição) e o profissional solicitante.
5. Registre o número da autorização quando a operadora fornecer.
6. Salve.

Depois, registre o número no campo "Guia Operadora" do agendamento. Autorizações registradas são usadas automaticamente no faturamento de guias.

10. Fila de Espera ✅ Novo — set/2026

Entregue no ciclo de setembro/2026 (#405, em produção desde 28/08); se ainda não apareceu no seu ambiente, chega na próxima atualização.

A Fila de Espera resolve o horário cheio sem perder o paciente:

1. Quando o horário desejado está cheio, o paciente pode ser colocado na fila de espera em vez de ir embora sem data.
2. Ao surgir um cancelamento, o sistema sugere automaticamente o encaixe do próximo da fila direto na grade da agenda.
3. A própria tela da fila tem o botão "Agendar": a recepção converte o paciente da fila em agendamento sem redigitar os dados.

11. Encaixe

Encaixe é um agendamento criado fora do horário regular, para urgências ou retornos rápidos. Para criar: em /portal/agenda/criar, no campo Tipo, selecione "Encaixe" (em vez de "Normal"), preencha os demais campos e salve. Encaixes recebem marcação visual diferenciada na grade.

✅ Novo — jul/2026 O encaixe agora aparece na hora na grade (correção de cache, #460). Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

✅ Novo — ago/2026 Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização: a liberação de encaixe adicional pode ser autorizada pelo médico via notificação (#523), e o pedido de cancelamento de um atendimento já Atendido passa por fluxo de autorização (#524).

12. Recursos avançados em produção

12.1. Novidades de julho/2026 ✅ Novo — jul/2026

Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

• Limite de agendamentos por convênio na grade (#476) — a grade respeita o limite configurado por convênio.
• Grade marca todos os convênios do médico (#461) — a visualização passa a sinalizar todos os convênios atendidos pelo profissional.
• Correção "equipamentos insuficientes" (#458) — mensagem indevida ao agendar foi corrigida.
• Campo expande (#501) — campos de texto do formulário se expandem para facilitar a digitação.
• Serviço online: itens não habilitados ficam ocultos (#426), listas por contexto (#427), correção da tela de colaborador (#428) e ativação por SMS (#389).
• Setas próximo/anterior no topo das telas (#459) e proteção anti-duplo-clique (idempotência, #408).

12.2. Novidades de agosto/2026 ✅ Novo — ago/2026

Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

• Status "Pendente" (#375) — status intermediário enquanto falta orçamento/autorização.
• Bloqueio de serviço por convênio (#376) e avisos visuais na grade (#377).
• Repetir agendamento corrigido de vez (#214/#573).
• Cancelado/não comparecido não consome autorização (#522).
• Idade do paciente em anos, meses e dias (#520) e quantidade de serviços (#537).
• Board: coluna "Autorizações" dividida em pendentes/aprovadas (#543).
• Previsão de estoque na data do agendamento, por item (#521).
• Encaixe adicional autorizado pelo médico via notificação (#523) e cancelamento de Atendido com fluxo de autorização (#524).
• Agendamento traz anexos de orçamento/autorização + upload (#574).

12.3. Novidades da 2ª quinzena de agosto/2026 ✅ Novo — ago/2026

Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

• Edição de agendamento Atendido — fluxo completo entregue (#560/#563/#564/#565/#566/#567): bloqueio da edição direta de Atendido + trava de troca de paciente (#560); botão "Editar" com motivo + solicitação de aprovação (#563); fluxo de aprovação (#564); a edição aprovada reflete na Autorização (#565); aviso fixo no topo do Agendamento para atendidos com divergência (#566); Fila de Atendimento com área fixa de divergências e botão Corrigir (#567).
• Aprovações por nível de alçada (#557/#558, épico #571): renomeado de "nível de desconto"; notifica todos do nível e, quando um responde, resolve para todos.
• Farol consolidado (#551/#552, épico #570): o farol do agendamento e da autorização passa a ser calculado sobre serviço + produto + taxa.
• Crítica de quantidades de produtos (#553): crítica de quantidade de produtos no agendamento a partir de orçamento/autorização; totais previstos × agendados nas telas (#554); detecção de divergência de quantidades entre agendamento e atendimento (#561).
• Board: mostra "faltam X de Y" de produtos controlados (#556) e a classificação de pendência foi corrigida (#555).
• Botão para agendar direto a partir da autorização (#226), com os dados já preenchidos.

13. Integrações do módulo

Fluxo completo do paciente: Agendamento → Acolhimento → Prontuário → Financeiro → Faturamento.

14. Permissões necessárias

O modelo atual é papel (Role) + 4 ações fixas por módulo: VIEW, CREATE, UPDATE, DELETE. Para o módulo Agendamento (que cobre Agenda, Acolhimento, Confirmação, Bloqueio, Orçamento e Autorização):

Níveis: NONE < VIEW < CREATE < UPDATE < DELETE.

15. Erros comuns e como resolver

16. 🟠 Planejado (roadmap) — ainda NÃO disponível

✅ Novo — jul/2026 Saíram deste roadmap por terem sido entregues em julho/2026: orçamento obrigatório (#373), autorização obrigatória (#374), bloqueio/prazo de retorno (#414/#415) e guard de edição (#401/#404) — ver seções 4.4 a 4.6. O farol de resultado (#390/#434) também foi entregue — ver a lição de Orçamento.

✅ Novo — ago/2026 Saíram deste roadmap por terem sido entregues em agosto/2026: status "Pendente" (#375), bloqueio de serviço por convênio (#376) e avisos visuais na grade (#377) — ver seção 12.2. Também entregues na 2ª quinzena de agosto/2026: a edição de agendamento Atendido (fluxo completo com bloqueio, botão "Editar" com motivo/aprovação, divergências e fila Corrigir — #560/#563-#567), a trava de troca de paciente (#560), as aprovações por nível de alçada (épico #571) e o farol consolidado + crítica de quantidades (épico #570) — ver seção 12.3.

✅ Novo — set/2026 Saiu deste roadmap por ter sido entregue em setembro/2026: a Fila de Espera (#405) — paciente entra na fila quando o horário está cheio, o sistema sugere o encaixe do próximo da fila ao surgir cancelamento e a fila tem botão "Agendar" — ver seção 10.

Pontos-chave

• A agenda fica em /portal/agenda; criar em /portal/agenda/criar.
• Ao salvar, o agendamento nasce com status Aguardando; após confirmar vira Confirmado; após check-in vira Acolhido.
• Campos obrigatórios do agendamento: Data, Hora início, Hora fim, Paciente, Especialidade, Profissional e Tipo. Convênio, plano, local, equipamentos, guia e observação são opcionais.
• Datas em dd/mm/aaaa; valores em R$ 1.234,56.
• Bloqueio impede novos agendamentos, mas não cancela os existentes.
• Repetição (#337, corrigida de vez em ago/2026 — #573), bloqueio de agenda, encaixe manual e acolhimento estão em produção. Novidades de jul/2026: obrigatoriedades de orçamento/autorização (#373/#374), bloqueio/prazo de retorno (#414/#415) e guard de edição (#401). Novidades de ago/2026: status "Pendente" (#375), bloqueio de serviço por convênio (#376), avisos na grade (#377), cancelado não consome autorização (#522), previsão de estoque no agendamento (#521), edição de Atendido com aprovação (#560/#563-#567), alçada (épico #571), farol consolidado e crítica de quantidades (épico #570) e botão agendar da autorização (#226). Novidade de set/2026: Fila de Espera (#405) entregue — paciente na fila quando o horário está cheio, sugestão automática de encaixe ao surgir cancelamento e botão "Agendar" na fila. Segue roadmap: pré-solicitação (#380).
• Permissões: Role + VIEW/CREATE/UPDATE/DELETE por módulo.

O que a prova vai cobrar

• Identificar o status inicial de um agendamento recém-criado (Aguardando) e a sequência de status até o atendimento.
• Reconhecer quais campos do novo agendamento são obrigatórios e quais são opcionais.
• Diferenciar as telas (Confirmação, Acolhimento, Bloqueio, Orçamento, Autorização) e suas rotas/finalidades.
• Saber que o bloqueio de agenda não cancela consultas já marcadas.
• Distinguir o que está em produção do que é roadmap: as obrigatoriedades de orçamento (#373) e autorização (#374) foram entregues em jul/2026; o status "Pendente" (#375), o bloqueio de serviço por convênio (#376), os avisos na grade (#377) e o fluxo de edição de agendamento Atendido (bloqueio + botão "Editar" com motivo e aprovação + divergências + fila Corrigir, #560/#563-#567) foram entregues em ago/2026; a Fila de Espera (#405) foi entregue em set/2026 (não é mais roadmap). Segue roadmap: pré-solicitação (#380).