📅 Agendamento

Criação e gestão de consultas, exames e procedimentos na agenda da clínica.

Visão Geral

O módulo de Agendamento é a agenda médica central da clínica. Por meio dele, a equipe de recepção e os profissionais de saúde gerenciam consultas, exames e procedimentos de forma organizada, com controle completo do fluxo do paciente desde o agendamento até o atendimento.

O módulo oferece diferentes telas especializadas para cada etapa do fluxo:

Agenda principal — visualização e criação de agendamentos
Confirmação — confirmar consultas agendadas em lote
Acolhimento — receber pacientes que chegam à clínica
Orçamentos — criar e gerenciar orçamentos de procedimentos
Bloqueio de agenda — impedir agendamentos em horários específicos
Autorizações — solicitar e registrar autorizações de convênios

📍 Rota no sistema

Acesse o módulo pela URL: http://app.rabisistemas.com.br/portal/agenda

Visualização da Agenda

A agenda principal (/portal/agenda) exibe os agendamentos organizados de forma visual, permitindo uma visão clara da disponibilidade dos profissionais.

Modos de visualização

Por dia — exibe todos os agendamentos do dia corrente, organizados por horário
Por semana — visão semanal com os agendamentos distribuídos nos dias da semana

Filtros disponíveis

A agenda pode ser filtrada para exibir apenas os agendamentos relevantes:

Profissional — filtra a agenda por médico, fisioterapeuta ou outro colaborador
Especialidade — exibe apenas agendamentos de determinada especialidade médica
Local do agendamento — filtra por sala, consultório ou unidade

💡 Navegação rápida

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

Status do Agendamento

Cada agendamento possui um status que representa sua situação atual no fluxo de atendimento. Os status são identificados visualmente por cores na grade da agenda.

