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 (planejado) gestão de glosas. O faturamento é o que abastece o financeiro nos atendimentos por convênio.

🟢 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çã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`

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)

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

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.

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

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

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.

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. 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 e o relatório de DRE por unidade/setor.

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.

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".
Administrar lote (/portal/lote/administrar-lote): acompanhar o processamento pela 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.
Geração de XML TISS para envio à operadora.

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.

🟠 Planejado (roadmap): a tela dedicada de Gestão de Glosas (registrar recurso, aceite, recuperação) ainda não está disponível em produção. Enquanto isso, recebimentos parciais de convênio são tratados como baixa parcial nas parcelas, mantendo o saldo restante em aberto para acompanhamento manual. Monitore o prazo: glosas não contestadas dentro do prazo do convênio são consideradas aceitas e viram perda de receita.

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 DRE
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:

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

🟠 Planejado (roadmap): permissões granulares / refactor de RBAC (#395) ainda não estão em produção. Hoje a permissão é sempre por papel + as 4 ações fixas acima.

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 (sem tela dedicada ainda)	Faça baixa parcial na parcela e acompanhe o saldo manualmente
Não encontro a tela "Contas a Receber"	Ela não é uma tela isolada	Use Registros com o filtro Tipo = "A Receber"

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.

🟠 Segue roadmap (não está em produção): links de pagamento (#409 — Sprint 3, em andamento) e integração bancária/CNAB (Sprint 9).

19. Pontos-chave

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.
Faturamento é TISS 4.03.00 em lotes; a tela de Gestão de Glosas ainda é roadmap.

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.
A ordem do ciclo de faturamento (pré-faturamento → fechar lote → administrar → gerar contas a receber → XML).
Que a Gestão de Glosas é planejada (roadmap) e como se trata glosa parcial hoje (baixa parcial).