🔗 Mapa de Integrações
Como os módulos do sistema Rabi se comunicam: fluxo de dados, dependências e impacto operacional de cada integração.
Visão Geral das Integrações
O sistema Rabi é uma plataforma integrada onde a ação em um módulo automaticamente afeta outros módulos relacionados. Isso elimina retrabalho, garante consistência dos dados e cria um fluxo operacional fluido da recepção ao faturamento.
💡 Como ler este mapa
Cada seção descreve um fluxo de integração entre dois ou mais módulos. As tabelas mostram: De (origem do dado), Para (destino), Campo/Evento (o que é transferido ou acionado) e Impacto (efeito prático).
Diagrama de Módulos
⚙️ ConfiguraçõesBase de tudo
→
👤 PacientesCadastro central
→
📅 AgendamentoAgenda da clínica
→
📋 ProntuárioAtendimento clínico
→
💰 FinanceiroGestão financeira
→
📈 RelatóriosAnálise gerencial
Fluxo Completo de Atendimento
O fluxo abaixo representa o ciclo completo de um paciente no sistema Rabi, desde o agendamento até o faturamento:
Fluxo Particular (pagamento no ato):
Fluxo Convênio (faturamento mensal):
1. Cadastrar Paciente
→
2. Agendar Consulta
→
3. Confirmar Agendamento
→
4. Check-in (Acolhimento)
→
5. Atendimento (Prontuário)
→
6. Lançamento Financeiro
→
7. Recebimento
1. Paciente + Carteirinha
→
2. Agendar + Autorização
→
3. Acolhimento + Check-in
→
4. Atendimento
→
5. Pré-faturamento (Guia)
→
6. Fechar Lote
→
7. Gerar Contas a Receber
→
8. Recebimentos de convênio (baixa + glosa)
Novo — out/2026 Desde 23/10/2026, a baixa do pagamento do convênio é feita em Faturamento › Recebimentos de convênio; convênio que não recebe XML segue o Envio sem XML no passo 6.
Configurações → Todos os Módulos
O módulo de Configurações é a fundação do sistema. Todos os outros módulos dependem dos cadastros feitos aqui para funcionar corretamente. É obrigatório configurar antes de usar qualquer outro módulo.
| De | Para | Campo/Evento | Impacto |
|---|---|---|---|
| Configurações | Agendamento | Colaboradores e suas especialidades | Profissionais disponíveis para seleção no agendamento; filtragem por especialidade |
| Configurações | Agendamento | Locais/Salas | Define onde ocorrerá o atendimento; campo "Local do Agendamento" |
| Configurações | Agendamento | Equipamentos | Permite vincular equipamentos ao agendamento (ex: aparelho de ultrassom) |
| Configurações | Agendamento | Tipos de Atendimento | Define categorias de consulta: primeira consulta, retorno, urgência, etc. |
| Configurações | Agendamento | Convênios e Planos | Permite selecionar convênio no agendamento; carrega automaticamente os planos associados |
| Configurações | Convênios / Orçamento | Tabela de Preços Internos (produtos) | Fonte de preço de produto: até 3 preços por produto (Nome Preço 1/2/3); se a tabela não tem o produto, vale o Preço de venda tabela. É escolhida na Política de Preço do convênio. Não define o valor do atendimento particular — esse sai do convênio Particular (conversão do convênio, pagamento no ato). |
| Configurações | Financeiro | Tabela de Preços por Convênio | Valor de repasse e cobrança calculado automaticamente por convênio e procedimento |
| Configurações | Financeiro | Tipos de Pagamento | Opções disponíveis ao registrar um recebimento (dinheiro, PIX, cartão etc.) |
| Configurações | Financeiro | Categorias de Pagamento | Agrupamento dos lançamentos para análise por categoria nos relatórios |
| Configurações | Financeiro | Contas/Caixas | Contas disponíveis para seleção nos lançamentos financeiros |
| Configurações | Prontuário | Tipos de Documento de Atendimento | Modelos disponíveis para emissão de atestados, receitas, laudos durante o atendimento |
| Configurações | Prontuário | Serviços/Procedimentos | Procedimentos que o profissional pode registrar no atendimento |
| Configurações | Faturamento | Convênios (prazos e regras) | Prazo de entrega das guias, limite de recurso de glosa, prazo de pagamento |
| Configurações | Estoque | Tipos de Produto, Fornecedores, Fabricantes | Dados auxiliares para cadastro de produtos no estoque |
Pacientes → Outros Módulos
O cadastro de pacientes é o dado central que atravessa praticamente todos os módulos. Um paciente precisa estar cadastrado para ser agendado, atendido, cobrado e faturado.
| De | Para | Campo/Evento | Impacto |
|---|---|---|---|
| Pacientes | Agendamento | Cadastro do paciente | Paciente disponível para seleção ao criar um agendamento; busca por nome ou CPF |
| Pacientes | Agendamento | Convênio/Plano/Carteirinha | Pré-carregado no agendamento, permitindo cobrar pelo convênio do paciente |
| Pacientes | Agendamento | Pessoa de Contato / Celular | Usada para confirmação e lembretes de consulta |
| Pacientes | Prontuário | Dados demográficos | Exibidos no cabeçalho do prontuário durante o atendimento |
| Pacientes | Prontuário | Histórico de atendimentos | Atendimentos anteriores visíveis no prontuário para contexto clínico |
| Pacientes | Financeiro | ID do paciente | Vincula lançamentos financeiros ao paciente para controle de contas a receber individuais |
| Pacientes | Faturamento | Número da carteirinha | Usado na geração da guia de faturamento para o convênio |
| Pacientes | Relatórios | CPF, Celular, Cidade | Disponíveis como filtros nos relatórios de agendamentos |
Agendamento → Prontuário Eletrônico
O agendamento alimenta automaticamente o prontuário quando um atendimento é iniciado. O profissional não precisa redigitar dados que já constam no agendamento.
| De | Para | Campo/Evento | Impacto |
|---|---|---|---|
| Agendamento | Prontuário | Check-in do paciente (Acolhimento) | Paciente entra na Fila de Atendimento; profissional pode iniciar o atendimento |
| Agendamento | Prontuário | Dados do paciente (ID) | Prontuário aberto com histórico completo do paciente |
| Agendamento | Prontuário | Data e hora do agendamento | Registrada como data/hora do atendimento no prontuário |
| Agendamento | Prontuário | Especialidade/Procedimento | Indica ao profissional qual o motivo do agendamento |
| Agendamento | Prontuário | Convênio do agendamento | Define se o atendimento é particular ou por convênio para fins de faturamento |
| Prontuário | Agendamento | Finalização do atendimento | Atualiza status do agendamento para "Atendido" |
| Estoque | Prontuário (Receitas) | Lista da Portaria 344/98, retenção, concentração e forma farmacêutica do produto/princípio ativo Novo — out/2026 | O Rabi sugere o tipo de receita e preenche o medicamento — ver Receitas e SNCR |
| Configurações | Prontuário (Receitas) | CPF e especialidade com conselho, número e UF do colaborador Novo — out/2026 | Dados conferidos pela Anvisa no pedido de numeração e impressos na receita. O SNCR só aceita CRM, CRMV ou CRO; vale a especialidade com a inscrição mais antiga (ver Receitas › Antes de começar). Ligação com a Anvisa ativa desde 23/10/2026. |
Agendamento → Financeiro
Atendimentos particulares geram automaticamente lançamentos financeiros. Para convênios, o fluxo passa pelo módulo de Faturamento antes de chegar ao Financeiro.
| De | Para | Campo/Evento | Impacto |
|---|---|---|---|
| Agendamento | Financeiro | Paciente + Convênio Particular | Gera lançamento de "Contas a Receber" com o valor do serviço no convênio Particular (conversão do convênio, pagamento no ato) — a tabela de preços internos só fornece preço de produto |
| Agendamento | Financeiro | Profissional responsável | Vincula ao repasse do profissional; base para relatório de Produtividade |
| Agendamento | Financeiro | Cancelamento de agendamento | Cancela ou reverte lançamento financeiro associado (se configurado) |
| Prontuário | Financeiro | Procedimentos registrados | Cada procedimento realizado pode gerar lançamento individual de cobrança |
Agendamento → Faturamento (Convênio)
Para atendimentos de convênio, o fluxo de faturamento ocorre em lotes mensais. A guia gerada no atendimento percorre o processo de pré-faturamento, fechamento de lote e geração de contas a receber.
| De | Para | Campo/Evento | Impacto |
|---|---|---|---|
| Agendamento | Faturamento | Autorização registrada (Guia Operadora) | Número da autorização vinculado à guia de faturamento |
| Prontuário | Faturamento | Procedimentos realizados | Geram guias de faturamento para o convênio correspondente |
| Faturamento | Financeiro | Fechar Lote + Gerar Contas a Receber | Lote aprovado pelo convênio cria lançamentos de "Contas a Receber" no Financeiro |
| Faturamento | Financeiro | Glosas aprovadas | Glosas não revertidas geram ajuste negativo no valor a receber do lote |
| Faturamento Novo — out/2026 | Financeiro + Glosas | Recebimentos de convênio (demonstrativo importado ou digitado → Baixar) | Baixa as contas a receber das guias (parcial deixa saldo em aberto), registra a glosa com motivo em Glosas e marca a guia como Paga / Paga parcial / Glosada; Estornar desfaz — ver Financeiro |
| Configurações (convênio › subaba Faturamento) Novo — out/2026 | Faturamento | Forma de envio Portal ou Papel | No lote fechado, "Envio sem XML": espelho de digitação, registro do envio; o número do portal ajuda a casar o pagamento — ver Faturamento sem XML |
Financeiro → Relatórios e Dashboard
Todos os lançamentos financeiros alimentam automaticamente os relatórios gerenciais e o dashboard financeiro, provendo visão em tempo real da saúde financeira da clínica.
| De | Para | Campo/Evento | Impacto |
|---|---|---|---|
| Financeiro | Relatórios | Lançamentos (pagar/receber) | Alimenta Relatório de Fluxo de Caixa (Saldo Dia, Acumulado, Máximo, Mínimo) |
| Financeiro | Relatórios | Lançamentos + Categorias de Pagamento (coluna "Linha do DRE") | ✅ 28/09/2026 Alimenta o DRE Gerencial (competência × caixa, mês a mês); categoria sem classificação entra por uma regra padrão pelo tipo de movimentação |
| Financeiro | Relatórios | Repasse por profissional | Relatório "Repasse por Colaborador" — valor de repasse por colaborador no período; desde 02/10 inclui taxas, a coluna "Origem do repasse" (geral/específico), a coluna "Tipo" e totais por tipo (#644). O repasse de serviço é calculado sobre o valor líquido (total − descontos) e retorno sai com 0 |
| Financeiro | Dashboard | Saldo atual e fluxo de caixa | Dashboard Financeiro exibe resumo de entradas/saídas e saldo do dia |
| Financeiro | Dashboard | Contas a receber pendentes | Dashboard alerta sobre valores a vencer e vencidos |
Agendamento → Relatórios e Dashboard
| De | Para | Campo/Evento | Impacto |
|---|---|---|---|
| Agendamento | Relatórios | Agendamentos criados/realizados | Relatório de Agenda: lista completa com filtros por data, especialidade, profissional, status |
| Agendamento | Relatórios | Status dos agendamentos | Relatório de Ocupação: taxa de comparecimento, faltas, cancelamentos |
| Agendamento | Relatórios | Procedimentos por colaborador | Relatório de Produtividade: total de atendimentos por profissional no período |
| Agendamento | Dashboard | Agendamentos do dia/semana | Dashboard de Agendamentos: total por status em tempo real |
| Agendamento | Dashboard | Orçamentos em aberto | Dashboard de Orçamentos: pipeline de orçamentos pendentes de aprovação |
| Agendamento | Dashboard | Autorizações pendentes | Dashboard de Autorizações: autorizações aguardando resposta da operadora |
Estoque → Relatórios e Dashboard
| De | Para | Campo/Evento | Impacto |
|---|---|---|---|
| Estoque | Relatórios | Saldo atual vs. Estoque Atual (antigo "Estoque Base") | Relatório "Mapa de Estoque": identifica produtos em situação CRÍTICA (saldo igual ou abaixo do mínimo) |
| Estoque | Dashboard | Produtos críticos | Dashboard de Produtos: resumo de itens abaixo do estoque mínimo |
| Prontuário | Estoque | Insumos utilizados no atendimento | Baixa automática no estoque dos insumos consumidos nos procedimentos |
Integração externa — TalkMe / agendamento assistido por IA ✅ Novo — ago/2026
Nova integração externa entregue no ciclo de agosto/2026 (issues #531–#536, fechadas entre 31/07 e 03/08/2026): APIs que servem de base para o agendamento assistido por IA/chat via TalkMe. Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
| Recurso da API | O que faz |
|---|---|
| Catálogos filtrados por convênio | API que retorna serviços, produtos e taxas filtrados pelo convênio do paciente |
| Profissionais com grade | Lista os profissionais que atendem o convênio, com a grade de atendimento de cada um |
| 3 opções de datas | Consulta de disponibilidade da agenda limitada a 3 opções de datas, para oferecer ao paciente no chat |
💡 O que isso significa na prática
Essas APIs são a base para o agendamento via TalkMe (assistente de IA/chat): o assistente consegue consultar o que a clínica oferece para o convênio do paciente, quais profissionais atendem e propor até 3 datas disponíveis.
TalkMe — isolamento por clínica e token próprio ✅ em produção desde 28/09/2026
✅ Novo — 29/09/2026 Em produção desde 28/09/2026 (concluído no desenvolvimento na Sprint 11, fechada em 25/09/2026):
- Isolamento por clínica (#597): a clínica habilita a integração TalkMe em Configurações › Parâmetros › Integrações. Sem habilitação, a TalkMe recebe 403 — e não lê dados de outra clínica nem trocando cabeçalho.
- Token TalkMe (IA) gerado pela própria clínica (#624): na mesma tela, a clínica gera, renova e revoga o token
rbt_…do tipo TalkMe (IA) (acesso fixo à API TalkMe da clínica); o valor aparece uma única vez; tudo auditado. O token TalkMe não tem "Editar permissões" (o acesso é fixo) e renova como antes — a edição de permissões (#653) vale só para o token de implantação. Ver Configurações › Parâmetros › Integrações. - Cuidados: guarde o token em local seguro; nunca cole em documento, chamado, e-mail, manual ou conversa com IA que fique salva; token de uma clínica não acessa outra; suspeita de vazamento → revogue e gere outro.
TalkMe — correções de 30/09 e o que manter em dia ✅ Novo — 30/09/2026
Correções no servidor, em produção desde 30/09/2026:
- Ao marcar, a IA passa a checar a duração do serviço — antes podia sobrepor agendamentos.
- Só oferece especialidades para um convênio quando existe grade que aceite esse convênio.
- Filtra os horários dos profissionais pelo serviço pedido.
- Serviço inativo é recusado na consulta e no agendamento.
✅ Atualização 13/10 — correções até 09/10: a IA só oferece horários e só agenda em grade que aceita o convênio e o serviço; as consultas passaram a levar o serviço e o tipo de serviço. A trava de especialidade do convênio (#628) está desligada ao gravar agendamentos pela recepção desde 06/10/2026 (temporário). 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.
TalkMe — consulta única de disponibilidade (#633) ✅ Novo — 13/10/2026
Em produção (issue fechada em 09/10/2026): numa consulta só, a IA sabe se a clínica tem profissional da especialidade pedida, que faz o procedimento, com agenda liberada para o convênio do paciente — inclusive paciente com dois convênios ao mesmo tempo — e recebe os códigos de profissional, especialidade, grade, local, convênio e serviço para seguir. A consulta não mostra horários: eles continuam vindo da agenda, depois que a IA escolhe o profissional. A IA usa regras mais rígidas que a agenda da recepção (credenciamento do profissional no convênio, convênio na unidade, especialidade marcada) — por isso pode responder "não temos" num caso que a recepção conseguiria agendar.
Catálogo de atendimento (#659) e o que ainda não está no ar
- ✅ Novo — 09/10/2026 #659 — sem tela: a base do "catálogo de atendimento" (o que a clínica atende por convênio, profissional, especialidade e unidade) está no banco de produção, mas não há tela, menu nem relatório. O único efeito visível é o painel "Disponibilidade por Convênio" da Agenda, que passou a usar a mesma regra da agenda interna e a ler os convênios de cada unidade do cadastro Unidades do convênio (a lista pode crescer bastante).
- ✅ Novo — 14/10/2026 #664 — catálogo considerando o Farol: em produção desde 14/10. A IA (TalkMe) não oferece serviço que o Farol bloqueia ou que só libera com aprovação (vermelho, roxo e amarelo com "Exigir aprovação de nível 2"); a IA agenda sem aprovação, então esses ficam para a 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. No painel "Disponibilidade por Convênio", com um convênio no filtro, somem os serviços que o Farol bloqueia para esse convênio (o que só pede aprovação continua aparecendo). A trava do Farol ao salvar orçamento, autorização e agendamento não mudou.
- 🟠 Roadmap #660 — IA abrir autorização e orçamento: não em produção. Hoje a IA só agenda; não abre autorização nem orçamento.
- Novo — out/2026 Retorno nos agendamentos da IA (24/10/2026): o retorno automático (#645) passou a valer também na TalkMe, com a mesma regra da recepção — no prazo e com o mesmo profissional vira retorno sozinho; no prazo com outro profissional é recusado (a IA recebe o nome do profissional anterior e os dias restantes e pode oferecer o mesmo profissional); pedir 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 adicional o retorno segue sem detecção automática — a recepção confere e marca. Ver Agendamento › Retorno pela IA.
- Novo — out/2026 Mais dados para a IA (24/10/2026): a IA passa a receber o gênero do profissional (campo Sexo do cadastro do colaborador — mantenha-o correto) e os retornos disponíveis do paciente (serviço, convênio, especialidade, profissional, prazo e dias restantes).
⚠️ O que a clínica deve manter em dia para a IA responder certo (vale desde já)
- No cadastro do profissional, marcar Atende convênio em cada convênio que ele atende.
- Na grade do profissional, cadastrar os serviços e configurar os convênios (Incluir ou Excluir).
- No convênio (clique em Liberar para edição — o convênio abre em modo consulta), marcar Utiliza nos serviços cobertos e, se usar, Atende nas especialidades cobertas.
- Deixar o convênio ativo na unidade onde é atendido (cadastro Unidades do convênio). Depois de alterar o convênio, clicar em Salvar no cabeçalho (desde 01/10 as abas só gravam no Salvar).
Se algum desses pontos faltar, a IA vai responder que não há atendimento para aquele caso — mesmo que a recepção consiga agendar pela tela. Ver também Configurações › Cadastros em dia para a IA.
Integração externa — API Externa de Implantação/Parceiros ✅ Novo — set/2026
Em produção desde 23–24/09/2026. API REST pública para que sistemas externos, parceiros implantadores ou uma IA cadastrem e mantenham os dados de uma clínica — útil para implantação e migração automatizadas.
| Aspecto | Como funciona |
|---|---|
| Autenticação | Header Authorization: Bearer rbk_… — uma chave por clínica, com permissões por rota e validade (informada em toda resposta no cabeçalho X-ApiKey-Expires-At). A chave rbk_ é emitida e renovada pelo time Rabi (sem renovação automática). ✅ em produção desde 28/09/2026 Tokens rbt_… gerados pela própria clínica em Configurações › Parâmetros › Integrações (#624, tipo "Implantação e manutenção", só com as permissões escolhidas — mesmo catálogo da rbk_); a rbk_ do time Rabi continua valendo. O token aparece uma única vez — guarde em local seguro e nunca cole em documento, chamado, e-mail ou conversa com IA salva. ✅ Novo — 30/09/2026 Para o kit de Implantação com IA, o caminho recomendado passa a ser o token rbt_ "Implantação e manutenção" da própria clínica, só com as permissões da implantação; a rbk_ fica como alternativa. ✅ Novo — 02/10/2026 Permissões do token rbt_ editáveis (#653): "Editar permissões" muda o acesso sem trocar o valor do token (vale na chamada seguinte) e Renovar deixa revisar permissões e validade; o rbt_ também envia X-ApiKey-Expires-At; o erro 403 traz escopoFaltante e onde liberar a permissão. |
| Cobertura | 270 operações (193 caminhos) em 25 grupos (Swagger de 13/10/2026; nova rota POST /financeiro/pagamentos/confirmacao, para o provedor de pagamento avisar que a cobrança foi paga — ✅ Atualização 15/10 os Links de Pagamento Pix, #409, estão em produção desde 13/10). ✅ Novo — 14/10/2026 Listagens com no máximo 200 itens por página (pedido acima é reduzido sem erro; use a paginação) — cadastros (empresas, locais, depósitos, operadoras, convênios, serviços, produtos, taxas, colaboradores, equipamentos, fornecedores, fabricantes, grades), pacientes, tabelas de preço, estoque, financeiro, NFS-e, agendamentos, orçamentos, faturamento, atendimentos e parâmetros. |
| Lotes | Até 50 itens por requisição, com resposta de sucesso total ou parcial. |
| Conferência | O Farol do convênio pode ser consultado por linha (GET /convenios/{id}/farol/itens): cada linha traz serviço raiz, tipo, nível e caminho do item, códigos (tipo de código, código, Tabela 87), Zerar/Somar itens, custo e receita (em reais), conta no total (conta_no_total), motivo (motivo_exclusao), margem do serviço (margem_servico_pct), farol do serviço (farol_servico) e utiliza. ✅ Novo — 26/09/2026 Nova rota GET /convenios/{id}/farol/itens/{servicoRaizId}: a árvore de um serviço, sem paginação, com os totais por subárvore — preferível quando já se sabe o serviço. Correção 26/09: este manual dizia que margem e "Conta no total" só apareciam na tela — a API externa também os traz. O efetivo.totalConvenio segue fora da API externa (para o total, use receita_total_servico). |
| Status das correções | ✅ tudo em produção Rodada 1 do QA externo em 24/09 (estoque paginado, divergências de faturamento sem erro 500, histórico de atendimentos exigindo pacienteId); rodadas 2 e 3 em 25/09 (agendamentos com data obrigatória e paginação real, todas as listagens no envelope padrão, grades e orçamentos paginados com filtros, filtro servicoAtivo no Farol por itens, cabeçalho X-ApiKey-Expires-At com a validade da chave, 401 para qualquer chave rejeitada). Swagger atualizado em 25/09: convenções oficiais de envelope e valores monetários (reais; exceções de faturamento sinalizadas na rota). Nada fica só em homologação. ✅ Novo — 26/09/2026 Swagger republicado em 26/09: GET /servicos/{id} e GET /convenios/{id} passam a devolver as listas que o PUT espera (composição, especialidades, unidades, políticas) — e o PUT aceita os mesmos nomes da leitura; rota inexistente sob /api/v1/integrations responde 404 (antes parecia erro de chave). ✅ Novo — 29/09/2026 Correção geral de 28/09/2026 (17:43): campo opcional omitido não derruba mais a rota; serviço com taxas em servicoTaxa: [{taxaId, quantidade}] (saíram taxaServicoId/valorTaxaServico); POST /estoque/saida e /estoque/transferencia exigem lote (null para produto sem lote); corrigidas gravações erradas sem aviso — quem gravou pela API antes de 28/09 17:43 deve conferir uma vez (pacientes em lote, lote de preços, PUT de movimentação/fornecedor, UF, estoque sem lote). ✅ Novo — 01/10/2026 PUT parcial é a regra (#634 corrigido): campo omitido mantém o valor atual, null limpa, lista omitida mantém e lista enviada substitui ([] apaga) — em serviços, orçamentos, pacientes, colaboradores, convênios, grades, movimentações financeiras e guias. Gravar pela API não apaga mais o que não foi enviado (ex.: documento obrigatório do serviço); produto da composição enviado sem valor mantém o valor que já tinha. Outras novidades: 409 ITEM_EM_USO_EM_SERVICOS ao excluir produto/taxa em uso (#626); campo nomeSocial no paciente; linha de repasse geral no colaborador (item vazio/null); preços de tabela em reais nas duas rotas (#652 — confira lotes carregados antes de 28/09). Detalhes na API Externa. |
| Ordem de carga | Segue a ordem oficial de implantação (depósito mínimo antes dos locais, taxas e produtos antes dos serviços e convênios) — ver o Guia de Implantação. |
Documentação completa (grupos, rotas, erros e exemplos): API Externa.
Outras integrações externas ✅ Atualizado — set/2026
- Provedor plugável de NFS-e (#463) — emissão de nota fiscal de serviço via camada de provedor plugável, com certificado A1 armazenado no provedor. Em produção. Ver Notas Fiscais.
- Importação de NF-e de fornecedor (#391) — o XML da nota do fornecedor carrega o estoque e o contas a pagar. Em produção desde 08/09/2026 (Compras › Notas Fiscais de Entrada). ✅ Atualização 13/10: desde 09/10 (#629) a importação traz lote e validade, conferência antes de confirmar, parcelas das duplicatas, conta a pagar com o total da nota e Estornar recebimento. Ver Compras e Notas Fiscais.
- Assinatura digital Lacuna / ICP-Brasil (#394) — assinatura de documentos médicos com validade jurídica. 1ª fase em produção (desde 03/09); a finalização segue aberta (agora na Sprint 14, sem data prometida). Desde 02/10, documento assinado fica só leitura. Ver Assinatura Digital.
- Novo — out/2026 SNCR — Anvisa (numeração das receitas controladas) — desde 22/10/2026 o Rabi pede à Anvisa, em nome do médico (entrando com o gov.br), os números das receitas de Controle Especial e de Retenção, e traz os números de Notificação liberados pela Vigilância Sanitária. A ligação com a Anvisa está ativa desde 23/10/2026 (se aparecer algum erro, use a receita em papel e avise o suporte). O SNCR só aceita prescritor de CRM, CRMV ou CRO; o Rabi usa a especialidade com a inscrição mais antiga (Antes de começar). Ver Receitas e SNCR.
- MailGrid (#518) — provedor de envio de e-mails da Central de Notificações. Em produção. Ver Central de Notificações.
- Conciliação bancária por arquivo OFX ✅ Novo — 12/10/2026 — Financeiro › Conciliação Bancária: importar o extrato OFX e conciliar com os lançamentos (#650). 🟠 Roadmap A integração automática com o banco por Open Finance (#651) e os Links de Pagamento/Pix com baixa automática (#409, Sprint 14) não estão em produção. Ver Financeiro. ✅ Atualização 15/10 os Links de Pagamento Pix entraram em produção em 13/10 e o Open Finance teve as telas publicadas, desligado (ver abaixo).
- ✅ Novo — 13/10/2026 Links de Pagamento Pix — API Pix padrão Banco Central (#409) — a clínica cadastra o provedor (a API Pix do próprio banco, com certificado e credenciais fornecidos pelo banco) em Configurações › Parâmetros › Pagamentos (links); só um provedor ativo por vez. O link gerado na parcela ou no sinal do agendamento é pago pelo paciente e o sistema dá a baixa sozinho (aviso do banco ou verificação a cada 5 minutos); o Pix do sinal confirma o agendamento. Opcional; gateways de cartão/boleto ainda não existem. Ver Financeiro › Links de Pagamento.
- 🟡 Chegando (módulo adicional) Open Finance — conciliação bancária automática (#651) — código e telas em produção desde 13/10 (Financeiro › Contas Conectadas), mas o módulo nasce desligado, é cobrado por conta conectada e depende de o time Rabi ativar o agregador bancário. Até lá, use o OFX. Ver Financeiro › Open Finance.
- ✅ Novo — 15/10/2026 TISS por webservice com as operadoras — fase 1 (elegibilidade) (#619) — configuração por operadora (aba "Integração TISS": credenciais do prestador, certificado/mTLS, assinatura de XML, endereço de cada webservice, Testar conexão), botão "Verificar elegibilidade" no agendamento e no acolhimento e tela "Log de integração TISS". Opcional: só aparece com a integração ativa na operadora/convênio. Novo — out/2026 Fases 2 a 4 (lote, demonstrativos, autorização online e recurso de glosa por webservice — menu Faturamento › Retorno da operadora): primeira versão no ar desde 23/10/2026, em validação, sem garantia de que todas as operadoras funcionem (#620/#622/#623). Ver Configurações › Integração TISS.
- Billing Asaas (#491) — motor de cobrança da área comercial (cadastro self-service e planos). Em produção (área comercial).
Permissões e Controle de Acesso
✅ Novo — set/2026: permissões granulares (#395)
Desde 15/09/2026, o controle é granular: permissão por funcionalidade e por ação (Visualizar, Criar, Alterar, Excluir — e as ações elevadas por colaborador em Agendamento/Acolhimento/Confirmação e Atendimentos: agir em registro de outro colaborador, Cancelar e Excluir em status final; desde out/2026 também ações próprias em Contas Caixas e o Cancelar das Notas Fiscais de Entrada), (Correção 30/09: Exportar, Imprimir e Autorizar não existem como ações de permissão. ✅ Atualização 13/10: desde 12/10 existe a ação Estornar, uma das 9 ações novas de Contas Caixas do Financeiro.) com perfis configuráveis pela clínica — ver Permissões Granulares. A tabela abaixo mostra os grupos base; desde ago/2026 há também o grupo COMPRAS (#393) e, desde set/2026, a Fila de Espera tem permissão própria, separada da agenda (#612). ✅ Novo — 01/10/2026 Salvar um perfil aplica a alteração a todos os usuários dele (#636).
🟠 Em preparação O "negar por padrão" (#667) não entrou (a issue foi fechada em 14/10 só com permissões em rotas que estavam abertas): hoje, quem não tem configuração num módulo continua vendo as telas dele. Quando vier, quem não tiver o módulo no perfil deixará de ver — confira os perfis desde já. ✅ Novo — 15/10/2026 Permissões novas da integração TISS: TISS_INTEGRACAO e TISS_ELEGIBILIDADE.
O sistema de permissões do Rabi controla o que cada usuário pode ver e fazer em cada módulo. As permissões são configuradas por grupo e ação:
| Grupo de Permissão | Módulo | Ações Disponíveis |
|---|---|---|
| AGENDAMENTO | Agenda, Acolhimento, Confirmação, Bloqueio, Orçamento, Autorização | VIEW, CREATE, UPDATE, DELETE |
| ATENDIMENTO | Fila de Atendimento, Prontuário | VIEW, CREATE, UPDATE |
| PACIENTES | Cadastro de Pacientes | VIEW, CREATE, UPDATE, DELETE |
| FINANCEIRO | Registros Financeiros, Contas/Caixa, Categorias, Centro de Custo | VIEW, CREATE, UPDATE, DELETE |
| FATURAMENTO | Pré-faturamento, Lotes, Glosas | VIEW, CREATE, UPDATE |
| CONFIGURACOES | Todos os cadastros de configuração | VIEW, CREATE, UPDATE, DELETE |
| ESTOQUE | Produtos, Fornecedores, Fabricantes, Depósitos | VIEW, CREATE, UPDATE, DELETE |
| RELATORIOS | Todos os relatórios, Logs de Auditoria | VIEW |
| DASHBOARD | Dashboard e todas as abas | VIEW |
⚠️ Dependências de permissão
Um usuário com permissão de AGENDAMENTO mas sem permissão de PACIENTES não conseguirá buscar ou cadastrar pacientes no formulário de agendamento. Configure sempre as permissões de forma complementar ao perfil do usuário.
Tabela Resumo de Integrações
| Módulo Origem | Módulo Destino | Quando ocorre | O que é enviado |
|---|---|---|---|
| Configurações | Todos | Sempre (base de dados) | Colaboradores, convênios, serviços, locais, tabelas de preços |
| Pacientes | Agendamento | Ao criar agendamento | ID, nome, convênio, carteirinha, celular |
| Pacientes | Prontuário | Ao abrir atendimento | Histórico clínico, dados demográficos |
| Pacientes | Financeiro | Ao gerar lançamento | ID do paciente para vincular cobrança |
| Agendamento | Prontuário | Check-in / início do atendimento | Dados do agendamento, especialidade, data/hora |
| Agendamento | Financeiro | Finalização do atendimento (particular) | Valor do serviço, paciente, profissional |
| Agendamento | Faturamento | Finalização do atendimento (convênio) | Guia com procedimentos e autorização |
| Orçamento | Financeiro / Acolhimento | Orçamento particular com várias sessões (criado desde 25/09/2026) ✅ Novo — 26/09/2026 | Uma movimentação financeira com o valor total do orçamento, compartilhada por todas as sessões; pago no orçamento ou no acolhimento (aparece pago nos dois); acolher exige o orçamento pago; NFS-e por parcela paga quando 100% particular — ver Orçamento |
| Autorização | Central de Notificações | Pré-solicitação com 90% ou mais do prazo do convênio (ou vencida) ✅ Novo — 26/09/2026 | Notificação PRE_SOLICITACAO_VENCENDO ao responsável (regra desde 25/09; tela ✅ em produção desde 28/09/2026) — ver Autorização |
| Convênio (Custos extras, Serviços extras) + Colaborador (repasse) | Farol (orçamento, agendamento, autorização, convênio) | Sempre que o Farol é calculado ✅ Novo — 12/10/2026 | Custo = produtos + custo extra do convênio + prestadores + repasse; o bloqueio por esses custos nasce desligado (Parâmetros › Orçamento) — ver Custos extras |
| Financeiro (Caixa) | Agenda › Receber / Registros Financeiros | Ao receber, se o controle de caixa estiver ligado ✅ Novo — 12/10/2026 | Pede caixa aberto (modo Aviso ou Bloqueio); controle nasce Desligado; Novo — out/2026 desde 22/10 os turnos ficam em Financeiro › Contas Caixa › Turnos por atendente (o item "Caixa" saiu do menu) — ver Financeiro |
| Prontuário | Agendamento | Finalização do atendimento | Status "Atendido" |
| Prontuário | Financeiro | Registro de procedimentos | Procedimentos → lançamentos de cobrança |
| Prontuário | Faturamento | Procedimentos com convênio | Guias de faturamento por procedimento |
| Faturamento | Financeiro | Aprovação do lote pelo convênio | Gera contas a receber do lote |
| Financeiro | Relatórios | Contínuo | Fluxo de caixa, repasses, saldos, DRE Gerencial (desde 28/09/2026) |
| Agendamento | Relatórios | Contínuo | Produtividade, ocupação, agenda |
| Estoque | Relatórios | Contínuo | Mapa de estoque, itens críticos |