🚀 Guia de Implantação

🤖 Novo: esta mesma sequência de 16 etapas pode ser executada por uma IA, com a sua aprovação em cada gravação. Veja Implantação com IA — passo a passo do implantador. ✅ Novo — 30/09/2026 Acesso recomendado para o kit: o token rbt_ da própria clínica (tipo "Implantação e manutenção", só com as permissões da implantação, gerado em Configurações › Parâmetros › Integrações); a chave rbk_ do time Rabi segue como alternativa.

🧩 Pré-requisitos de cadastro: antes de cada cadastro, veja o que precisa existir antes e o caminho completo no menu (ex.: Local exige Depósito ativo; Produto exige Tipo de Produto e Fabricante (e o depósito); serviço de medicamento exige o Produto).

Roteiro completo para colocar o sistema Rabi em produção: configuração inicial, cadastros, testes e go-live para uma nova clínica.

✅ Corrigido em 24/09/2026 — ordem de implantação: 3 dependências estavam invertidas

Na implantação assistida por IA e pela API externa verificamos que o roteiro antigo deste guia tinha três dependências na ordem errada. O roteiro abaixo já está corrigido:

O manual dizia	Dependência real (verificada na tela e na API)	Ordem correta
Local na etapa 1; depósito só no estoque (etapa 8)	O local exige um depósito padrão de saída ativo — a tela pede e, pela API, `POST /locais` recusa com erro 422 se o depósito estiver inativo ou não existir (`depositoPadraoSaidaId` é obrigatório)	Criar um depósito mínimo por unidade logo depois da empresa, antes dos locais. O restante do estoque continua depois.
Serviços antes do catálogo de produtos	O serviço de medicamento exige o produto já cadastrado (a composição do serviço aponta para o produto)	Catálogo de produtos antes dos serviços. Entradas de estoque e custo podem ficar para depois.
Taxa na etapa 7	As tabelas de preço do convênio (abas Taxas/Serviços) e a tabela de preços interna exigem as taxas	Taxas antes dos convênios e das tabelas de preço internas.

Ordem oficial: Empresa → Depósito mínimo → Locais e tipos → Operadoras/Fornecedores/Fabricantes → Taxas → Produtos (catálogo) → Equipamentos → Serviços (subserviços antes dos pais) → Colaboradores → Convênios (dados, depois abas) → Conferência pelo Farol → Financeiro/Estoque → Pacientes → Parâmetros e Permissões.

✅ Novo — 15/10/2026 Pontos opcionais novos, encaixados na ordem: aba Integração TISS da operadora (junto das Operadoras — etapa 4 — ou depois dos Convênios, se o convênio tiver configuração própria); Referências oficiais no produto (etapa 6) e no convênio (etapa 10), em 1ª fase e sem carga de preços pela tela — confirme com o time Rabi; Parâmetros › Pagamentos (links) depois de Contas e Caixas e Tipos de Pagamento (etapa 12); permissões TISS_INTEGRACAO e TISS_ELEGIBILIDADE nos perfis (etapa 14).

