Implantação › Clínica pequena/média
🏥 Implantação — Clínica pequena/média
🧩 Novo — 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).
✅ Corrigido em 24/09/2026 — ordem de implantação: 3 dependências estavam invertidas. O local exige um depósito ativo (1 depósito mínimo por unidade antes dos locais); o serviço de medicamento exige o produto (catálogo de produtos antes dos serviços); as tabelas de preço do convênio exigem as taxas (taxas antes dos convênios). A ordem abaixo já está corrigida — tabela completa no Guia de Implantação. 🔌 Implantação pela API externa — mesma ordem: API externa · Implantação via API.
Modelo para clínicas com 3 a 10 profissionais, atendendo convênios e particular. Cobre o sistema inteiro, com peso em convênios, tabelas de preço, agenda multi-profissional e faturamento TISS.
Meta de tempo: clínica pequena em 3 a 5 dias; clínica média com vários convênios em 1 a 2 semanas. Filosofia: a implantação vive ou morre pela qualidade dos convênios e das tabelas de preço. Invista aí — o faturamento correto depende disso.
Visão do porte
- Quem é: clínica com recepção, vários profissionais e mix de especialidades. 1 unidade (às vezes 2).
- Recebimento: combinação de particular e vários convênios, com faturamento por guia (TISS) e lotes mensais.
- Equipe: recepcionistas, profissionais de saúde, financeiro/faturamento e um gestor.
- O que mais importa: convênios bem cadastrados, tabelas de preço corretas, agenda de vários profissionais e o ciclo de faturamento fechando sem glosa por erro de cadastro.
Ordem de cadastro recomendada
A ordem respeita as dependências entre módulos (ex.: depósito antes do local; taxas e produtos antes dos serviços; operadora antes de convênio; convênio + serviço + taxa antes da tabela de preço).
- Empresa e Unidade — Configurações → Empresas e Unidades. CNPJ, razão social, logo. Dia 1.
- Depósito mínimo (1 por unidade) ✅ Corrigido — 24/09/2026 — Estoque → Depósitos (
/portal/estoque/depositos; pela API,POST /depositos). Só para cada local ter o seu depósito padrão de saída; os demais depósitos, entradas e custos ficam para o passo 13. Dia 1. - Locais / Salas e tipos — Configurações → Empresas e Unidades → Locais (cada local com o depósito padrão de saída ativo) e as tabelas básicas: Tipos de Serviço, de Taxa, de Produto, de Atendimento e de Código (TUSS/CBHPM). Dia 1.
- Operadoras e Fornecedores — Configurações → Operadoras (Unimed, Bradesco, Amil etc.) e Estoque → Fornecedores, Fabricantes e Princípios Ativos. Dia 1–2.
- Taxas — Configurações → Taxas (sala, material, guia…). Vêm antes das tabelas de preço, que dependem delas. Dia 2.
- Produtos (catálogo) — Estoque → Produtos (exige Tipo de Produto, Fabricante e Depósito). Medicamentos e materiais usados nos serviços; entradas de estoque e custo podem ficar para depois. Classifique os controlados: Lista da Portaria 344/98 e Sujeito a retenção de receita (antimicrobianos e GLP-1) na aba Dados do Produto — ou no Princípio Ativo, que o produto herda. Novo — out/2026 Dia 2.
- Equipamentos — Configurações → Equipamentos. Aparelhos que entram na agenda. Dia 2.
- Serviços/Procedimentos — Configurações → Serviços. Catálogo de procedimentos da clínica — subserviços antes dos serviços pais; a composição aponta para produtos e taxas já cadastrados. Em seguida, a tabela de preço interna (preço de produto — antes dos convênios; o preço do particular sai do convênio "Particular"). Dia 2–3.
- Colaboradores + especialidades (CBOS) — Configurações → Colaboradores. A grade de horário vem depois dos convênios. Novo — out/2026 Médicos: CPF e especialidade ativa com conselho, número e UF iguais aos do conselho — para o SNCR, só CRM, CRMV ou CRO (o Rabi usa a especialidade mais antiga com um desses conselhos; quem tem mais de um CRM fica com a inscrição mais antiga), e o certificado digital em Minha Conta — checklist do médico para as receitas (SNCR), ligação com a Anvisa ativa desde 23/10/2026; peça a numeração antes de 31/10/2026. Dia 3–4.
- Convênios: dados, depois abas — Configurações → Convênios. Primeiro os dados (planos, prazo de pagamento/retorno/entrega de guias, limite de glosa); depois as abas de preço (Serviços, Produtos, Taxas — importar via Excel ou manual) e o credenciamento dos colaboradores (aba CBOS) — a ordem tela a tela está no Guia do Implantador de Preços. 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. Valor combinado não é pacote: o valor digitado na linha 🔁 muda só o preço do serviço e os itens continuam somando; para preço fechado, marque Pacote na linha do serviço no convênio e "Zerar valor em pacotes" nos itens inclusos (sintoma "digitei um valor e os itens continuaram somando" → marque Pacote — Guia da clínica). ✅ Novo — 30/09/2026 Convênio recém-criado abre liberado; ao voltar a um convênio já salvo para preencher ou corrigir as abas, ele abre em modo consulta (#632) — o 1º passo é clicar em Liberar para edição (vale só nesta visita). ✅ Novo — 01/10/2026 Depois de alterar, clique em Salvar no cabeçalho do convênio — as abas só gravam aí (a célula pendente fica destacada). Não use "Copiar convênio" para montar um convênio novo (#639). Especialidades (aba Especialidades, coluna Atende): marque as que o convênio cobre antes dos serviços e profissionais — no cadastro do convênio serviço de especialidade não atendida não aceita Utiliza; no agendamento a trava está desligada desde 06/10/2026 (#628). ✅ Novo — 12/10/2026 Se a operadora cobra algo à parte (ex.: taxa administrativa percentual), cadastre na aba Custos extras do convênio — entra só no custo do Farol (veja); e preencha a Conta de recebimento do convênio (aba Dados), usada no Gerar Contas a Receber do lote. Dia 4–5.
- Grade de horário ✅ Corrigido — 24/09/2026 — de cada profissional e equipamento, depois dos convênios (a grade lista os convênios aceitos). ✅ Novo — 30/09/2026 Se a clínica vai usar a TalkMe (IA), cadastre na grade os serviços e os convênios (Incluir/Excluir) e marque Atende convênio no cadastro do profissional em cada convênio que ele atende — a IA só oferece o que esses cadastros mostram (consulta única de disponibilidade #633, em produção desde 09/10/2026; o painel Disponibilidade por Convênio da Agenda usa o cadastro Unidades do convênio). Dia 5.
- Conferência pelo Farol — em cada convênio, aba Farol › Itens (cada linha mostra só a própria conta) e a seta de expandir em cada serviço composto ou 🔴/🟡 na aba Serviços ✅ Novo — 26/09/2026 (#625, concluído: árvore do serviço como sai na guia, com farol, custo, receita e o Motivo de cada item fora da cobrança). Nenhum item 🟣 roxo. ⚠️ Produto ou taxa em uso num serviço ativo não pode ser excluído desde 02/10/2026 (#626): o sistema mostra a lista de serviços para substituir o item antes. ✅ Novo — 12/10/2026 O custo do Farol inclui custos extras do convênio, prestadores e o repasse do profissional — cadastre-os antes de conferir; a cor de alguns serviços pode mudar (os valores cobrados não). Mantenha desmarcada a opção de bloqueio por custos extras (Parâmetros › Orçamento) até rodar "Ver serviços que mudam de cor". Regras resumidas na árvore de decisão. Dia 5.
- Financeiro base e estoque — Contas e Caixas, Tipos de Pagamento, Categorias, Centro de Custo e conferência do repasse; ✅ Novo — 12/10/2026 Controle de caixa (nasce Desligado — Configurações › Parâmetros › Financeiro: Desligado / Aviso / Bloqueio; comece em Aviso) e as 9 permissões novas do financeiro em CONTAS CAIXAS, que ninguém recebe sozinho — ver guia mestre, etapa 12. Repasse: cadastre na etapa de colaboradores, com o repasse geral (aba Vínculo e Repasse — veja). Se usar insumos: depósitos adicionais, entradas/saldo inicial e custos dos produtos. Dia 5–6.
- Pacientes — importar a base existente (tela, planilha ou API externa). Dia 6.
- Parâmetros, Documentos e Usuários/permissões granulares (#395) — Parâmetros do sistema, Tipos de Documento de Atendimento (receita/atestado/laudo), Tipos de Impressão; usuários de recepção, profissionais, financeiro/faturamento e gestor, cada um com o acesso mínimo, controlado 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.) Dia 7–8.
- Testes de validação — rodar os cenários (agendamento particular, agendamento convênio, faturamento/lote, bloqueio, relatórios, permissões). Dia 8–9.
Cuidado com dependências. Não dá para salvar local sem depósito ativo, nem serviço de medicamento sem o produto, nem convênio sem operadora, nem tabela de preço sem serviço e taxa, nem agendar sem colaborador com grade. Se pular a ordem, você trava mais à frente. Consulte a tabela de dependências no guia mestre.
Módulo × prioridade neste foco
| Módulo / Cadastro | Prioridade | Observação para este porte |
|---|---|---|
| Empresa / Unidade / Depósito mínimo / Locais / Equipamentos | 🟢 Essencial | 1 unidade com o seu depósito mínimo; salas e aparelhos que a agenda reserva. |
| Taxas + catálogo de Produtos | 🟢 Essencial | Antes dos serviços e das tabelas de preço, que dependem deles. |
| Operadoras | 🟢 Essencial | Base dos convênios. Cadastre antes. |
| Convênios + prazos | 🟢 Essencial | Vários. Prazos corretos evitam problemas de recebimento. |
| Tabelas de preço (convênios, inclusive o convênio "Particular") | 🟢 Essencial | Ponto mais crítico. Erro aqui vira glosa. Use importação Excel — e siga o Guia do Implantador de Preços. |
| Serviços / Procedimentos + Tipos de Código | 🟢 Essencial | Catálogo com TUSS/CBHPM para o TISS. |
| Colaboradores + CBOS + grade + credenciamento | 🟢 Essencial | Vincular cada profissional aos convênios que atende. |
| Agenda multi-profissional | 🟢 Essencial | Confirmação em massa, acolhimento/check-in, encaixe, bloqueio. |
| Prontuário + Documentos | 🟢 Essencial | Atendimento clínico e emissão de documentos por modelo. |
| Faturamento TISS + Lotes + Glosas | 🟢 Essencial | Pré-faturamento, fechar/administrar lote, gerar contas a receber, geração de XML — com baixa/glosa automática do retorno TISS (#586) e reconciliação do pré-faturamento (#568/#569). |
| Financeiro (contas, categorias, centro de custo, repasse) | 🟢 Essencial | Repasse por colaborador é comum neste porte. |
| Autorização / Orçamento | 🟡 Importante | Autorização de convênio e orçamento particular convertível em agendamento. |
| Estoque básico | 🟡 Importante | Se usa insumos/medicamentos. Comece simples (o depósito mínimo já criado no passo 2). |
| Relatórios / Dashboards | 🟡 Importante | Agenda, Ocupação, Fluxo de Caixa, Repasses, Mapa de Estoque. |
| Permissões granulares (#395) | 🟡 Importante | Separar recepção × profissional × financeiro × gestor, por funcionalidade e ação. |
| Tipos de Anexo / Identificação | ⚪ Opcional | Configure conforme surgir a necessidade (taxas usadas nos serviços entram no passo 5). |
✅ Tudo isto já está em produção. Obrigatoriedade de orçamento/autorização, status "Pendente" na agenda, farol de margem receita/custo, bloqueio de serviço por convênio e notificações por e-mail/SMS já estão disponíveis. ✅ Novo — set/2026 A importação de NF-e de fornecedor (#391) e a 1ª fase da emissão de NFS-e (módulo fiscal opt-in por clínica — emissão no pagamento, por convênio, assíncrona, IBS/CBS) foram entregues no ciclo de setembro/2026; ✅ Novo — 26/09/2026 as peças finais da NFS-e (modelos de nota, gestão das notas e onboarding fiscal) estão em produção desde 22/09/2026 — o módulo fiscal está completo e o go-live fiscal pode ser planejado com o onboarding fiscal guiado. ✅ Novo — 29/09/2026 Desde 28/09 também estão em produção o DRE gerencial (#617 — classifique as categorias na coluna "Linha do DRE"), o pagamento parcial antecipado por serviço (#604, confirmação manual), o Copiar agenda (#616) e os tokens
rbt_ (#624). (Cuidados com o token: ele aparece uma única vez — guarde em local seguro; nunca cole em documento, chamado, e-mail ou conversa com IA; suspeita de vazamento → revogue e gere outro.) Na etapa de convênios, marque as especialidades que cada convênio atende (aba Especialidades, coluna Atende — passa a valer com a #628, roadmap) e, para alterar um convênio já salvo, clique antes em Liberar para edição (modo consulta, #632, em produção desde 29/09). Notas de compra (#391): lote, validade e parcelas ainda não vêm da nota — ajuste no estoque e na conta a pagar. ✅ Atualização 13/10/2026 Em produção desde 01–12/10: bloqueio de exclusão de produto/taxa em uso (#626); abas do convênio só gravam no Salvar e histórico por aba (#638); repasse geral por profissional (#643); NF de entrada com lote, validade e parcelas da nota (#629); custos extras do convênio no Farol (#655); controle de caixa e Conciliação Bancária por OFX (#650 — nasce desligado); consulta única de disponibilidade da IA (#633). A coluna Atende das especialidades (#628) vale no cadastro do convênio, mas a trava no agendamento está desligada desde 06/10. Seguem no roadmap: Links de Pagamento (#409) e referências oficiais de produto (#662). ✅ Atualização 15/10 desde 13–15/10 estão em produção os links de pagamento Pix (opcional: Parâmetros › Pagamentos (links), com a API Pix do banco da clínica), a elegibilidade TISS (opcional: aba Integração TISS da operadora) e as referências oficiais em 1ª fase (sem carga de preços pela tela — confirme com o time Rabi). Onde entram na ordem: Guia de Implantação. (A nota sobre as notas de compra deixou de valer em 09/10/2026 — #629.)
Tempo estimado
| Fase | Conteúdo | Duração |
|---|---|---|
| Semana 1 (dias 1–5) | Estrutura (empresa, depósito mínimo, locais, tipos), operadoras/fornecedores, taxas, produtos, equipamentos, serviços, colaboradores, convênios e conferência pelo Farol | ~5 dias |
| Semana 1–2 (dias 5–7) | Financeiro, estoque básico, pacientes, parâmetros e documentos | ~2 dias |
| Semana 2 (dias 8–9) | Usuários/permissões + testes de validação | ~2 dias |
| Semana 2 (dia 10+) | Go-live, treinamento por perfil, acompanhamento | 1+ dia |
| Total | 3 a 5 dias (pequena) · 1 a 2 semanas (média com vários convênios) | |
Checklist de go-live (completo)
Estrutura e cadastros-mestre
- ☐ Empresa e unidade cadastradas
- ☐ 1 depósito mínimo ativo por unidade
- ☐ Locais/salas criados (com depósito padrão de saída) e tipos cadastrados
- ☐ Operadoras e fornecedores cadastrados
- ☐ Taxas e catálogo de produtos cadastrados
- ☐ Equipamentos criados
- ☐ Serviços/procedimentos com códigos (TUSS/CBHPM) vinculados (subserviços antes dos pais)
- ☐ Convênio "Particular" configurado (é dele que sai o preço do atendimento particular) e tabela de preço interna (preço de produto), se usar
- ☐ Colaboradores com especialidade, CBOS e grade; médicos com CPF, conselho/número/UF e certificado (checklist SNCR)
- ☐ Convênios criados com planos e prazos corretos, abas de preço preenchidas e colaboradores credenciados
- ☐ Cada convênio conferido na aba Farol › Itens (sem valores faltando, nenhum item roxo)
Operação e financeiro
- ☐ Contas/caixas, tipos e categorias de pagamento cadastrados
- ☐ Centro de custo definido e repasse de cada profissional cadastrado (com o repasse geral)
- ☐ Controle de caixa decidido (Desligado / Aviso / Bloqueio) e permissões novas do financeiro liberadas para quem precisa
- ☐ Custos extras e Conta de recebimento de cada convênio cadastrados
- ☐ Modelos de documento (receita/atestado/laudo) prontos
- ☐ Estoque básico (entradas e custos) cadastrado (se aplicável)
- ☐ Base de pacientes existente migrada/importada (se houver)
- ☐ Usuários criados por perfil com permissão mínima e validados um a um
Testes (todos devem passar)
- ☐ Cenário 1 — Agendamento particular → atendimento → recebimento
- ☐ Cenário 2 — Agendamento por convênio → atendimento → guia gerada
- ☐ Cenário 3 — Pré-faturamento → fechar lote → gerar contas a receber → XML
- ☐ Cenário 4 — Bloqueio de agenda funciona
- ☐ Cenário 5 — Relatórios (Agenda, Fluxo de Caixa, Repasses) consistentes
- ☐ Cenário 6 — Cada perfil vê apenas o que deve
- ☐ Dados de teste apagados antes do go-live
Go-live
- ☐ Base de pacientes importada conferida por amostragem
- ☐ Treinamento por perfil realizado (recepção, profissionais, financeiro, gestor)
- ☐ Data oficial de entrada em produção definida
- ☐ Acompanhamento pós-implantação agendado (1ª semana)
✅ Pronto para operar em escala. Se a clínica crescer para várias unidades ou muitos profissionais, avance para o modelo Clínica grande / rede, que trata governança, permissões por perfil em escala e dashboards gerenciais.