Status	Cor	Significado
Aguardando	Cinza	Agendamento criado, aguardando confirmação do paciente ou da clínica
Confirmado	Verde	Paciente ou clínica confirmou a consulta. O atendimento está garantido
Cancelado	Vermelho	Consulta cancelada. O horário volta a ficar disponível na agenda
Atendido	Azul	Atendimento concluído pelo profissional de saúde
Em Atendimento	Laranja	Paciente está sendo atendido no momento
Acolhido	Roxo	Check-in realizado. Paciente está na fila aguardando ser chamado
Remarcado	Cor do status configurado	Agendamento foi transferido para nova data/horário. ✅ Novo — jul/2026 O remarcado deixou de ter cor diferenciada e passa a usar o status normal configurado (#457). Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

Recursos da Agenda em produção

Estes recursos já estão disponíveis no sistema:

Recurso	O que faz	Issue
Agendamento em série (repetição)	Criar uma série de agendamentos (semanal, quinzenal, mensal) numa só operação — útil para tratamentos longos.	#378
Bloqueio de agenda	Configurar bloqueios totais (feriados, férias do profissional, manutenção de equipamento); o sistema impede agendamento no período.	#380
Fila de espera + encaixe automático	Paciente entra na fila quando o horário está cheio; ao haver cancelamento, o sistema sugere encaixe para o próximo da fila.	#382
Encaixe manual	Encaixe em horário teoricamente cheio, autorizado pelo responsável.	#383
Acolhimento (check-in)	Recepção registra a chegada do paciente, que entra na fila de atendimento do profissional.	—

Novidades do ciclo de julho/2026 ✅ Novo — jul/2026

As entregas abaixo foram concluídas no desenvolvimento em julho/2026 (issues do GitLab fechadas). Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

Regras de agendamento entregues

Novidade	O que muda	Issue
Orçamento obrigatório no agendamento	Conforme a parametrização, o agendamento passa a ser bloqueado quando não há orçamento aprovado.	#373
Autorização obrigatória no agendamento	Conforme a parametrização, o agendamento passa a ser bloqueado sem a autorização do convênio.	#374
Bloqueio no prazo de retorno do convênio	O sistema bloqueia a criação de novo agendamento dentro do prazo de retorno do convênio.	#414
Prazo de retorno configurável	O prazo de retorno passa a ser configurável por convênio e por serviço.	#415
Repetir agendamento	Recurso de repetição de agendamento entregue (um ajuste fino, #214, segue em andamento na Sprint 3).	#337
Limite de agendamentos por convênio na grade	Permite limitar a quantidade de agendamentos de um convênio dentro de uma grade.	#476
Confirmação ao sair da tela (guard de edição)	Ao sair de um formulário com alterações pendentes, o sistema pede confirmação. Ver página dedicada.	#401, #404

Grade, encaixe e correções

Novidade	O que muda	Issue
Marcar todos os convênios na grade	Na tela de grade, é possível marcar de uma vez todos os convênios que o médico atende.	#461
Campo de serviços expansível na grade	Na tela de grade, o campo se expande conforme serviços são adicionados.	#501
Correção: encaixe aparece imediatamente	O encaixe criado na grade agora aparece na hora (correção de cache).	#460
Correção: "equipamentos insuficientes" indevido	Corrigido o aviso indevido de equipamentos insuficientes na grade.	#458
Remarcado sem cor diferente	O agendamento remarcado deixa de ter cor própria e passa a usar o status normal configurado.	#457

Serviço de agendamento online

Novidade	O que muda	Issue
Ocultar itens não habilitados	O serviço online deixa de exibir itens que não estão habilitados.	#426
Listas restritas ao contexto	Só são listadas as especialidades e os médicos do contexto.	#427
Correção: área do colaborador	Corrigida a tela em branco na área do colaborador.	#428
Ativação por SMS do paciente	Ativação do paciente por SMS no serviço de agendamento online.	#389

Melhorias transversais (valem em todo o sistema)

Novidade	O que muda	Issue
Busca global	Busca por parte do nome/sobrenome, telefone, e-mail ou CPF.	#456
Setas de navegação	Setas próximo/anterior no topo das telas para navegar entre registros.	#459
Idempotência em criações/edições	Sem duplicidades por duplo clique ao salvar.	#408

🟠 Planejado (roadmap) — ainda NÃO disponível. As regras abaixo foram levantadas na reunião de 18/06/2026 e estão no roadmap. Elas não fazem parte do comportamento atual do sistema.

Regras planejadas para a Agenda

Obs.: o farol de resultado por convênio (#390) saiu desta lista — foi ✅ entregue em jul/2026 (ver Orçamento).

Regra (planejada)	O que vai mudar	Issue
Status "Pendente"	Novo status intermediário enquanto faltar orçamento/autorização (planejado para a Sprint 5, em agosto).	#375
Bloqueio de serviço por convênio	Convênio poderia bloquear serviços específicos; o sistema impediria o agendamento.	#376
Avisos visuais na grade	Ícones/badges para colaborador indisponível, equipamento em manutenção e bloqueio total.	#377

Novo Agendamento

Para criar um novo agendamento, acesse /portal/agenda/criar ou clique em "Novo Agendamento" na agenda principal.

Passo a passo do agendamento

Acesse o formulário de novo agendamento
Clique em "Novo Agendamento" na agenda ou acesse /portal/agenda/criar.

Defina a data e horário

Campo	Obrigatoriedade	Observação
Data	Obrigatório	Data do agendamento no formato DD/MM/AAAA
Hora início	Obrigatório	Horário de início da consulta ou procedimento
Hora fim	Obrigatório	Horário de término previsto

Selecione o paciente
No campo Paciente, digite o nome ou CPF para buscar o paciente cadastrado. O sistema exibe sugestões em tempo real. Selecione o paciente correto na lista.

💡 Paciente não cadastrado

Caso o paciente ainda não esteja cadastrado, acesse o módulo de Pacientes para realizar o cadastro antes de criar o agendamento.

Informe os dados do atendimento

Campo	Obrigatoriedade	Observação
Convênio	Opcional	Preenchido automaticamente com o convênio do cadastro do paciente, se houver
Plano	Opcional	Plano do convênio selecionado
Especialidade	Obrigatório	Especialidade médica do atendimento (ex: Cardiologia, Fisioterapia)
Profissional / Colaborador	Obrigatório	Médico ou profissional de saúde responsável pelo atendimento
Local do Agendamento	Opcional	Sala, consultório ou unidade onde o atendimento ocorrerá
Equipamentos	Opcional	Equipamentos necessários para o procedimento
Tipo	Obrigatório	Normal — consulta no horário regular; Encaixe — consulta fora do horário normal
Guia Operadora	Opcional	Número da guia de autorização emitida pela operadora de convênio
Observação	Opcional	Informações adicionais sobre o agendamento

Verifique os contatos do paciente
O formulário exibe a Lista de Contatos vinculada ao cadastro do paciente, permitindo confirmar se as informações de contato estão atualizadas antes de salvar o agendamento.
Anexe documentos, se necessário
Na seção Documentos / Anexos, é possível incluir arquivos avulsos relacionados ao agendamento (pedidos médicos, guias, laudos etc.).
Salve o agendamento
Clique em "Salvar". O agendamento aparecerá na agenda com status Aguardando.

Confirmação de Agendamentos

A tela de Confirmação (/portal/agenda/confirmacao) permite confirmar consultas agendadas de forma rápida, sem precisar abrir cada agendamento individualmente.

Como confirmar agendamentos em massa

Acesse Agendamento › Confirmação no menu ou navegue para /portal/agenda/confirmacao
A tela exibe a lista de agendamentos com status Aguardando
Use os filtros de data, profissional e especialidade para localizar os agendamentos desejados
Selecione um ou mais agendamentos marcando as caixas de seleção
Clique em "Confirmar" para alterar o status para Confirmado

Também é possível confirmar agendamentos individualmente diretamente pela grade da agenda principal ou pela tela de edição do agendamento (/portal/agenda/:id/editar).

ℹ️ Integração com financeiro

Ao confirmar uma consulta, o sistema pode gerar automaticamente um lançamento financeiro, conforme as configurações da clínica.

Acolhimento de Pacientes

O Acolhimento (/portal/agenda/acolhimento) é a etapa em que a recepção registra a chegada do paciente à clínica. Após o check-in, o paciente entra na fila de atendimento do profissional.

Fluxo do acolhimento

Paciente chega à clínica e se apresenta na recepção
A recepcionista acessa a tela de Acolhimento (/portal/agenda/acolhimento)
Localiza o paciente na lista de agendamentos do dia (busca por nome ou CPF)
Realiza o check-in do paciente (ver seção abaixo)
O status do agendamento muda para Acolhido
O paciente é incluído automaticamente na fila de atendimento do profissional
O profissional chama o próximo da fila pelo sistema, e o status muda para Em Atendimento

Informações exibidas na tela de acolhimento

A tela exibe todos os agendamentos do dia com as seguintes informações:

Nome do paciente
Horário agendado
Profissional e especialidade
Status atual do agendamento
Convênio

Check-in do Paciente

O check-in é o registro formal da chegada do paciente à clínica. Ele é realizado na tela de acolhimento e altera o status do agendamento para Acolhido.

Como realizar o check-in

Acesse a tela de Acolhimento: /portal/agenda/acolhimento
Localize o agendamento do paciente que chegou (busque por nome, CPF ou use a lista do dia)
Clique no agendamento para abrir a tela de check-in: /portal/agenda/acolhimento/:id/checkin
Confirme os dados do paciente e do agendamento exibidos na tela
Clique em "Realizar Check-in"
O status do agendamento é atualizado para Acolhido
O paciente é inserido na fila de espera do profissional responsável

💡 Fila de atendimento

Após o check-in, o profissional de saúde pode visualizar a fila de pacientes acolhidos e chamar o próximo diretamente pelo sistema, otimizando o fluxo do consultório.

Orçamentos

A tela de Orçamentos (/portal/agenda/orcamento) permite criar e gerenciar orçamentos de procedimentos para pacientes, antes de confirmá-los como agendamentos.

Criar um orçamento

Acesse Agendamento › Orçamentos ou navegue para /portal/agenda/orcamento
Clique em "Novo Orçamento" ou acesse /portal/agenda/orcamento/criar
Selecione o paciente e informe os procedimentos desejados
Informe os valores e o convênio, se aplicável
Salve o orçamento. Ele ficará listado na tela de orçamentos com status pendente

Reabrir um orçamento cancelado

Localize o orçamento cancelado na lista
Clique em "Reabrir" para alterar o status do orçamento de volta para ativo
Faça os ajustes necessários e salve novamente

Converter orçamento em agendamento

Localize o orçamento aprovado na lista
Clique em "Converter em Agendamento"
O sistema abrirá o formulário de agendamento com os dados do orçamento preenchidos automaticamente
Defina a data, horário e profissional
Salve para confirmar o agendamento

Bloqueio de Agenda

O Bloqueio de Agenda (/portal/agenda/bloqueio) permite marcar horários como indisponíveis para agendamento, impedindo que consultas sejam criadas nesses períodos.

Quando usar o bloqueio

Reuniões internas ou de equipe
Folgas e férias de profissionais
Feriados
Manutenção de equipamentos
Qualquer outro impedimento de agenda

Como criar um bloqueio

Acesse Agendamento › Bloqueio de Agenda ou navegue para /portal/agenda/bloqueio
Clique em "Novo Bloqueio"
Selecione o profissional e o local a serem bloqueados
Informe a data, o horário de início e o horário de fim do bloqueio
Adicione uma descrição ou motivo do bloqueio (ex: "Reunião", "Folga")
Salve. O horário bloqueado aparecerá na agenda com indicação visual de indisponibilidade

⚠️ Agendamentos no período bloqueado

O bloqueio de agenda impede novos agendamentos no período, mas não cancela automaticamente agendamentos já existentes. Verifique se há consultas no período antes de criar o bloqueio.

Autorizações de Convênio

A tela de Autorizações (/portal/agenda/autorizacao) permite solicitar e registrar autorizações de procedimentos junto às operadoras de convênio.

Como criar uma autorização

Acesse Agendamento › Autorizações ou navegue para /portal/agenda/autorizacao
Clique em "Nova Autorização" ou acesse /portal/agenda/autorizacao/criar
Selecione o paciente e o convênio envolvido
Informe os procedimentos que necessitam de autorização (código TUSS, descrição)
Informe os dados do profissional solicitante
Registre o número da autorização fornecido pela operadora, quando disponível
Salve a autorização

Vincular autorização ao agendamento

Após obter a autorização da operadora, o número pode ser registrado no campo "Guia Operadora" do formulário de agendamento, garantindo o rastreamento da autorização ao longo do atendimento e do faturamento.

ℹ️ Integração com faturamento

Autorizações registradas no sistema são utilizadas automaticamente no processo de faturamento de guias de convênio.

Encaixe

O Encaixe é um agendamento criado fora do horário regular da agenda do profissional, para atender pacientes em situações especiais ou de urgência.

Como criar um encaixe

Acesse o formulário de novo agendamento: /portal/agenda/criar
Selecione a data, horário e paciente normalmente
No campo Tipo, selecione "Encaixe" (em vez de "Normal")
Preencha os demais campos obrigatórios
Salve o agendamento

Agendamentos do tipo Encaixe são identificados visualmente na grade da agenda com marcação diferenciada, alertando a equipe de que aquele atendimento foi inserido fora do fluxo regular.

💡 Quando usar encaixe

Use o Encaixe para pacientes que necessitam de atendimento urgente, retornos rápidos ou situações em que a agenda regular já está completa mas o profissional autoriza um atendimento adicional.

Integrações do Módulo de Agendamento

O módulo de Agendamento se integra com os principais módulos do sistema, compondo o fluxo completo de atendimento da clínica:

Módulo	Como a integração funciona
Pacientes	O agendamento é vinculado ao cadastro do paciente. Dados de convênio, contato e carteira são herdados automaticamente do módulo de Pacientes.
Atendimento	Ao realizar o check-in na tela de Acolhimento, o sistema cria automaticamente a fila de atendimento para o profissional. O prontuário eletrônico é aberto a partir do agendamento.
Financeiro	Ao confirmar uma consulta, pode ser gerado automaticamente um lançamento financeiro, conforme a configuração da clínica. Valores de procedimentos e formas de pagamento são registrados no módulo Financeiro.
Faturamento	Agendamentos vinculados a convênios geram guias de faturamento. O número de autorização registrado no agendamento é utilizado no processo de faturamento junto às operadoras.

💡 Fluxo completo do paciente

O fluxo completo de atendimento passa pelos seguintes módulos: Agendamento (marcação) → Acolhimento (chegada) → Prontuário (atendimento) → Financeiro (cobrança) → Faturamento (convênio).

Capturas de Tela

Imagens de referência das telas do módulo com indicação numerada dos elementos principais.

**Figura 1 — Lista de Agendamentos (tela principal)**

Botões de adição — *Locais*, *Especialidades*, *Profissionais*

Mini-calendário de navegação por data

Colunas de agendamentos do dia distribuídas por profissional

Card de agendamento com status colorido