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 principal 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.

✅ Atualização 13/10: o prazo de retorno é o campo Prazo de Retorno em (Dias) do convênio, e o serviço precisa estar com Retorno marcado na aba Serviços do convênio — prazo por convênio × serviço ainda não existe. Desde 05/10/2026 o retorno é marcado e zerado automaticamente (mesmo profissional) e o agendamento com outro profissional dentro do prazo é bloqueado — ver a seção 12.7.

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.

6.2. O que impede o acolhimento ✅ Novo — 26/09/2026

• Orçamento particular não pago: orçamento particular com financeiro pode ser agendado sem estar pago, mas não pode ser acolhido sem estar pago — o pagamento é feito ali mesmo, no acolhimento (ou antes, na tela do orçamento; pago de um lado, aparece pago nos dois). Mensagem: "Não é possível acolher: o orçamento (id N) ainda não foi pago." Trocar o status direto pelo menu do check-in também exige o orçamento pago. Orçamento só de convênio (sem parcelas) não entra nesta regra.
• Financeiro único do orçamento (orçamentos criados a partir de 25/09/2026): todas as sessões usam uma só cobrança com o valor total do orçamento. O acolhimento bloqueia sessão sem a movimentação do orçamento, financeiro diferente do total, duas sessões com movimentações diferentes (cobrança em dobro) e agendamento ligado a mais de um orçamento com financeiro ("separe as sessões por orçamento").
• Depois de pago, o valor trava: no acolhimento não se altera valor nem se dá desconto em orçamento já pago. Antes do pagamento, o desconto dado no acolhimento vale para o orçamento e todas as sessões.
• Agendamento inativo ou cancelado não acolhe nem volta para a fila: o sistema pede "…Crie um novo agendamento para o paciente."

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 Em negociação (ou Pendente de aprovação interna, quando o Farol exigir aprovação).

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 "Agendar"; 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 set/2026); 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).

✅ Novo — 26/09/2026 Encaixe adicional não aprovado ou recusado vira Cancelado (25/09/2026): se o encaixe adicional não for aprovado no prazo ou for recusado, o agendamento provisório passa a Cancelado, com o motivo "Encaixe adicional não aprovado dentro do prazo — horário liberado automaticamente." (ou "Encaixe adicional recusado."). Antes ele ficava inativo e podia ser acolhido por engano, virando um paciente invisível na fila. Agendamento inativo ou cancelado não pode ser acolhido — crie um novo agendamento.

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.

12.4. 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.