🔌 Implantação pela API externa — mesma ordem. Quem vai implantar ou migrar a clínica por sistema externo ou por IA segue exatamente esta sequência: veja a API externa do Rabi e o roteiro Implantação via API. Pela API, os cadastros de tipos (grupo Auxiliares) são só leitura — crie-os pela tela e informe os ids. ✅ Novo — 29/09/2026 A clínica pode gerar o próprio token rbt_ do tipo "Implantação e manutenção" em Configurações › Parâmetros › Integrações (#624, em produção desde 28/09; a chave rbk_ do time Rabi continua valendo) — o token aparece uma única vez: guarde em local seguro e nunca cole em documento, chamado, e-mail, manual ou conversa com IA salva. ⚠️ Conferência retroativa: quem gravou pela API antes de 28/09 às 17:43 deve conferir uma vez pacientes em lote, lote de preços, PUT de movimentação/fornecedor, UF de operadora/empresa/colaborador e saídas/transferências de estoque sem lote (correção geral da API — ver novidades da API).

⚡ Implantação em 30 Minutos — Clínica Simples

Para clínicas com 1 médico e até 2 funcionários, siga estes passos mínimos para começar a usar o Rabi hoje (já na ordem corrigida em 24/09/2026):

Passo 0 — Cadastre/contrate pelo site ✅ Novo — ago/2026
Ainda não tem ambiente? O cadastro é self-service em www.rabisistemas.com.br (#488/#489/#491 — fluxo oficial): escolha o plano, faça o pagamento online e o ambiente da clínica é criado na hora.
Cadastre a empresa
Vá em Configurações → Empresas e Unidades e insira CNPJ, nome e endereço.
Crie o depósito mínimo da unidade ✅ Corrigido — 24/09/2026
Em Estoque → Depósitos (/portal/estoque/depositos), crie um depósito (ex.: "Depósito Principal"). Mesmo sem usar estoque, o local precisa de um depósito padrão de saída ativo.
Crie 1 local de atendimento
Em Configurações → Empresas e Unidades → Locais (/portal/configuracoes/empresas-unidades/locais), adicione "Consultório 01" e escolha o depósito criado no passo anterior como depósito padrão de saída.
Cadastre a operadora "Particular"
Em Configurações → Operadoras, crie a operadora "Particular" — ela é a base do convênio "Particular" (passo 7).
Cadastre 1 serviço
Em Configurações → Serviços, adicione "Consulta" com o seu valor de cadastro — no particular, o preço cobrado sai da conversão do convênio "Particular" (a tabela de preço interna é só para produtos). (Se o serviço usar taxa ou medicamento, cadastre a taxa e o produto antes do serviço.)
Cadastre o médico como colaborador
Em Configurações → Colaboradores, adicione nome, especialidade e CRM/CBOS.
Crie ao menos 1 convênio "Particular"
Em Configurações → Convênios, crie um convênio chamado "Particular" (da operadora "Particular" criada no passo 4) com pagamento no ato = Sim. (Convênio recém-criado abre liberado; se voltar a ele depois, clique em Liberar para edição — ele abre em modo consulta.)
Defina a grade de horário do médico
No cadastro do colaborador, informe dias, horários e local de atendimento e os convênios aceitos — sem grade a agenda não abre horários (por isso vem depois do convênio).
Crie o primeiro paciente e agende
Acesse Pacientes → Novo, preencha os obrigatórios (nome, CPF — ou Estrangeiro —, data de nascimento e celular). Depois vá em Agenda → Novo Agendamento.

Pronto para o primeiro atendimento! As demais configurações (faturamento, relatórios, múltiplos convênios) podem ser feitas gradualmente conforme necessidade.

Introdução

Este guia descreve as etapas necessárias para implantar o sistema Rabi em uma nova clínica. O processo é sequencial — cada etapa deve ser concluída antes de iniciar a próxima, pois os módulos têm dependências entre si (veja o Mapa de Integrações e os Pré-requisitos de cadastro).

⚠️ Respeite a ordem das etapas

Não é possível cadastrar colaboradores sem ter cadastrado a empresa primeiro. Não é possível salvar um local sem um depósito ativo na unidade. Não é possível montar um serviço de medicamento sem o produto no catálogo, nem um serviço pai sem os seus subserviços. Não é possível preencher as tabelas de preço do convênio sem as taxas e sem a operadora. Não é possível agendar sem ter cadastrado profissionais e serviços. A ordem deste guia é obrigatória.

💡 Suporte durante a implantação

A equipe da Rabi Sistemas acompanha o processo. Em caso de dúvidas, acesse o portal do sistema em app.rabisistemas.com.br.

Checklist de Implantação — Visão Rápida

Use este checklist para controlar o progresso da implantação. São 16 etapas na ordem oficial (corrigida em 24/09/2026). Cada item é detalhado nas seções seguintes.

Empresa e Unidades

Dia 1

Cadastrar Empresa/Clínica

Razão social, CNPJ, endereço, logo — em Configurações → Empresas e Unidades

Cadastrar Unidades

Se a clínica tiver mais de um local de atendimento

Depósito mínimo (1 por unidade)

Dia 1

📦 O que é o depósito mínimo ✅ Corrigido — 24/09/2026

É um depósito por unidade, criado só para que cada local tenha o seu depósito padrão de saída (de onde sai o material consumido nos atendimentos daquele local). Vale mesmo para quem não vai usar estoque agora. O restante do estoque — outros depósitos, entradas, custos — continua na etapa 12 (Financeiro, Fiscal e Estoque).

Na tela: Estoque → Depósitos (/portal/estoque/depositos) → novo depósito, vinculado à unidade (ex.: "Depósito Principal"). Pela API: POST /depositos (unidade + descrição do depósito). Mantenha-o ativo: o local recusa depósito inativo.

Criar 1 depósito ativo em cada unidade

Estoque → Depósitos — antes de qualquer local

Locais e Tipos (tabelas básicas)

Dia 1

Cadastrar Locais/Salas

Consultórios, salas de exame — em Configurações → Empresas e Unidades → Locais (/portal/configuracoes/empresas-unidades/locais). Cada local exige o depósito padrão de saída da etapa 2 (ativo).

Cadastrar Tipos de Serviço

Consulta, Exame, Cirurgia, etc. — em Configurações → Serviços → Tipos

Cadastrar Tipos de Taxa e Tipos de Produto

Configurações → Taxas → Tipos · Estoque → Produtos → Tipos de Produto

Cadastrar Tipos de Atendimento

Primeira consulta, retorno, urgência, telemedicina — em Configurações → Tipo de Atendimento (usados também na aba Serviços do convênio)

Cadastrar Tipos de Código, de Anexo e de Identificação

Codificações do faturamento (TUSS, CBHPM…), categorias de anexos e documentos de identificação do paciente

Operadoras e Fornecedores

Dia 1–2

💡 Operadoras antes de Convênios

Cada convênio deve ser vinculado a uma operadora. Cadastre as operadoras agora; os convênios vêm na etapa 10, depois de taxas, produtos e serviços.

Cadastrar Operadoras

Empresas de plano de saúde: Unimed, Bradesco Saúde, Amil, etc. (e "Particular") — em Configurações → Operadoras

Cadastrar Fornecedores

Empresas fornecedoras de insumos e medicamentos — em Estoque → Fornecedores

Cadastrar Fabricantes e Princípios Ativos

Estoque → Fabricantes · Estoque → Princípios Ativos (para medicamentos). O Fabricante é obrigatório no produto (etapa 6) — cadastre ao menos um.

Integração TISS da operadora (opcional) ✅ Novo — 15/10/2026

Só se a operadora oferecer webservice e fornecer endereço e credenciais. Configurações → Operadoras → (editar) → aba Integração TISS: Integração ativa, credenciais do prestador (código do prestador vazio = o da operadora), certificado/assinatura se a operadora exigir, endereço do webservice de Verificar elegibilidade → Testar conexão → Salvar integração. Hoje só a elegibilidade é usada (lote, autorização e recurso por webservice são roadmap). Um convênio pode ter configuração própria, que substitui a da operadora — por isso, se precisar, volte aqui depois da etapa 10. Pode ficar para depois do go-live. Ver Configurações.

Taxas

Dia 2

Configurar Taxas ✅ Corrigido — 24/09/2026

Taxa de sala, de material, de guia etc. — em Configurações → Taxas. Antes ficavam na etapa 7; as tabelas de preço do convênio (abas Taxas/Serviços) e a tabela de preços interna exigem as taxas, por isso vêm agora.

Produto ou taxa em uso não pode ser excluído ✅ Novo — 02/10/2026

Desde 02/10/2026 (#626), excluir ou inativar um produto ou uma taxa que está na composição de serviço ativo é recusado: aparece "Não é possível excluir" com a lista dos serviços (com link). Para trocar o item, substitua-o nesses serviços primeiro. Até 02/10 a exclusão era livre e o item sumia da composição sem aviso.

Produtos (catálogo)

Dia 2

Cadastrar o catálogo de Produtos ✅ Corrigido — 30/09/2026

Medicamentos, materiais e insumos usados nos serviços — em Estoque → Produtos → Novo. Obrigatórios da tela: Nome, Tipo de Código, Tipo Produto, Código Produto, Localização padrão (do depósito), Fabricante, Apresentação, Contendo, Unidade De Medida e CD; opcionais: EAN, NCM, Princípio Ativo, Fornecedores, preço da última pesquisa, Tabela 87 e "Estoque pode negativar". O cadastro não tem campos de custo, margem nem "Est. Base" — o Estoque mínimo fica na aba Estoque do produto (opcional; ver etapa 12). O serviço de medicamento exige o produto já cadastrado (a composição aponta para ele). Entradas de estoque, saldo inicial e custos podem ficar para a etapa 12.

Códigos do produto no tamanho certo ✅ Novo — 02/10/2026

Código do produto até 10 caracteres (letras, números, ponto, hífen ou barra — padrão TISS); EAN com 8, 12, 13 ou 14 dígitos (o zero à esquerda é mantido); NCM com exatamente 8 dígitos (#635). Princípio Ativo, Tabela 87, Fabricante e Data da última pesquisa agora podem ser limpos. Produto em uso num serviço ativo não pode ser excluído (#626).

Classificar os medicamentos controlados Novo — out/2026

Em Estoque → Produtos → aba Dados do Produto, bloco "Controle e receita (opcional)": Lista da Portaria 344/98 (Não controlado, A1 … C5) e Sujeito a retenção de receita (Sim para antimicrobianos e GLP-1). Atalho: classifique o Princípio Ativo — o que ficar em branco no produto é herdado dele. É isso que faz a receita sugerir o tipo certo (Receitas › passo 5).

Referências oficiais do produto (opcional, 1ª fase) ✅ Novo — 15/10/2026

Se os contratos usam SIMPRO/Brasíndice/CMED: Estoque → Produtos → aba Referências oficiais (código na publicação, descrição oficial, unidade, fator de conversão) e, depois, no convênio (etapa 10) o bloco "Referências oficiais por tipo de produto". Cuidado: a importação de preços pela tela foi retirada em 15/10 — a carga de preços ainda não está disponível pela tela; confirme com o time Rabi antes de contar com o nível 2. Ver Guia do Implantador.

Equipamentos

Dia 2

Cadastrar Equipamentos

Aparelhos médicos que serão vinculados aos agendamentos — em Configurações → Equipamentos

Serviços e Procedimentos

Dia 2–3

Cadastrar os subserviços primeiro

Um serviço composto (pai) aponta para os seus subserviços — cadastre os subserviços antes dos pais

Cadastrar Serviços/Procedimentos

Todos os procedimentos realizados pela clínica, com nome, tipo e código (TUSS) — e a composição (produtos, taxas, subserviços), que já existem das etapas 5 e 6 — em Configurações → Serviços

Pagamento parcial antecipado (opcional) ✅ em produção desde 28/09/2026

Parâmetro do serviço (#604): "exige pagamento parcial" + percentual mínimo (sobre a sessão agendada) + prazo da reserva — o agendamento nasce "Pendente de Pagamento", segura o horário e expira sozinho sem pagamento. Configure serviço a serviço, só onde a clínica quer reduzir faltas, e combine com a recepção: nesta versão a confirmação do pagamento é manual — desde 12/10/2026 ela pede Conta caixa e Forma de pagamento e gera uma movimentação de recebimento própria (sem NFS-e). Os Links de Pagamento (#409) seguem no roadmap (Sprint 14). ✅ Atualização 15/10 links de pagamento Pix em produção desde 13/10 — com provedor Pix ativo (etapa 12), o sinal pode ser pago por link e se confirma sozinho (ver).

Configurar a Tabela de Preço Interna ✅ Corrigido — 24/09/2026

Fonte do preço de produto: cada tabela tem até 3 preços por produto (Nome Preço 1/2/3); se a tabela não tiver o produto, vale o Preço de venda tabela — em Configurações → Tabela de Preços Internos. Fica antes dos convênios (exige taxas e produtos). Não define o valor da consulta particular: esse sai da conversão do convênio "Particular" (etapa 10). Detalhes no Guia do Implantador de preços.

Colaboradores

Dia 3–4

Cadastrar Colaboradores

Nome, foto, e-mail, especialidades (com CBOS), empresa — em Configurações → Colaboradores

Vincular especialidades a cada colaborador

Um colaborador pode ter múltiplas especialidades; cada especialidade tem seu CBOS

Médicos: CPF, conselho e certificado (para as receitas) Novo — out/2026

Cada médico precisa ter no cadastro de colaborador o CPF e uma especialidade ativa com conselho, número e UF iguais aos do conselho (é o que a Anvisa confere). O SNCR só aceita CRM, CRMV ou CRO: o Rabi usa a especialidade mais antiga com um desses conselhos (médico com mais de um CRM fica com a inscrição mais antiga — a tela não tem escolha). O próprio médico cadastra o certificado digital em Minha Conta › Certificado Digital. Faça com cada médico o checklist "Antes de começar" — a ligação com a Anvisa está ativa desde 23/10/2026; peça a numeração antes de 31/10/2026, quando as receitas controladas eletrônicas passam a exigir o número.

Cadastrar o repasse de cada profissional (com o repasse geral) ✅ Novo — 02/10/2026

Configurações → Colaboradores → (colaborador) → aba Vínculo e Repasse. Nas tabelas Serviços, Produtos e Taxas, a primeira linha fixa é o repasse geral ("Todos os serviços" / "Todos os produtos" / "Todas as taxas"): percentual e/ou valor, com a chave Maior / Menor — vale para todo item sem linha própria. As linhas abaixo são exceções por item (substituem o geral só para aquele item; 0 e 0% = sem repasse naquele item). Sem geral nem específica, o tipo não gera repasse. Repasse de taxa agora é calculado (#643). Desde 12/10/2026 o repasse também entra no custo do Farol (#655) — cadastre-o antes da conferência da etapa 11.

Convênios (dados, depois abas)

Dia 4–5

Cadastrar Convênios — dados

Um convênio por operadora, com seus respectivos planos — em Configurações → Convênios

Configurar prazos do convênio

Prazo de pagamento, prazo de retorno, prazo de entrega de guias, limite de glosa — e o Prazo de autorização (dias de resposta da operadora), que alimenta o farol da pré-solicitação (#380; regra e tela ✅ em produção desde 28/09/2026)

Preencher as abas de preço (Serviços, Produtos, Taxas)

Importar via Excel ou cadastrar manualmente cada item e seu valor — só depois dos dados do convênio e com taxas, produtos e serviços já cadastrados. ✅ Novo — 30/09/2026 Convênio recém-criado abre liberado; ao voltar a um convênio já salvo, o 1º passo é clicar em Liberar para edição (modo consulta, #632). ✅ Novo — 01/10/2026 Depois de alterar, clique em Salvar no cabeçalho do convênio — as abas Planos, Especialidades, Produtos, Serviços e Taxas só gravam aí (a célula pendente fica destacada); importar Excel, copiar e "Selecionar todos" gravam na hora. ⚠️ Não use Copiar convênio para montar um convênio novo (correção não confirmada — #639) e não use "Selecionar todos" nas colunas Retorno/Autorização/Pacote (só mexe no Utiliza).

Cadastrar os custos extras do convênio ✅ Novo — 12/10/2026

Se a operadora cobra algo à parte (ex.: taxa administrativa de 5% sobre o que paga): aba Custos extras do convênio → Novo custo extra (percentual da receita ou valor fixo por execução, sobre o que incide, vigência). Prestadores terceiros de um serviço (cooperativa, transporte): expanda o serviço na aba Serviços → painel Serviços extras. Esses custos entram só no custo do Farol — não mudam guia, XML nem repasse pago. Detalhes em Preços › custos extras.

Conta de recebimento do convênio ✅ Novo — 12/10/2026

Na aba Dados do convênio, informe a Conta de recebimento (conta caixa onde entra o pagamento do convênio) — usada no Gerar Contas a Receber do lote. Sem ela no convênio e sem a "Conta Padrão de Recebimento de Convênios" nos Parâmetros › Financeiro, o sistema recusa (a criação automática de conta acabou).

Vincular colaboradores ao convênio (aba CBOS)

Definir quais colaboradores atendem cada convênio (credenciamento)

Marcar as especialidades que o convênio atende (aba Especialidades, coluna Atende) ✅ Novo — 29/09/2026

Marque Atende em cada especialidade coberta antes de configurar serviços e profissionais do convênio, e salve. Desde 02/10/2026 (#628) a marcação vale no cadastro do convênio: serviço de especialidade não atendida aparece como "Não atendida" e não aceita Utiliza. ⚠️ A trava no agendamento e no orçamento está desligada desde 06/10/2026 (temporário): hoje o agendamento não barra por especialidade, mesmo que a tela do convênio diga que "não poderão ser agendados" — oriente a recepção a conferir a cobertura. 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. Convênio sem nenhuma especialidade marcada não restringe nada.

Convênio em modo consulta — Liberar para edição → alterar → Salvar ✅ Novo — 30/09/2026

Desde 29/09/2026 (#632) todo convênio existente abre em modo consulta: dá para ver tudo, trocar de aba, filtrar, expandir os itens do serviço, ver o Farol e exportar, sem gravar nada ("Modo consulta. Para alterar, clique em Liberar para edição."). Para alterar: Liberar para edição → alterar → Salvar no cabeçalho (desde 01/10/2026; ao bloquear com pendências, o sistema pergunta se quer salvar ou descartar). A liberação vale só nesta visita. ✅ Novo — 02/10/2026 Botão Histórico no cabeçalho mostra quem alterou o quê em cada aba (#638); se outra pessoa gravou depois que você abriu a tela, aparece "Este registro foi alterado por outra pessoa. Recarregue a tela antes de alterar." (#640). Usuário sem permissão de alterar convênio só consulta. A API não passa pelo modo consulta.

Definir a grade horária (agenda) de colaboradores e equipamentos ✅ Corrigido — 24/09/2026

Dias, horários, unidade e local em que cada profissional/equipamento atende — sem grade a agenda não abre horários. Vem depois dos convênios porque a grade lista os convênios aceitos. ✅ Novo — 30/09/2026 Se a clínica usa a TalkMe (IA): cadastre na grade os serviços e os convênios (Incluir/Excluir), marque Atende convênio no profissional em cada convênio que ele atende e deixe o convênio ativo na unidade — a IA só oferece o que esses cadastros mostram (consulta única de disponibilidade #633, em produção desde 09/10/2026). ✅ Novo — 09/10/2026 O painel Disponibilidade por Convênio da Agenda usa as mesmas regras (catálogo #659) e lê os convênios de cada unidade do cadastro Unidades do convênio — confira-o.

💰 Como o Rabi chega ao preço? A ordem de configuração de preços e os 3 níveis de conversão por convênio estão no Guia do Implantador da área Preços e Conversão de Valores; a árvore de decisão resume as regras vigentes. ✅ Em produção desde 23–24/09/2026 Nas tabelas de preço, deixe vazio o que não tem regra (não use 0,01 como marcador — 0,00 é preço zero de verdade) e marque Utiliza em tudo que o convênio cobre. Taxas, produtos e subserviços com Utiliza sempre entram na conta do serviço.

Preço fechado? Marque Pacote ✅ regra vigente

Valor combinado não é pacote: o valor digitado na linha 🔁 do serviço muda só o preço do serviço e os itens continuam somando por cima. Se o convênio paga um preço fechado que já inclui itens: valor combinado na 🔁 + Pacote marcado na linha do serviço (aba Serviços do convênio — não existe pacote no cadastro do serviço) + "Zerar valor em pacotes" em cada item incluso. Sem Pacote, o "Zerar" nem é consultado. Sintoma: "digitei um valor e os itens continuaram somando" → marque Pacote. Receitas no Guia da clínica — Preços.

Ler a coluna Valor do serviço ✅ em produção desde 24/09

A coluna tem 4 linhas: 🔒 casa (em serviço que soma itens, "(soma dos itens)"), 🔁 combinado, ✅ valor do próprio serviço na guia e Σ total do serviço no convênio (= receita do Farol). Em serviço que soma itens sem valor combinado, a ✅ mostra "0,00 (sem preço próprio: itens cobrados à parte)" — não é erro; confira o total na Σ. A explicação do 0,00 aparece ao passar o mouse na linha ✅; um texto visível na própria linha chega no próximo ajuste. Produtos e taxas seguem com 3 linhas.

Referências oficiais por tipo de produto (opcional) ✅ Novo — 15/10/2026

Liberar para edição → Dados do convênio → bloco Referências oficiais por tipo de produto (abaixo da Política de preço): publicação do código e do preço, tipo de preço, ICMS, ajuste %, tabela TISS 20 (medicamentos) ou 19 (materiais) → Salvar referências; use a simulação. Ordem do preço: conversão do produto no convênio > referências oficiais > política de preço. Sem preço carregado, nada muda — confirme com o time Rabi (1ª fase).

Conferência pelo Farol

Dia 5

Conferir cada convênio na aba Farol › Itens ✅ Novo — set/2026

Cada linha mostra só a própria conta (valor considerado, custo, receita, margem e farol); a linha do serviço traz o total do serviço. Nenhum item deve ficar 🟣 roxo (produto com custo 0 ou sem preço). ✅ Novo — 12/10/2026 O custo do Farol inclui custos extras do convênio, prestadores e repasse do profissional — por isso cadastre-os antes de conferir. Deixe desmarcada a opção "Custos extras (convênio, prestadores e repasse) também bloqueiam" (Configurações › Parâmetros › Orçamento) até rodar "Ver serviços que mudam de cor" com a clínica.

Conferir cada serviço com o "expandir" ✅ Novo — 26/09/2026

Recomendado para todo serviço composto e todo serviço 🔴/🟡: na aba Serviços do convênio (ou em Configurações › Serviços › aba Convênios), clique na seta da linha para abrir a árvore do serviço naquele convênio, como sai na guia — farol, tipo/código/Tabela 87, Zerar, Somar itens, Conta no total, Utiliza, Motivo (item esmaecido quando fica fora da cobrança: "Convênio não utiliza", "Zerado em pacote", "Subserviço pai fora do total"), quantidade, custo e receita. Os números são os mesmos da aba Farol › Itens — e é o jeito mais rápido de responder "por que este serviço está vermelho?" (#625, concluído).

Pela API: GET /convenios/{id}/farol/itens

Devolve as linhas item por item — custo, receita, margem_servico_pct, farol_servico, conta_no_total, motivo_exclusao e Utiliza. ✅ Novo — 26/09/2026 Para conferir um serviço, use GET /convenios/{id}/farol/itens/{servicoRaizId} (a árvore desse serviço, com totais por subárvore) — ver Implantação via API

Financeiro, Fiscal e Estoque

Dia 5–6

Cadastrar Contas e Caixas

Caixa físico, conta bancária, conta digital — em Financeiro → Contas e Caixas

Cadastrar Tipos de Pagamento

Dinheiro, PIX, cartão débito, cartão crédito, transferência, cheque — em Financeiro → Tipos de Pagamento. ✅ Novo — 12/10/2026 Preencha a coluna Comprovação de cada tipo (Automática / Dinheiro / Pix / Cartão / Transferência / Não exige comprovação).

Cadastrar Categorias de Pagamento

Consultas, Procedimentos, Material de Escritório, Salários, etc. — em Financeiro → Categorias. ✅ Novo — 29/09/2026 Preencha também a coluna "Linha do DRE" de cada categoria: é ela que alimenta o DRE Gerencial (#617, em produção desde 28/09); sem classificação, vale uma regra padrão pelo tipo de movimentação.

Configurar Centro de Custo

Departamentos ou áreas para alocação de despesas e receitas. ✅ Novo — 29/09/2026 Defina o centro de custo padrão nos Parâmetros: desde 28/09 a conta a receber de convênio gerada pelo faturamento usa esse padrão.

Conferir as regras de repasse

Cadastradas na etapa 9 (repasse geral + exceções). Desde 06/10/2026 o repasse de serviço é calculado sobre o valor líquido (total − desconto); confira no relatório Repasse por Colaborador (colunas Tipo e Origem do repasse).

Decidir o controle de caixa e liberar as permissões do financeiro ✅ Novo — 12/10/2026

Em produção desde 12/10/2026 (#650), mas nasce desligado: em Configurações → Parâmetros → Financeiro, bloco "Caixa por atendente", escolha o Controle de caixa — Desligado, Aviso (recebe sem caixa aberto) ou Bloqueio (exige caixa aberto) (a dica do sistema: "Comece em Aviso") — e defina a tolerância de diferença no fechamento, a hora de fim de expediente e a Conta Padrão de Recebimento de Convênios. Telas: Financeiro → Contas Caixa, aba Turnos por atendente (desde 22/10 o menu "Caixa" saiu) (abrir/fechar com contagem cega, sangria, suprimento, conferência do líder) e Conciliação Bancária (extrato OFX). Ninguém recebe as 9 permissões novas sozinho: libere, em CONTAS CAIXAS, só para quem precisa — CONFERIR_CAIXA, REABRIR_CAIXA, RECEBER_OUTRA_CONTA, ALTERAR_RECEBEDOR, BAIXA_RETROATIVA, CONCILIAR, DESCONCILIAR, EXCLUIR_COMPROVANTE e ESTORNAR ("líder" = administrador ou quem tem EDIT_ALHEIO em CONTAS CAIXAS). Open Finance (#651) segue no roadmap. ✅ Atualização 15/10 a tela Contas Conectadas já aparece, mas o módulo nasce desligado e é adicional — 🟡 Chegando (módulo adicional); implante a conciliação por OFX.

Links de pagamento Pix (opcional) ✅ Novo — 13/10/2026

Depende de Contas e Caixas e Tipos de Pagamento (acima). A clínica contrata a API Pix com o banco (certificado e credenciais). Configurações → Parâmetros → aba Pagamentos (links) → Novo provedor "Pix — API padrão Banco Central (qualquer banco)": banco, URLs da API e do token, escopos, Chave Pix da clínica, Validade do link (minutos) (padrão 1440), Client ID/secret, certificado, Conta caixa onde o dinheiro cai e Forma de pagamento da baixa → Testar conexão → Cadastrar aviso (aviso automático de pagamento) → ativar. Só um provedor ativo por vez. Faça um Pix de teste de valor baixo e confira a baixa em Financeiro → Links de Pagamento. Ver Parâmetros › Pagamentos.

Ativar o módulo de NFS-e (opt-in) ✅ Novo — set/2026

Se a clínica for emitir nota pelo Rabi (módulo fiscal completo em produção): ativar o módulo fiscal (#471, com taxa do módulo)

Configuração fiscal da clínica

Inscrição, regime, código de serviço/alíquota e provedor — configuração fiscal por clínica (#464)

Modelos de nota e onboarding fiscal

Modelos de nota configuráveis (#465 — padrão + por serviço) e checklist de onboarding fiscal (#472) — em produção desde 22/09/2026 ✅ Novo — 26/09/2026. Siga o checklist do onboarding antes da 1ª emissão.

Estoque completo (se aplicável)

Depósitos adicionais (farmácia, almoxarifado…), entradas de estoque/saldo inicial, custos e Estoque mínimo (aba Estoque de cada produto — cada campo grava ao sair dele; nenhum é obrigatório) dos produtos já cadastrados na etapa 6 — em Estoque. Opcional para clínicas de consulta simples; o depósito mínimo da etapa 2 continua obrigatório.

Notas Fiscais de Entrada (se a clínica compra com NF-e) ✅ Novo — 29/09/2026

Em Compras › Notas Fiscais de Entrada a clínica importa o XML da nota do fornecedor. ✅ Novo — 09/10/2026 (#629) Antes de Confirmar recebimento, a conferência mostra lote, validade e quantidade por lote, fator de conversão, depósito por item, motivo da entrada, categoria e forma de pagamento e as parcelas da nota (o botão só libera quando os totais fecham); a conta a pagar sai com o valor total da nota e as parcelas; e dá para Estornar recebimento (exige a ação CANCELAR em NOTAS FISCAIS DE ENTRADA). As limitações da 1ª versão (lote vazio, validade padrão, conta sem parcelas) deixaram de valer em 09/10/2026.

Pacientes

Dia 6

Migrar/importar base de pacientes existentes (se houver)

Pela tela, por planilha ou pela API externa (inclusive migração de histórico de atendimentos) — com convênios e planos já cadastrados para as carteirinhas

Parâmetros, Documentos, Usuários e Permissões

Dia 6–7

Configurar Parâmetros do Sistema

Configurações gerais: horário de funcionamento, duração padrão, obrigatoriedades, notificações — em Configurações → Parâmetros. ✅ em produção desde 28/09/2026 Em Parâmetros › Integrações a clínica gera, renova e revoga os próprios tokens rbt_… (#624 — tipos "Implantação e manutenção", com as permissões escolhidas, e "TalkMe (IA)") e habilita a TalkMe (#597). A chave rbk_ emitida pelo time Rabi continua valendo. ⚠️ O token aparece uma única vez: guarde em local seguro; nunca cole em documento, chamado, e-mail, manual ou conversa com IA salva; token de uma clínica não acessa outra; suspeita de vazamento → revogue e gere outro. ✅ Novo — 02/10/2026 As permissões do token de implantação podem ser alteradas depois em Editar permissões (sem trocar o token) e Renovar revisa permissões e validade (30, 90, 365 dias ou sem validade). ✅ Novo — 30/09/2026 Para o kit de Implantação com IA, gere um token do tipo "Implantação e manutenção" só com as permissões da implantação — é o caminho recomendado.

Configurar Tipos de Documento de Atendimento

Modelos de atestados, receitas, laudos, encaminhamentos — em Configurações → Tipos de Documento

Configurar Tipos de Impressão

Cabeçalhos e rodapés de documentos impressos

⚠️ Permissões granulares por perfil de função ✅ Novo — set/2026

Crie os usuários com as permissões mínimas necessárias para sua função, usando as permissões granulares (#395): controle por funcionalidade e por ação (Visualizar, Criar, Alterar, Excluir — e, só em Agendamento/Acolhimento/Confirmação e Atendimentos, as ações elevadas por colaborador: agir em registro de outro colaborador, Cancelar e Excluir em status final), (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 múltiplos perfis/grupos por usuário. Nunca dê acesso de CONFIGURACOES para recepcionistas ou financeiro para médicos, salvo exceções justificadas. (As indicações VIEW/CREATE/UPDATE abaixo são o ponto de partida — refine por ação no modelo granular.) ✅ Novo — 01/10/2026 Salvar o perfil aplica a alteração a todos os colaboradores ativos daquele perfil ("Alteração aplicada a N usuário(s)"); salvar as permissões de um colaborador muda só ele (#636). As 9 permissões novas do financeiro (CONTAS CAIXAS) não vêm marcadas para ninguém — ver etapa 12.

Criar usuário Administrador

Acesso completo a todos os módulos — restrito ao gestor da clínica

Criar usuários Recepcionistas

Permissões: AGENDAMENTO (VIEW/CREATE/UPDATE) + PACIENTES (VIEW/CREATE/UPDATE)

Criar usuários Médicos/Profissionais

Permissões: ATENDIMENTO (CREATE) + AGENDAMENTO (VIEW) + PACIENTES (VIEW)

Criar usuários Financeiro/Faturamento

Permissões: FINANCEIRO + FATURAMENTO (todos os níveis) + RELATORIOS (VIEW)

Permissões novas de TISS e cobrança ✅ Novo — 15/10/2026

Se a clínica usa a integração TISS: TISS_ELEGIBILIDADE (VIEW = ver; CREATE = verificar) para recepção/autorização e TISS_INTEGRACAO (VIEW = ver configuração e log; UPDATE = salvar e testar) para quem configura. Links Pix: ver e gerar seguem REGISTROS FINANCEIROS, CONTAS CAIXAS ou AGENDAMENTO/ACOLHIMENTO/CONFIRMAÇÃO (VIEW para ver, UPDATE para gerar); alterar o provedor exige PARAMETROS UPDATE. Atenção: o "negar por padrão" (#667) não entrou — quem não tem configuração num módulo continua vendo; confira mesmo assim se cada perfil tem os módulos que usa.

Validar acesso de cada usuário

Logar com cada usuário e verificar se vê apenas o que deve ver

Testes de Validação

Dia 7

Execute cada cenário abaixo com dados simulados antes do go-live. Todos devem ser aprovados:

Cenário 1 — Agendamento Particular

Cadastrar paciente → Agendar → Confirmar → Check-in → Atender → Verificar lançamento financeiro

Cenário 2 — Agendamento por Convênio

Paciente com carteirinha → Agendar com convênio → Check-in → Atender → Verificar guia de faturamento

Cenário 3 — Faturamento

Ir para Pré-faturamento → Fechar Lote → Gerar Contas a Receber → Verificar lançamento no Financeiro

Cenário 4 — Bloqueio de Agenda

Criar bloqueio → Verificar que o horário não aparece disponível para agendamento

Cenário 5 — Relatórios

Gerar relatório de agenda e fluxo de caixa com os dados dos testes; verificar consistência

Cenário 6 — Permissões

Logar com cada perfil de usuário e verificar acessos permitidos e bloqueados

Cenário 7 — Emissão de NFS-e ✅ Novo — set/2026

Com o módulo fiscal ativo: registrar recebimento particular → emitir a NFS-e no ato do pagamento → verificar retorno/autorização da nota. ⚠️ Em produção, a NFS-e de teste é uma nota REAL (vai para a prefeitura): emita só com dados conferidos e cancele a nota em seguida — ou combine o teste com o time Rabi.

Cenário 8 — Fila de Espera ✅ Novo — set/2026

Colocar paciente na fila com horário cheio → cancelar um agendamento → verificar a sugestão do próximo da fila e o botão "Agendar" (#405)

Cenário 9 — Aprovação por alçada

Aplicar desconto acima do limite (ou farol consolidado vermelho) → verificar a pendência na Central de Notificações (#559) → aprovar com usuário de alçada e conferir o desbloqueio

Cenário 10 — Orçamento com serviço composto ✅ Novo — set/2026

Orçar um serviço com medicamento e taxa → conferir que produtos e taxas com Utiliza entram na conta e que o farol consolidado bate com a conferência da etapa 11

Cenário 11 — Caixa (se o controle de caixa foi ligado) ✅ Novo — 12/10/2026

Abrir o caixa → receber um particular → anexar o comprovante → fechar com contagem cega → conferir com o líder (Financeiro → Contas Caixa → Turnos por atendente)

Cenário 12 — Receita no atendimento Novo — out/2026

Com um médico já preparado (checklist): abrir um atendimento de teste → seção Receitas → Nova receita com um medicamento classificado → conferir o tipo sugerido → Prévia → salvar como rascunho. Não emita receita real para paciente de teste.

Validação dos dados de teste

Após os testes, limpar dados simulados antes do go-live (cancelar a NFS-e de teste, se emitida, e estornar os lançamentos financeiros de teste)

Go-Live e Treinamento

Dia 8+

Com todos os cenários de teste aprovados, a clínica está pronta para entrar em operação.

Treinamento por Perfil

Realize o treinamento separado por perfil de usuário, focando apenas nos módulos que cada grupo utiliza:

🗓️ Recepcionistas

Login e navegação básica
Cadastro de pacientes (campos obrigatórios e convenio)
Criação e edição de agendamentos
Confirmação de consultas em massa
Acolhimento e check-in de pacientes
Busca de pacientes e histórico

🩺 Médicos e Profissionais de Saúde

Login e acesso à fila de atendimento
Abertura e registro no prontuário eletrônico
Registro de procedimentos realizados
Emissão de documentos (atestados, receitas, laudos)
Finalização do atendimento
Visualização do histórico do paciente

💰 Equipe Financeira e Faturamento

Registros financeiros (contas a pagar e receber)
Gestão de caixas e contas — Contas Caixa com turnos por atendente, Recebimentos de convênio, comprovantes, estorno e Conciliação Bancária (OFX), se a clínica ligar o controle
Processo de pré-faturamento
Fechamento de lotes de convênio
Gestão de glosas
Relatórios financeiros e fluxo de caixa

📊 Gestores e Administradores

Dashboard completo e interpretação de métricas
Relatórios gerenciais (produtividade, ocupação, repasses)
Manutenção de configurações do sistema
Gestão de usuários e permissões
Logs de auditoria

Ações do Go-Live

Definir data oficial de entrada em produção

Conferir a base de pacientes importada na etapa 13 (se houver)

Amostragem de cadastros, carteirinhas e convênios vinculados

Realizar treinamento com toda a equipe

Ativar acesso de todos os usuários

Agendar acompanhamento pós-implantação (1ª semana)

Suporte intensivo nas primeiras semanas de operação

Divulgar URL do manual para toda a equipe

O manual interativo fica disponível em: https://www.rabisistemas.com.br/manual (o sistema fica em app.rabisistemas.com.br)

Diagrama de Dependências

A tabela abaixo mostra quais cadastros precisam existir antes de criar outros (as 3 linhas marcadas ✅ foram corrigidas em 24/09/2026). Mapa completo, com o caminho no menu, em Pré-requisitos de cadastro.

Para cadastrar	Precisa ter cadastrado antes	Onde configurar
Unidades	Empresa	Configurações → Empresas e Unidades
Depósito mínimo	Empresa/Unidade	Estoque → Depósitos (`/portal/estoque/depositos`) · API `POST /depositos`
✅ Locais/Salas	Unidade + depósito padrão de saída ativo	Configurações → Empresas e Unidades → Locais
Taxas	Tipo de Taxa	Configurações → Taxas
Produtos (catálogo)	Tipo de Produto + Fabricante + Depósito (para a Localização padrão) — obrigatórios; Fornecedor/Princípio Ativo, se usados	Estoque → Produtos
✅ Serviço de medicamento / com composição	Tipo de Serviço + Produto (e Taxa) da composição; serviço pai: subserviços antes	Configurações → Serviços
Tabela de Preços Internos (preço de produto)	Taxas + Produtos + Serviços — e vem antes dos Convênios	Configurações → Tabela de Preços Internos
Colaboradores	Empresa	Configurações → Colaboradores
Convênios	Operadoras	Configurações → Convênios
✅ Tabela de Preços por Convênio (abas)	Convênio + Serviços + Produtos + Taxas	Configurações → Convênios → abas Serviços / Produtos / Taxas
Grade (agenda) do colaborador/equipamento	Colaborador/Equipamento + Local + Convênios (a grade lista os aceitos)	Grade do colaborador (Configurações → Colaboradores) / do equipamento
Agendamento	Paciente + Colaborador + Serviço + Local	Portal → Agenda → Criar
Atendimento (Prontuário)	Agendamento com check-in realizado	Portal → Fila de Atendimento
Lançamento Financeiro (Convênio)	Convênio configurado (com Conta de recebimento, ou a conta padrão nos Parâmetros) + Atendimento realizado	Portal → Faturamento → Pré-faturamento → lote → Gerar Contas a Receber
Usuário com permissão	Colaborador cadastrado	Configurações → Colaboradores → Editar → atribuir perfis/permissões (permissões granulares)

Tempo Estimado por Porte de Clínica

Porte da Clínica	Característica	Tempo de Implantação
Primeiro atendimento	Consultório simples: o mínimo para agendar e atender	~30 minutos para configurar
Consultório individual	1 profissional, 1 especialidade, particular ou 1 convênio	Em produção em 1–2 dias
Clínica pequena	Poucos profissionais e convênios	3–5 dias
Clínica média	3 a 10 profissionais, várias especialidades e vários convênios, estoque	1–2 semanas
Rede / multiunidade	Várias unidades, muitos convênios, faturamento TISS centralizado	3–6 semanas