Lição: Configurações e Cadastros-mestre

Esta lição prepara o implantador para configurar um ambiente Rabi do zero. As Configurações são a fundação do sistema: todos os demais módulos (Agendamento, Prontuário, Faturamento, Financeiro, Estoque) dependem dos dados cadastrados aqui. Ao final você deverá saber cadastrar, na ordem oficial (corrigida em 24/09/2026): empresa e unidades, depósito mínimo, locais, operadoras/fornecedores/fabricantes, taxas, catálogo de produtos, equipamentos, serviços e tabela de preços interna, colaboradores com CBOS, convênios (a peça mais complexa) com a conferência pelo Farol e a grade da agenda, financeiro/estoque, pacientes, parâmetros e permissões — respeitando as dependências.

✅ Em produção. Todo o conteúdo desta lição descreve o que já está disponível em produção (app.rabisistemas.com.br), salvo quando explicitamente marcado como 🟠 planejado.

Objetivo do módulo e onde fica

O módulo administra a estrutura da clínica e os cadastros-mestre reutilizados por todo o sistema. Acesso pelo menu lateral Configurações. Rota base em produção:

/portal/configuracoes/empresas-unidades — porta de entrada do módulo

⚠️ Acesso restrito. O módulo exige o grupo de permissão CONFIGURACOES. Apenas administradores e implantadores devem ter acesso — alterações incorretas impactam toda a operação da clínica.

A ordem de configuração (a regra de ouro do implantador)

Os cadastros têm dependências entre si. Seguir a ordem errada trava a implantação (ex.: não dá para criar convênio sem operadora, nem colaborador sem empresa, nem local sem depósito). Sequência oficial para clínica nova ✅ corrigida em 24/09/2026:

