⚙️ Configurações

Área administrativa do sistema: estrutura da clínica, colaboradores, convênios, serviços, usuários e parâmetros gerais.

Visão Geral

As Configurações são a fundação do sistema Rabi. Todos os outros módulos dependem dos dados cadastrados aqui. É obrigatório configurar esta área antes de utilizar qualquer outro módulo.

Acesso em produção: app.rabisistemas.com.br/portal/configuracoes

Novidades de setembro/2026 ✅ Novo — set/2026

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

• Padronização dos cadastros estruturais (#606) — os campos estruturados dos cadastros passaram a ser padronizados em maiúsculas e sem acentuação, evitando duplicidades e divergências de grafia entre cadastros.
• 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.
• Regras de preço por convênio — todas em produção (23–24/09) — ver Convênios › Regras de preço.
• Ordem de implantação corrigida (24/09) — depósito mínimo antes dos locais, produtos antes dos serviços, taxas antes dos convênios — ver Ordem de Configuração.
• ✅ Novo — 26/09/2026 Expandir serviço concluído (#625, 25/09) — na aba Serviços do convênio e na aba Convênios do serviço (que agora também mostra o Farol e a linha ✅ efetiva) — ver Expandir serviço.
• ✅ Novo — 26/09/2026 Convênio: marcar só "Pacote" não liga mais "Zerar valor" sozinho (correção de 25/09).
• ✅ Novo — 26/09/2026 Tokens de integração pela própria clínica (#624) e habilitação da TalkMe (#597) em Parâmetros › Integrações — ✅ em produção desde 28/09/2026 (ver Parâmetros).
• ✅ Novo — 26/09/2026 Pagamento parcial antecipado por serviço (#604) — ✅ em produção desde 28/09/2026 (ver Serviços).
• ✅ Novo — 26/09/2026 Cuidado ao excluir produto/taxa: hoje a exclusão é livre e tira o item da composição dos serviços sem aviso; a trava é a #626 (roadmap S12) — ver Taxas. ✅ Atualização 13/10: a trava entrou em produção em 02/10.
• ✅ Novo — 29/09/2026 Conta a receber de convênio usa o centro de custo padrão dos Parâmetros (28/09): a conta a receber gerada pelo faturamento de convênio passa a usar o centro de custo padrão definido em Parâmetros, com correção de valores e unidade.
• ✅ Novo — 30/09/2026 Convênio abre em modo consulta (#632, ✅ em produção desde 29/09/2026) — dá para ver tudo sem risco de alterar; para mudar qualquer dado, clique em Liberar para edição. Junto vieram: políticas de preço por tipo de produto que não se apagam mais ao salvar, aviso de campo inválido em outra aba e lista de convênios paginada no servidor — ver Convênios.
• ✅ Novo — 30/09/2026 Menu lateral: listas longas (como a de Configurações, com cerca de 24 itens) não são mais cortadas pela tela, e o rodapé do menu (conta e tema) não some mais.
• ✅ Novo — 30/09/2026 🟠 Roadmap IA (TalkMe): consulta única de disponibilidade (#633, Sprint 12) — o que a clínica já deve manter em dia nos cadastros para a IA responder certo: ver Cadastros em dia para a IA. ✅ Atualização 13/10: em produção (issue fechada 09/10).
• ✅ Novo — 29/09/2026 🟠 Roadmap Aba Especialidades do convênio vai passar a valer (#628, Sprint 12) — hoje a marcação Atende não tem efeito; revise os convênios desde já — ver Especialidades do convênio. ✅ Atualização 13/10: entrou, mas está desligada no agendamento desde 06/10.

✅ Atualização 13/10: a trava de exclusão de produto/taxa em uso (#626) entrou em produção em 02/10; a consulta única da IA (#633) está em produção; a trava de especialidade (#628) entrou e foi desligada temporariamente no agendamento em 06/10; os tokens agora têm Editar permissões e Renovar com escolha de permissões (#653). Detalhes no bloco de outubro, logo abaixo.

Novidades de outubro/2026 ✅ Novo — 13/10/2026

• ✅ Novo — 01/10/2026 Convênio: as abas só gravam no botão Salvar (#640/#639/#654) — nas abas Planos, Especialidades, Produtos, Serviços e Taxas, o que você altera fica pendente (destacado) até clicar em Salvar no cabeçalho do convênio; as ações em massa (Selecionar/Desmarcar todos, Copiar, Importar) gravam na hora — ver Salvar no cabeçalho.
• ✅ Novo — 02/10/2026 Histórico de alterações do convênio por aba (#638) — botão Histórico no cabeçalho do convênio e ícone na lista — ver Histórico do convênio.
• ✅ Novo — 02/10/2026 "Este registro foi alterado por outra pessoa" (#640) — o sistema inteiro passou a recusar gravação por cima do trabalho de outra pessoa e só libera a edição depois de carregar todos os dados — ver Gravação protegida.
• ✅ Novo — 12/10/2026 Aba Custos extras do convênio, painel Serviços extras e repasse no Farol (#655) — o bloqueio por esses custos nasce desligado — ver Custos extras.
• ✅ Novo — 02/10/2026 Repasse geral do colaborador (#643/#644) — linha "Todos os serviços / produtos / taxas" na aba Vínculo e Repasse; repasse de taxa passa a ser calculado — ver Repasse geral.
• ✅ Novo — 01/10/2026 Salvar o perfil de permissão aplica a todos os usuários do perfil (#636) — ver Permissões Granulares.
• ✅ Novo — 01/10/2026 Usuário com e-mail que já existe no Rabi (#642) — a tela avisa que ele foi vinculado e que a senha informada não foi aplicada — ver Colaboradores.
• ✅ Novo — 02/10/2026 Excluir produto ou taxa em uso agora é bloqueado (#626) — ver Taxas.
• ✅ Novo — 02/10/2026 Tokens de integração: Editar permissões e Renovar escolhendo permissões e validade (#653) — ver Parâmetros › Integrações.
• Trava de especialidade do convênio (#628) desligada no agendamento desde 06/10/2026 (temporário) — ver Especialidades do convênio.
• ✅ Novo — 09/10/2026 Painel "Disponibilidade por Convênio" da Agenda passa a ler os convênios de cada unidade do cadastro Unidades do convênio (#659) — ver Cadastros em dia.
• 🟠 Roadmap Tela de catálogo de atendimento (#659 — hoje sem tela), IA abrindo autorização e orçamento (#660). Novo — out/2026 O log de auditoria só com o campo alterado (#627) entrou em produção em 23/10/2026. ✅ Atualização 15/10 o catálogo considerando o Farol (#664), os Links de Pagamento (#409) e a maior parte do pacote de segurança (#663, #666, #669) entraram em produção entre 13 e 15/10 — ver Novidades de 13 a 15/10. O "negar por padrão" (#667) não entrou.

Novidades de 13 a 15/10/2026 ✅ Novo — 15/10/2026

• ✅ Novo — 15/10/2026 Integração TISS — fase 1 (#619): aba "Integração TISS" na operadora (elegibilidade online por webservice) e tela "Log de integração TISS" — ver Operadoras › Integração TISS.
• ✅ Novo — 13/10/2026 Parâmetros › Pagamentos (links) (#409): cadastro do provedor Pix que gera os links de pagamento — ver Pagamentos (links).
• 🟡 Chegando Parâmetros › Registro Financeiro › Conciliação bancária (Open Finance) (#651): opção já visível, módulo adicional desligado — ver Financeiro › Open Finance.
• ✅ Novo — 14/10/2026 Configurações › "Log de erros" — só para administrador — ver Log de erros.
• ✅ Novo — 13–14/10/2026 Segurança (#663/#666/#669): troca de senha/e-mail de quem trabalha em mais de uma clínica só pelo próprio usuário, erros técnicos com código, limites de tentativas e de itens por página — ver Segurança em produção.
• ✅ Novo — 14/10/2026 Painel "Disponibilidade por Convênio" e IA consideram o Farol (#664) — ver Cadastros em dia para a IA.
• ✅ Novo — 15/10/2026 Referências oficiais por tipo de produto no convênio (#662, 1ª fase) — ver Estoque › Referências oficiais.
• ✅ Novo — 15/10/2026 Token do convênio passa a ser exigido só no Acolhimento (não mais ao criar/editar o agendamento).

Novidades de 15 a 23/10/2026 Novo — out/2026

• Novo — out/2026 Permissões redesenhadas (15–16/10): níveis Sem Permissão / Visualizar / Criar / Editar / Total, busca e a ação Ver Valores (excepcional) — ver Usuários e Permissões.
• Novo — out/2026 Receitas e SNCR (22/10): para o médico fazer receita controlada, o colaborador precisa de CPF e especialidade ativa com conselho, número e UF; desde 23/10 o conselho precisa ser CRM, CRMV ou CRO e vale a inscrição mais antiga — ver Colaboradores › Receitas controladas.
• Novo — out/2026 Convênio › subaba Faturamento (23/10): forma de envio (XML, Portal ou Papel), intermediador, endereço do portal e periodicidade — ver Faturamento sem XML.
• Novo — out/2026 Log de auditoria só com o campo alterado (#627, 23/10) — ver Histórico do convênio.
• Novo — out/2026 Log de erros com as origens Estoque, Financeiro e Orçamento e filtro por usuário — ver Log de erros.
• Novo — out/2026 TISS fases 2 a 4 (22–23/10): menu Faturamento › Retorno da operadora — primeira versão no ar, em validação — ver Integração TISS.
• Novo — out/2026 Tabelas com 30 linhas por página.

Novidades de 26 a 29/10/2026 Novo — out/2026

• Novo — out/2026 Tipos de Documento Atendimento (28/10): coluna "Documento com assinatura digital" (quem pode assinar) e coluna da Memed (chegando) — ver Assinatura digital e Memed por tipo de documento.
• Novo — out/2026 Serviços (29/10): quem só tem Visualizar abre o cadastro do serviço em modo leitura — ver Serviços › modo leitura.
• Novo — out/2026 Parâmetros › Serviços Online › Agendamento (29/10): as perguntas do agendamento passam a ser enviadas também à IA (TalkMe) — ver Integrações e Mapa de integrações.

Empresas e Unidades

Define a estrutura organizacional da clínica. Uma empresa (CNPJ) pode ter múltiplas unidades físicas de atendimento.

URL: /portal/configuracoes/empresas-unidades

Como cadastrar a empresa

1. Acesse Configurações → Empresas e Unidades

   No menu lateral, clique em Configurações e depois em Empresas e Unidades.

2. Clique em "Nova Empresa"

   Botão no canto superior direito da listagem.

3. Preencha os dados obrigatórios

   Razão Social, CNPJ (apenas números) e endereço completo com CEP.

4. Adicione logo (opcional)

   Clique em "Upload de Logo" e selecione um arquivo PNG ou JPG. A logo aparecerá nos documentos impressos.

5. Salve

   Clique em "Salvar". A empresa aparece na listagem e já pode ser vinculada a colaboradores.

Campos do formulário

Locais / Salas

Ambientes físicos dentro de uma unidade onde ocorrem os atendimentos: consultórios, salas de exame, salas de procedimento, etc. Cada local pode ter uma lotação máxima e ser vinculado a um equipamento.

URL: /portal/configuracoes/empresas-unidades/locais

Como cadastrar um local

1. Acesse Configurações › Empresas e Unidades › Locais

   Rota /portal/configuracoes/empresas-unidades/locais.

2. Clique em "Novo Local"
3. Preencha o nome do local

   Exemplos: "Consultório 01", "Sala de Exames", "Sala de Procedimentos", "Recepção".

4. Selecione a unidade

   Vincule ao estabelecimento correto (se a clínica tem mais de uma unidade).

5. Escolha o depósito padrão de saída

   Selecione o depósito ativo da unidade (o depósito mínimo criado logo depois da empresa). Sem depósito ativo, o local não é salvo.

6. Salve

   O local aparece na lista de locais disponíveis ao criar agendamentos.

Colaboradores

Profissionais de saúde e administrativos que atuam na clínica. Cada colaborador terá sua própria agenda e acesso ao sistema conforme as permissões configuradas.

URL: /portal/configuracoes/colaboradores

Como cadastrar um colaborador

1. Acesse Configurações → Colaboradores
2. Clique em "Novo Colaborador"
3. Preencha nome e e-mail

   O e-mail é usado para acesso ao sistema. Deve ser único por colaborador. Se o e-mail já tem login no Rabi (por exemplo, em outra clínica), veja abaixo.

4. Selecione a Empresa Principal

   Vincule à empresa cadastrada anteriormente. Se houver múltiplas unidades, escolha a principal deste profissional.

5. Adicione as especialidades

   Clique em "+ Adicionar Especialidade". Para cada especialidade, informe o nome (ex: Cardiologia) e o código CBOS correspondente.
   Exemplo: Cardiologia → CBOS 225120

6. Faça upload de foto (opcional)

   PNG ou JPG. Aparece no prontuário e agenda.

7. Salve

   O colaborador aparece na lista e está disponível para agendamentos.

Campos do formulário

O que é o CBOS?

O CBOS (Classificação Brasileira de Ocupações em Saúde) é um código numérico que identifica cada especialidade médica. É obrigatório para emissão de guias e faturamento de convênios.

Para outras especialidades, consulte a tabela completa do CBOS no site do Ministério da Saúde.

Colaborador médico: dados para receitas controladas e SNCR Novo — out/2026

Para o médico fazer receitas controladas e pedir a numeração do SNCR (Anvisa), o cadastro dele precisa ter:

• CPF do colaborador (a numeração do SNCR é dada ao CPF do médico);
• uma especialidade ativa com conselho, número e UF iguais aos do conselho profissional (ex.: CRM, número, UF) — é isso que a Anvisa confere. Novo — out/2026 O SNCR só aceita CRM, CRMV ou CRO: o Rabi usa a especialidade mais antiga do colaborador que tenha um desses conselhos (antes pegava a primeira de qualquer conselho). Médico com mais de um CRM: vale sempre a inscrição mais antiga — a tela não tem escolha;
• para Talidomida, também o nº do cadastro do médico na talidomida.

Se o conselho for outro (ex.: COREN, CRF), a tela mostra "O SNCR só aceita prescritor de CRM, CRMV ou CRO. O conselho cadastrado na sua especialidade (X) não é aceito. Peça para cadastrarem o conselho certo, com número e UF, em Configurações → Colaboradores → Conselhos e Especialidades." e, na emissão de RCE e Notificação, a pendência "inscrição em CRM, CRMV ou CRO (o SNCR não aceita o conselho X)" — inclua a especialidade com o conselho certo, número e UF. A ligação com a Anvisa está ativa desde 23/10/2026.

Se faltar, a tela de numeração mostra "Seu cadastro não tem conselho, número e UF do conselho…". Lista completa do que o médico, a clínica e o paciente precisam ter em Receitas e SNCR › Antes de começar.

Usuário com e-mail que já existe no Rabi ✅ Novo — 01/10/2026

O login do Rabi é o mesmo para todas as clínicas. Ao criar o usuário de um colaborador (Configurações › Colaboradores › Usuário) com um e-mail que já tem acesso ao Rabi — por exemplo, porque a pessoa trabalha em outra clínica —, o sistema só vincula esse login à sua clínica e avisa:

"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 ela não lembrar, use "Esqueci minha senha" na tela de login (ver Recuperar senha).
• O campo Senha continua na tela; o sistema não consulta o e-mail antes de você digitar a senha.
• Pela API externa, POST /colaboradores/{id}/usuario responde criado: false, vinculadoExistente: true e a mesma mensagem.

Repasse do colaborador — linha de repasse geral ✅ Novo — 02/10/2026

Em Configurações › Colaboradores › (colaborador) › aba "Vínculo e Repasse", as tabelas Serviços, Produtos e Taxas ganharam uma primeira linha fixa (fundo cinza): "Todos os serviços", "Todos os produtos" e "Todas as taxas" (#643).

• Linha geral — "Repasse geral — vale para todos sem linha própria abaixo. Vazio = sem repasse geral." Campos: percentual (%), valor (R$), a chave Maior / Menor e o botão "Limpar repasse geral". Só existe uma linha geral por tipo.
• Linhas abaixo = específicas — cada uma exige o item ("Selecione o serviço da linha (o repasse para todos fica na linha geral)") e substitui o geral só para o item escolhido. Específica com 0 e 0% = sem repasse naquele item.
• Sem linha geral nem específica, aquele tipo não gera repasse.
• Repasse de taxa passa a ser calculado (base = valor convertido do convênio ou do cadastro × quantidade).
• O repasse de serviço é calculado sobre o valor líquido (total − descontos); valor fixo continua fixo. Serviço zerado no pré-faturamento gera repasse sobre zero; valor vazio usa o valor de cadastro.
• A linha geral vale para atendimentos a partir de 01/10/2026.

O relatório Relatórios › Repasse por Colaborador (#644) passou a trazer as taxas, a coluna "Origem do repasse" (geral ou específico), a coluna "Tipo" (Serviço/Produto/Taxa — antes chamada "Status") e os totais do filtro por tipo. Ver Relatórios. O repasse também entra no Farol desde 12/10.

Grade do colaborador — novidades de setembro/2026 ✅ Novo — set/2026

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

• Limite de agendamentos por convênio no modo EXCLUIR — o limite de agendamentos por convênio dentro da grade passa a funcionar também no modo EXCLUIR (antes só no modo incluir).
• Correção: modo do convênio que revertia sozinho — corrigido o comportamento em que o modo do convênio na grade voltava sozinho ao salvar.
• Correção: rolagem da seção de limite — corrigida a rolagem da seção de limite de agendamentos na grade.

Cadastros em dia para a IA (TalkMe) ✅ Novo — 30/09/2026

O atendimento por IA (integração TalkMe) só oferece ao paciente o que os cadastros dizem que a clínica atende. Desde 30/09/2026 a IA já confere a duração do serviço ao marcar (não sobrepõe mais agendamentos), só oferece especialidades para um convênio quando existe grade que aceite esse convênio, filtra os horários dos profissionais pelo serviço pedido e recusa serviço inativo.

✅ Novo — 13/10/2026 #633 — consulta única de disponibilidade (em produção; issue fechada em 09/10/2026): numa consulta só, a IA sabe se há profissional da especialidade, que faz o procedimento, com agenda liberada para o convênio do paciente (inclusive paciente com dois convênios). Ela não mostra horários — esses continuam vindo da agenda, depois que a IA escolhe o profissional. Desde 30/09 a IA também só oferece horário em grade que aceita o convênio e o serviço.

Painel "Disponibilidade por Convênio" (Agenda) ✅ Novo — 09/10/2026 — passa a usar a mesma regra da agenda interna: grade aceita o convênio; convênio com Utiliza no serviço; profissional, especialidade, local, serviço e equipamento ativos; serviço da especialidade da grade. Os convênios de cada unidade agora vêm do cadastro Unidades do convênio (não mais da empresa principal) — por isso a lista do painel pode crescer bastante; confira as unidades marcadas em cada convênio. A seleção automática respeita o local e o serviço escolhidos.

🟠 Roadmap Catálogo de atendimento (#659) — a base de dados do "o que a clínica atende por convênio, profissional, especialidade e unidade" já existe, mas não há tela, menu nem relatório; hoje ela só alimenta o painel acima. A IA abrir autorização e orçamento (#660) também é roadmap: hoje a IA não abre autorização nem orçamento.

✅ Novo — 14/10/2026 Catálogo considera o Farol (#664, em produção desde 14/10): a IA não oferece serviço que o Farol bloqueia ou que só libera com aprovação (vermelho, roxo e amarelo com "Exigir aprovação de nível 2") — esses são agendados pela recepção, com aprovação. No painel "Disponibilidade por Convênio", com um convênio no filtro, somem os serviços que o Farol bloqueia para esse convênio (vermelho ou roxo sem liberação de nível 3); o que só pede aprovação continua aparecendo. Sem parâmetro vermelho/amarelo, ou com "Desabilitar TODO bloqueio de farol", nada sai da lista. A trava do Farol ao salvar orçamento, autorização e agendamento não mudou.

Especialidades

As especialidades não têm cadastro próprio — são criadas diretamente no formulário do colaborador. Cada colaborador pode ter múltiplas especialidades (ex: Cardiologia + Clínica Geral).

As especialidades disponíveis na agenda são automaticamente as especialidades dos colaboradores ativos.

Equipamentos

Aparelhos médicos que podem ser vinculados aos agendamentos para controle de disponibilidade. Exemplos: ecocardiograma, raio-X, ultrassom, eletrocardiógrafo, densitômetro.

URL: /portal/configuracoes/equipamentos

Como cadastrar um equipamento

1. Acesse Configurações → Equipamentos
2. Clique em "Novo Equipamento"
3. Informe o nome do equipamento

   Ex: "Ultrassom GE Logic 5", "Raio-X Digital".

4. Selecione a unidade

   Onde o equipamento está localizado.

5. Salve

   O equipamento fica disponível para seleção no formulário de agendamento.

Operadoras

Empresas de plano de saúde. São a base para criação dos convênios — primeiro cadastre a operadora, depois crie o convênio.

URL: /portal/configuracoes/operadoras

Como cadastrar uma operadora

1. Acesse Configurações → Operadoras
2. Clique em "Nova Operadora"
3. Informe o nome da operadora

   Ex: "Unimed Nacional", "Bradesco Saúde", "Amil", "SulAmérica", "Hapvida". Para atendimentos sem plano, crie uma operadora chamada "Particular".

4. Preencha o CNPJ (se disponível)
5. Salve

   A operadora fica disponível para criação de convênios.

Aba "Integração TISS" da operadora — fase 1 (elegibilidade) ✅ Novo — 15/10/2026

Em produção desde 15/10/2026 (#619). É opcional e configurada por operadora, com o endereço do webservice e as credenciais que a própria operadora fornece. Sem nada configurado, aparece "Operadora sem integração TISS configurada — as telas continuam como hoje."

1. Abra a operadora para editar

   Configurações › Operadoras → editar. Na edição aparecem as abas "Dados da operadora" e "Integração TISS" ("Webservices da operadora (elegibilidade, autorização, lotes...)").

2. Credenciais do prestador

   Marque Integração ativa e informe as credenciais do prestador (a senha fica cifrada: "Senha definida — deixe em branco para manter." / "Remover senha"). Código do prestador: "Vazio = código da operadora. Vale só para os webservices."

3. Certificado e assinatura (se a operadora pedir)

   "Usar certificado cliente (mTLS)", "Assinar XML" e o certificado, que mostra "(válido até dd/mm/aaaa)".

4. Endereços dos webservices

   Um campo por transação (Verificar elegibilidade, Solicitação de procedimento, Status da autorização, Envio de lote de guias, Status do protocolo, Demonstrativo de retorno, Recurso de glosa, Status do recurso de glosa, Cancelamento de guia, Lote de anexos). Hoje só a elegibilidade é usada; os demais endereços podem ser guardados, mas nenhum fluxo os usa ainda.

5. Teste e salve

   Testar conexão ("Conexão OK") e Salvar integração ("Integração TISS salva com sucesso").

Configuração por convênio: "A configuração do convênio, se existir, substitui a da operadora." Sem configuração própria: "Este convênio usa a configuração padrão da operadora. Salve para criar uma configuração própria."

Onde se usa: botão "Verificar elegibilidade" no Agendamento e no Acolhimento — ver Agendamento.

Log de integração TISS: menu Configurações › "Log de integração TISS" (rota /portal/configuracoes/log-integracao-tiss) — "Chamadas aos webservices das operadoras", com filtros, paginação e o XML de envio ("Envio (senha mascarada)"). Sem permissão: "Você não tem permissão para ver o XML das transações."

Como o "negar por padrão" (#667) não está ligado, colaborador sem configuração nessas permissões vê a configuração e o log; salvar, testar e verificar exigem a permissão concedida (administrador tem tudo).

Novo — out/2026 TISS fases 2 a 4 — primeira versão no ar, em validação (telas em 22/10 e servidor em 23/10/2026): o menu Faturamento › Retorno da operadora reúne lote, demonstrativos, autorização online e recurso de glosa por webservice, usando os endereços cadastrados acima. Está em validação (#620/#622/#623 abertas): não há garantia de que todas as operadoras funcionem — teste com a sua e, se não funcionar, siga pelo caminho de hoje (XML, portal da operadora).

Convênios

Contratos com operadoras de saúde aceitos pela clínica. Esta é a configuração mais complexa e importante — define todas as regras comerciais, prazos e tabelas de preços.

URL: /portal/configuracoes/convenios

Subaba Faturamento: convênio enviado por portal ou papel Novo — out/2026

Desde 23/10/2026 o cadastro do convênio tem a subaba Faturamento, onde se informa:

• Forma de envio: XML, Portal ou Papel;
• Intermediador (associação ou cooperativa), quando o faturamento passa por um;
• Endereço do portal onde as guias são digitadas;
• Periodicidade do faturamento (ex.: quinzenal).

Com isso, no lote fechado (Administrar Lotes) aparece o botão Envio sem XML, que gera o espelho de digitação e registra o envio feito no portal. Passo a passo em Faturamento. Lembre: o convênio abre em modo consulta — use Liberar para edição e grave no Salvar do cabeçalho.

Histórico de alterações do convênio ✅ Novo — 02/10/2026

Botão Histórico (ícone de relógio, "Histórico de alterações da aba atual") no cabeçalho do Cadastro de Convênio, ao lado de Liberar para edição/Salvar (#638). Abre o histórico da aba em que você está ("Histórico — <aba>"); funciona também em modo consulta, em convênio desativado e para quem não pode editar. Na aba Farol abre o histórico geral.

• Na lista de convênios, o ícone "Histórico de alterações" de cada linha abre o Histórico do Convênio (todas as abas).
• Filtros: Subaba (no geral), Usuário (só quem alterou, inclusive alterações feitas por integração/API), Operação (Criação/Alteração/Remoção) e De/Até ("Até" abre em hoje).
• Cada linha mostra o item alterado; "Ver campos alterados" mostra antes e depois.

Novo — out/2026 Log de auditoria só com o campo alterado (#627, em produção desde 23/10/2026): o histórico mostra só o que mudou — antes e depois, quem e quando. A inclusão não lista campos vazios, e salvar sem mudar nada não gera registro. A conversão dos registros antigos é feita clínica a clínica: na sua clínica, os registros mais antigos ainda podem aparecer no formato anterior (com todos os campos).

Como cadastrar um convênio

1. Acesse Configurações → Convênios
2. Clique em "Novo Convênio"

   O convênio recém-criado já abre liberado para preencher. Para alterar um convênio que já existe (inclusive voltar outro dia para preencher as abas), abra-o e clique primeiro em Liberar para edição — ele abre em modo consulta — e, ao terminar, clique em Salvar no cabeçalho (as abas só gravam no Salvar).

3. Selecione a operadora

   A operadora deve estar cadastrada antes. Ex: "Unimed Nacional".

4. Informe o nome do convênio

   Ex: "Unimed Individual", "Bradesco Nacional Flex", "Particular".

5. Preencha os prazos comerciais

   Prazo de pagamento, prazo de retorno, prazo de entrega de guias, prazo de glosa. Esses valores vêm do contrato com a operadora.

6. Defina "Pagamento no ato?"

   Se Sim: paciente paga copagamento na recepção ao chegar. Se Não: faturamento é feito depois em lote.

7. Salve os dados e depois configure as abas de preço

   Primeiro os dados do convênio (inclusive a Conta de recebimento, usada em Gerar Contas a Receber do lote); depois as abas Serviços, Produtos e Taxas — cada alteração fica pendente até o Salvar do cabeçalho. As abas exigem que taxas, produtos e serviços já estejam cadastrados — por isso eles vêm antes dos convênios na implantação. Veja opções na seção abaixo.

8. Credenciamento de colaboradores (abas Especialidades e Colaboradores)

   Selecione quais especialidades (com o CBOS) e quais colaboradores estão credenciados neste convênio. Marque Atende nas especialidades que o convênio cobre — vale no cadastro do convênio (abas Serviços, Colaboradores e Produtos); no agendamento a trava está desligada temporariamente desde 06/10/2026 (ver Especialidades do convênio).

9. Ative o convênio e salve

   Marque "Ativo = Sim" para que o convênio apareça nos agendamentos e no cadastro de pacientes.

Campos do formulário

Tabela de preços do convênio

Cada convênio tem sua própria tabela com o valor pago por procedimento. Há quatro formas de configurar. Antes de importar, cadastrar, copiar ou alterar valores, abra o convênio e clique em Liberar para edição (em modo consulta esses botões não gravam); exportar funciona também em modo consulta.

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 (layout mais limpo) e recebeu ajustes visuais, deixando o cadastro do "de–para" mais rápido e claro.

Regras de preço por convênio — todas em produção ✅ em produção desde 23–24/09/2026

A série de regras de preço por convênio está inteira em produção (23/09 e 24/09/2026) — não resta nada da série 22–24/09 pendente de ativação — e a coluna Valor do serviço com 4 linhas (linha Σ) está em produção desde 24/09. Elas fecham o comportamento das abas Serviços, Produtos, Taxas, Equipamentos e Farol do convênio. Para decidir caso a caso, use a árvore de decisão.

• Zero é zero, vazio é vazio — em todas as telas — campo com 0,00 significa preço zero de verdade (não desce de nível); campo vazio significa "não tenho regra aqui" e o sistema usa as conversões dos níveis de baixo (política do convênio, depois o cadastro). Use o botão "Limpar valor" para deixar o campo vazio. Quem usava R$ 0,01 como marcador de "sem valor" deve limpar o campo.
• Utiliza = "o convênio cobre este item" — item sem Utiliza tem custo, mas não tem receita (fica fora da receita do Farol; no orçamento entra a R$ 0). Item com Utiliza é precificado pela cadeia de conversão do convênio (valor combinado → política do convênio → cadastro), nunca pelo "preço da casa".
• Taxas, produtos e subserviços sempre entram na conta do serviço ✅ 23/09/2026 — cada um com as próprias conversões, como saem na guia/XML. "Definir preço do serviço pelos itens" decide só o valor próprio do serviço (zero quando marcado) — não decide mais se os itens entram. Só ficam fora: item sem Utiliza, ou zerado em pacote de preço fechado. Para um preço fixo ou valor combinado "já incluir" itens: clique em Liberar para edição, marque Pacote na linha do serviço (aqui, na aba Serviços do convênio) e Zerar valor em pacotes nos itens inclusos.
• 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 100 → 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 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.
• Zerar valor em pacotes é por item e não desce em cascata ✅ 24/09/2026 — só age quando o serviço é pacote de preço fechado (Pacote marcado + valor fixo ou combinado preenchido, inclusive 0). Um 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 que está dentro dele.
• Linha ✅ do serviço = valor do próprio serviço ✅ 23/09/2026 — na aba Serviços, a linha ✅ mostra o valor do próprio serviço como sai na linha de procedimento do XML; produtos e taxas saem nas áreas deles. Quem soma tudo é o Farol (o do serviço consolida tudo; o da taxa é só a taxa; o do produto só o produto).
• 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). 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. Passar o mouse em cada linha explica o que ela é. Produtos, taxas e a coluna Tipo de Atendimento seguem com 3 linhas.
• Coluna Tipo de Atendimento na aba Serviços — o tipo de atendimento também é convertido por convênio, com as 3 linhas: 🔒 o do cadastro do serviço, 🔁 o escolhido para o convênio e ✅ o que vale (efetivo). O efetivo vai para o atendimento, o pré-faturamento e o campo tipoAtendimento do XML.
• Textos e valores finais convertidos ✅ 24/09/2026 — todas as telas do convênio mostram o nome, a descrição, o código, a tabela 87 e os valores finais convertidos (nível do convênio → política do convênio, só para preço de produto → catálogo).
• Aba Farol › Itens: cada linha reflete só ela ✅ 24/09/2026 — valor efetivamente considerado (zero quando fora), custo, receita, margem e farol da própria linha, com a coluna "Conta no total" (Sim/Não); a linha do serviço traz o total do serviço e a do subserviço, o total do que está dentro dele. A sub-aba Farol › Serviços, que mostrava "0 registros", foi corrigida.
• Expandir serviço ✅ Novo — 26/09/2026 — seta na linha do serviço (aba Serviços do convênio e aba Convênios do serviço) que abre a árvore do serviço naquele convênio, como sai na guia, com farol por item. Concluído (#625, fechada em 25/09) — ver seção própria.
• Farol do orçamento, agendamento e autorização é consolidado — soma de tudo que o convênio paga ÷ soma de todos os custos; um item vermelho sozinho não bloqueia se o conjunto fecha; item sem custo/preço → roxo.
• 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 fica na cor do Farol (cinza claro quando não há Farol calculado).

Expandir serviço — a árvore do serviço como sai na guia ✅ Novo — 26/09/2026

Concluído e em produção (#625, issue fechada em 25/09/2026). Está em dois lugares:

• Configurações › Convênios › [convênio] › aba Serviços;
• Configurações › Serviços › [serviço] › aba Convênios — novidade: essa aba agora mostra, por convênio, 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 — e também expande.

Ao clicar na seta da linha, abre (sob demanda) a árvore do serviço naquele convênio. Colunas do painel, nesta ordem:

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 a coluna Motivo diz por quê: "Convênio não utiliza", "Zerado em pacote" ou "Subserviço pai fora do total".
• Cada linha mostra 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 no banco) — nunca recalculados na tela. Editou um valor na lista? Os painéis abertos recarregam sozinhos.
• Ficou mais rápido: carregamento sob demanda e cache das listas.
• ✅ Novo — 29/09/2026 Passe o mouse na bolinha do Farol de cada linha para ver a margem, a receita e o custo daquele item.
• ✅ Novo — 29/09/2026 Não há linha de total no fim da lista expandida: o total do serviço naquele convênio é a linha Σ da coluna Valor (o mesmo número da receita do Farol).
• ✅ Novo — 29/09/2026 Ao alterar valor, Pacote ou Zerar na linha do serviço e salvar, a lista expandida se atualiza sozinha.

Custos extras do convênio, Serviços extras e repasse no Farol ✅ Novo — 12/10/2026

Em produção desde 12/10/2026 (#655). O Farol passa a enxergar o custo real do atendimento, não só os produtos.

• Aba "Custos extras" (Configurações › Convênios › [convênio]) — 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 (serviços, produtos e taxas) / 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"); Início e Fim da vigência (vazio = "Sempre"). A lista tem Editar/Inativar e "Mostrar inativos". Esta aba grava na hora (fora do Salvar do cabeçalho), obedece ao modo consulta e tem histórico próprio. O percentual incide sobre a receita de cada linha; 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 do convênio: Prestador (do cadastro de Fornecedor), Descrição, Valor (fixo por execução), quantidade e Vigência.
• Farol: custo = produtos + custo extra do convênio + prestadores + repasse do profissional. Sem profissional definido, usa o maior repasse entre quem atende o serviço e aceita o convênio (pior caso). O tooltip e a expansão mostram a composição (Produtos, Custo extra do convênio, Prestadores, Repasse, Custo total, Receita, Índice).
• Cores: "sem cor" agora só quando o custo total é 0; roxo = há produto com custo 0; índice exatamente no limite do vermelho passa a ser amarelo. Serviços sem produto que antes ficavam sem cor passam a ter cor (por causa do repasse estimado).
• O bloqueio nasce desligado: em Configurações › Parâmetros › Orçamento, a opção "Custos extras (convênio, prestadores e repasse) também bloqueiam" vem desmarcada — a cor mostrada já inclui os custos novos, mas o bloqueio e a aprovação usam a cor sem eles. Antes de ligar, use o botão "Ver serviços que mudam de cor" (relatório com Antes/Depois por convênio e serviço).
• Custo extra é projeção: não gera lançamento, não altera DRE, repasse pago, guia nem XML. Fornecedor usado em custo extra ou prestador ativo não pode ser excluído nem inativado.

O passo a passo tela a tela dessas regras está no Guia do Implantador — Preços e Conversão de Valores; o resumo para decidir está na árvore de decisão.

Novidades de setembro/2026 nos Convênios ✅ Novo — set/2026

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

• Regras de preço por convênio (23–24/09) — todas em produção — zero é zero, Utiliza = cobre, itens sempre entram, Zerar por item sem cascata, linha ✅ = valor do próprio serviço, textos convertidos, Farol › Itens por linha, "Expandir serviço" — ver seção acima.
• Domínio de tabela 87 ampliado — o domínio de tabela 87 do convênio ganhou os códigos Brasindice (05), SIMPRO (12) e Taxa Própria (97).
• 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.
• ✅ Novo — 26/09/2026 Expandir serviço concluído (#625, 25/09) — ver seção própria.
• ✅ Novo — 26/09/2026 Criar vínculo marcando só "Pacote" não liga mais "Zerar valor" sozinho (correção de 25/09): marque o Zerar valor em pacotes você mesmo, só nos itens inclusos no preço fechado.
• ✅ Novo — 30/09/2026 Modo consulta + Liberar para edição (#632, em produção desde 29/09), políticas por tipo de produto protegidas ao salvar e lista de convênios paginada no servidor — ver o quadro no início de Convênios.

Novidades de agosto/2026 nos Convênios ✅ Novo — ago/2026

Entregas do ciclo de agosto/2026 (issues fechadas no GitLab). Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

• Subabas do convênio com filtro e ordenação por utilização (#583, 26/08): as subabas Produtos, Serviços e Taxas do cadastro do convênio ganharam filtro e ordenação por utilização — os itens mais usados aparecem primeiro.
• Subabas Produtos, Serviços e Taxas corrigidas (#544): correções nas subabas de Produtos, Serviços e Taxas dentro do cadastro do convênio.
• Farol — visão geral com lista de cruzamentos (#435, 02/08): nova visão geral do farol, com a lista dos cruzamentos serviço × convênio e produto × convênio, permitindo enxergar de uma vez a situação (🟢/🟡/🔴) de cada combinação. Era "em breve" — agora entregue.

Novidades de julho/2026 nos Convênios ✅ Novo — jul/2026

Entregas do ciclo de julho/2026 (issues fechadas no GitLab). Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

• Valor por conversão visível na linha (#473 — 24/07): a lista passa a mostrar, na própria linha, o valor por conversão de serviço, produto e taxa.
• Desativar convênio com colaboradores vinculados (#455 — 20/07): agora é permitido desativar um convênio mesmo quando há colaboradores vinculados a ele.
• Sub-aba Colaboradores mais limpa (#429 — 01/07): a sub-aba Colaboradores do convênio passa a listar somente quem tem consulta.
• Farol de % de gastos do convênio (#339 — 22/07): indicador em cores do percentual de gastos do convênio.
• Farol por parâmetros em convênios e serviços (#505/#506/#507 — 20–22/07, e #434 — 22/07): exibição do farol em cores (🟢 verde / 🟡 amarelo / 🔴 vermelho) com o índice do parâmetro nos serviços e bloqueio quando o farol está vermelho. Faz parte da entrega do Farol de Margem Receita/Custo (#390), concluída em julho/2026.

Credenciamento de colaboradores (abas Especialidades e Colaboradores)

Dentro de cada convênio, nas abas Especialidades (especialidades aceitas, com o CBOS) e Colaboradores, você registra quais especialidades e colaboradores estão credenciados para atender por aquele plano. Em convênio já existente, clique antes em Liberar para edição.

Aba Especialidades — a marcação "Atende" ✅ Novo — 13/10/2026

Na aba Especialidades do convênio, a coluna Atende define quais especialidades o convênio cobre. A regra (#628) entrou em produção no início de outubro, mas hoje vale só dentro do cadastro do convênio:

• No cadastro do convênio (ligada): 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 pode ser marcado como Utiliza; "Selecionar todos" pula esses serviços; Copiar e Importar Excel os trazem desmarcados. A aba Colaboradores só aceita especialidade atendida, e a aba Produtos segue a mesma marcação. A API externa obedece à mesma regra.
• No agendamento, orçamento e autorização (desligada temporariamente desde 06/10/2026): o sistema não filtra nem bloqueia profissionais, especialidades ou serviços pela especialidade do convênio. A recepção consegue agendar qualquer combinação — confira a especialidade/cobertura do convênio ao agendar. 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.
• Atenção: os textos da tela do convênio ("não podem ser usados no agendamento", chip "Não agenda" e, ao desmarcar Atende, "não poderão ser agendados por este convênio") descrevem a regra ligada. Hoje o agendamento não barra; quando a trava for religada, esses textos voltam a valer.
• Regras (quando ligada): convênio sem nenhuma especialidade marcada como Atende não restringe nada; serviço sem especialidade não passa pela trava; serviço ou profissional com várias especialidades é coberto se uma for atendida; desmarcar Atende não mexe em cascata nos outros cadastros.
• Para alterar: abrir o convênio → Liberar para edição → aba Especialidades → marcar/desmarcar Atende → Salvar no cabeçalho.

✅ Atualização 13/10: o que este bloco dizia em 29/09 ("a marcação não tem efeito"; "planejado — Sprint 12") foi substituído pela situação acima.

Tabela de Preços Internos

A tabela de preços interna é uma fonte de preço de PRODUTO: cada tabela tem até 3 preços por produto (Nome Preço 1/2/3). Quando o produto usa uma tabela interna como fonte de preço e a tabela não tem aquele produto (0 ou vazio), o sistema cai para o Preço de venda tabela do cadastro do produto (aba Estoque), sempre com o Fator K do produto. Detalhes no Guia do Implantador de Preços.

URL: /portal/configuracoes/tabela-precos-internos

Como configurar

1. Acesse Configurações › Tabelas precos internos
2. Crie a tabela e dê nome aos preços

   Defina os nomes dos até 3 preços (Nome Preço 1/2/3). Taxas, produtos e serviços já devem estar cadastrados antes da tabela interna.

3. Informe os preços dos produtos

   Para cada produto, preencha o Preço 1, 2 e/ou 3. Produto que não estiver na tabela usa o Preço de venda tabela do cadastro.

4. Aponte o produto para a tabela

   No cadastro do produto (Estoque › Produtos › aba Estoque), a Fonte de Preço indica qual tabela/preço usar.

5. Salve

   Pela API externa: /tabelas-preco e /tabelas-preco/produtos (upsert; em lote até 200).

Serviços e Procedimentos

Catálogo de todos os procedimentos realizados pela clínica. São usados no agendamento, no prontuário e em todas as tabelas de preços.

URL: /portal/configuracoes/servicos

Como cadastrar um serviço

1. Primeiro, cadastre os Tipos de Serviço

   Acesse /portal/configuracoes/servicos/tipos e crie as categorias: Consulta, Exame, Cirurgia, Terapia, Procedimento.

2. Acesse Configurações → Serviços
3. Clique em "Novo Serviço"
4. Preencha os dados

   Nome (ex: "Consulta Cardiológica"), Tipo de serviço (ex: Consulta), Código TUSS ou código próprio se aplicável.

5. Monte a composição (se houver)

   Produtos (medicamentos, materiais), taxas e subserviços do serviço — todos precisam já estar cadastrados.

6. Salve

   O serviço aparece nas tabelas de preços e no agendamento.

✅ Novo — 26/09/2026 Aba Convênios do serviço: mostra, por convênio, a coluna Farol (linha inteira colorida) e a linha ✅ efetiva (descrição, tipo de código, código, Tabela 87 e valor que vai na guia); a seta da linha abre a árvore do serviço naquele convênio — ver Expandir serviço.

Novo — out/2026 Modo leitura (29/10/2026): quem tem apenas Visualizar em Serviços abre o cadastro do serviço em modo leitura — vê tudo (dados, composição, convênios), mas não altera nem salva. Para editar, é preciso Criar/Editar em Serviços (ver Usuários e Permissões).

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

✅ Novo — 29/09/2026 Em produção desde 28/09/2026. No cadastro do Serviço há: "exige pagamento parcial" + percentual mínimo + prazo da reserva (configurável por serviço). O agendamento desse serviço nasce "Pendente de Pagamento", segurando o horário até o prazo; sem pagamento, expira sozinho e libera o horário (e as reservas de medicamento; a vaga vai para a Fila de Espera). Vale na agenda da 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 é a #409 (Roadmap, Sprint 14 — ✅ Atualização 15/10 em produção desde 13/10: com provedor Pix ativo, o link confirma o sinal sozinho — ver Pagamentos (links)). ✅ Atualização 13/10: desde 12/10 a confirmação do sinal exige Conta caixa e Forma de pagamento e gera uma movimentação de recebimento própria (sem NFS-e); o agendamento mostra "Sinal já recebido". Ver Agendamento.

Tipos de Atendimento

Classificações das consultas realizadas. Usadas no agendamento para indicar a natureza da visita.

URL: /portal/configuracoes/tipo-atendimento

Como cadastrar

1. Acesse Configurações → Tipos de Atendimento
2. Clique em "Novo Tipo"
3. Informe o nome

   Ex: "Primeira Consulta", "Retorno 30 dias", "Urgência".

4. Salve

Parâmetros do Sistema

Configurações globais que controlam o comportamento do sistema para toda a clínica. Cada parâmetro afeta como o sistema funciona para todos os usuários.

URL: /portal/configuracoes/parametros

Parâmetros › Pagamentos (links) — provedor Pix ✅ Novo — 13/10/2026

Em produção desde 13/10/2026 (#409). Na aba "Pagamentos (links)" (permissão PARAMETROS; alterar = UPDATE) a clínica cadastra os bancos/provedores com que cobra por link. Só um fica ativo por vez: ele gera os links no agendamento online e para os atendentes, e o pagamento confirmado dá baixa sozinho no financeiro. Tipo disponível: "Pix — API padrão Banco Central (qualquer banco)" — é preciso contratar a API Pix com o banco, que fornece o certificado e as credenciais. Botões: Novo provedor, Testar conexão, Cadastrar aviso, Desligar links, Histórico de vigência. Passo a passo e campos em Financeiro › Links de Pagamento.

🟡 Chegando Na aba "Registro Financeiro", bloco "Conciliação bancária", aparece a opção "Conciliação bancária automática (Open Finance) — módulo adicional, cobrado por conta conectada" (desmarcada). Ela só funciona depois que o time Rabi ativar o agregador — ver Open Finance.

Log de erros (só administrador) ✅ Novo — 14/10/2026

Menu Configurações › "Log de erros". A tela é só para administrador (não é uma permissão de perfil). Mostra os erros da clínica logada nos fluxos de agendamento, acolhimento, confirmação, cancelamento, status, bloqueio, fila/lista de espera, encaixe, anexos, divergências, IA TalkMe, API externa, criação de guia e sinal vencido, com filtros por origem, busca e período. Novo — out/2026 Também as origens Estoque, Financeiro e Orçamento, e filtro por usuário. O detalhe traz o código de rastreio — o mesmo que aparece na mensagem "Ocorreu um erro inesperado. Tente novamente em instantes. (código XXXX)" — e os dados enviados, com os dados sensíveis mascarados.

Parâmetros › Integrações — tokens e TalkMe ✅ em produção desde 28/09/2026

✅ Novo — 29/09/2026 Em produção desde 28/09/2026 (concluído no desenvolvimento na Sprint 11, fechada em 25/09).

• Tokens de integração self-service (#624): em Configurações › Parâmetros › Integrações, a própria clínica gera, vê, renova e revoga tokens rbt_…. O valor do token aparece uma única vez (copie na hora); validade opcional; tudo auditado; limite de requisições (resposta 429 quando excedido). Dois tipos:
  • TalkMe (IA) — acesso fixo à API TalkMe da clínica;
  • Implantação e manutenção — acesso à API externa (/api/v1/integrations/*), só com as permissões escolhidas (mesmo catálogo da chave rbk_).
• Habilitação da TalkMe (#597): a clínica habilita a integração TalkMe na mesma tela. Sem habilitação, a TalkMe recebe 403 — e não lê dados de outra clínica nem trocando cabeçalho (isolamento por clínica).

✅ Novo — 02/10/2026 Editar permissões e Renovar (#653):

• "Editar permissões" no token de implantação ativo: abre a matriz já marcada; não salva vazia; o valor do token não muda e a alteração vale na chamada seguinte. Token legado com acesso total mostra aviso. O token TalkMe não tem essa ação; token revogado ou expirado não pode ser editado. Fica registrado quem alterou e as permissões antes e depois.
• Renovar o token de implantação abre o mesmo diálogo para revisar permissões e validade (sem alteração, o novo herda as permissões); gera um valor novo e invalida o anterior. O token TalkMe renova como antes.
• O diálogo do token gerado mostra a validade; o token envia o cabeçalho X-ApiKey-Expires-At. Quando falta permissão, o erro 403 diz qual é e onde liberar (ex.: "Serviços > Excluir").

✅ Atualização 13/10: não é mais preciso gerar outro token para ganhar permissão.

A chave rbk_ emitida pelo time Rabi no portal comercial continua valendo (renovação dela também pelo time Rabi) — ver API externa.

✅ Novo — 30/09/2026 Implantação com IA: o caminho recomendado passa a ser o token rbt_ da própria clínica, do tipo "Implantação e manutenção", gerado aqui só com as permissões da implantação (decisão de 30/09/2026). A chave rbk_ continua valendo como alternativa para quem já tem — ver Implantação com IA.

Tipos de Pagamento e Categorias

Define como os pacientes pagam (tipo) e para que os lançamentos financeiros são categorizados (categoria).

• Tipos de Pagamento: /portal/configuracoes/tipos-de-pagamento
• Categorias de Pagamento: /portal/financeiro/categorias-de-pagamento

✅ Novo — 29/09/2026 Coluna "Linha do DRE" nas Categorias de Pagamento (em produção desde 28/09/2026, #617): cada categoria pode ser classificada na linha do DRE Gerencial em que deve entrar. Categoria sem classificação usa uma regra padrão pelo tipo de movimentação. Ver Financeiro › Categorias de Pagamento.

Como configurar tipos de pagamento

1. Acesse Configurações → Tipos de Pagamento
2. Clique em "Novo Tipo"
3. Informe o nome

   Ex: "PIX", "Cartão de Crédito Visa".

4. Salve

   Aparece no dropdown ao registrar um lançamento financeiro.

Usuários e Permissões

O acesso de cada usuário ao sistema é controlado por grupos de permissão com diferentes níveis de ação.

Tela de permissões redesenhada Novo — out/2026

Desde 15–16/10/2026, a lista de permissões do perfil e do colaborador usa os níveis Sem Permissão, Visualizar, Criar, Editar e Total, com busca pelo nome da permissão. Há também a ação Ver Valores (excepcional), para colaborador com conselho profissional: desde 21/10/2026, quem tem conselho e Ver Valores pode aprovar orçamento. Detalhes em Permissões Granulares.

Receitas: fazer e emitir receita = Atendimentos (Editar); assinar a receita eletrônica = Assinatura Digital (Criar); ver o PDF assinado e enviar ao paciente = Assinatura Digital (Visualizar) — ver Receitas e SNCR › Permissões.

Grupos de permissão disponíveis

Nota (set/2026): a Fila de Espera tem permissão própria, separada do grupo de agendamento (#612).

✅ 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). Ver Permissões Granulares.

✅ Novo — 12/10/2026 Financeiro: 9 ações novas em CONTAS CAIXAS (conferir/reabrir caixa, receber em outra conta, alterar recebedor, baixa retroativa, conciliar, desconciliar, excluir comprovante, estornar) que ninguém recebe automaticamente — o administrador libera no perfil. Ver Permissões Granulares.

Níveis de ação por grupo

Na tela (desde 15–16/10/2026) os níveis aparecem como Sem Permissão (NONE), Visualizar (VIEW), Criar (CREATE), Editar (UPDATE) e Total (inclui excluir).

✅ Atualização 15/10: enquanto o "negar por padrão" (#667) não for ligado, colaborador sem nenhuma configuração num módulo continua vendo as telas dele (só leitura) — ver Segurança em preparação. Novas em 15/10: TISS_INTEGRACAO e TISS_ELEGIBILIDADE (ver Integração TISS).

Perfis recomendados por função

Configuração fiscal (NFS-e) ✅ Novo — set/2026

• Configuração fiscal por clínica (#464) — emissor, certificado e ambientes, em produção. Novo — out/2026 O provedor NotaPlano também pode ser configurado como provedor de NFS-e da clínica (por emitente) — essa configuração é feita pela equipe Rabi; não há tela para isso.
• Ativação do módulo NFS-e por clínica (opt-in com taxa, #471) — em produção.
• Modelos de nota por serviço (#465) — modelo padrão da clínica + atribuição por serviço, perfil fiscal por serviço e tabelas auxiliares (LC 116, NBS, CST/cClassTrib) — em produção desde 22/09/2026. ✅ Novo — 26/09/2026
• Onboarding fiscal (#472) — checklist de pré-requisitos para ativar a emissão — em produção desde 22/09/2026.
• Gestão das notas (#468) — tela Notas NFS-e: cancelar, substituir, pendências e histórico — em produção desde 22/09/2026.

Detalhes completos em Notas Fiscais (NFS-e / NF-e).

Tipos de Documento de Atendimento

Modelos de documentos clínicos que o profissional pode emitir durante o atendimento no prontuário. Cada tipo define o nome e o modelo do documento.

URL: /portal/configuracoes/tiposDocumentoAtendimento

Como cadastrar um tipo de documento

1. Acesse Configurações → Tipos de Documento de Atendimento
2. Clique em "Novo Tipo de Documento"
3. Informe o nome

   Ex: "Atestado Médico Padrão".

4. Configure o modelo (template)

   Insira o conteúdo padrão do documento. Os campos do paciente e médico são preenchidos automaticamente no prontuário.

5. Defina se é de assinatura digital

   Coluna "Documento com assinatura digital": tipo novo começa em Não — mude para Sim se o documento precisa ser assinado pelo profissional (ver abaixo).

6. Salve

   O documento fica disponível no prontuário do paciente durante o atendimento.

Assinatura digital e Memed por tipo de documento Novo — out/2026

Desde 28/10/2026 a lista de Tipos de Documento Atendimento tem duas colunas novas:

Ao criar um tipo de documento que precisa ser assinado (atestado, laudo, receita), lembre de marcar "Documento com assinatura digital = Sim". Quem pode assinar e as mensagens: Prontuário › Documento com assinatura digital. Memed: Prontuário › Memed — chegando.

Tipos de Impressão

Modelos de cabeçalho e rodapé para documentos impressos pela clínica — receitas, atestados, laudos. Permite personalizar o layout com logo, dados da clínica e dados do profissional.

URL: /portal/configuracoes/tipo-impressao

Tipos de Código

Padrões de codificação usados no faturamento de convênios. Definem como os procedimentos são identificados nas guias.

URL: /portal/configuracoes/tipos-de-codigo

Taxas e Tipos de Taxas

Encargos administrativos ou taxas cobradas em serviços específicos (ex: taxa de sala, taxa de materiais, taxa de guia).

• Tipos de Taxas: /portal/configuracoes/taxas/tipos — categorias (ex: Taxa Hospitalar, Taxa de Material)
• Taxas: /portal/configuracoes/taxas — valores específicos por tipo

Ordem de Configuração para Clínica Nova

Esta é a sequência oficial de configuração para uma clínica nova. Respeite a ordem pois há dependências entre os cadastros:

1. Empresa e Unidades

   Cadastrar a empresa (CNPJ, endereço, logo) e suas unidades físicas.

2. Depósito mínimo (1 por unidade)

   Estoque → Depósitos: um depósito ativo por unidade, só para os locais terem o depósito padrão de saída. O restante do estoque fica para depois.

3. Locais / Salas e tipos

   Cadastrar os ambientes de atendimento de cada unidade (com o depósito padrão de saída) e as tabelas básicas: tipos de serviço, taxa, produto, atendimento, código, anexo e identificação.

4. Operadoras e Fornecedores

   Cadastrar as empresas de saúde (antes dos convênios) e os fornecedores, fabricantes e princípios ativos (antes dos produtos).

5. Taxas

   Antes das tabelas de preço do convênio e da tabela interna, que dependem delas.

6. Produtos (catálogo)

   Estoque → Produtos. Antes dos serviços de medicamento; entradas de estoque e custos podem ficar para depois.

7. Equipamentos

   Cadastrar aparelhos médicos que serão vinculados aos agendamentos.

8. Serviços (subserviços antes dos pais) e Tabela de Preços Internos

   Cadastrar os procedimentos realizados pela clínica, com a composição. Em seguida, se a clínica usar, a tabela de preços interna (preços de produto) — depois de taxas, produtos e serviços e antes dos convênios. O valor do atendimento particular é definido no convênio "Particular".

9. Colaboradores e Especialidades

   Cadastrar todos os profissionais com suas especialidades e CBOS (e o repasse na aba Vínculo e Repasse — a linha geral evita cadastrar item a item). A grade (agenda) do colaborador e do equipamento é montada depois dos convênios, porque ela lista os convênios aceitos.

10. Convênios (dados, depois abas)

    Criar os convênios, planos e prazos; marcar na aba Especialidades as que o convênio atende (Atende — já vale no cadastro do convênio; no agendamento a trava está desligada desde 06/10); depois preencher as abas de preço (Serviços, Produtos, Taxas), clicar em Salvar no cabeçalho, cadastrar os Custos extras se houver e o credenciamento na aba Colaboradores. Em seguida, montar as grades dos colaboradores e equipamentos.

11. Conferência pelo Farol

    Aba Farol › Itens de cada convênio e "Expandir serviço" nos serviços compostos (na aba Serviços do convênio ou na aba Convênios do serviço) — nenhum item roxo; itens esmaecidos só com o motivo esperado.

12. Financeiro / Estoque

    Contas e caixas, tipos e categorias de pagamento (coluna Comprovação), centro de custo, conta padrão de recebimento de convênios e, se a clínica quiser, o controle de caixa (Parâmetros › Financeiro — começa Desligado; recomendado começar em Aviso); depósitos adicionais, entradas e custos do estoque.

13. Pacientes

    Cadastro ou importação da base de pacientes.

14. Parâmetros e Permissões

    Parâmetros gerais (com suporte da equipe Rabi), tipos de documento e impressão, usuários e permissões granulares por perfil.

Capturas de Tela

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