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:

🟢 Em produção: contas a pagar/receber, conta/caixa, centro de custo, movimentação financeira, tipos de conta/pagamento/categoria e faturamento TISS (pré-faturamento, fechar/administrar lote, contas a receber, geração de XML).

Onde fica: menu principal → Financeiro. Rotas em produção (todas sob /portal/):

FunçãoRota
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

FiltroOpções
TipoA Pagar, A Receber
StatusPendente, Pago, Parcialmente Pago
DataPeríodo (data inicial e final, formato dd/mm/aaaa)
BeneficiárioPaciente, Convênio, Colaborador, Fornecedor, Empresa
Conta/CaixaPor conta cadastrada
CategoriaPor categoria de pagamento

3.2 Status dos lançamentos

StatusSignificado
PendenteValor ainda não pago/recebido
PagoValor pago/recebido integralmente
Parcialmente PagoParte 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):

  1. Acesse Financeiro → Registros e clique em "+ A Pagar" ou "+ A Receber".
  2. 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.
  3. Preencha os dados do lançamento (ver tabela de campos abaixo).
  4. Defina o Parcelamento: UNITARIO (pagamento único) ou AGRUPADO (parcelado). Se parcelado, informe número de parcelas e intervalo.
  5. Clique em Salvar. O lançamento aparece na lista com status Pendente.

4.1 Campos do lançamento

CampoDescrição / validaçãoObrigatório?
Pagar para / Receber deOrigem: PACIENTE, CONVENIO, COLABORADOR, EMPRESA, FORNECEDOR, PRODUTO, OUTRA_DESPESA. Exatamente uma origem por lançamento.Obrigatório
DataData de vencimento ou pagamento, no formato dd/mm/aaaa.Obrigatório
ValorValor em reais, formato R$ 1.234,56.Obrigatório
Conta / CaixaConta bancária ou caixa onde ocorre a movimentação. Precisa estar cadastrada antes.Obrigatório
Categoria de pagamentoAgrupamento para análise (ex.: Consultas, Salários). Base para o DRE gerencial (coluna "Linha do DRE" na categoria).Obrigatório
Centro de custoDepartamento/área que recebe a receita ou despesa.Obrigatório
Tipo de pagamentoForma: Dinheiro, PIX, cartão, transferência, cheque, etc.Obrigatório
Nota FiscalNúmero da NF vinculada.Opcional
ParcelamentoUNITARIO ou AGRUPADO.Obrigatório
Nº de parcelas / intervaloSe 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
Regra prática: toda movimentação financeira exige, obrigatoriamente, conta/caixa + categoria de pagamento + centro de custo + tipo financeiro (PAGAMENTO ou RECEBIMENTO) + data + valor + uma origem. Sem esses, o lançamento não salva.

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.

Atenção ao nome: não existe uma tela exclusiva "Contas a Receber do Faturamento". O botão "Gerar contas a receber" apenas cria automaticamente um lançamento de entrada com parcelas, que passam a aparecer na tela de Registros filtrada por "A Receber". Descontos só são aplicados com solicitante e aprovador registrados.

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

  1. Acesse Financeiro → Contas e Caixas (/portal/financeiro/contas-caixa).
  2. Clique em "+ Novo".
  3. Informe nome, tipo (banco/caixa/carteira), saldo inicial e unidade.
  4. Salve. A conta fica disponível para seleção em todos os lançamentos.
  5. O Histórico de Contas (/portal/financeiro/historico-contas) mostra a evolução do saldo por conta.
Implantação: cadastre pelo menos uma conta ou caixa antes de registrar qualquer lançamento — caso contrário o campo obrigatório "Conta/Caixa" fica vazio e o lançamento não salva.

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ívelLimite típicoPerfil
Nível 1até 5%Recepcionista
Nível 2até 10%Coordenador
Nível 3até 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

  1. 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.
  2. Fechar lote (/portal/faturamento/fechar-lotes): agrupar as guias por convênio e período de competência; o lote fica com status "Fechado".
  3. 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).
  4. Administrar lote (/portal/lote/administrar-lote): acompanhar o retorno da operadora, valores aprovados e glosados.
  5. Gerar contas a receber (/portal/lote/gerar-contas-a-receber): cria os lançamentos e parcelas a receber no Financeiro.
