Lição: Financeiro (Contas, Caixa, Centro de Custo)
Esta lição prepara você para operar e configurar o módulo Financeiro do Sistema Rabi do zero. Ao final, você saberá registrar lançamentos a pagar e a receber, controlar contas e caixas, classificar despesas por categoria e centro de custo, e entender como o faturamento de convênios alimenta o financeiro. Tudo o que está aqui é o que existe em produção hoje; o que ainda é planejamento aparece separado na caixa amarela de roadmap.
1. Objetivo do módulo e onde fica
O módulo Financeiro controla toda a vida financeira da clínica. Ele se divide em duas grandes áreas complementares:
- Financeiro: lançamentos de contas a pagar e a receber, controle de caixa, categorias e centros de custo.
- Faturamento: geração e gestão de guias de convênio, fechamento de lotes e gestão de glosas (rework entregue em ago/2026). O faturamento é o que abastece o financeiro nos atendimentos por convênio.
Onde fica: menu principal → Financeiro. Rotas em produção (todas sob /portal/):
| Função | Rota |
|---|---|
| Registros financeiros (lista) | /portal/financeiro/registros |
| Novo a pagar | /portal/financeiro/registros/pagar/criar |
| Novo a receber | /portal/financeiro/registros/receber/criar |
| Contas e caixas | /portal/financeiro/contas-caixa |
| Histórico de contas | /portal/financeiro/historico-contas |
| Tipos de conta | /portal/financeiro/tipos-de-conta |
| Tipos de pagamento | /portal/financeiro/tipos-de-pagamento |
| Categorias de pagamento | /portal/financeiro/categorias-de-pagamento |
| Centro de custo | /portal/financeiro/centro-de-custo |
| Turnos de caixa ✅ Novo — 23/10/2026 — a tela "Caixa" saiu do menu em 22/10; tudo fica em Contas Caixa (abas Contas e Turnos por atendente) | /portal/financeiro/contas-caixa |
| Conciliação Bancária ✅ Novo — 12/10/2026 | /portal/financeiro/conciliacao-bancaria |
Grupos de permissão: FINANCEIRO (registros, caixa, categorias, centro de custo) e FATURAMENTO (guias, lotes, glosas).
2. Como o financeiro é estruturado
Entenda a espinha dorsal antes de operar. A Movimentação Financeira é o hub central: toda entrada e saída passa por ela, vinculando categoria, centro de custo, conta/caixa e a origem (paciente, fornecedor ou outra).
Atendimento particular / Orçamento / Lote de convênio
↓
Movimentação Financeira ←— hub central
├→ Registro Financeiro (detalhe item-a-item)
├→ Duplicatas / parcelas (vencimentos)
└→ Desconto Financeiro
↑
Centro de Custo · Categoria de Pagamento · Conta/Caixa (cadastros-mestre)
Os três cadastros-mestre (conta/caixa, categoria de pagamento e centro de custo) precisam existir antes de qualquer lançamento, porque a movimentação exige os três.
3. Tela de Registros Financeiros
A tela principal (/portal/financeiro/registros) lista todos os lançamentos, tanto a pagar quanto a receber. Cada lançamento representa uma movimentação financeira da clínica.
3.1 Filtros da lista
| Filtro | Opções |
|---|---|
| Tipo | A Pagar, A Receber |
| Status | Pendente, Pago, Parcialmente Pago |
| Data | Período (data inicial e final, formato dd/mm/aaaa) |
| Beneficiário | Paciente, Convênio, Colaborador, Fornecedor, Empresa |
| Conta/Caixa | Por conta cadastrada |
| Categoria | Por categoria de pagamento |
3.2 Status dos lançamentos
| Status | Significado |
|---|---|
| Pendente | Valor ainda não pago/recebido |
| Pago | Valor pago/recebido integralmente |
| Parcialmente Pago | Parte do valor foi paga/recebida (baixa parcial) |
✅ Novo — 23/10/2026 Desde 22/10/2026 o pagamento parcial vira uma parcela paga + o saldo em aberto (a parte que falta fica numa parcela própria, em aberto).
4. Criar um lançamento financeiro (passo a passo)
Para registrar manualmente uma entrada (a receber) ou saída (a pagar):
- Acesse Financeiro → Registros e clique em "+ A Pagar" ou "+ A Receber".
- No campo "Pagar para" (ou "Receber de"), escolha o tipo de origem: PACIENTE, CONVENIO, COLABORADOR, EMPRESA, FORNECEDOR, PRODUTO ou OUTRA_DESPESA, e busque pelo nome, CPF ou CNPJ.
- Preencha os dados do lançamento (ver tabela de campos abaixo).
- Defina o Parcelamento: UNITARIO (pagamento único) ou AGRUPADO (parcelado). Se parcelado, informe número de parcelas e intervalo.
- Clique em Salvar. O lançamento aparece na lista com status Pendente.
4.1 Campos do lançamento
| Campo | Descrição / validação | Obrigatório? |
|---|---|---|
| Pagar para / Receber de | Origem: PACIENTE, CONVENIO, COLABORADOR, EMPRESA, FORNECEDOR, PRODUTO, OUTRA_DESPESA. Exatamente uma origem por lançamento. | Obrigatório |
| Data | Data de vencimento ou pagamento, no formato dd/mm/aaaa. | Obrigatório |
| Valor | Valor em reais, formato R$ 1.234,56. | Obrigatório |
| Conta / Caixa | Conta bancária ou caixa onde ocorre a movimentação. Precisa estar cadastrada antes. | Obrigatório |
| Categoria de pagamento | Agrupamento para análise (ex.: Consultas, Salários). Base para o DRE gerencial (coluna "Linha do DRE" na categoria). | Obrigatório |
| Centro de custo | Departamento/área que recebe a receita ou despesa. | Obrigatório |
| Tipo de pagamento | Forma: Dinheiro, PIX, cartão, transferência, cheque, etc. | Obrigatório |
| Nota Fiscal | Número da NF vinculada. | Opcional |
| Parcelamento | UNITARIO ou AGRUPADO. | Obrigatório |
| Nº de parcelas / intervalo | Se AGRUPADO: quantidade de parcelas e intervalo (DIA/SEMANA/MÊS) — gera N duplicatas automaticamente. | Condicional |
| A cada (recorrência) | Para lançamentos recorrentes: MENSAL, ANUAL, dia da semana. | Opcional |
5. Contas a Receber
Lista todos os valores que a clínica tem a receber: consultas particulares, procedimentos, pagamentos parcelados e lotes de convênio aprovados. Os valores a receber são compostos por parcelas (duplicatas) vinculadas a um lançamento financeiro.
- Particular: o lançamento nasce diretamente do atendimento finalizado.
- Convênio: o lançamento nasce após o fechamento do lote no Faturamento (função "Gerar contas a receber do lote").
6. Contas a Pagar
Lista todas as despesas da clínica: fornecedores, colaboradores (salários e repasses), despesas operacionais, impostos, etc. O fluxo de criação é o mesmo da seção 4, escolhendo "+ A Pagar".
7. Contas e Caixas
Gerencia os cofres físicos e contas bancárias da clínica. Todo lançamento financeiro precisa estar vinculado a uma conta/caixa. Suporta contas bancárias, caixas físicos e carteiras digitais, com histórico e saldo corrente.
7.1 Como cadastrar uma conta ou caixa
- Acesse Financeiro → Contas e Caixas (
/portal/financeiro/contas-caixa). - Clique em "+ Novo".
- Informe nome, tipo (banco/caixa/carteira), saldo inicial e unidade.
- Salve. A conta fica disponível para seleção em todos os lançamentos.
- O Histórico de Contas (
/portal/financeiro/historico-contas) mostra a evolução do saldo por conta.
8. Tipos de Pagamento
Cadastro das formas de pagamento aceitas pela clínica (/portal/financeiro/tipos-de-pagamento). Exemplos padrão: Dinheiro, PIX, Cartão de Débito, Cartão de Crédito, Transferência Bancária, Cheque e Outros (configurável).
9. Tipos de Conta
Cadastro dos tipos de conta usados nas movimentações (/portal/financeiro/tipos-de-conta). Classifica as contas/caixas por natureza.
10. Categorias de Pagamento
Agrupamento de lançamentos para análise gerencial (/portal/financeiro/categorias-de-pagamento). São categorias hierárquicas (Receitas vs Despesas) e servem de base para o DRE gerencial — ✅ em produção desde 28/09/2026 a coluna "Linha do DRE" classifica cada categoria na linha do DRE (sem classificação, vale uma regra padrão pelo tipo de movimentação). Exemplos: Consultas Particulares, Convênios, Insumos e Materiais, Pessoal (salários, repasses), Despesas Administrativas, Impostos e Taxas.
11. Centro de Custo
Alocação de despesas e receitas por departamento, especialidade, unidade ou projeto (/portal/financeiro/centro-de-custo). Toda movimentação é vinculada a um centro de custo, o que permite análise financeira segmentada (o DRE gerencial, em produção desde 28/09/2026, filtra por centro de custo — ver seção 18.3).
12. Desconto financeiro com aprovação por nível
Descontos em lançamentos são controlados por nível de permissão do colaborador. O sistema valida se quem lança tem alçada para o percentual solicitado:
| Nível | Limite típico | Perfil |
|---|---|---|
| Nível 1 | até 5% | Recepcionista |
| Nível 2 | até 10% | Coordenador |
| Nível 3 | até 20% | Gerente |
| Sem limite | — | Diretor |
Desconto acima do limite do colaborador é bloqueado e exige aprovação de um superior. Descontos só se aplicam com solicitante e aprovador registrados.
✅ Novo — 15/10/2026 Senha de aprovação (13–14/10): na aprovação pela senha do colaborador, 5 senhas erradas em 15 minutos bloqueiam por 15 minutos ("Muitas tentativas de autenticação…" / na aprovação presencial: "Muitas tentativas de senha para este aprovador. Aguarde 15 minutos ou peça a aprovação remota."). A aprovação remota continua funcionando.
✅ Novo — 26/09/2026 Aprovações em tempo real (24/09/2026): pedidos de aprovação de desconto, farol e edição/cancelamento de Atendido chegam em tempo real a todos os aprovadores do nível exigido ou superior (um pedido de Nível 2 chega ao Nível 2 e ao Nível 3); quando um responde, o pedido some da tela dos demais. Canais isolados por clínica.
✅ Novo — 26/09/2026 Orçamento já pago não recebe desconto: no orçamento com financeiro, depois de pago o valor trava — não se altera valor nem se dá desconto ("O orçamento desta sessão já foi pago — não é possível alterar o valor nem dar desconto."). Antes do pagamento, o desconto dado no acolhimento vale para o orçamento e todas as sessões.
✅ Novo — ago/2026 O "nível de desconto" foi renomeado para "nível de alçada" (#557) e as aprovações por nível de alçada foram entregues (épico #571): a solicitação notifica todos os usuários do nível e, quando um responde, resolve para todos (#558). Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
13. Faturamento de Convênios (visão geral)
Faturamento é o processo de cobrar as operadoras de saúde pelos atendimentos de convênio, feito em lotes mensais. O padrão é TISS 4.03.00. Pré-requisito: o atendimento precisa estar autorizado (quando exigido), finalizado no prontuário e vinculado ao convênio correto no agendamento.
13.1 Ciclo do faturamento
- Pré-faturamento (
/portal/guia2/list/pre-faturamento): revisar e corrigir as guias antes de fechar o lote — procedimentos, valores, número de autorização, dados do paciente e convênio. - Fechar lote (
/portal/faturamento/fechar-lotes): agrupar as guias por convênio e período de competência; o lote fica com status "Fechado". - XML TISS (gerado no lote fechado): a clínica envia o arquivo pelo portal/canal da operadora e registra o protocolo no Rabi (envio automático por webservice = roadmap, épico #618).
- Administrar lote (
/portal/lote/administrar-lote): acompanhar o retorno da operadora, valores aprovados e glosados. - Gerar contas a receber (
/portal/lote/gerar-contas-a-receber): cria os lançamentos e parcelas a receber no Financeiro.
14. Glosas
Glosa é a recusa ou redução de pagamento por parte da operadora. Alguns campos de glosa já podem ser configurados no convênio hoje:
- Limite de Recurso de Glosa: prazo máximo para contestar (em dias).
- Prazo de Pagamento de Recurso de Glosa: prazo para a operadora responder ao recurso.
Para alterar esses campos, abra o convênio e clique em Liberar para edição — desde 29/09/2026 o convênio existente abre em modo consulta (#632).
15. Integrações do Financeiro
| Vem de | O que chega | Impacto no Financeiro |
|---|---|---|
| 📅 Agendamento | Atendimento particular finalizado | Gera lançamento de Contas a Receber automaticamente |
| 📋 Prontuário | Procedimentos realizados (particular) | Cada procedimento gera lançamento individual de cobrança |
| 📄 Faturamento | Lote de convênio aprovado | Cria contas a receber do valor aprovado pela operadora |
| 📦 Estoque | Compra/consumo de produtos (Registro Financeiro) | Atualiza a posição de estoque: entrada soma, saída subtrai |
| Financeiro → | 📈 Relatórios | Alimenta Fluxo de Caixa, Repasses e o DRE gerencial (✅ em produção desde 28/09/2026, #617) |
| Financeiro → | 📊 Dashboard | Atualiza indicadores do Dashboard Financeiro |
16. Permissões
Modelo atual: papel (Role) + 4 ações fixas por módulo — VIEW, CREATE, UPDATE, DELETE. Grupos que cobrem o financeiro:
✅ Atualização 13/10: desde 12/10 (#650) há 9 ações novas em CONTAS CAIXAS — CONFERIR_CAIXA, REABRIR_CAIXA, RECEBER_OUTRA_CONTA, ALTERAR_RECEBEDOR, BAIXA_RETROATIVA, CONCILIAR, DESCONCILIAR, EXCLUIR_COMPROVANTE e ESTORNAR — e ninguém as recebe automaticamente: o administrador libera no perfil. "Líder" = admin ou quem tem EDIT_ALHEIO em CONTAS CAIXAS. As telas de caixa (desde 22/10, Contas Caixa › Turnos por atendente) e Conciliação Bancária usam CONTAS CAIXAS › VIEW. ✅ Novo — 23/10/2026 Na lista redesenhada (15–16/10) os níveis aparecem como Sem Permissão / Visualizar / Criar / Editar / Total. A rota de movimentação passou a usar a permissão real "REGISTROS FINANCEIROS" (antes, quem não era admin recebia 403).
| Grupo | Cobre | Ações |
|---|---|---|
FINANCEIRO | Registros, conta/caixa, categorias, centro de custo, tipos | VIEW, CREATE, UPDATE, DELETE |
FATURAMENTO | Pré-faturamento, lotes, glosas | VIEW, CREATE, UPDATE |
17. Erros comuns e como resolver
| Situação | Causa provável | Solução |
|---|---|---|
| Não consigo salvar o lançamento | Falta conta/caixa, categoria ou centro de custo (campos obrigatórios) | Cadastre os três cadastros-mestre antes; preencha todos os obrigatórios |
| Desconto bloqueado | Percentual acima da alçada do colaborador | Peça aprovação de um superior com nível suficiente |
| Recebimento de convênio não aparece | Lote ainda não foi fechado / contas a receber não geradas | Feche o lote e use "Gerar contas a receber do lote" |
| Valor recebido a menos do convênio | Glosa parcial | Desde 23/10/2026, baixe o pagamento em Faturamento › Recebimentos de convênio (importar o demonstrativo ou digitar): a diferença vira glosa com motivo e o saldo fica em aberto. A baixa pela tela Glosas fica só para casos antigos. ✅ Novo — 23/10/2026 |
| Importei XML TISS e apareceram avisos por guia ("sem valorTotalGeral" ou "soma dos itens não bate") | Desde 29/09/2026 (#631) o lançamento usa o valorTotalGeral de cada guia e o sistema avisa guia sem valor ou com soma dos itens diferente (os avisos não bloqueiam) | Confira cada guia avisada contra o arquivo antes de seguir; registre o caso com o time Rabi se o valor estiver errado |
| "Importação não realizada para não gerar lançamento de R$ 0,00" | Nenhuma guia do lote tem valor (#631 — bloqueio antes de gravar) | Confira o arquivo com a operadora/sistema de origem; nada foi gravado |
| Guia importada não casou com a guia do Rabi | O casamento automático segue em revisão (#630) | Vincule manualmente; siga a orientação temporária (poucos arquivos, conta caixa separada, conferir o A Receber após excluir) |
| DRE com categoria na linha errada | Categoria sem "Linha do DRE" entra pela regra padrão do tipo de movimentação | Classifique a categoria em Financeiro › Categorias de Pagamento (coluna Linha do DRE) |
| Não encontro a tela "Contas a Receber" | Ela não é uma tela isolada | Use Registros com o filtro Tipo = "A Receber" |
| Ao receber, abriu a janela "Abrir o caixa" ✅ Novo — 12/10/2026 | O controle de caixa está ligado e você não tem caixa aberto | Clique em "Abrir caixa e continuar". "Seguir sem abrir" só existe no modo Aviso; no modo Bloqueio, só líder e admin recebem sem caixa. ✅ Novo — 23/10/2026 O botão "Abrir caixa" leva a Financeiro › Contas Caixa. |
| Não consigo excluir uma movimentação ✅ Novo — 12/10/2026 | Ela tem parcela paga — desde 12/10 a exclusão é bloqueada | Use o Estornar no Histórico da Conta (o líder estorna; o original fica no histórico). |
| Gerar Contas a Receber do lote dá erro de conta ✅ Novo — 12/10/2026 | Sem "Conta de recebimento" no convênio nem "Conta Padrão de Recebimento de Convênios" nos Parâmetros (a conta não é mais criada sozinha) | Preencha uma das duas (convênio: Liberar para edição → aba Dados → Salvar). |
| Não aparece a ação de conferir/reabrir caixa ou de conciliar ✅ Novo — 12/10/2026 | As 9 ações novas de CONTAS CAIXAS nascem sem ninguém | Peça ao administrador para liberar a ação no perfil. |
| Não aparece o ícone "Link de pagamento (Pix)" na parcela ✅ Novo — 15/10/2026 | Nenhum provedor Pix ativo, ou a parcela já está paga / não é recebimento | Peça ao administrador para cadastrar e ativar o provedor em Parâmetros › Pagamentos (links) |
| O paciente pagou o Pix, mas a parcela não baixou ✅ Novo — 15/10/2026 | A baixa automática falhou (aparece em Links de Pagamento › "Pagos sem baixa") | Dê a baixa manualmente, conforme o motivo informado |
| "Open Finance não configurado no servidor (credenciais do agregador)." ✅ Novo — 15/10/2026 | O módulo adicional não foi ativado pelo time Rabi | Use a Conciliação Bancária por arquivo OFX; fale com o time Rabi sobre o módulo |
| "Muitas tentativas de autenticação. Aguarde 15 minutos e tente novamente." ✅ Novo — 15/10/2026 | 5 senhas de aprovação de desconto erradas em 15 minutos | Aguarde 15 minutos ou peça a aprovação remota |
18. Novidades de julho/2026 ✅ Novo — jul/2026
Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
- Pagamento de sessões (#335): registro do pagamento de sessões no Financeiro.
- Ajuste de serviços de colaboradores para repasse (#344): ajuste dos serviços de colaboradores usados no cálculo de repasse.
18.1. Novidades de agosto/2026 ✅ Novo — ago/2026
Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
- Vínculo registro financeiro ↔ agendamento ↔ guia na importação (#422): a importação de faturamento passa a vincular os registros financeiros ao agendamento e à guia.
- Backfill dos vínculos (#423): os vínculos também foram preenchidos retroativamente para os registros já existentes.
18.2. ✅ Novidades — set/2026 ✅ Novo — set/2026
Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
- NFS-e no ato do pagamento (#467): ao registrar o recebimento, o Rabi já pode emitir a NFS-e. ✅ Novo — 26/09/2026 O módulo fiscal completo está em produção desde 22/09/2026 (1ª fase desde set; modelos de nota #465, tela Notas NFS-e com cancelar/substituir/pendências #468 e onboarding fiscal #472 desde 22/09).
- Emissão de NFS-e por convênio (#466) e emissão assíncrona (#469): a nota é processada em segundo plano, sem travar o caixa.
- Opt-in do módulo NFS-e (#471): a emissão é opcional e habilitada por clínica.
- NFS-e direto do agendamento/orçamento (#594) — ver a lição de Faturamento para o módulo fiscal completo.
- Pendências de alçada na Central de Notificações (#559): liberações de alçada (ex.: farol vermelho) chegam como pendência na Central para o aprovador.
- Tela de Auditoria (#185): consulta de quem fez o quê e quando em tela própria do sistema (acesso restrito a administradores).
- ✅ Novo — 26/09/2026 Orçamento com várias sessões = financeiro único (em produção desde 24/09/2026; orçamentos criados a partir de 25/09): todas as sessões compartilham uma movimentação financeira com o valor total do orçamento (nunca valor × sessões). O pagamento é feito na tela do orçamento ou no acolhimento — pago de um lado, aparece pago nos dois. Orçamento particular com financeiro pode ser agendado sem pagar, mas só é acolhido pago; depois de pago, o valor trava. O acolhimento bloqueia cobrança em dobro (sessões com movimentações diferentes ou financeiro diferente do total).
- ✅ Novo — 26/09/2026 NFS-e por parcela do orçamento particular: em orçamento 100% particular com financeiro próprio, a nota das sessões sai pelo lado do orçamento, por parcela paga (sem duplicar); orçamento misto ou sem financeiro próprio segue emitindo pela movimentação.
- ✅ em produção desde 28/09/2026 Pagamento parcial antecipado (#604): saiu da homologação — ver seção 18.3.
- Zero é zero nas contas a receber do lote (23/09/2026): as contas a receber geradas do lote respeitam a regra "zero é zero" — valor convertido
0,00entra como preço zero de verdade (não é substituído pelo valor de cadastro); só o campo vazio na conversão do convênio faz o sistema descer de nível.
18.3. Em produção desde 28/09/2026 ✅ em produção desde 28/09/2026
- DRE gerencial (#617) — saiu do roadmap: em Relatórios › DRE Gerencial. Filtros: período com regime de competência × caixa, Unidade, Convênio, Centro de custo e Categoria. Visão mês a mês, com as linhas Receita líquida, Lucro bruto, Resultado operacional, Resultado líquido e o % da receita líquida. O botão Ver lançamentos abre o detalhe de cada linha; há Exportar XLSX e Imprimir.
- Coluna "Linha do DRE" nas Categorias de Pagamento: em Financeiro › Categorias de Pagamento, classifique cada categoria na linha do DRE em que ela deve aparecer. Categoria sem classificação entra por uma regra padrão pelo tipo de movimentação — classifique as categorias para o DRE sair do jeito que a clínica analisa.
- Pagamento parcial antecipado (#604): serviço configurado para exigir pagamento parcial (percentual mínimo + prazo da reserva) faz o agendamento nascer "Pendente de Pagamento", segurando o horário; sem o pagamento, expira sozinho e libera o horário. 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). ✅ Atualização 13/10: #409 na Sprint 14; desde 12/10 a confirmação do sinal exige Conta caixa e Forma de pagamento e gera recebimento próprio (sem NFS-e). ✅ Atualização 15/10: desde 13/10 a confirmação pode ser automática pelo link Pix (#409), quando a clínica tem provedor Pix ativo — ver seção 18.5.
- Conta a receber de convênio gerada no faturamento passa a usar o centro de custo padrão dos Parâmetros (com correção de valores/unidade).
- Filtros padrão (#396): as principais listas buscam e ordenam no servidor — a busca percorre toda a base filtrada, não só a página visível.
✅ Novo — 30/09/2026 Atualização 30/09 — #631 corrigida em produção desde 29/09/2026 (#630 segue aberta): o lançamento usa sempre o valorTotalGeral da guia (antes, guia com valor só em "outras despesas" entrava com R$ 0,00 e "sucesso"); lote em que nenhuma guia tem valor é bloqueado antes de gravar ("Importação não realizada para não gerar lançamento de R$ 0,00"); avisos por guia (não bloqueiam) para guia sem valorTotalGeral (entrou com R$ 0,00) e para guia cuja soma dos itens não bate com o valorTotalGeral; excluir uma importação libera o número do lote para reimportar e respeita o convênio (o mesmo número de lote em outro convênio não é afetado); guias de importação excluída não aparecem mais como pendência e não podem ser casadas/vinculadas. Seguem em reteste (#630): casamento automático de guias, filtros da lista e saldo A Receber ao excluir. Orientação temporária ajustada: testar primeiro com poucos arquivos numa conta caixa separada; ler os avisos por guia; conferir o saldo A Receber depois de excluir uma importação; o casamento automático pode não casar — vincular manualmente quando preciso; boa prática: não importar o mesmo arquivo duas vezes. ✅ Atualização 13/10: do #630 entraram em produção em 01/10 a situação/protocolo/data de envio do lote à operadora (modal "Importar XML TISS" e coluna/filtro Envio na Conciliação XML Externo › Auditoria), o Desvincular guia (restaura o estado anterior ao casamento) e os filtros de data, valor e conta caixa na lista de movimentações. Continue vinculando manualmente o que o casamento automático não casar — essa parte não foi confirmada como resolvida.
18.4. Caixa, comprovantes, estorno e conciliação bancária (#650) ✅ Novo — 12/10/2026
Em produção desde 12/10/2026 — revisão geral do financeiro. O controle de caixa nasce DESLIGADO: cada clínica liga em Configurações › Parâmetros › Financeiro, bloco "Caixa por atendente". Telas, comprovantes, estorno, conciliação e relatórios já funcionam.
18.4.1 Como ligar (implantação)
- Em Parâmetros › Financeiro › Caixa por atendente, escolha o Controle de caixa: Desligado / Aviso (recebe sem caixa aberto) / Bloqueio (exige caixa aberto) — a própria tela recomenda: comece em Aviso.
- Defina a Tolerância de diferença no fechamento (R$), a hora de fim de expediente e o e-mail diário aos líderes (07:30). No mesmo lugar fica a "Conta Padrão de Recebimento de Convênios".
- Libere as ações novas de CONTAS CAIXAS para quem confere caixa, concilia ou estorna (ninguém as recebe sozinho).
- Em Tipos de Pagamento, confira a coluna nova "Comprovação": Automática (pelo nome) / Dinheiro (conferência do caixa) / Pix (identificador ou comprovante) / Cartão (NSU ou comprovante) / Transferência (comprovante + conciliação) / Não exige comprovação.
18.4.2 Turnos de caixa (Financeiro › Contas Caixa › Turnos por atendente) ✅ Novo — 23/10/2026
- Abrir e operar o próprio turno (antes "Meu caixa"): abrir o caixa (conta caixa + troco inicial; também "Abrir caixa em outra conta"); Registrar sangria e Registrar suprimento (valem depois do aceite do líder); cancelar com o motivo "Aberto por engano"; Fechar caixa com contagem cega ("Dinheiro contado", sem mostrar o esperado) e "Justificativa (obrigatória se houver diferença)" acima da tolerância; lista de recebimentos sem comprovante (ou "Tudo comprovado"); resumo por forma de pagamento.
- Turnos por atendente (antes "Caixas por atendente"; painel do líder): filtro por período e Situação (Aberto, Aguardando conferência, Conferido, Divergente, Cancelado); conferência (conferido ou divergente, podendo aceitar a quebra de caixa, que gera lançamento); Reabrir com motivo; aceite ou recusa de sangrias e suprimentos; fechamento em PDF com assinaturas.
- Regras: uma sessão aberta por atendente e conta; o líder nunca confere o próprio caixa; reabrir e estornar exigem alçada nível 2 ou 3 (admin passa); depois do fechamento, a parcela paga não muda — correção só por estorno.
- Com o controle ligado: ao salvar um recebimento (Agenda › Receber ou Registros Financeiros) sem caixa aberto, abre "Abrir o caixa" ("Abrir caixa e continuar" / "Seguir sem abrir", só no modo Aviso); a agenda mostra "Você não tem caixa aberto…" com o botão Abrir caixa; no modo Bloqueio, líder e admin recebem sem caixa.
18.4.3 Comprovantes, quem recebeu, estorno e transferência
- Comprovantes da parcela: o botão de anexo da parcela (Agenda › Receber e Registros Financeiros), que antes não fazia nada, abre o diálogo — vários arquivos por parcela, com autor e data, "Excluir (com motivo)" e os campos ID da transação / Pix, NSU (cartão), Autorização (cartão) e Recebido por. Arquivos antigos aparecem como "Comprovante antigo (sem autor registrado)".
- Quem recebeu × quem registrou: o sistema grava Recebido por, Liquidado por e a hora da baixa; indicar outra pessoa como recebedora exige a ação ALTERAR_RECEBEDOR.
- Estorno: botão "Estornar" no Histórico da Conta (valor até o pago; motivo com no mínimo 5 caracteres) lança o inverso e mantém a parcela original no histórico; o estorno é feito pelo líder: exige a ação Estornar (CONTAS CAIXAS) e alçada Nível 2 ou 3; o administrador também pode. Excluir movimentação com parcela paga é bloqueado — o caminho é o estorno.
- Transferência: campo Tipo (Transferência / Sangria / Suprimento); o aceite é do dono da conta de destino, do líder ou do admin; recusar pede motivo.
- Histórico da Conta Caixa: filtros Conciliadas/Não conciliadas, Com anexo/Sem anexo e quem deu a baixa; colunas Recebido por e Liquidado por. Registros Financeiros ganhou o botão "Histórico de alterações".
18.4.4 Conciliação Bancária por arquivo OFX
- Importar extrato OFX; filtros Pendentes / Conciliados / Ignorados / Todos; sugestões com "Confiança da sugestão" e busca manual; Conciliar ou Baixar e conciliar (no título de lote de convênio, dá a baixa com o valor creditado e a diferença segue para glosa); Desfazer; Ignorar com motivo (ex.: tarifa bancária).
- Não é Open Finance: a integração bancária automática (#651) 🟡 Chegando tem tela desde 13/10, mas é módulo adicional que nasce desligado e depende do time Rabi — o caminho é o OFX. ✅ Atualização 15/10: a baixa automática por link Pix existe desde 13/10 (#409, seção 18.5), quando a clínica tem provedor Pix ativo.
18.4.5 Também em outubro
- Relatórios › Financeiro: "Recebimentos por Atendente" e "Conciliação: pago × conciliado".
- Avisos no sino (Parâmetros › Notificações, ligados por padrão): Atendido sem recebimento, Recebimentos sem comprovante, Caixa pendente, Transferência aguardando aceite, Títulos vencidos, Pagamento sem conciliar e Lotes vencidos sem crédito — com escalonamento para líder e gestor.
- Convênio: campo "Conta de recebimento" na aba Dados (usado no Gerar Contas a Receber do lote).
- Sinal / pagamento parcial: a confirmação exige Conta caixa e Forma de pagamento (identificador opcional), gera movimentação de recebimento própria, sem NFS-e, e o agendamento mostra "Sinal já recebido". ✅ Atualização 15/10: ou é feita sozinha pelo link Pix (#409, desde 13/10).
- Os limites dos Parâmetros Financeiros (máximo de parcelas e valor mínimo por parcela) passaram a ser aplicados; saldo, histórico e fluxo de caixa deixaram de contar movimentação excluída.
- Repasse: calculado sobre o valor líquido (total − desconto) desde 06/10; serviço zerado no pré-faturamento repassa sobre zero (vazio usa o cadastro) — ver a lição de Relatórios.
- Pedido de desconto mostra paciente e serviço (#637).
- Ainda não pronto: a glosa dá baixa só na primeira parcela. ✅ Novo — 23/10/2026 Para o pagamento do convênio, use Faturamento › Recebimentos de convênio (23/10).
18.5. Links de pagamento Pix (#409) e Open Finance (#651) — 13/10/2026 ✅ Novo — 13/10/2026
18.5.1 Links de pagamento Pix — em produção desde 13/10
Opcional: só funciona depois que a clínica contrata a API Pix com o banco (o banco fornece certificado e credenciais) e cadastra e ativa o provedor. Sem provedor ativo, nada aparece nas telas de cobrança.
- Configurar (administrador): Configurações › Parâmetros › aba "Pagamentos (links)" (permissão PARAMETROS; alterar = UPDATE) → Novo provedor → tipo "Pix — API padrão Banco Central (qualquer banco)": banco, URL da API Pix, URL do token (OAuth), escopos, chave Pix da clínica, validade do link (padrão 1440 minutos = 24 h), Client ID/secret, certificado do banco (.pfx/.p12 e senha, ou PEM), conta caixa onde o dinheiro cai e forma de pagamento da baixa (vazio = a forma Pix cadastrada). Testar conexão ("Conexão com o provedor OK."), Cadastrar aviso (aviso automático de pagamento no provedor) e ativar. Só um provedor fica ativo por vez; há "Desligar links" e "Histórico de vigência".
- Gerar o link: ícone "Link de pagamento (Pix)" na parcela em aberto (gerador de parcelas do registro financeiro) ou botão "Link de pagamento" no aviso de sinal do agendamento "Pendente de Pagamento".
- Enviar: a janela mostra o QR Code, "Copiar Pix copia e cola", "Enviar ao paciente" (WhatsApp, SMS ou e-mail — vazio = o contato do cadastro) e "Cancelar link" (pede motivo). O paciente recebe "<descrição>: R$ X. Pague por Pix pelo link: <url>".
- Baixa automática: pelo aviso do banco ou por verificação a cada 5 minutos, sempre consultando a cobrança — "Baixa feita no financeiro.". O Pix do sinal confirma o agendamento sozinho.
- Acompanhar: Financeiro › "Links de Pagamento" (menu novo) — filtros Aguardando pagamento, Pagos sem baixa ("Pagos no banco, mas a baixa automática falhou") e Agendamento online. Se a baixa falhar: "A baixa automática falhou: <motivo>. Dê a baixa manualmente."
Permissões para ver/gerar: REGISTROS FINANCEIROS, CONTAS CAIXAS ou AGENDAMENTO/ACOLHIMENTO/CONFIRMAÇÃO (VIEW para ver, UPDATE para gerar). Link é só para recebimento. Gateways de cartão/boleto (Asaas, Pagar.me etc.) não existem — só Pix padrão Banco Central. A issue segue aberta (melhorias), mas a função está no ar.
18.5.2 Open Finance (#651) — 🟡 Chegando módulo adicional
O código e as telas estão no ar desde 13/10, mas o módulo nasce desligado, é adicional (cobrado por conta conectada) e depende de o time Rabi ativar o agregador. Telas visíveis: Configurações › Parâmetros › aba "Registro Financeiro" › bloco "Conciliação bancária" (caixa "Conciliação bancária automática (Open Finance) — módulo adicional, cobrado por conta conectada", "Avisar extrato sem conciliar há (dias)" e "Avisar autorização do banco vencendo em (dias)"); Financeiro › "Contas Conectadas (Open Finance)"; e, na Conciliação Bancária, o selo Open Finance e "Não foi lançado no financeiro — criar lançamento a partir do extrato". Sem o agregador ativo, conectar responde "Open Finance não configurado no servidor (credenciais do agregador)." Não conte com a conciliação automática: o caminho continua sendo importar o OFX (seção 18.4.4). Confirme com o time Rabi antes de ligar.
18.5.3 Também em 13–15/10
- Desconto por sessão do orçamento espelhado no financeiro do agendamento (13/10).
- Senha de aprovação de desconto: 5 senhas erradas em 15 minutos → "Muitas tentativas de autenticação. Aguarde 15 minutos e tente novamente."; senha errada → "Não foi possível autenticar o colaborador. Confira a senha e tente novamente." Na aprovação presencial (desconto, cancelamento e edição de Atendido), 5 erros em 15 minutos travam aquele aprovador ("…Aguarde 15 minutos ou peça a aprovação remota.").
- Listas com teto: 100 itens por página (seletores de conta caixa, centro de custo etc. até 500; relatórios e exportações até 10.000) — pedido acima do teto é reduzido sem erro: use a paginação ou a exportação.
- Permissão no servidor: registros e movimentação financeira exigem REGISTROS FINANCEIROS VIEW para leitura; duplicatas e glosas também passaram a conferir a permissão. Quem usa essas telas com o perfil normal continua usando.
- Seguem valendo: Open Finance desligado por padrão e a glosa dando baixa só na primeira parcela (seção 18.4.5).
18.6. Novidades de 15–23/10/2026 ✅ Novo — 23/10/2026
- Caixa saiu do menu (22/10): Financeiro › Contas Caixa › abas Contas e Turnos por atendente; na conta, Lançamentos e Turnos desta conta; sangrias aguardando aceite. O botão "Abrir caixa" leva para lá.
- Regras financeiras (22/10):
- pagamento parcial vira parcela paga + saldo em aberto;
- cancelar agendamento ou orçamento encerra os títulos e os links de pagamento;
- agendamento Atendido e pago exige estorno antes de cancelar ou alterar;
- particular avulso só é acolhido pago;
- guia com contas a receber gerado ou em lote enviado não é mais editável; lote enviado não reabre;
- "Preencher Valor Pago" usa a data de hoje.
- Recebimentos de convênio (23/10, #686): baixa do pagamento do convênio pelo demonstrativo — ver a lição de Faturamento.
- Relatórios › Pareto (21/10): análises 80/20 de despesas por fornecedor, categoria e centro de custo — ver a lição de Relatórios.
- Log de erros com as origens Estoque, Financeiro e Orçamento e filtro por usuário; tabelas com 30 linhas por página.
19. Pontos-chave
- ✅ Novo — 23/10/2026 O caixa fica em Financeiro › Contas Caixa › Turnos por atendente (o item "Caixa" saiu do menu em 22/10). Pagamento parcial = parcela paga + saldo em aberto; Atendido pago só se cancela/altera depois do estorno; lote enviado não reabre. O pagamento do convênio se baixa em Faturamento › Recebimentos de convênio.
- Todo lançamento exige conta/caixa + categoria + centro de custo + tipo + data + valor + origem.
- Cadastros-mestre (conta/caixa, categoria, centro de custo) vêm antes dos lançamentos.
- Particular gera lançamento direto do atendimento; convênio gera após fechar o lote.
- "Contas a Receber" = lançamentos de entrada com parcelas, vistos na tela de Registros filtrada.
- Desconto é validado por nível de alçada do colaborador; acima do limite exige aprovação — desde ago/2026 a aprovação notifica todos do nível e resolve para todos quando um responde (épico #571).
- Orçamento com várias sessões (criado a partir de 25/09/2026) tem um financeiro só, com o valor total; particular com financeiro só acolhe pago; pago, o valor trava (sem desconto); NFS-e do orçamento 100% particular sai por parcela paga.
- Faturamento é TISS 4.03.00 em lotes; o rework de Glosas foi entregue em ago/2026 (#585–#588): fluxos unificados, baixa/glosa automática do retorno TISS, relatório agregado e status de guia unificados.
- ✅ Desde 28/09/2026: DRE gerencial em Relatórios (competência × caixa, mês a mês, Ver lançamentos, XLSX) — as categorias ganham a coluna "Linha do DRE"; e o pagamento parcial antecipado (#604, confirmação manual — ✅ Atualização 15/10: ou automática pelo link Pix, desde 13/10).
- Importação de XML TISS no Financeiro: desde 29/09/2026 (#631) lança o valorTotalGeral de cada guia, bloqueia o lote sem nenhum valor, mostra avisos por guia e, ao excluir a importação, libera o número do lote. ⚠️ #630 segue em revisão: teste com poucos arquivos numa conta caixa separada, leia os avisos por guia, confira o A Receber após excluir e vincule manualmente o que não casar.
- ✅ Novo — 12/10/2026 Caixa por atendente (abrir, sangria/suprimento, fechar com contagem cega, conferência do líder), comprovantes da parcela, estorno (exclusão de movimentação paga bloqueada), transferência com aceite e Conciliação Bancária por OFX (#650). O controle de caixa nasce Desligado — ligue em Parâmetros › Financeiro, começando em Aviso — e as 9 ações novas de CONTAS CAIXAS precisam ser liberadas. Open Finance (#651) e links de pagamento (#409) seguem roadmap. ✅ Atualização 15/10: links de pagamento Pix em produção desde 13/10 (com provedor Pix ativo; baixa e confirmação do sinal automáticas); Open Finance com tela, mas módulo adicional desligado (🟡 Chegando).
20. O que a prova vai cobrar
- Quais campos são obrigatórios em uma movimentação financeira (conta/caixa, categoria, centro de custo, tipo, data, valor, origem).
- Como se formam as "Contas a Receber" para particular × convênio, e por que não há tela isolada.
- A regra de aprovação de desconto por nível de alçada — pedidos chegam em tempo real a todos do nível exigido ou superior — e que orçamento já pago não recebe desconto.
- A ordem do ciclo de faturamento (pré-faturamento → fechar lote → XML TISS → administrar lote → gerar contas a receber) — a mesma da lição de Faturamento.
- Que o rework de Glosas foi entregue em ago/2026: baixa/glosa automática a partir do retorno TISS (#586) e relatório agregado (#587). Desde 23/10/2026 o pagamento do convênio é baixado em Recebimentos de convênio (o relatório agregado calcula o glosado como faturado − pago). ✅ Novo — 23/10/2026
- Que a importação de XML TISS no Financeiro lança o valorTotalGeral da guia, bloqueia lote sem valor e traz avisos por guia que o operador deve ler (#631, em produção desde 29/09/2026), e que o #630 parcial (01/10): envio do lote, Desvincular guia e filtros em produção; só o casamento automático guia × atendimento ainda pede cautela.
- Que o DRE gerencial (#617) está em produção desde 28/09/2026 (a resposta antiga "DRE é roadmap" está desatualizada), onde fica (Relatórios › DRE Gerencial), a diferença entre regime de competência e de caixa e o papel da coluna "Linha do DRE" das categorias.
- ✅ Novo — 12/10/2026 Como ligar o controle de caixa (Parâmetros › Financeiro: Desligado / Aviso / Bloqueio — começar em Aviso), que excluir movimentação com parcela paga é bloqueado (o caminho é o estorno, feito pelo líder) e que a conciliação bancária é por arquivo OFX (Open Finance é roadmap). ✅ Atualização 15/10: Open Finance = módulo adicional que nasce desligado; o OFX continua o caminho.
- ✅ Novo — 23/10/2026 Onde fica o caixa depois de 22/10 (Contas Caixa › Turnos por atendente), as regras de 22/10 (parcial, cancelamento encerra títulos, estorno antes de mexer em Atendido pago, lote enviado não reabre) e qual é o caminho novo do pagamento do convênio (Recebimentos de convênio).
- ✅ Novo — 15/10/2026 Como funciona o link de pagamento Pix (#409): onde se cadastra o provedor (Parâmetros › Pagamentos (links), um ativo por vez, exige API Pix contratada com o banco), onde se gera (parcela em aberto e sinal do agendamento), que o pagamento dá baixa sozinho e confirma o sinal, e o que fazer com "Pagos sem baixa".