• Progresso de sessões na agenda (#603): agendamentos de múltiplas sessões passam a exibir "x/y" direto na agenda (ex.: sessão 3 de 10) — a recepção enxerga em que ponto do pacote o paciente está sem abrir o agendamento.
• Reforço da documentação obrigatória (#608): o sistema passa a bloquear o agendamento/acolhimento sem a documentação obrigatória anexada — a exigência configurada deixa de ser contornável.
• Avisos por tela no serviço online (#424): textos informativos configuráveis por tela do agendamento online — a clínica escreve o aviso que o paciente vê em cada etapa.
• Repetição de agendamento com múltiplas sessões corrigida (#613): a repetição não funcionava quando o agendamento tinha múltiplas sessões; corrigido no fechamento da Sprint 10 (17–18/09) — as séries voltam a funcionar também para pacotes de sessões.
• Permissão da Fila de Espera separada do Agendamento (#612): a permissão da Fila de Espera agora é própria, separada do grupo Agendamento — ajuste fino de perfis (dá para liberar a fila sem liberar a agenda toda). Corrigido também o bug em que a separação bloqueava indevidamente usuários que deveriam ter acesso.
• Farol CONSOLIDADO (em produção desde 23/09/2026): o Farol do agendamento (como o do orçamento e da autorização) é um só para o conjunto: Σ do que o convênio paga por todos os serviços, produtos e taxas ÷ Σ do custo de todos os produtos × 100 — deixa de valer a cor do pior item. A cor por linha só orienta; item sem custo/preço deixa o consolidado roxo e bloqueia; a aprovação por alçada refere-se ao consolidado. E 0,00 é preço zero — só campo vazio desce de nível na conversão.
• Botão COPIAR na agenda (#616) ✅ em produção desde 28/09/2026 — botão Copiar na grade de profissional e na de equipamento: cria uma nova agenda (de profissional ou de equipamento) já preenchida com tudo, exceto a vigência/datas; nada é gravado até você salvar, e valem as mesmas validações de conflito.
• Financeiro único do orçamento com várias sessões (em produção desde 24/09/2026; orçamentos criados a partir de 25/09): uma só movimentação com o valor total; pagamento na tela do orçamento ou no acolhimento; orçamento particular com financeiro agenda sem pagar, mas só acolhe pago; depois de pago o valor trava. Ver seção 6.2 e a lição de Orçamento.
• Contagem de sessões corrigida (25/09/2026): a contagem usa o uso real pelos agendamentos, e cancelar um agendamento devolve a sessão ao orçamento/autorização (pela tela de cancelar, pelo cancelamento da autorização e pelo portal do paciente).
• Pequenas correções (24–25/09/2026): salvar agendamento com anexo não trava mais o redirecionamento; voltar para a Agenda a partir do check-in troca a tela corretamente; itens do menu não somem enquanto as permissões carregam.
• Regras de preço completas (em produção desde 23–24/09/2026): produtos, taxas e subserviços sempre entram na conta do serviço agendado, com as conversões do convênio — ficam fora só os itens sem Utiliza ou zerados em pacote de preço fechado (Zerar por item, sem cascata). Detalhes na lição de Orçamento e na Árvore de decisão de preços.

12.5. Entraram em produção em 28/09/2026 ✅ em produção desde 28/09/2026

Estavam em homologação (Sprint 11, fechada em 25/09/2026) e chegaram à produção em 28/09/2026.

• Copiar agenda (#616) — ver seção 12.4.
• Pagamento parcial antecipado (#604): no cadastro do Serviço, a opção "exige pagamento parcial" com percentual mínimo e prazo da reserva. O agendamento desse serviço nasce "Pendente de Pagamento", segurando o horário até o prazo; sem pagamento, expira sozinho e libera o horário (e as reservas de medicamento; a vaga vai para a Fila de Espera). Vale na agenda da recepção e no agendamento online. O percentual incide sobre a sessão agendada, não sobre o pacote todo. Nesta versão a confirmação do pagamento é manual (um colaborador registra o valor recebido); o link de pagamento automático é o #409 🟠 Roadmap (Sprint 12, em andamento). ✅ Atualização 13/10: a Sprint 12 fechou em 02/10 sem os links; o #409 está na Sprint 14 (09–16/10), sem data prometida. Desde 12/10, a confirmação do sinal exige Conta caixa e Forma de pagamento (o identificador é opcional), gera uma movimentação de recebimento própria, sem NFS-e, e o agendamento mostra "Sinal já recebido". ✅ Atualização 15/10: desde 13/10 existe o link de pagamento Pix (#409) — com um provedor Pix cadastrado e ativo pela clínica, o aviso do sinal ganha o botão "Link de pagamento" e o Pix pago dá baixa sozinho e confirma o agendamento; sem provedor ativo, a confirmação segue manual. Ver seção 12.8.
• Pré-solicitação de autorização (#380) — agora completa: a regra e a notificação estão no servidor desde 25/09 e a tela chegou em 28/09 — ícone Acompanhamento na lista de autorizações (data da pré-solicitação + observação, com histórico) e nova coluna Pré-solicitação na lista, com farol e dias. Detalhes na lição de Autorização.
• Filtros padrão (#396): as principais listas passaram a buscar e ordenar no servidor — a busca percorre toda a base filtrada, não só a página visível.
• Listas de pacientes não trazem mais pacientes inativados.

12.6. Agendamento pela IA (TalkMe) — correções de 30/09/2026 ✅ Novo — 30/09/2026

Correções no servidor, em produção desde 30/09/2026, para o agendamento feito pela IA (TalkMe): a IA passa a checar a duração do serviço ao marcar (antes podia sobrepor agendamentos); só oferece especialidades por convênio quando existe grade que aceite o convênio; filtra os horários dos profissionais pelo serviço pedido; e serviço inativo é recusado na consulta e no agendamento. A consulta única de disponibilidade (#633) segue no roadmap — ver seção 16. ✅ Atualização 13/10: em produção desde 09/10/2026: a IA (TalkMe) já responde numa consulta só se há profissional da especialidade, que faz o procedimento, com agenda liberada para o convênio — continua valendo manter o cadastro em dia (Atende convênio no profissional, serviços e convênios na grade, Utiliza/Atende no convênio, convênio ativo na unidade).

12.7. Novidades de outubro/2026 (01–13/10) ✅ Novo — out/2026

Conferido no código de produção em 13/10/2026.

• Retorno automático (#645, desde 05/10): ao criar o agendamento pela tela, se o paciente tem atendimento do mesmo serviço no mesmo convênio dentro do Prazo de Retorno em (Dias) do convênio e o serviço está com Retorno marcado na aba Serviços do convênio: mesmo profissional → vira retorno sozinho, com serviço e taxas zerados (pré-faturamento, guia/XML e repasse saem com R$ 0,00; chip "RETORNO" na lista de guias do pré-faturamento); outro profissional → bloqueado, sem opção de confirmar ("O atendimento anterior foi realizado por outro profissional. Não é possível agendar para um profissional diferente dentro do prazo de retorno."). Retorno marcado à mão só vale se existir o atendimento anterior no prazo. Na edição, mudar a data reavalia o retorno e avisa. Cuidados que continuam: ✅ Novo — 26/10/2026 desde 24/10 a regra roda também nos agendamentos feitos pela IA (TalkMe) e, desde 23/10, no Novo Atendimento sem agendamento (ver abaixo); a detecção automática segue sem rodar no agendamento online, no encaixe adicional e no agendamento pela guia — ali confira e marque à mão; só o primeiro serviço que casa é marcado sozinho; e não existe senha para desmarcar o retorno.
• Especialidade do convênio (#628) 🟡 Parcial: a trava foi desligada temporariamente em 06/10/2026 no agendamento e no orçamento — hoje o sistema não filtra nem bloqueia profissionais e serviços pela coluna Atende. A consulta de disponibilidade da IA (TalkMe, #633) é a exceção: ela respeita a coluna Atende — por isso a IA pode dizer que não há horário num caso que a recepção consegue agendar. O cadastro do convênio continua sinalizando ("Não atendida" / "Não agenda") e o aviso diz que esses serviços "não poderão ser agendados" — mas hoje o agendamento não barra. Confira a especialidade e a cobertura ao agendar.
• "Fora da grade atual" (#658, desde 03/10): agendamento de grade que foi inativada ou mudou (vigência, dia ou recorrência) não some mais: a grade original volta no fim da lista, embaixo da grade atual do mesmo profissional e local, com o aviso "Fora da grade atual" e o motivo (ex.: "Grade inativada", "A grade não atende mais neste dia"). Ali não há horários livres, encaixe nem "adicionar à fila de espera". Vale só para grade de colaborador. A seção "Atendimentos sem grade" não existe: atendimento aberto sem agendamento continua fora da agenda — use os relatórios para ver todos os atendimentos do dia.
• Quem alterou primeiro (#640, desde 02/10): se outra pessoa gravou o agendamento depois que a sua tela abriu, o sistema recusa com "Este registro foi alterado por outra pessoa. Recarregue a tela antes de alterar." — nada é gravado por cima. E a tela só libera a edição depois de carregar tudo ("Parte dos dados não carregou: nada foi gravado. Recarregue a tela antes de alterar.").
• Subserviços visíveis (#641) 🟡 Parcial: no agendamento, no acolhimento e no orçamento aparece o quadro "Subserviços" com a árvore do serviço e o campo "Autorização do subserviço" — opcional: hoje a autorização do subserviço não é obrigatória e não deixa o agendamento em Pendente de Autorização.
• Autorização de guia já fechada (#649, desde 08/10): autorização cuja guia mãe foi pré-faturada, faturada ou entrou em lote sai das "Autorizadas" e não é oferecida no agendamento; tentar usá-la dá "A guia desta autorização já foi pré-faturada/faturada; peça nova autorização."
• Paciente: nome social (desde 05/10) — as telas mostram "NOME SOCIAL (nome civil)"; aviso não bloqueante de carteirinha duplicada ou com número quase igual (a carteira repetida só barra no mesmo convênio); a UF do endereço informada no agendamento passa a ficar salva.
• Valor e aprovações: a quantidade do serviço multiplica o valor no financeiro (02/10); o pedido de desconto mostra o paciente e os serviços (#637); o pedido remoto de edição ou cancelamento de Atendido vai para todos de nível 2 ou 3 (o primeiro que responder vale).
• Caixa na recepção (#650, desde 12/10 — nasce desligado): com o controle de caixa ligado em Parâmetros › Financeiro, receber sem caixa aberto abre a janela "Abrir o caixa" ("Abrir caixa e continuar" / "Seguir sem abrir", este só no modo Aviso) e a agenda mostra o alerta "Você não tem caixa aberto…" com o botão Abrir caixa. O botão de anexo da parcela na Agenda › Receber abre os Comprovantes da parcela. Ver a lição de Financeiro.
• Disponibilidade por Convênio (09/10): o painel da Agenda passa a seguir a mesma regra da agenda interna e lista os convênios por unidade a partir do cadastro Unidades do convênio — a lista pode crescer bastante. Não existe tela de "Catálogo de atendimento" (#659). ✅ Atualização 15/10: desde 14/10 (#664), com um convênio escolhido no filtro, o painel esconde os serviços que o Farol bloqueia para esse convênio (vermelho ou roxo sem liberação de nível 3 nos parâmetros); o que só pede aprovação continua aparecendo, porque a agenda pede a aprovação ao salvar. Sem convênio no filtro, o Farol não entra.
• Farol com custos extras (#655, desde 12/10): o Farol do agendamento passa a somar ao custo o repasse do profissional, os custos extras do convênio e os prestadores — ver a lição de Orçamento.

12.8. Novidades de 13–15/10/2026 ✅ Novo — 15/10/2026

Conferido no código de produção em 15/10/2026.

• Link de pagamento Pix do sinal (#409, desde 13/10): opcional — só aparece quando a clínica contratou a API Pix com o banco e cadastrou e ativou o provedor em Configurações › Parâmetros › aba "Pagamentos (links)" (um provedor ativo por vez). No agendamento "Pendente de Pagamento", o aviso do sinal ganha o botão "Link de pagamento": a janela mostra o QR Code, "Copiar Pix copia e cola", "Enviar ao paciente" (WhatsApp, SMS ou e-mail; vazio = o contato do cadastro) e "Cancelar link" (pede motivo), e acompanha até "Baixa feita no financeiro.". O Pix pago dá baixa sozinho no financeiro (aviso do banco ou verificação a cada 5 minutos) e confirma o agendamento. O agendamento online também oferece pagar o sinal. Se a baixa automática falhar: "A baixa automática falhou: <motivo>. Dê a baixa manualmente." Sem provedor ativo, nada muda — a confirmação do sinal continua manual (Conta caixa + Forma de pagamento). Só existe o tipo Pix padrão Banco Central (cartão/boleto por gateway não existem).
• Elegibilidade TISS online (#619, desde 15/10): no quadro do convênio do paciente, no agendamento e no acolhimento, o botão "Verificar elegibilidade" consulta o webservice da operadora e mostra o chip "Elegível" (verde) ou "Não elegível: <motivo>" (vermelho), com "verificado em dd/mm/aa hh:mm"; o resultado fica gravado na carteira. Só aparece com a integração TISS ativa na operadora (ou no convênio) e a carteira já salva — sem isso, a tela fica igual. Verificar exige a permissão TISS_ELEGIBILIDADE (CREATE); sem ela, o botão fica cinza ("Você não tem permissão para verificar elegibilidade"). Só a elegibilidade usa o webservice hoje: autorização online, envio de lote e demonstrativos seguem roadmap (Sprint 14, #620–#623).
• Token do convênio só no Acolhimento (15/10): o convênio que exige token não trava mais criar ou editar o agendamento — o token passa a ser exigido só no acolhimento.
• IA (TalkMe) e o Farol (#664, desde 14/10): a IA deixa de oferecer o serviço que o Farol bloqueia ou que só sai com aprovação (vermelho, roxo e amarelo com "Exigir aprovação de nível 2") — para esses, agende pela recepção, que pede a aprovação ao salvar. Sem parâmetro vermelho/amarelo, ou com "Desabilitar TODO bloqueio de farol", nada sai da lista. A trava do Farol ao salvar o agendamento não mudou.
• Aprovação presencial (#669, desde 14/10): na aprovação com a senha de outro colaborador (desconto, cancelamento e edição de Atendido), 5 senhas erradas em 15 minutos travam a aprovação presencial daquele aprovador: "Muitas tentativas de senha para este aprovador. Aguarde 15 minutos ou peça a aprovação remota." A aprovação remota continua funcionando; trocar de máquina ou de tela não renova as tentativas.
• Autorização no agendamento (15/10): a autorização certa abre destacada no topo com o chip "Aberta agora"; colocar o protocolo depois não apaga mais os acompanhamentos; na lista de agendamentos pendentes de autorização, a coluna "Pendente" passa a olhar só o saldo de sessões.
• Outras correções (13–15/10): editar uma repetição já salva não trava mais a validação; agendamento cancelado não recebe lembrete nem confirmação por SMS; o desconto por sessão do orçamento aparece no financeiro do agendamento; a UF do endereço do paciente é gravada pelo agendamento; o card de aprovação do Farol mostra quem pediu, o serviço e o paciente; erro técnico aparece como "Ocorreu um erro inesperado. Tente novamente em instantes. (código XXXX)" — informe esse código ao abrir chamado.

13. Integrações do módulo

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

14. Permissões necessárias

O modelo base é papel (Role) + 4 ações por módulo: VIEW, CREATE, UPDATE, DELETE (✅ Atualização 13/10: desde 15/09 há também as permissões granulares e as ações elevadas EDIT_ALHEIO, CANCELAR e EXCLUIR — ver a lição de Segurança). Para o módulo Agendamento (que cobre Agenda, Acolhimento, Confirmação, Bloqueio, Orçamento e Autorização):

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

✅ Atualização 15/10: permissões novas — TISS_ELEGIBILIDADE (VIEW vê o status; CREATE verifica) e, no link de pagamento, VIEW para ver e UPDATE para gerar (em AGENDAMENTO/ACOLHIMENTO/CONFIRMAÇÃO, REGISTROS FINANCEIROS ou CONTAS CAIXAS). Atenção: o "negar por padrão" (#667) não entrou — colaborador sem nenhuma configuração num módulo continua vendo as telas dele (só leitura). Revise o perfil de cada colaborador com os módulos que ele usa.

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.

✅ Novo — 29/09/2026 Saíram do roadmap/homologação e estão em produção desde 28/09/2026: a pré-solicitação de autorização (#380) completa (regra + tela), o Copiar agenda (#616) e o pagamento parcial antecipado (#604) — ver seção 12.5.

✅ Novo — 15/10/2026 Saíram do roadmap em 13–15/10/2026: os links de pagamento Pix (#409), a elegibilidade TISS online (#619, fase 1) e o catálogo da IA considerando o Farol (#664) — ver seção 12.8. Seguem roadmap: autorização online, envio de lote e demonstrativos por webservice (#620–#623), a IA abrir autorização e orçamento (#660) e o novo layout (#340).

Novidades de 15–23/10/2026 ✅ Novo — 23/10/2026

Conferidas no código de produção em 23/10/2026.

• Token do convênio só é exigido no Acolhimento.
• SMS não vai para agendamento cancelado.
• A agenda carrega também em internet lenta; tabelas com 30 linhas por página.
• Regras financeiras (22/10): cancelar o agendamento encerra os títulos e os links de pagamento; agendamento Atendido e pago exige estorno antes de cancelar ou alterar; particular avulso só é acolhido pago.
• Os documentos obrigatórios no acolhimento continuam exigidos.

Novidades de 23–24/10/2026 ✅ Novo — 26/10/2026

Conferidas no código de produção em 26/10/2026.

• Retorno nos agendamentos da IA (TalkMe), desde 24/10: a mesma regra da recepção — no prazo de retorno e com o mesmo profissional, vira retorno sozinho; no prazo com outro profissional, a IA recebe a recusa com o nome do profissional anterior e os dias restantes e pode oferecer o mesmo profissional; marcar retorno sem atendimento anterior no prazo é recusado. No agendamento por equipamento não há a recusa por outro profissional. No agendamento online e no encaixe a regra segue sem rodar.
• A IA passa a receber também o gênero do profissional (campo Sexo do cadastro do colaborador — confira o Sexo no cadastro) e os retornos disponíveis do paciente (serviço, convênio, especialidade, profissional, prazo e dias restantes).
• Aprovar sem acesso a Colaboradores (23/10): o médico que não tem acesso à tela de Colaboradores agora consegue aprovar — opções como "Aprovado pela Assistência" deixam de ficar desabilitadas por falta dessa permissão.
• Novo Atendimento sem agendamento (Histórico do paciente) foi refeito em 23/10 e aplica o retorno igual ao agendamento — ver a lição de Pacientes.

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). Novidades 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 —, progresso de sessões "x/y" na agenda (#603), bloqueio sem documentação obrigatória (#608) e avisos configuráveis por tela no serviço online (#424). Em 24–26/09/2026: financeiro único do orçamento (orçamento particular com financeiro agenda sem pagar, mas só acolhe pago; pago, o valor trava), cancelar agendamento devolve a sessão, e encaixe adicional não aprovado/recusado vira Cancelado (agendamento inativo ou cancelado não acolhe). Em produção desde 28/09/2026: Copiar agenda (#616), pagamento parcial antecipado (#604 — confirmação manual; percentual sobre a sessão agendada) e a pré-solicitação completa (#380, com tela). Em 30/09/2026: correções do agendamento pela IA/TalkMe (duração do serviço, grade que aceite o convênio, filtro pelo serviço, serviço inativo recusado). Segue roadmap (situação em 30/09): especialidade do convênio, links de pagamento (#409), consulta única de disponibilidade para a IA (#633) e novo layout do agendamento (#340). ✅ Atualização 13/10: o #633 está em produção desde 09/10; #628 parcial (cadastro vale; trava desligada desde 06/10 — ver o item abaixo); links de pagamento (#409) na Sprint 14. ✅ Atualização 15/10: links de pagamento Pix em produção desde 13/10 (opcional, com provedor Pix ativo).
• Permissões: Role + VIEW/CREATE/UPDATE/DELETE por módulo.
• ✅ Novo — out/2026 Desde 05/10, dentro do prazo de retorno do convênio, o mesmo serviço com o mesmo profissional vira retorno automático (R$ 0,00) e com outro profissional o agendamento é bloqueado; a detecção roda também na IA (TalkMe, desde 24/10) e no Novo Atendimento sem agendamento (desde 23/10), mas não roda no online e no encaixe adicional, e não há senha para desmarcar. A trava de especialidade do convênio (#628) está desligada temporariamente desde 06/10. Novos: "Fora da grade atual" (#658), nome social, conflito de edição "alterado por outra pessoa" (#640), autorização de guia fechada recusada (#649) e o caixa na recepção (#650, nasce desligado).
• ✅ Novo — 15/10/2026 Desde 13–15/10: link de pagamento Pix no sinal (#409 — exige provedor Pix ativo; o Pix pago confirma o agendamento sozinho; sem provedor, confirmação manual); botão "Verificar elegibilidade" no agendamento e no acolhimento (#619 — só com integração TISS ativa na operadora); token do convênio exigido só no acolhimento; a IA não oferece serviço bloqueado pelo Farol ou que exige aprovação, e o painel Disponibilidade por Convênio, com convênio no filtro, esconde os bloqueados (#664); 5 senhas erradas em 15 min travam a aprovação presencial (#669).

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), o progresso de sessões "x/y" (#603), o bloqueio sem documentação obrigatória (#608) e os avisos por tela no serviço online (#424) foram entregues em set/2026 (não são mais roadmap). Em produção desde 28/09/2026 (saíram da homologação): Copiar agenda (#616), pagamento parcial antecipado (#604 — agendamento nasce "Pendente de Pagamento" e expira sozinho; confirmação manual) e a pré-solicitação de autorização completa (#380, regra + tela). Segue roadmap: marcação Atende do convênio passando a valer (#628 — hoje sem efeito), links de pagamento (#409), consulta única de disponibilidade para a IA (#633 — e o que manter em dia para ela responder certo) e novo layout do agendamento (#340). ✅ Atualização 13/10: o #633 está em produção desde 09/10/2026. ✅ Atualização 15/10: os links de pagamento (#409) estão em produção desde 13/10 — a confirmação do sinal é manual ou automática pelo link Pix, quando a clínica tem provedor ativo.
• Saber que orçamento particular com financeiro pode ser agendado sem pagamento, mas não acolhido; que encaixe adicional não aprovado no prazo ou recusado vira Cancelado; e que agendamento inativo ou cancelado não pode ser acolhido.
• ✅ Novo — out/2026 Saber como funciona o retorno automático (mesmo profissional = retorno zerado; outro profissional no prazo = bloqueado; pré-requisitos: Prazo de Retorno em (Dias) no convênio + Retorno marcado no serviço do convênio) e que a trava de especialidade do convênio está desligada no agendamento desde 06/10/2026. ✅ Novo — 26/10/2026 E onde a regra roda: tela da recepção, IA TalkMe (desde 24/10) e Novo Atendimento sem agendamento; não roda no online nem no encaixe.
• ✅ Novo — 15/10/2026 Saber o que o link de pagamento Pix faz com o sinal (baixa e confirmação automáticas; só com provedor Pix ativo, cadastrado em Parâmetros › Pagamentos (links)), onde fica o "Verificar elegibilidade" e quando ele aparece (integração TISS ativa + carteira salva), que o token do convênio é exigido só no acolhimento e por que a IA não oferece um serviço que o Farol bloqueia ou que exige aprovação.