⚙️ Parâmetros do sistema

Parâmetros do sistema

Do manual: abrir esta parte no manual completo ›

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 ✅ Novo — 14/10/2026 Novo — out/2026

Menu "Log de erros". Novo — out/2026 Desde 30/10/2026 a tela é aberta a todo usuário logado (antes era só para administrador). 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.

Novo — out/2026 Erros de NFS-e (30/10/2026): origem "NFS-e", com os canais "Emissão automática" e "Aviso do provedor". A rejeição da emissão automática agora aparece aqui como erro (antes ficava "aguardando prefeitura").

Exportar o Log de erros (CSV) Novo — out/2026

1. Abra o Log de erros e clique em "Exportar CSV"
2. Escolha os filtros

   Origem, Usuário (vazio = todos), Buscar no erro, De/Até e Todos ou só os mais recentes (padrão: 1000).

3. Acompanhe a barra de progresso

   Dá para Cancelar no meio.

4. Abra no Excel

   O arquivo sai separado por ";" e abre direto no Excel. Útil para mandar ao suporte junto com o código do erro.

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.

Parâmetros › Integrações (tokens e TalkMe)

Do manual: abrir esta parte no manual completo ›

✅ 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.

Parâmetros › Pagamentos (provedor Pix)

Do manual: abrir esta parte no manual completo ›

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.

Como ligar o controle de caixa

Do manual: abrir esta parte no manual completo ›

1. Abra os parâmetros

   Configurações › Parâmetros › Financeiro, bloco "Caixa por atendente".

2. Escolha o modo

   Controle de caixa: Desligado / Aviso (recebe sem caixa aberto) / Bloqueio (exige caixa aberto). A própria tela recomenda: "Comece em Aviso". Depois que a equipe se acostumar, passe para Bloqueio.

3. Defina a tolerância e o expediente

   Tolerância de diferença no fechamento (R$) — acima dela, o fechamento exige justificativa. Hora de fim de expediente — caixa ainda aberto depois desse horário gera aviso. Se quiser, ligue o e-mail diário aos líderes (enviado às 07:30).

4. Escolha a conta de convênios

   No mesmo bloco, "Conta Padrão de Recebimento de Convênios" — usada em Gerar Contas a Receber quando o convênio não tem conta própria.

5. Defina quem é líder e conceda as permissões

   "Líder" é o administrador ou quem tem a ação Agir em registro de outro colaborador (EDIT_ALHEIO) em CONTAS CAIXAS. Conceda aos líderes e ao financeiro as ações da tabela de permissões em Permissões.

Lição: parâmetros e a chave da API

Do manual: abrir esta parte no manual completo ›

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.

✅ 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.

✅ 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".

Log de erros (administrador)

Do manual: abrir esta parte no manual completo ›

Menu "Log de erros". Novo — out/2026 Desde 30/10/2026 a tela é aberta a todo usuário logado (antes era só para administrador). 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.

Novo — out/2026 Erros de NFS-e (30/10/2026): origem "NFS-e", com os canais "Emissão automática" e "Aviso do provedor". A rejeição da emissão automática agora aparece aqui como erro (antes ficava "aguardando prefeitura").