Empresa e Unidades — CNPJ, endereço, logo.
Depósito mínimo — um por unidade (Estoque → Depósitos, /portal/estoque/depositos) — o local exige um depósito padrão de saída ativo. O resto do estoque continua lá na frente.
Locais / Salas e seus tipos — ambientes de atendimento dentro de cada unidade.
Operadoras, Fornecedores e Fabricantes — as empresas de plano de saúde (inclusive a operadora "Particular"), as empresas fornecedoras e os fabricantes (o produto exige fabricante).
Taxas e Tipos de Taxa — antes dos convênios e da tabela de preços internos (as abas Taxas/Serviços do convênio e a tabela interna exigem as taxas).
Produtos (catálogo) — tipos de produto, princípios ativos e os produtos em si (o produto exige tipo de produto, fabricante e localização padrão do depósito, além de nome, tipo de código, código, apresentação, contendo, unidade de medida e CD; o Estoque mínimo fica na aba Estoque do produto, é opcional e pode ser ajustado depois — correção 30/09/2026). Serviço de medicamento aponta para o produto, então o catálogo vem antes dos serviços; entradas de estoque e custo podem ficar para depois.
Equipamentos — aparelhos vinculáveis à agenda.
Tipos de Serviço e Serviços — catálogo de procedimentos, com os subserviços cadastrados ANTES dos serviços pais; e os Tipos de Atendimento (primeira consulta, retorno, urgência etc.). Em seguida, a Tabela de Preços Internos — preço de produto (até 3 preços por produto) —, depois de taxas, produtos e serviços e antes dos convênios.
Colaboradores e Especialidades — profissionais com CBOS e especialidades (login e perfil de acesso ficam no cadastro do colaborador). A grade horária é montada depois dos convênios.
Convênios — primeiro os dados do convênio, depois as abas (Serviços, Produtos, Taxas, CBOS). O atendimento particular também é um convênio: o convênio Particular (pagamento no ato), com os preços do particular na aba Serviços. Com os convênios prontos, monte a grade dos colaboradores e equipamentos (ela lista os convênios aceitos).
Conferência pelo Farol — antes, ajuste a régua do Farol em Parâmetros › aba Valores (Parâmetro Vermelho e Parâmetro Amarelo); depois confira na aba Farol › Itens do convênio e na seta de expandir o serviço (#625): confirme que cada item entra (ou fica fora) como esperado.
Financeiro e Estoque — contas/caixas, tipos e categorias de pagamento; entradas e saldos de estoque.
Pacientes — carga/migração da base.
Parâmetros e Permissões — tipos de documento e impressão, demais parâmetros do sistema, perfis e permissões dos colaboradores.

✅ Novo — set/2026 🚨 Ordem corrigida em 24/09/2026 — 3 dependências estavam invertidas no material anterior (verificadas na API e na tela):

Depósito antes dos locais: o local exige depósito padrão de saída ativo (a API recusa com erro 422 se ele estiver inativo ou não existir). Crie um depósito mínimo por unidade logo após a empresa.
Catálogo de produtos antes dos serviços: a composição do serviço de medicamento aponta para o produto — sem o produto, o serviço não fica completo.
Taxas antes dos convênios e da tabela interna: as tabelas de preço do convênio (abas Taxas/Serviços) e a tabela de preços internos exigem as taxas já cadastradas.

As seções desta lição seguem a organização do menu; para implantar, siga a lista acima. A mesma ordem vale para a implantação por API externa (migração por sistema externo ou por IA). Para decidir se cada item entra no preço, use a Árvore de decisão de preços.

Empresas e Unidades

Define a estrutura organizacional: uma empresa (um CNPJ) pode ter várias unidades físicas de atendimento. Clínica com uma só sede cadastra uma empresa e uma unidade. Rota: /portal/configuracoes/empresas-unidades.

Passo a passo — cadastrar a empresa

Acesse Configurações → Empresas e Unidades.
Clique em Nova Empresa (canto superior direito).
Preencha os dados obrigatórios: Razão Social, CNPJ (só números) e endereço com CEP.
Opcional: faça Upload de Logo (PNG/JPG) — aparece nos documentos impressos.
Clique em Salvar. A empresa já pode ser vinculada a colaboradores.

Campos do formulário

#	Campo	Obrig.?	Validação / Observação
1	Razão Social	Sim	Nome jurídico. Ex.: Clínica Rabi Sistemas Ltda
2	Nome Fantasia	Não	Nome comercial
3	CNPJ	Sim	14 dígitos, sem pontuação. Validação de CNPJ
4	CEP	Sim	Preenche endereço automaticamente
5	Logradouro / Número	Sim	Rua/Av. e número
6	Bairro / Cidade / Estado	Sim	Preenchido pelo CEP
7	Telefone	Não	Formato BR: (00) 00000-0000
8	E-mail	Não	E-mail de contato
9	Logo	Não	PNG/JPG, aparece em impressos

✅ Novo — jul/2026 Logo/customização por clínica (#503): a logo e a customização passam a ser configuráveis por clínica. Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

⚠️ Etapa 1 — faça primeiro. Sem a empresa não é possível cadastrar colaboradores nem convênios. Logo em seguida (etapa 2), crie o depósito mínimo da unidade em Estoque → Depósitos — sem ele não dá para salvar os locais.

Locais / Salas

Ambientes físicos dentro de uma unidade onde ocorrem atendimentos: consultórios, salas de exame, de procedimento, recepção. Cada local é vinculado a uma unidade. Rota: /portal/configuracoes/empresas-unidades/locais.

Passo a passo

Em Empresas e Unidades, clique em Locais.
Clique em Novo Local.
Informe o nome (ex.: "Consultório 01", "Sala de Exames").
Selecione a unidade correta.
Informe o depósito padrão de saída (o depósito mínimo da unidade, que precisa estar ativo).
Salve. O local passa a aparecer no campo "Local do Agendamento".

🔗 Integração. Se um local não aparece na agenda, confira se foi salvo e vinculado à unidade correta.

Operadoras

Empresas de plano de saúde — a base para os convênios. Primeiro a operadora, depois o convênio. Rota: /portal/configuracoes/operadoras.

Passo a passo

Acesse Configurações → Operadoras.
Clique em Nova Operadora.
Informe o nome (ex.: Unimed Nacional, Bradesco Saúde, Amil). Para atendimentos sem plano, crie uma operadora "Particular".
Preencha o CNPJ, se disponível.
Salve.

⚠️ Operadora ≠ Convênio. Operadora é a empresa (Unimed, Bradesco). Convênio é o plano específico (Unimed Individual). Uma operadora tem vários convênios. Não é possível criar convênio sem operadora.

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

Desde 15/10/2026, ao editar uma operadora aparecem as abas "Dados da operadora" e "Integração TISS" ("Webservices da operadora (elegibilidade, autorização, lotes...)"). É opcional: sem nada configurado, "Operadora sem integração TISS configurada — as telas continuam como hoje."

Peça à operadora o endereço dos webservices e as credenciais do prestador.
Na aba Integração TISS, marque Integração ativa e preencha as Credenciais do prestador (a senha fica cifrada: "Senha definida — deixe em branco para manter."; o código do prestador vazio = código da operadora) e, se a operadora exigir, Certificado e assinatura ("Usar certificado cliente (mTLS)", "Assinar XML").
Em Endereços dos webservices, preencha ao menos Verificar elegibilidade (há campos para as outras transações, mas hoje nenhum fluxo os usa).
Clique em Testar conexão ("Conexão OK") e em Salvar integração.

Um convênio pode ter configuração própria ("A configuração do convênio, se existir, substitui a da operadora."). Com a integração ativa, o agendamento e o acolhimento ganham o botão "Verificar elegibilidade"; as chamadas ficam em Configurações › Log de integração TISS (filtros e XML de envio com a senha mascarada). Permissões novas no grupo Configurações: TISS_INTEGRACAO (VIEW vê configuração e log; UPDATE salva e testa) e TISS_ELEGIBILIDADE (VIEW vê o status; CREATE verifica). Só a elegibilidade funciona hoje; autorização online, envio de lote, demonstrativos e recurso de glosa são as fases 2 a 4 🟠 Roadmap (#620–#623).

Convênios — o cadastro mais crítico

Contratos com operadoras aceitos pela clínica. É a configuração mais complexa: define regras comerciais, prazos, credenciamento e tabelas de preço. Rota: /portal/configuracoes/convenios.

Passo a passo — cadastrar um convênio

Acesse Configurações → Convênios e clique em Novo Convênio.
Selecione a operadora (já cadastrada).
Informe o nome do convênio (ex.: Unimed Individual).
Preencha os prazos comerciais (pagamento, retorno, entrega de guias, glosa) — vêm do contrato com a operadora.
Defina "Pagamento no ato?": Sim = copagamento na recepção; Não = faturado depois em lote.
Configure a tabela de preços (ver métodos abaixo).
Na aba Especialidades, marque Atende nas especialidades que o convênio cobre (hoje a marcação ainda não filtra o agendamento — ver "Especialidades do convênio" abaixo). ✅ Atualização 13/10: na aba Serviços ela já sinaliza e bloqueia marcar Utiliza em serviço de especialidade não atendida; no agendamento a trava está desligada desde 06/10.
Marque Ativo = Sim e salve.

O convênio recém-criado abre liberado para preencher. Para alterar um convênio que já existe (dados, valores, Utiliza, Pacote, Zerar, especialidades, colaboradores, planos, taxas, produtos, serviços, dados fiscais, copiar ou importar planilha), o 1º passo é sempre clicar em Liberar para edição — veja o quadro abaixo.

✅ Atualização 13/10: e o último passo é clicar em Salvar, no cabeçalho do convênio: desde 01/10/2026 o que você altera nas abas Planos, Especialidades, Produtos, Serviços e Taxas fica como rascunho (célula destacada) e só grava no Salvar. Sequência: Liberar para edição → alterar → Salvar.

🔒 Convênio abre em modo consulta (#632) ✅ Novo — 30/09/2026 — em produção desde 29/09/2026:

Todo convênio existente abre em modo consulta: dá para ver tudo, trocar de aba, filtrar, buscar, ordenar, paginar, expandir os itens do serviço, ver o Farol e exportar; não dá para alterar campos, caixas de marcação, "marcar todos", incluir, excluir, copiar convênio nem importar planilha.
Para alterar: botão Liberar para edição (um clique, sem pedir confirmação). Aparece uma faixa de aviso e o botão Bloquear edição. A liberação vale só nesta visita: sair da tela, abrir outro convênio ou recarregar a página volta ao modo consulta. Não há bloqueio automático por tempo nem registro de quem liberou.
Em modo consulta nada é gravado (nem ao sair do campo, Enter ou clique); se tentar, aparece "Modo consulta: nada foi gravado. Clique em Liberar para edição para alterar o convênio."
Casos especiais: convênio recém-criado abre liberado; usuário sem permissão de alterar convênio só consulta ("Você não tem permissão para alterar convênios" — o botão não serve para ele); se os dados não carregarem, a tela avisa e não deixa salvar ("Aguarde o carregamento dos dados do convênio antes de salvar" / "Não foi possível carregar os dados do convênio").
A aba Convênios do colaborador continua editável como sempre. A API externa não muda (grava normalmente).
Correções junto (29/09): as políticas de preço por tipo de produto passam a carregar junto com a aba Dados (antes, se demorassem, o Salvar mandava lista vazia e inativava todas as políticas do convênio); salvar com campo inválido em outra aba mostra "Não foi possível salvar: há campos inválidos na aba Dados do convênio"; a lista de convênios pagina, filtra e ordena no servidor (ativos primeiro, depois ordem alfabética; o filtro da coluna Convênio busca por nome).

Esta lição dizia antes que as abas "gravavam sozinhas" ao sair do campo — isso acabou em 29/09.

✅ Novo — 01/10/2026 As abas só gravam no Salvar (rascunho, desde 01/10) e o convênio grava só o que mudou (02/10):

Com a edição liberada, a faixa avisa: "Edição liberada. As alterações só são gravadas ao clicar em Salvar. N linha(s) com alteração não salva nas abas." Ao salvar: "N alteração(ões) das abas gravada(s)." — se algo falhar, "X gravada(s); Y não gravada(s): <motivo>" (o que falhou continua pendente e destacado). Salvar sem mudar nada: "Nenhuma alteração para salvar."
Ações em massa gravam na hora (Selecionar/Desmarcar todos, Copiar, Importar). Com pendências, o sistema avisa: "Há alterações não salvas no convênio. Clique em Salvar (ou descarte em "Bloquear edição") antes de usar esta ação."
"Bloquear edição" com pendências abre "Alterações não salvas": Continuar editando / Descartar alterações / Salvar e bloquear.
Ficam fora do rascunho (gravam na própria aba): Colaboradores, Custos extras, Farol e Dados Fiscais (NFS-e).
Histórico por subaba (#638, 02/10): botão "Histórico" (ícone de relógio) no cabeçalho abre o histórico da aba atual — funciona até em modo consulta; na lista de convênios, o ícone "Histórico de alterações" abre o histórico geral. Filtros Subaba, Usuário (inclui integração/API), Operação (Criação/Alteração/Remoção) e De/Até; "Ver campos alterados" mostra antes e depois.
Proteções (#640): "Este registro foi alterado por outra pessoa. Recarregue a tela antes de alterar." (outra pessoa gravou depois que a sua tela abriu); "Parte dos dados não carregou: nada foi gravado. Recarregue a tela antes de alterar. A tela fica só leitura até carregar tudo." (botão "Recarregar a tela").
Correções (#639/#654, 01–02/10): marcar Utiliza/Autorização/Retorno/Pacote ou editar código não apaga mais o valor convertido; salvar a aba Dados não troca mais o prazo de autorização pelo limite de parcelas; data de reajuste vazia não vira 01/01/1970; "Atende" e o perfil fiscal NFS-e omitidos não são apagados; limpar Tabela 87 funciona; plano novo marcado nasce com Utiliza ligado. Cuidados que continuam: o "Selecionar/Desmarcar todos" da aba Serviços só alterna o Utiliza, qualquer que seja a coluna escolhida (Retorno, Autorização, Pacote) — não use para essas colunas; evite o "Copiar convênio" (sem correção confirmada); e, para ir a outro convênio, prefira voltar à lista e abrir o próximo.

Campos do formulário

#	Campo	Obrig.?	Descrição
1	Operadora	Sim	Cadastrada antes
2	Nome do Convênio	Sim	Ex.: Unimed Individual Ambulatorial
3	Credenciado	Sim	Sim = clínica credenciada; Não = atende mas não fatura
4	Ativo	Sim	Sim = disponível em agendamentos
5	Prazo de pagamento (dias)	Não	Prazo da operadora para pagar lotes
6	Prazo de retorno (dias)	Não	Janela de retorno sem nova cobrança. ✅ Atualização 13/10: é o "Prazo de Retorno em (Dias)" que faz o retorno automático (#645): dentro dele, o mesmo serviço com o mesmo profissional vira retorno zerado (o serviço precisa ter Retorno marcado na aba Serviços) e com outro profissional o agendamento é bloqueado. Sem prazo, o retorno manual é recusado.
7	Prazo de reajuste	Não	Periodicidade de reajuste da tabela
8	Prazo entrega de guias (dias)	Não	Máximo para enviar guias após atendimento
9	Limite recurso de glosa	Não	Prazo para contestar glosa recebida
10	Prazo pagamento glosa (dias)	Não	Prazo da operadora responder ao recurso
11	Pagamento no ato?	Sim	Sim = copagamento na chegada; Não = lote
—	Conta de recebimento ✅ Novo — 12/10/2026	Não	Conta caixa usada no Gerar Contas a Receber do lote (#650); sem ela, vale a "Conta Padrão de Recebimento de Convênios" de Parâmetros › Financeiro — sem nenhuma das duas, o Gerar Contas a Receber dá erro
12	Fator K / Inflator (%)	Não	Percentual de ajuste dos valores da tabela

Tabela de preços do convênio (4 métodos)

Cada convênio tem tabela própria com o valor pago por procedimento. Formas de configurar (em convênio já existente, clique antes em Liberar para edição — só Exportar funciona em modo consulta):

Método	Quando usar	Como fazer
Importar Excel	Muitos procedimentos de uma vez	Baixe o template → preencha → botão "Importar Excel"
Cadastrar manualmente	Poucos itens / ajustes pontuais	Botão "+ Procedimento", um a um
Copiar de outro convênio	Tabelas parecidas	Botão "Copiar de convênio" → selecione origem. ✅ Atualização 13/10: por enquanto, evite: o Copiar convênio não teve correção confirmada no pacote de 01–02/10 — prefira importar a planilha e conferir.
Exportar Excel	Revisão / backup	Botão "Exportar Excel"

Painel de conversão de serviço (atualizado jun/2026)

Em /portal/configuracoes/convenios/:id/servicos, o painel de Conversão de Serviço faz o "de–para" entre os serviços internos da clínica e os códigos/serviços do convênio. Em junho/2026 esse painel foi simplificado e recebeu ajustes visuais, tornando o cadastro do "de–para" mais rápido e claro.

Novidades de julho/2026 no convênio ✅ Novo — jul/2026

Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

Valor por conversão na linha (#473): o valor por conversão passa a ser informado direto na linha do serviço.
Desativar convênio com vinculados (#455): agora é possível desativar um convênio mesmo com colaboradores vinculados.
Sub-aba Colaboradores (#429): a sub-aba passa a listar apenas os colaboradores que têm consulta.
Farol de resultado 🟢🟡🔴 (#390/#434/#339): farol por convênio/serviço/produto, com cores + índice, parametrizado no convênio. Bloqueia no vermelho (liberação por nível superior) — desde 23/09/2026, no orçamento, agendamento e autorização, quem bloqueia é o Farol CONSOLIDADO do conjunto (Σ receita ÷ Σ custo); a cor de cada item só orienta. A régua (Parâmetro Vermelho/Amarelo) fica em Parâmetros › aba Valores.

✅ Novo — ago/2026 Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização: a visão geral do farol (#435) — lista de cruzamentos serviço×convênio e produto×convênio — foi entregue, e o farol ganhou a cor ROXA (#545) para erro de preço (sem custo ou sem receita), com bloqueio.

✅ Novo — ago/2026 Subabas do convênio com filtro e ordenação (#583): as subabas Produtos, Serviços e Taxas do convênio ganharam filtro e ordenação por utilização — os itens mais usados aparecem primeiro, agilizando a manutenção das tabelas. Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

✅ Novo — set/2026 Novos códigos no domínio da tabela 87 (TISS): o domínio de tabela 87 do convênio ganhou os códigos 05 — Brasindice, 12 — SIMPRO e 97 — Taxa Própria, permitindo referenciar corretamente materiais/medicamentos (Brasindice/SIMPRO) e taxas próprias da clínica nas guias. Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

✅ Novo — set/2026 Correção: campo "Política de Preço" exibia "null" (#615): o campo Política de Preço do produto no convênio exibia "null" em vez do valor configurado; corrigido no fechamento da Sprint 10 (17–18/09). Também no ciclo: cadastros estruturais padronizados (#606) — campos estruturados em maiúsculas e sem acentuação, evitando duplicidades de grafia.

✅ Novo — set/2026 Regras finais de preço nas abas do convênio (em produção desde 23/09/2026); se ainda não apareceu no seu ambiente, chega na próxima atualização:

Zero é zero, vazio é vazio — em todas as telas: na coluna Valor da aba Serviços, digitar 0,00 significa preço zero de verdade (serviço gratuito para o convênio — não desce de nível); para dizer "não tenho preço combinado", deixe o campo vazio usando o botão Limpar valor — aí o sistema desce para a política do convênio e depois para o cadastro. O bug que tratava 0,00 do serviço como vazio foi corrigido. Quem usou R$ 0,01 como "marcador de sem valor" deve limpar o campo.
Coluna Tipo de Atendimento com 3 linhas: a aba Serviços do convênio ganhou a coluna Tipo de Atendimento com as 3 linhas do padrão do item (🔒 o do cadastro · 🔁 o escolhido para o convênio · ✅ o que vale). O do convênio prevalece e vai para o atendimento, o pré-faturamento e o campo tipoAtendimento do XML TISS.
Utiliza = "este convênio cobre este item": item sem Utiliza tem custo, mas não tem receita (fica fora da receita do Farol; o custo continua contando). Item com Utiliza usa a cadeia de conversão do convênio (valor combinado → política do convênio → cadastro) — nunca o "preço da casa". Marque Utiliza em tudo que o convênio cobre.
"Zerar valor em pacotes" é por item e só age quando o serviço é pacote de preço fechado (Pacote marcado + valor fixo ou valor combinado preenchido, inclusive 0).
Cor da 1ª linha corrigida: a primeira linha das abas Serviços, Produtos, Taxas e Equipamentos recebia sempre fundo branco mesmo com a bolinha do Farol colorida; agora a linha inteira recebe a cor do Farol (linha sem Farol calculado fica cinza claro).
Os itens SEMPRE entram (✅ em produção desde 23/09): taxas, produtos e subserviços sempre entram na conta do serviço, cada um com as próprias conversões, como saem na guia/XML. "Definir preço do serviço pelos itens" (somar itens) decide só o valor próprio do serviço (zero quando marcado). Só ficam fora: item sem Utiliza ou zerado em pacote de preço fechado. Serviço de preço fixo sem Pacote = valor fixo + todos os itens com Utiliza (no orçamento, itens na quantidade inteira) — o mesmo vale para o valor combinado no convênio sem Pacote; para o preço fixo ou o valor combinado "já incluir" itens, marque Pacote na linha do serviço no convênio + Zerar nos itens inclusos.
Zerar por item, sem cascata (✅ em produção desde 24/09): subserviço zerado perde só o próprio valor; os itens dentro dele seguem cada um o seu Zerar. Só a falta de Utiliza no subserviço tira tudo o que está dentro dele.
Linha ✅ do serviço = valor do próprio serviço (✅ em produção desde 23/09): na aba Serviços, a linha ✅ mostra o valor do serviço como sai na linha de procedimento do XML (nível 3 do convênio, senão o cadastro; zero se somar itens sem valor combinado) — produtos e taxas saem nas áreas deles. Quem soma tudo é o Farol.
Valor combinado NÃO é pacote ✅ regra vigente — decisão de 25/09/2026: digitar um valor na linha 🔁 do serviço muda só o preço do serviço; os itens continuam somando por cima, cada um com o seu preço (ex.: combinado R$ 100,00 → total = 100 + aplicação + medicamento). Pacote é sempre uma marcação por convênio — não existe pacote no cadastro do serviço (catálogo), onde o serviço só tem preço fixo ou soma dos itens; preço fixo no catálogo ou valor combinado no convênio definem só o preço do serviço. Preço fechado = (1) valor combinado na linha 🔁 + (2) Pacote marcado na linha do serviço + (3) "Zerar valor em pacotes" em cada item incluso (abas Produtos, Taxas ou Serviços do convênio). Item sem "Zerar" continua cobrado à parte; sem Pacote, o "Zerar" dos itens nem é consultado. Sintoma típico: "digitei um valor e os itens continuaram somando" → marque Pacote.
Coluna Valor do serviço com 4 linhas — nova linha Σ ✅ em produção desde 24/09: 🔒 preço da casa (em serviço que soma itens, a soma dos itens a preço de casa, com a etiqueta "(soma dos itens)"); 🔁 valor combinado com este convênio; ✅ valor do próprio serviço que vai na guia; Σ total do serviço neste convênio = serviço + produtos, taxas e subserviços que entram na conta — o que o convênio paga e o mesmo número da receita do Farol. Em serviço que soma itens sem valor combinado, a linha ✅ mostra "0,00 (sem preço próprio: itens cobrados à parte)" — não é erro (caso real: "Ferinject aplicado" no convênio Particular, com "Definir preço do serviço pelos itens" marcado). Passar o mouse em cada linha explica o que ela é — 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, taxas e a coluna Tipo de Atendimento seguem com 3 linhas.
Textos e valores finais convertidos (✅ em produção desde 24/09): nome, descrição, código, tabela 87 e valores aparecem já convertidos em todas as telas do convênio — nível 3 (o item no convênio) → nível 2 (política do convênio, só para preço de produto) → catálogo.
Aba Farol › Itens (✅ 24/09): cada linha reflete só ela — valor efetivamente considerado (zero quando fica fora), custo, receita, margem e farol da própria linha; a linha do serviço traz o total do serviço e o subserviço, o total do que está dentro dele; coluna "Conta no total" (Sim/Não). A sub-aba Farol › Serviços, que mostrava "0 registros", foi corrigida.
Expandir serviço (#625 — concluído em 25/09/2026) ✅ Novo — 26/09/2026: na aba Serviços do convênio, a seta da linha abre (sob demanda) a árvore do serviço naquele convênio, como sai na guia. Colunas do painel: Farol · Item tipo (Serviço/Subserviço/Produto/Taxa) · Item nome · Tipo código · Código · Tabela 87 · Zerar valor · Somar itens · Conta no total · Utiliza · Motivo · Unidade de medida · Quantidade · Custo unitário · Receita unitária · Custo total · Receita. Item que não entra na cobrança aparece esmaecido e o Motivo diz por quê: "Convênio não utiliza", "Zerado em pacote" ou "Subserviço pai fora do total". Cada linha tem o próprio farol; a linha do subserviço mostra o total da sua subárvore. Os números são os mesmos da aba Farol › Itens e da bolinha do Farol (mesma fonte, nunca recalculados na tela); editou um valor na lista, os painéis abertos recarregam sozinhos. Uso prático: responder "por que este serviço está vermelho?" sem filtrar milhares de linhas na aba Farol › Itens. Também ficou mais rápido (carregamento sob demanda e cache das listas).
Criar vínculo marcando só "Pacote" não liga mais "Zerar valor" sozinho ✅ Novo — 26/09/2026 (correção de 25/09/2026): Pacote e Zerar são marcações independentes — marque o Zerar em cada item incluso.

🌳 Na dúvida se um item entra ou não entra, siga a Árvore de decisão de preços.

💰 Preços e Conversão de Valores: toda a lógica de conversão de valores do convênio, as 3 linhas do item (a coluna Valor do serviço tem a 4ª linha Σ — ✅ em produção desde 24/09) e o modo pacote (marcação por convênio) estão explicados na área dedicada Preços e Conversão de Valores.

Subaba Faturamento do convênio (envio sem XML, #687) ✅ Novo — 23/10/2026

No convênio, a subaba Faturamento define a forma de envio (XML, Portal ou Papel), o intermediador (associação ou cooperativa, quando houver), o endereço do portal e a periodicidade (ex.: quinzenal). Para convênio que não recebe XML, o lote fechado ganha o botão Envio sem XML (ver a lição de Faturamento). Lembre: alterar convênio começa por Liberar para edição. Desde 15–22/10 o token do convênio só é exigido no Acolhimento.

Especialidades do convênio (coluna Atende)

Na aba Especialidades do convênio a coluna Atende indica quais especialidades o convênio cobre (o código CBOS de cada especialidade vem do cadastro da especialidade e é usado nas guias). ✅ Novo — 29/09/2026 Correção de 29/09/2026: hoje (produção) a marcação Atende não tem efeito no agendamento, no orçamento e na autorização — o sistema deixa escolher qualquer profissional e qualquer serviço para o convênio (esta lição dizia antes que só os credenciados apareciam).

✅ Atualização 13/10: 🟡 Parcial a trava (#628) entrou em produção em 01–05/10 e foi desligada temporariamente em 06/10/2026 no agendamento e no orçamento — lá, hoje, não há filtro nem bloqueio. 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. No cadastro do convênio ela vale: na aba Serviços, serviço de especialidade não atendida aparece com a caixa desabilitada e o chip "Não atendida" (ou "Não agenda", se já estava marcado) — não dá para marcar Utiliza; "Selecionar todos" pula esses serviços; Copiar e Importar Excel os trazem desmarcados; a aba Colaboradores só aceita especialidade atendida. Atenção: os textos dessas telas dizem que os serviços "não poderão ser agendados" — hoje o agendamento não barra. Convênio sem nenhuma especialidade marcada como Atende não restringe nada.

🟠 Roadmap #628 (Sprint 12) — a marcação Atende passa a valer: depois de escolher o convênio, agendamento, orçamento e autorização só vão mostrar os profissionais, as especialidades e os serviços das especialidades que o convênio atende; na aba Serviços do convênio, os demais ficarão sombreados e sem edição. Ainda não está em produção. Recomendação desde já: revise a aba Especialidades de todos os convênios — convênio com especialidade faltando vai deixar de mostrar profissionais e serviços quando a mudança entrar. ✅ Atualização 13/10: ver o parágrafo acima — a parte da aba Serviços entrou; o filtro no agendamento está desligado temporariamente.

Custos extras do convênio e Serviços extras (#655) ✅ Novo — 12/10/2026

Em produção desde 12/10/2026 — alimentam o Farol (é projeção: não gera lançamento, não altera DRE, repasse pago, guia nem XML).

Aba "Custos extras" (10ª aba do convênio, com histórico próprio; obedece ao modo consulta e grava na hora, fora do Salvar): botão Novo custo extra com Descrição, Tipo (Percentual da receita ou Valor fixo por execução), Percentual (%) ou Valor (R$), Incide sobre (Tudo / Só serviços / Só produtos / Só taxas / Serviços específicos), Credor (fornecedor) — opcional, Grupo do DRE ("Só classificação; não gera lançamento") e vigência (vazio = "Sempre"). O percentual incide sobre a receita de cada linha (5% por linha = 5% da guia); o valor fixo é por execução × quantidade × sessões.
Painel "Serviços extras" (prestadores terceiros): ao expandir a linha do serviço na aba Serviços — Prestador (cadastro de Fornecedor), Descrição, Valor fixo por execução, quantidade e Vigência. O do convênio sobrescreve o geral.
Farol: custo = produtos + custo extra do convênio + prestadores + repasse do profissional (sem profissional definido: o maior repasse entre quem atende). Sem cor só com custo total 0; roxo = produto com custo 0; no limite do vermelho = amarelo.
Bloqueio opcional: em Parâmetros › Orçamento, "Custos extras (convênio, prestadores e repasse) também bloqueiam" vem desmarcado; antes de ligar, rode "Ver serviços que mudam de cor".
Fornecedor em uso em custo extra ou prestador ativo não pode ser excluído nem inativado. O Copiar convênio leva os prestadores e há cópia própria para os custos extras.

Referências oficiais por tipo de produto no convênio (#662, 1ª fase) ✅ Novo — 15/10/2026

Em Convênio › Dados do convênio, abaixo da Política de preço, o bloco "Referências oficiais por tipo de produto (código, descrição e preço)": por tipo de produto, a publicação do código (e se usa a descrição oficial), a publicação do preço, o tipo de preço (PF, PMC…), a Alíquota ICMS %, o ajuste % e a tabela TISS (87) opcional; há simulação de um produto. O botão "Salvar referências" respeita o Liberar para edição. É o nível 2 da conversão: entre o item do convênio e a política de preço/cadastro — sem política de referência no convênio, nada muda. Cuidado do código: o XML descarta itens das tabelas 05 e 12 — na política, use 20 (medicamentos) ou 19 (materiais). Hoje a carga de preços por planilha está fora da tela (escondida em 15/10) — o preço do nível 2 ainda não tem como ser carregado pela tela; confirme com o time Rabi antes de contar com ele. Detalhes na lição de Estoque e em Preços e Conversão de Valores.

Tabela de Preços Internos

Preço de venda de PRODUTOS (corrigido em 24/09/2026 — a tabela interna não guarda o preço da consulta particular). Cada tabela tem até 3 preços por produto (Preço 1/2/3); se a tabela não tem o produto, vale o preço de venda do cadastro do produto. Na ordem de implantação, entra depois de Taxas, Produtos e Serviços e antes dos Convênios. Rota: /portal/configuracoes/tabela-precos-internos.

Acesse Configurações → Tabela de Preços Internos.
Crie (ou abra) a tabela e localize o produto (vindo do catálogo de Produtos).
Informe os preços do produto (Preço 1, 2 e/ou 3).
Salve. O convênio que usa a tabela interna como fonte de preço de produto passa a ler esses valores (com o Fator K do convênio, quando houver).

💡 E o preço do atendimento particular? Particular, no Rabi, é um convênio: crie o convênio "Particular" (operadora Particular, Pagamento no ato = Sim) e informe os preços dos serviços na aba Serviços dele (ex.: Consulta Cardiológica = R$ 350,00). É desse convênio que sai o valor do agendamento particular.

✅ Novo — jul/2026 A Tabela de Preços Internos ganhou filtros (#475). Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização. ✅ Novo — 09/10/2026 filtros por coluna (linha de filtros aberta por padrão) e ordenação por todas as colunas. Pela API, os preços em lote são em reais (#652) — confira os lotes carregados antes de 28/09/2026.

✅ em produção desde 28/09/2026 Filtros padrão (#396): as principais listas passaram a buscar e ordenar no servidor — a busca percorre toda a base filtrada, não só a página visível (antes esta lição dizia "roadmap").

Serviços e Procedimentos

Catálogo de tudo que a clínica realiza. Usados no agendamento, no prontuário e em todas as tabelas de preço. Rota: /portal/configuracoes/servicos.

ℹ️ Ordem de cadastro. Cadastre primeiro os Tipos de Serviço (Consulta, Exame, Cirurgia, Terapia, Procedimento) em /portal/configuracoes/servicos/tipos, pois cada serviço precisa estar vinculado a um tipo. Antes dos serviços já devem existir as taxas e o catálogo de produtos (serviço de medicamento aponta para o produto); e, entre os serviços, cadastre os subserviços antes dos serviços pais.

Cadastre os Tipos de Serviço.
Acesse Configurações → Serviços e clique em Novo Serviço.
Preencha nome (ex.: "Consulta Cardiológica"), tipo (ex.: Consulta) e código TUSS/próprio se aplicável.
Salve. O serviço aparece nas tabelas de preço e no agendamento.

✅ Novo — 26/09/2026 Aba Convênios do serviço (25/09/2026): no cadastro do serviço (Configurações › Serviços › [serviço] › aba Convênios), cada convênio agora mostra a coluna Farol (linha inteira colorida) e a linha ✅ efetiva — descrição, tipo de código, código, Tabela 87 e o valor que vai na guia —, igual à aba Serviços do convênio. A linha também expande a árvore do serviço naquele convênio (#625). É o caminho mais curto para ver, de uma vez, como um serviço sai em todos os convênios.

✅ em produção desde 28/09/2026 Pagamento parcial antecipado (#604): no cadastro do serviço, as opções "exige pagamento parcial", percentual mínimo e prazo da reserva. O agendamento desse serviço nasce "Pendente de Pagamento", segurando o horário; sem o pagamento, expira sozinho e libera o horário (e as reservas de medicamento; a vaga vai para a Fila de Espera). Vale na recepção e no agendamento online; o percentual incide sobre a sessão agendada, não sobre o pacote todo. Nesta versão a confirmação do pagamento é manual (um colaborador registra o valor recebido); o link de pagamento automático é o #409 🟠 Roadmap (Sprint 12, em andamento). ✅ Atualização 13/10: #409 na Sprint 14; desde 12/10 a confirmação do sinal exige Conta caixa e Forma de pagamento. ✅ Atualização 15/10: o link de pagamento Pix (#409) está em produção desde 13/10 — com provedor Pix ativo (Parâmetros › Pagamentos (links)), o Pix pago dá baixa e confirma o sinal sozinho; sem provedor, a confirmação segue manual.

⚠️ Antes de excluir ou inativar um produto ou uma taxa ✅ Novo — 26/09/2026: hoje (produção) a exclusão é livre — o item some da composição dos serviços sem aviso, e o serviço passa a ser agendado e faturado sem aquela receita (a taxa deixa de ser cobrada; o material sai da guia e do custo). Antes de excluir, confira em quais serviços o item está (expanda o serviço no convênio ou use a aba Farol › Itens) e substitua-o. O bloqueio automático — impedir excluir/inativar produto ou taxa que esteja na composição de serviço ativo, mostrando a lista de serviços (na tela e na API, erro 409) — é o #626, 🟠 Roadmap da Sprint 12 (atual).
✅ Atualização 13/10: bloqueio em produção desde 02/10: produto ou taxa na composição de serviço ativo não é excluído nem inativado — abre "Não é possível excluir" com a lista dos serviços (link para cada um); corrija a composição e tente de novo.

Tipos de Atendimento

Classificam a natureza da visita, usados no agendamento. Rota: /portal/configuracoes/tipo-atendimento. Exemplos: Primeira Consulta, Retorno (usa o prazo de retorno do convênio), Urgência, Telemedicina, Domiciliar.

Colaboradores e Especialidades (CBOS)

Profissionais de saúde e administrativos. Cada colaborador terá agenda própria e acesso ao sistema conforme as permissões. Rota: /portal/configuracoes/colaboradores.

Passo a passo

Acesse Configurações → Colaboradores e clique em Novo Colaborador.
Preencha Nome e E-mail (o e-mail é usado no acesso e deve ser único).
Selecione a Empresa Principal.
Clique em + Adicionar Especialidade e informe nome + código CBOS (ex.: Cardiologia → 225120). ✅ Novo — 23/10/2026 Para quem prescreve, preencha na especialidade o conselho, o número e a UF exatamente como no conselho (ex.: CRM/DF 12345) e informe o CPF do colaborador — são os dados que a Anvisa confere na numeração do SNCR. Para Talidomida, também o nº do cadastro do médico na talidomida. ✅ Novo — 26/10/2026 O SNCR só aceita prescritor com CRM, CRMV ou CRO: o Rabi usa a especialidade mais antiga do colaborador que tenha um desses conselhos (médico com mais de um CRM: vale a inscrição mais antiga). Com outro conselho, o médico vê "O SNCR só aceita prescritor de CRM, CRMV ou CRO. O conselho cadastrado na sua especialidade (X) não é aceito..." — corrija aqui, em Configurações → Colaboradores → Conselhos e Especialidades.
Opcional: foto (PNG/JPG). Salve.

Campos do formulário

#	Campo	Obrig.?	Descrição
1	Nome	Sim	Nome completo
2	Foto	Não	PNG/JPG
3	E-mail	Sim	Acesso ao sistema. Único
4	Empresa Principal	Sim	Onde atua principalmente
5	Especialidades	Sim	Uma ou mais, cada uma com CBOS
6	Pessoa de Contato	Não	Contato alternativo
7	CPF ✅ Novo — 23/10/2026	Para quem prescreve	A numeração do SNCR é do CPF do médico; sem CPF a receita controlada não sai.
8	Conselho, número e UF (na especialidade) ✅ Novo — 23/10/2026	Para quem prescreve	Iguais aos do conselho. Se faltar, o médico vê "Seu cadastro não tem conselho, número e UF do conselho…". ✅ Novo — 26/10/2026 Para o SNCR, só CRM, CRMV ou CRO (vale a especialidade mais antiga com um deles). Quem tem conselho + a ação Ver Valores (excepcional) pode aprovar orçamento (21/10).

✅ Novo — 23/10/2026 Ver o que o cadastro do médico precisa ter para as receitas.

✅ Novo — jul/2026 A tela do colaborador ganhou o campo Conselho (conselho profissional) (#513). Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

✅ Novo — 02/10/2026 Repasse geral do colaborador (#643) — Configurações › Colaboradores › (colaborador) › aba "Vínculo e Repasse", tabelas Serviços, Produtos e Taxas. Cada tabela tem uma primeira linha fixa (fundo cinza): "Todos os serviços" / "Todos os produtos" / "Todas as taxas" — "Repasse geral — vale para todos sem linha própria abaixo. Vazio = sem repasse geral." Campos: percentual (%), valor (R$), chave Maior / Menor e "Limpar repasse geral". As linhas de baixo são específicas e substituem a geral só para o item escolhido (específica com 0 e 0% = sem repasse naquele item). Sem geral nem específica, o tipo não gera repasse. O repasse de taxa passou a ser calculado, e a linha geral vale para atendimentos a partir de 01/10/2026. Não é mais preciso cadastrar o repasse item a item.

✅ Novo — out/2026 Usuário com e-mail que já tem acesso (#642): ao criar o usuário com um e-mail que já tem login no Rabi (ex.: em outra clínica), aparece "Este e-mail já possui acesso ao sistema (ex.: em outra clínica). O usuário foi vinculado a esta clínica e já pode acessar com a senha que já usa. A senha informada não foi aplicada e o cadastro dele não foi alterado." — vale a senha que a pessoa já usa (se esqueceu, "Esqueci minha senha" no login). Colaborador desativado é barrado na hora em qualquer ação ("Seu usuário está desativado nesta clínica. Procure o administrador do sistema.").

O que é o CBOS

O CBOS (Classificação Brasileira de Ocupações em Saúde) é um código numérico que identifica cada especialidade. É obrigatório para emissão de guias e faturamento de convênios. Exemplos: Clínica Geral 225125, Cardiologia 225120, Pediatria 225124, Ginecologia/Obstetrícia 225250, Fisioterapia 223605, Psicologia 251510, Nutrição 223710, Odontologia 223208.

⚠️ Colaborador não aparece na agenda? Verifique: (1) se foi salvo; (2) se tem ao menos uma especialidade; (3) se a empresa vinculada é a mesma do agendamento.

Grade horária: colaboradores (e equipamentos) possuem grade horária configurável, que define os horários disponíveis para agendamento. Monte a grade depois dos convênios: ela lista os convênios aceitos pelo profissional/equipamento.

🤖 Cadastro em dia para a IA (TalkMe) responder certo ✅ Novo — 30/09/2026. A consulta única de disponibilidade para a IA — responder numa consulta só se há profissional da especialidade, que faz o procedimento, com agenda liberada para o convênio (inclusive paciente com dois convênios); sem mostrar horários, que continuam vindo da agenda — é o #633 🟠 Roadmap (Sprint 12; ✅ Atualização 13/10: em produção desde 09/10/2026 — a IA já usa essa consulta). Vale desde já manter em dia:

no cadastro do profissional, Atende convênio marcado em cada convênio que ele atende;
na grade do profissional, os serviços cadastrados e os convênios configurados (Incluir/Excluir);
no convênio, Utiliza nos serviços cobertos e, se usar, Atende nas especialidades (clique em Liberar para edição para alterar);
o convênio ativo na unidade onde é atendido.

Faltando algo, a IA dirá que não há atendimento, mesmo que a recepção consiga agendar pela tela. Já em produção (correções de 30/09 no servidor): a IA confere a duração do serviço ao marcar (não sobrepõe agendamentos), só oferece especialidades por convênio quando existe grade que aceite o convênio, filtra horários pelo serviço pedido e recusa serviço inativo. ✅ Atualização 13/10: desde 09/10 o painel "Disponibilidade por Convênio" da Agenda segue a mesma regra da agenda interna e lista os convênios por unidade a partir de Unidades do convênio (a lista pode crescer bastante) — mantenha esse cadastro em dia. Não existe tela de "Catálogo de atendimento" (#659) — o catálogo considerar o Farol (#664) ✅ Atualização 15/10: entrou em produção em 14/10: a IA não oferece serviço que o Farol bloqueia ou que exige aprovação, e o painel Disponibilidade por Convênio, com convênio no filtro, esconde os bloqueados —, e a IA ainda não abre autorização nem orçamento (#660, roadmap).

✅ Novo — set/2026 Limite de agendamentos por convênio na grade — modo EXCLUIR: na grade do colaborador, o limite de agendamentos por convênio ganhou o modo EXCLUIR — além de limitar a quantidade, agora dá para excluir um convênio de determinados horários da grade. Também foram corrigidos o defeito em que o modo do convênio revertia sozinho ao salvar e a rolagem da seção de limite. Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

Equipamentos

Aparelhos médicos vinculáveis aos agendamentos para controle de disponibilidade (ecocardiograma, raio-X, ultrassom, etc.). Também possuem grade horária. Rota: /portal/configuracoes/equipamentos.

Acesse Configurações → Equipamentos e clique em Novo Equipamento.
Informe o nome (ex.: "Ultrassom GE Logic 5").
Selecione a unidade e salve.

🔗 Reserva na agenda. No agendamento, o campo "Equipamentos" vincula um ou mais aparelhos ao horário, evitando conflitos de uso.

Tipos de Documento, Impressão, Código, Taxas e Anexos

Tipos de Documento de Atendimento

Modelos de documentos clínicos emitidos no prontuário (atestado, receita simples, receita controlada — Portaria 344, encaminhamento, solicitação de exames, laudo, relatório). Rota: /portal/configuracoes/tiposDocumentoAtendimento. Cadastre nome + modelo (template); os dados de paciente/médico são preenchidos automaticamente.

Tipos de Impressão

Modelos de cabeçalho/rodapé para impressos (receitas, atestados, laudos) com logo e dados da clínica/profissional. Rota: /portal/configuracoes/tipo-impressao.

Tipos de Código

Padrões de codificação no faturamento: TUSS (Terminologia Unificada da Saúde Suplementar — maioria dos convênios ANS), CBHPM (convênios médicos tradicionais) e código próprio da operadora. Rota: /portal/configuracoes/tipos-de-codigo.

Taxas e Tipos de Taxa

Encargos administrativos cobrados em serviços (taxa de sala, de material, de guia). Tipos em /portal/configuracoes/taxas/tipos e valores em /portal/configuracoes/taxas. Na implantação, cadastre as taxas cedo — antes dos convênios e da tabela de preços internos, que dependem delas. Cuidado ao excluir ou inativar uma taxa: hoje a exclusão é livre e o serviço que a usa deixa de cobrá-la sem aviso — veja o alerta na seção Serviços (bloqueio automático = #626, roadmap). ✅ Atualização 13/10: bloqueio em produção desde 02/10 (taxa em uso: "Esta taxa está em uso … não pode ser excluída").

Tipos de Anexos

Categorias de anexos usadas em pacientes/atendimentos. Cadastro auxiliar de configuração.

Tipos de Pagamento e Categorias

Define como o paciente paga (Tipo: PIX, Dinheiro, Cartão de Crédito/Débito, Transferência, Cheque) e para que os lançamentos são classificados (Categoria: Consulta, Exame, Material, Salário, Aluguel). Rotas: /portal/financeiro/tipos-de-pagamento e /portal/financeiro/categorias-de-pagamento (menu Financeiro). Ambos alimentam os dropdowns dos registros financeiros. ✅ Novo — 12/10/2026 Tipos de Pagamento ganhou a coluna "Comprovação" (Automática / Dinheiro / Pix / Cartão / Transferência / Não exige comprovação), usada pelo controle de caixa e pelos comprovantes (#650).

Parâmetros do Sistema (e a chave da API externa)

Configurações globais que controlam o comportamento do sistema para toda a clínica (horário de funcionamento, duração padrão de consulta, notificações, integrações). Rota: /portal/configuracoes/parametros. A aba Valores guarda a régua do Farol (Parâmetro Vermelho (%) e Parâmetro Amarelo (%)) — ajuste-a antes da conferência pelo Farol; os demais parâmetros ficam para o fim da implantação.

🔌 API externa e chaves de integração (atualizado 24/09/2026): a API externa permite implantar/migrar a clínica por sistema externo ou por IA, na mesma ordem desta lição. ✅ Novo — 30/09/2026 Caminho recomendado (decisão de 30/09/2026): o token rbt_ da própria clínica, tipo "Implantação e manutenção", gerado em Configurações › Parâmetros › Integrações só com as permissões da implantação (quadro abaixo, com os cuidados) — é o que o kit de Implantação com IA passa a usar. Alternativa: a chave rbk_ (Bearer rbk_..., por clínica, com permissões por rota e validade — exibida uma única vez) emitida pelo time Rabi no portal comercial — continua valendo para quem já tem. Na rbk_, a validade vem em toda resposta no cabeçalho X-ApiKey-Expires-At e a chave nova é pedida ao time Rabi antes de vencer; o token rbt_ a própria clínica renova ou revoga.
✅ Novo — 29/09/2026 Correção geral da API em 28/09/2026 (17:43): campo opcional omitido não derruba mais a rota, e foram corrigidas gravações erradas sem aviso. Quem gravou pela API antes dessa data 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. Mudanças de contrato (ex.: taxas do serviço em servicoTaxa; lote obrigatório na saída/transferência de estoque) estão na página da API externa.

✅ Novo — out/2026 Parâmetros novos de outubro: Parâmetros › Financeiro › "Caixa por atendente" — Controle de caixa (Desligado / Aviso / Bloqueio; nasce Desligado; comece em Aviso), Tolerância de diferença no fechamento (R$), hora de fim de expediente, e-mail diário aos líderes e a "Conta Padrão de Recebimento de Convênios" (#650); Parâmetros › Orçamento — "Custos extras (convênio, prestadores e repasse) também bloqueiam" (desmarcado) e "Ver serviços que mudam de cor" (#655); Parâmetros › Notificações — avisos novos do financeiro, ligados por padrão. API externa: desde 01–02/10 o PUT parcial é a regra — campo omitido mantém, null limpa, lista omitida mantém e lista enviada substitui (o defeito "gravar pela API apaga dados não enviados", #634, foi corrigido); o erro 403 traz escopoFaltante e onde liberar a permissão.

✅ em produção desde 28/09/2026 Tokens de integração da clínica (#624) e habilitação da TalkMe (#597). Em Configurações › Parâmetros › Integrações, a própria clínica gera, vê, renova e revoga tokens rbt_…: o valor aparece uma única vez, a validade é opcional, tudo é auditado e há limite de requisições (erro 429). Dois tipos: TalkMe (IA) — acesso fixo à API TalkMe da clínica — e Implantação e manutenção — API externa (/api/v1/integrations/*) só com as permissões escolhidas, o mesmo catálogo da chave rbk_. No mesmo lugar, a clínica habilita a integração TalkMe; sem habilitação, a TalkMe recebe 403 e não lê dados de outra clínica. A chave rbk_ do portal comercial continua valendo.
🔐 Cuidados com o token: ele aparece uma única vez — guarde em local seguro; nunca cole o token 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.
✅ Novo — 02/10/2026 Editar permissões e Renovar (#653): no token de implantação ativo, a ação "Editar permissões" abre a matriz pré-marcada (não salva vazia) — o valor do token não muda e a alteração vale na chamada seguinte (token TalkMe não tem essa ação); o Renovar abre o mesmo diálogo para revisar permissões e validade (sem alteração, herda as permissões). O token rbt_ também envia o cabeçalho X-ApiKey-Expires-At. Não é mais preciso gerar outro token para ganhar permissão.

✅ Novo — 15/10/2026 Parâmetros novos de 13–15/10: aba "Pagamentos (links)" (#409, em produção desde 13/10) — cadastro dos provedores com que a clínica cobra por link (só um ativo por vez; botões Novo provedor, Desligar links, Testar conexão, Cadastrar aviso e Histórico de vigência). Tipo disponível: "Pix — API padrão Banco Central (qualquer banco)", com banco, URLs da API Pix e do token, escopos, chave Pix da clínica, validade do link (padrão 1440 min = 24 h), Client ID/secret, certificado do banco, conta caixa onde o dinheiro cai e forma de pagamento da baixa. É preciso contratar a API Pix com o banco (ele fornece certificado e credenciais) — nunca coloque essas credenciais em documento, chamado ou conversa. Sem provedor ativo, "Nenhum provedor ativo: os links de pagamento estão desligados." Na aba "Registro Financeiro", o bloco "Conciliação bancária" traz a caixa "Conciliação bancária automática (Open Finance) — módulo adicional, cobrado por conta conectada" 🟡 Chegando: nasce desmarcada e depende de o time Rabi ativar o agregador — até lá, a conciliação é pelo arquivo OFX. Em Parâmetros › Notificações, novo aviso "Extrato bancário e Open Finance". E o menu Configurações ganhou "Log de erros" (só administrador — não é permissão de perfil): os erros da clínica com o código de rastreio (o mesmo do "(código XXXX)" da mensagem) e os dados enviados, com os sensíveis mascarados; e "Log de integração TISS".

⚠️ Configuração sensível. Parâmetros afetam toda a aplicação. Altere apenas como administrador e, de preferência, com suporte da equipe Rabi durante a implantação.

Usuários e Permissões

Onde fica: o login e o perfil de cada pessoa ficam no cadastro do colaborador — Configurações → Colaboradores (/portal/configuracoes/colaboradores/:id/editar → atribuir perfis). O acesso é controlado por grupos de permissão (módulos) com níveis de ação. Modelo em produção: papel (Role) + 4 ações fixas por módulo.

✅ Novo — 01/10/2026 Salvar o perfil aplica a todos (#636): ao salvar um perfil, a alteração vale para todos os colaboradores ativos daquele perfil ("Alteração aplicada a N usuário(s)"); o perfil guarda também as ações elevadas (EDIT_ALHEIO/CANCELAR/EXCLUIR), e as ações elevadas dadas individualmente a um usuário são preservadas. Salvar as permissões de um colaborador muda só ele. Não é mais preciso abrir e salvar cada colaborador. Desde 12/10 há 9 ações novas em CONTAS CAIXAS que ninguém recebe sozinho (ver a lição de Financeiro).

✅ Novo — 15/10/2026 Segurança de usuários (#663/#666, 13–14/10): colaborador que também tem acesso a outra clínica só troca senha e e-mail ele mesmo — o administrador recebe "Este usuário também tem acesso a outra clínica. A senha e o e-mail só podem ser trocados por ele mesmo ("Esqueci minha senha" na tela de login)."; pelo cadastro, só se vincula o usuário à clínica atual. A busca de e-mail existente é exata. Só administrador altera a lista de administradores. Removido de uma clínica, o usuário volta sozinho para a clínica do login. Permissão passou a valer no servidor em rotas que estavam abertas (ex.: salvar glosa exige GLOSAS UPDATE; editar XML exige UPDATE em Administrar Lote ou Faturamento). Atenção: o "negar por padrão" (#667) não entrou — colaborador sem nenhuma configuração num módulo ainda vê as telas dele (só leitura). Antes dessa mudança chegar, confira se o perfil de cada colaborador tem os módulos que ele usa (inclusive aprovações pelo app).

Níveis de ação

Nível	O que permite
NONE	Sem acesso — não vê nem acessa o módulo
VIEW	Apenas visualizar
CREATE	VIEW + criar registros
UPDATE	VIEW + CREATE + editar
DELETE	VIEW + CREATE + UPDATE + excluir

✅ Novo — 23/10/2026 Lista de permissões redesenhada (15–16/10/2026): a tela agora tem busca e os níveis aparecem com nomes simples — Sem Permissão / Visualizar / Criar / Editar / Total (correspondem a NONE / VIEW / CREATE / UPDATE / DELETE da tabela acima). Nova ação Ver Valores (excepcional): para colaborador com conselho; quem tem conselho + Ver Valores pode aprovar orçamento (21/10). Dê com cautela. Também no próximo login o sistema pode pedir para a pessoa atualizar o perfil/senha.

Ordem: NONE < VIEW < CREATE < UPDATE < DELETE (na tela: Sem Permissão < Visualizar < Criar < Editar < Total). Grupos: AGENDAMENTO, ATENDIMENTO, PACIENTES, FINANCEIRO, FATURAMENTO, CONFIGURACOES, ESTOQUE, RELATORIOS, DASHBOARD.

✅ Novo — ago/2026 Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização: sessão única (#482) — o sistema não permite mais o acesso do mesmo usuário em 2 locais ao mesmo tempo — e revisão da área de permissões (#512): a permissão configurada agora reflete exatamente o que o usuário pode fazer.

Perfis recomendados

Função	Grupos	Nível
Administrador	Todos	DELETE (total)
Recepcionista	AGENDAMENTO, PACIENTES, DASHBOARD	UPDATE
Médico	ATENDIMENTO, AGENDAMENTO, PACIENTES	ATENDIMENTO: CREATE; demais VIEW
Financeiro	FINANCEIRO, FATURAMENTO, RELATORIOS, DASHBOARD	UPDATE / VIEW
Gestor	Todos exceto CONFIGURACOES	VIEW

🟢 ENTREGUE (GitLab #395, 15/09/2026) ✅ Novo — set/2026. As permissões granulares entraram em produção: além da base Role + 4 ações por módulo descrita acima, o administrador passa a configurar permissões finas por funcionalidade/ação (ver a lição de Segurança). Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

Erros comuns e como resolver

Sintoma	Causa provável	Solução
Não consigo criar convênio	Operadora não cadastrada	Cadastre a operadora antes
Colaborador não aparece na agenda	Sem especialidade / empresa divergente	Adicione especialidade e confira a empresa
Não consigo alterar o convênio / aparece "Modo consulta: nada foi gravado"	Desde 29/09/2026 o convênio existente abre em modo consulta (#632)	Clique em Liberar para edição e refaça a alteração (vale só nesta visita)
O botão Liberar para edição não resolve / "Você não tem permissão para alterar convênios"	Usuário sem permissão de alterar convênio (só consulta)	Peça a alteração a quem tem a permissão ou ajuste o perfil do colaborador
"Aguarde o carregamento dos dados do convênio antes de salvar"	Os dados do convênio ainda não carregaram (ou falharam)	Espere carregar; se aparecer "Não foi possível carregar os dados do convênio", recarregue a página (volta ao modo consulta) e libere de novo
Local não aparece no agendamento	Não vinculado à unidade / não salvo	Verifique unidade e salve o local
Não consigo salvar o local	Unidade sem depósito ativo (depósito padrão de saída obrigatório)	Crie o depósito mínimo da unidade (etapa 2) e salve o local de novo
Serviço de medicamento não encontra o produto na composição	Catálogo de produtos cadastrado depois dos serviços	Cadastre o produto e volte à composição do serviço
Aba Taxas do convênio / tabela interna sem as taxas	Taxas cadastradas depois dos convênios	Cadastre as taxas (etapa 5) e complete as abas
Serviço não pode ser criado	Tipo de Serviço inexistente	Cadastre o Tipo de Serviço antes
Valor não aparece no agendamento particular	Preço não definido no convênio Particular (ou convênio Particular inexistente)	Cadastre o valor do serviço na aba Serviços do convênio Particular (a Tabela de Preços Internos é preço de produto)
Convênio não aparece na grade do colaborador	Grade montada antes do convênio existir	Crie o convênio e volte à grade para marcá-lo como aceito
Digitei o valor combinado do serviço e os itens continuaram somando por cima	Valor combinado não é pacote — ele muda só o preço do serviço	Marque Pacote na linha do serviço (aba Serviços do convênio) e "Zerar valor em pacotes" em cada item incluso
Excluí um produto ou uma taxa e o serviço passou a sair mais barato / sem o material na guia	Hoje a exclusão é livre: o item sai da composição sem aviso (bloqueio automático = #626, roadmap) — ✅ Atualização 13/10: até 01/10; desde 02/10 a exclusão de item em uso é bloqueada	Antes de excluir, expanda o serviço no convênio ou use a aba Farol › Itens para ver onde o item está e substitua-o na composição
Alterei a aba do convênio, saí e a alteração sumiu ✅ Novo — 01/10/2026	Desde 01/10 as abas Planos, Especialidades, Produtos, Serviços e Taxas só gravam no Salvar do cabeçalho	Liberar para edição → alterar → Salvar. Confira a mensagem "N alteração(ões) das abas gravada(s)"
"Há alterações não salvas no convênio. Clique em Salvar (ou descarte em "Bloquear edição") antes de usar esta ação." ✅ Novo — 01/10/2026	Tentou uma ação em massa (Selecionar todos, Copiar, Importar) com pendências	Salve (ou descarte) antes; as ações em massa gravam na hora
"Este registro foi alterado por outra pessoa. Recarregue a tela antes de alterar." ✅ Novo — 02/10/2026	Outra pessoa gravou depois que a sua tela abriu (#640)	Recarregue, confira pelo botão Histórico o que mudou e refaça
Usei "Selecionar todos" na coluna Retorno/Autorização/Pacote e mudou o Utiliza ✅ Novo — 13/10/2026	A ação em massa da aba Serviços só alterna o Utiliza (#639, parcial)	Não use a ação em massa nessas colunas; marque item a item e Salve
"Este e-mail já possui acesso ao sistema…" ao criar usuário ✅ Novo — out/2026	O e-mail já tem login no Rabi (#642)	Normal: o usuário foi vinculado e entra com a senha que já usa
Marquei "Pacote" e os itens continuaram cobrados	Pacote não liga o "Zerar valor" sozinho (desde 25/09)	Marque "Zerar valor em pacotes" em cada item incluso
Linha ✅ do serviço mostra R$ 0,00 (ex.: "Ferinject aplicado" no Particular)	Serviço que soma itens, sem valor combinado: ele não tem preço próprio — os itens são cobrados à parte	Não é erro. Confira o total pela linha Σ da coluna Valor (em produção desde 24/09) ou pela aba Farol › Itens
"Este usuário também tem acesso a outra clínica. A senha e o e-mail só podem ser trocados por ele mesmo…" ✅ Novo — 15/10/2026	O colaborador trabalha em mais de uma clínica (#663)	Ele mesmo troca pelo "Esqueci minha senha" na tela de login
"Apenas planilhas Excel (.xlsx ou .xls) são permitidas." / "A planilha deve ter no máximo 10MB." ✅ Novo — 15/10/2026	Importação de produtos/taxas do convênio ou fonte de preço com outro formato ou arquivo grande	Salve como .xlsx/.xls, até 10 MB, um arquivo por vez
A aba Integração TISS não aparece na operadora ✅ Novo — 15/10/2026	Ela só aparece na edição (operadora já salva)	Salve a operadora e abra de novo para editar
Não encontro como carregar os preços das referências oficiais ✅ Novo — 15/10/2026	A importação por planilha foi escondida em 15/10 (#662, 1ª fase)	Cadastre códigos e descrições e a política por convênio; para preços, confirme com o time Rabi

Pontos-chave

Configurações são a fundação: sem elas, nenhum módulo funciona.
Respeite a ordem (corrigida em 24/09/2026): Empresa → Depósito mínimo → Locais → 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.
Operadora ≠ Convênio: operadora é a empresa; convênio é o plano.
O CBOS é obrigatório para faturamento. A marcação Atende da aba Especialidades do convênio hoje não tem efeito no agendamento/orçamento/autorização; passa a limitar profissionais, especialidades e serviços com o #628 (roadmap S12) — revise a aba em todos os convênios desde já. ✅ Atualização 13/10: no cadastro do convênio a marcação já vale (aba Serviços: "Não atendida"/"Não agenda"); no agendamento/orçamento a trava está desligada temporariamente desde 06/10; a consulta de disponibilidade da IA (TalkMe, #633) é a exceção e respeita a coluna Atende.
✅ Desde 29/09/2026 (#632) o convênio existente abre em modo consulta (vê tudo, expande, vê o Farol, exporta; nada é gravado). Para alterar: Liberar para edição — vale só nesta visita (sair, trocar de convênio ou recarregar volta ao modo consulta). Convênio recém-criado abre liberado; sem permissão, só consulta.
A tabela de preço do convênio tem 4 métodos (importar/manual/copiar/exportar Excel).
Permissões: base Role + 4 ações (VIEW/CREATE/UPDATE/DELETE) e, desde set/2026, permissões granulares (#395) em produção — permissões finas por funcionalidade/ação.
Ciclo de julho/2026 entregou: farol de resultado no convênio (#390/#434/#339), valor por conversão na linha (#473), desativar convênio com vinculados (#455), sub-aba Colaboradores (#429), campo Conselho do colaborador (#513), logo por clínica (#503) e filtros na Tabela de Preços Internos (#475).
Ciclo de agosto/2026 entregou: visão geral do farol/cruzamentos (#435), farol roxo para erro de preço (#545), sessão única (#482), revisão da área de permissões (#512) e subabas Produtos/Serviços/Taxas do convênio com filtro e ordenação por utilização (#583).
Ciclo de setembro/2026 entregou: modo EXCLUIR no limite de agendamentos por convênio na grade do colaborador (com correção do modo que revertia ao salvar e da rolagem), os códigos Brasindice (05), SIMPRO (12) e Taxa Própria (97) no domínio de tabela 87 do convênio, a correção do campo Política de Preço que exibia "null" (#615) e a padronização dos cadastros estruturais — maiúsculas, sem acentuação (#606).
Desde 23/09/2026 (regras finais de preço): 0,00 é preço zero e vazio desce de nível (use Limpar valor para "sem preço combinado"); a aba Serviços tem a coluna Tipo de Atendimento em 3 linhas (🔒/🔁/✅ — o efetivo vai ao tipoAtendimento do XML); Utiliza = o convênio cobre (sem Utiliza: custo sem receita); Zerar em pacotes é por item e só em pacote de preço fechado; e a 1ª linha das abas recebe a cor do Farol.
Desde 23–24/09/2026 (série de preços completa em produção): itens sempre entram ("somar itens" decide só o valor próprio do serviço); preço fixo sem Pacote cobra os itens; para embutir, Pacote + Zerar nos itens; Zerar por item, sem cascata; textos finais convertidos; conferência pela aba Farol › Itens e pela seta de expandir o serviço.
✅ Desde 25/09/2026: expandir serviço (#625) concluído — nas duas telas (aba Serviços do convênio e aba Convênios do serviço), com farol por linha, itens fora da cobrança esmaecidos e a coluna Motivo; mesmos números do Farol. Marcar só "Pacote" não liga o "Zerar" sozinho.
✅ Novo — 02/10/2026 Produto ou taxa em uso não é excluído (#626): o sistema bloqueia e lista os serviços com link. (Até 01/10 a exclusão era livre.)
✅ Em produção desde 28/09/2026: tokens de integração rbt_ gerados pela clínica em Parâmetros › Integrações (#624 — aparecem uma vez; nunca colar em documento, chamado, e-mail ou conversa com IA salva; vazou → revogue), habilitação da TalkMe por clínica (#597), pagamento parcial antecipado no cadastro do serviço (#604) e filtros padrão no servidor (#396). Desde 30/09/2026 o token rbt_ "Implantação e manutenção" é o caminho recomendado para implantar por API/IA; a chave rbk_ do time Rabi continua valendo como alternativa.
✅ Novo — 09/10/2026 #633 (em produção desde 09/10): consulta única de disponibilidade para a IA (TalkMe). Desde já, mantenha em dia Atende convênio no profissional, serviços/convênios na grade, Utiliza/Atende no convênio e convênio ativo na unidade — senão a IA diz que não há atendimento.
Valor combinado NÃO é pacote (regra vigente): a linha 🔁 muda só o preço do serviço e os itens continuam somando por cima. Pacote é marcação por convênio (não existe no catálogo). Preço fechado = valor combinado + Pacote na linha do serviço + Zerar nos itens inclusos; sem Pacote, o Zerar nem é consultado.
✅ Em produção desde 24/09: a coluna Valor do serviço tem a 4ª linha Σ (total do serviço no convênio = receita do Farol); em serviço que soma itens sem valor combinado, o ✅ "0,00 (sem preço próprio: itens cobrados à parte)" não é erro (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, taxas e Tipo de Atendimento seguem com 3 linhas.
✅ Novo — 01/10/2026 Convênio: Liberar para edição → alterar → Salvar (as abas só gravam no Salvar do cabeçalho; ações em massa gravam na hora); botão Histórico por subaba (#638); "alterado por outra pessoa" (#640). Não usar "Selecionar todos" em Retorno/Autorização/Pacote nem o "Copiar convênio". Novos: aba Custos extras e painel Serviços extras (#655, Farol com repasse), repasse geral do colaborador (#643), conta de recebimento do convênio e controle de caixa nos Parâmetros (#650), salvar o perfil aplica a todos (#636), tokens com Editar permissões/Renovar (#653), API com PUT parcial.
✅ Novo — 23/10/2026 Permissões com nomes novos na tela (Sem Permissão / Visualizar / Criar / Editar / Total, com busca) e a ação Ver Valores (excepcional) (conselho + Ver Valores aprova orçamento). Colaborador que prescreve precisa de CPF e de conselho, número e UF na especialidade (receitas/SNCR) — ✅ Novo — 26/10/2026 para o SNCR, conselho CRM, CRMV ou CRO (vale a especialidade mais antiga com um deles). Convênio ganhou a subaba Faturamento (forma de envio XML/Portal/Papel).
✅ Novo — 15/10/2026 Desde 13–15/10: aba Integração TISS na operadora (#619 — opcional; habilita o "Verificar elegibilidade"; permissões TISS_INTEGRACAO e TISS_ELEGIBILIDADE), aba Pagamentos (links) nos Parâmetros (#409 — provedor Pix contratado pela clínica, um ativo por vez), Referências oficiais por tipo de produto no convênio (#662, 1ª fase — carga de preços pela tela ainda indisponível), Log de erros só para administrador, Open Finance como módulo adicional que nasce desligado (#651), troca de senha/e-mail de quem tem outra clínica só pelo próprio usuário (#663) e planilhas só .xlsx/.xls até 10 MB. O "negar por padrão" (#667) não entrou.

O que a prova vai cobrar

A ordem correta de configuração e por que operadora vem antes de convênio — e as dependências corrigidas em 24/09: depósito mínimo antes dos locais, catálogo de produtos antes dos serviços, taxas antes dos convênios e da tabela interna.
Diferença entre operadora e convênio, e o papel da aba CBOS no credenciamento.
Métodos de montar a tabela de preços do convênio (inclusive o convênio Particular, fonte do preço do particular) e o papel da tabela de preços internos (preço de produto).
Onde o CBOS é obrigatório e o efeito de faltar especialidade no colaborador — e que a marcação Atende do convênio ainda não filtra o agendamento (✅ Atualização 13/10: a trava do #628 está desligada no agendamento desde 06/10; no cadastro do convênio ela vale).
O modelo de permissões: base Role + 4 ações e as permissões granulares (#395), entregues em set/2026.
Que valor combinado não é pacote: para um preço fechado que já inclui itens é preciso marcar Pacote na linha do serviço no convênio e Zerar nos itens inclusos — e que pacote não existe no cadastro do serviço (catálogo).
Ler a coluna Valor do serviço: ✅ = valor do próprio serviço na guia (0,00 em serviço que soma itens sem valor combinado não é erro) e Σ = total do serviço no convênio, igual à receita do Farol.
Usar o expandir serviço (#625) para descobrir por que um serviço está vermelho: cada item com o próprio farol e o Motivo de quem fica fora ("Convênio não utiliza", "Zerado em pacote", "Subserviço pai fora do total").
Saber que, desde 02/10/2026, produto/taxa em uso não pode ser excluído (#626) e que, desde 28/09/2026, a clínica gera os próprios tokens rbt_ (#624) em Parâmetros › Integrações — caminho recomendado para a implantação por API/IA (tipo "Implantação e manutenção"), com os cuidados (aparece uma vez; nunca colar em documento/chamado/e-mail/conversa com IA salva; revogar se vazar) — enquanto a chave rbk_ do time Rabi continua valendo como alternativa.
O modo consulta do convênio (#632, em produção desde 29/09/2026): o convênio existente abre só para consulta; para alterar, Liberar para edição (vale só nesta visita); convênio recém-criado abre liberado; usuário sem permissão só consulta.
O que manter em dia para a IA (TalkMe) oferecer atendimento certo: Atende convênio no cadastro do profissional, serviços e convênios na grade, Utiliza/Atende no convênio e convênio ativo na unidade.
✅ Novo — 01/10/2026 A sequência para alterar um convênio (Liberar para edição → alterar → Salvar no cabeçalho), quais ações gravam na hora (em massa), onde fica o Histórico por subaba; e que salvar um perfil aplica a alteração a todos os colaboradores dele.
✅ Novo — 12/10/2026 O que a aba Custos extras e o painel Serviços extras somam ao custo do Farol (com o repasse) e onde se configura o repasse geral do colaborador (aba Vínculo e Repasse: "Todos os serviços/produtos/taxas"; a linha específica substitui a geral).
✅ Novo — 23/10/2026 A ordem dos níveis na tela nova (Sem Permissão < Visualizar < Criar < Editar < Total), para que serve Ver Valores (excepcional) e quais dados do colaborador a receita controlada exige (CPF; conselho, número e UF — e, para o SNCR, conselho CRM, CRMV ou CRO, valendo a especialidade mais antiga).
✅ Novo — 15/10/2026 Como ativar a integração TISS da operadora (aba Integração TISS, só na edição: credenciais, endereço de elegibilidade, Testar conexão, Salvar integração) e que hoje só a elegibilidade usa o webservice; onde se cadastra o provedor do link de pagamento Pix (Parâmetros › Pagamentos (links)); e que quem trabalha em mais de uma clínica troca a própria senha pelo "Esqueci minha senha".