💰 Aprofunde — como o Rabi chega ao preço? Os valores das guias e dos lançamentos nascem da conversão do convênio — os 3 níveis de conversão, as 3 linhas de cada item e o modo pacote estão explicados de ponta a ponta na nova área Preços e Conversão de Valores.

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:

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

✅ Rework de Glosas ENTREGUE ✅ Novo — ago/2026: os fluxos de registro de glosa foram unificados com histórico corrigido (#585); a baixa/glosa passa a ser AUTOMÁTICA a partir do retorno TISS real (#586); há relatório agregado de glosas por convênio/motivo/período (#587); e os status de guia foram unificados — 3 mecanismos viraram 1 (#588). Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização. Detalhes na lição de Faturamento. Monitore o prazo: glosas não contestadas dentro do prazo do convênio são consideradas aceitas e viram perda de receita.
✅ Novo — 23/10/2026 Caminho novo para o pagamento do convênio: Faturamento › Recebimentos de convênio (#686). Importe o demonstrativo (ou digite), confira os totais, informe data e conta e clique em Baixar: as contas a receber ficam pagas (pagamento parcial deixa o saldo em aberto), a glosa é registrada com motivo e vai para Glosas, e a guia vira Paga / Paga parcial / Glosada. Lançar glosa manual numa cobrança que já tem valor recebido dá "Complete a baixa em Faturamento > Recebimentos de convênio". A baixa pela tela Glosas continua só para os casos antigos. Passo a passo na lição de Faturamento.

15. Integrações do Financeiro

Vem deO que chegaImpacto no Financeiro
📅 AgendamentoAtendimento particular finalizadoGera lançamento de Contas a Receber automaticamente
📋 ProntuárioProcedimentos realizados (particular)Cada procedimento gera lançamento individual de cobrança
📄 FaturamentoLote de convênio aprovadoCria contas a receber do valor aprovado pela operadora
📦 EstoqueCompra/consumo de produtos (Registro Financeiro)Atualiza a posição de estoque: entrada soma, saída subtrai
Financeiro →📈 RelatóriosAlimenta Fluxo de Caixa, Repasses e o DRE gerencial (✅ em produção desde 28/09/2026, #617)
Financeiro →📊 DashboardAtualiza 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).

GrupoCobreAções
FINANCEIRORegistros, conta/caixa, categorias, centro de custo, tiposVIEW, CREATE, UPDATE, DELETE
FATURAMENTOPré-faturamento, lotes, glosasVIEW, CREATE, UPDATE
🟢 ENTREGUE (set/2026) ✅ Novo — set/2026: as permissões granulares (#395) entraram em produção em 15/09 — permissões finas por funcionalidade/ação, além do papel + 4 ações acima (ver a lição de Segurança). Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.

17. Erros comuns e como resolver

SituaçãoCausa provávelSolução
Não consigo salvar o lançamentoFalta conta/caixa, categoria ou centro de custo (campos obrigatórios)Cadastre os três cadastros-mestre antes; preencha todos os obrigatórios
Desconto bloqueadoPercentual acima da alçada do colaboradorPeça aprovação de um superior com nível suficiente
Recebimento de convênio não apareceLote ainda não foi fechado / contas a receber não geradasFeche o lote e use "Gerar contas a receber do lote"
Valor recebido a menos do convênioGlosa parcialDesde 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 RabiO 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 erradaCategoria sem "Linha do DRE" entra pela regra padrão do tipo de movimentaçãoClassifique a categoria em Financeiro › Categorias de Pagamento (coluna Linha do DRE)
Não encontro a tela "Contas a Receber"Ela não é uma tela isoladaUse Registros com o filtro Tipo = "A Receber"
Ao receber, abriu a janela "Abrir o caixa" ✅ Novo — 12/10/2026O controle de caixa está ligado e você não tem caixa abertoClique 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/2026Ela tem parcela paga — desde 12/10 a exclusão é bloqueadaUse 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/2026Sem "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/2026As 9 ações novas de CONTAS CAIXAS nascem sem ninguémPeça ao administrador para liberar a ação no perfil.
Não aparece o ícone "Link de pagamento (Pix)" na parcela ✅ Novo — 15/10/2026Nenhum provedor Pix ativo, ou a parcela já está paga / não é recebimentoPeç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/2026A 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/2026O módulo adicional não foi ativado pelo time RabiUse 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/20265 senhas de aprovação de desconto erradas em 15 minutosAguarde 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.

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.

🟠 Segue roadmap (não está em produção): links de pagamento (#409 — Sprint 12, 25/09–02/out), revisão da importação de XML TISS no Financeiro (#630 — Sprint 12, segue em reteste; a parte do #631 foi corrigida em produção em 29/09 — orientação temporária na seção 18.3) e integração bancária (#343 — Sprint 13, 02–09/out). ✅ Atualização 13/10: a Sprint 12 fechou em 02/10; os links (#409) estão na Sprint 14; a integração bancária Open Finance (#651) segue no roadmap — o que entrou foi a Conciliação Bancária por arquivo OFX (seção 18.4); ✅ Atualização 15/10: os links de pagamento Pix (#409) estão em produção desde 13/10 e o Open Finance (#651) tem código no ar, mas é módulo adicional que nasce desligado (🟡 Chegando) — ver seção 18.5; #630 parcial (01/10): envio do lote, Desvincular guia e filtros em produção; só o casamento automático guia × atendimento ainda pede cautela.

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.

18.3. Em produção desde 28/09/2026 ✅ em produção desde 28/09/2026

✅ Novo — 29/09/2026 ⚠️ Importação de XML TISS no Financeiro — em revisão (#630/#631, Sprint 12, prioridade 2). O botão Importar XML de Financeiro › Registros Financeiros e a Conciliação XML Externo estão sendo retestados na versão atual (pontos observados num piloto — não é erro confirmado). Orientação temporária: antes de importar muitos arquivos, teste com poucos, numa conta caixa separada; depois de importar, confira o valor do lançamento com o do arquivo; não importe o mesmo arquivo duas vezes; e confira o saldo A Receber da conta caixa depois de excluir uma importação.
✅ 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.
📦 Conta a pagar gerada pela Nota Fiscal de Entrada (#391, Compras): nasce sem parcelas e sem vencimento da nota e com o total só dos produtos (frete, impostos e desconto não entram) — ajuste no financeiro depois de confirmar o recebimento. As melhorias são o #629 (roadmap). ✅ Atualização 13/10: em produção desde 09/10: a conta a pagar fecha com o valor total da nota (produto + frete + seguro + outras + impostos − desconto), com as parcelas das duplicatas do XML (editáveis na conferência) ou parcela única, e o recebimento pode ser estornado. Ver a lição de Estoque.

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)

  1. 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.
  2. 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".
  3. Libere as ações novas de CONTAS CAIXAS para quem confere caixa, concilia ou estorna (ninguém as recebe sozinho).
  4. 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

Mudou em 22/10/2026: o item Caixa saiu do menu. Tudo fica em Financeiro › Contas Caixa, com as abas Contas e Turnos por atendente; dentro de cada conta, Lançamentos e Turnos desta conta, e as sangrias aguardando aceite. O funcionamento (abrir, contar, sangria, conferir) segue igual. O campo de valor (troco inicial, estorno) ficou no estilo de app de banco: os números entram da direita para a esquerda.

18.4.3 Comprovantes, quem recebeu, estorno e transferência

18.4.4 Conciliação Bancária por arquivo OFX

18.4.5 Também em outubro

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.

  1. 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".
  2. 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".
  3. 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>".
  4. 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.
  5. 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

18.6. Novidades de 15–23/10/2026 ✅ Novo — 23/10/2026

19. Pontos-chave

20. O que a prova vai cobrar

  1. Quais campos são obrigatórios em uma movimentação financeira (conta/caixa, categoria, centro de custo, tipo, data, valor, origem).
  2. Como se formam as "Contas a Receber" para particular × convênio, e por que não há tela isolada.
  3. 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.
  4. 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.
  5. 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
  6. 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.
  7. 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.
  8. ✅ 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.
  9. ✅ 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).
  10. ✅ 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".