Guias de Usuário Externo

Conciliação Bancária Manual — Manual de Uso

Manual de Uso — Conciliação Bancária Manual

Sumário

  1. Visão Geral
  2. Fluxo Completo Passo a Passo
  3. Conciliação Extrato × Recebimentos (com Cancelamentos e Ajustes)
  4. Conciliação Saldo Zero (Recebimentos × Ajustes)
  5. Ignorar Lançamentos do Extrato
  6. Filtros e Agrupamento
  7. Critério de Extrato Conciliado
  8. Abas Cartão e PIX
  9. Perguntas Frequentes

1. Visão Geral

A Conciliação Bancária Manual permite vincular manualmente lançamentos do extrato bancário com as contrapartidas do sistema (recebimentos, cancelamentos e ajustes), validando visualmente a diferença antes de concluir a operação.

Objetivo: Garantir que cada lançamento do extrato bancário receba um tratamento — seja conciliado com contrapartidas, seja marcado como ignorado — para que o extrato seja considerado conciliado.

Fluxo resumido:

Tela Inicial → Selecionar Banco → Selecionar Extrato → Workspace (4 painéis) → Conciliar

2. Fluxo Completo Passo a Passo

2.1. Tela Inicial

URL: /conciliation/manual

2.2. Selecionar Banco

URL: /conciliation/manual/banks

2.3. Selecionar Extrato

URL: /conciliation/manual/select?cod_banco=X&banco=NOME&conta=CONTA

2.4. Workspace — Painéis de Conciliação

URL: /conciliation/manual/workspace?extrato_id=DATA&cod_banco=X&banco=NOME&conta=CONTA&data_ini=DATA

O workspace é a tela principal, dividida em 4 painéis:

Painel Fonte Descrição
🏦 Extrato Bancário extratoBanco Lançamentos do extrato bancário (Status = 0)
💳 Recebimentos recebimentos + movimento Recebimentos agrupados por adquirente, bandeira, serviço e parcelamento
⚙️ Ajustes ajustesTaxas Ajustes de taxas (estornos, tarifas, etc.)
❌ Cancelamentos cancelamento Cancelamentos de transações

Cabeçalho do workspace:

Toast de diferença: indicador flutuante que mostra a diferença entre os valores selecionados. Fica verde quando a diferença é zero.

Rodapé com totais consolidados:

Botões de ação no rodapé:

3. Conciliação Extrato × Recebimentos (com Cancelamentos e Ajustes)

3.1. Como Funciona

O usuário seleciona manualmente:

  1. Um ou mais lançamentos do extrato (painel esquerdo)
  2. Contrapartidas (painéis direitos): recebimentos, cancelamentos e/ou ajustes

O sistema calcula a diferença em tempo real:

Diferença = Total Recebimentos - Total Extrato + Total Ajustes + Total Cancelamentos

A conciliação só é permitida quando Diferença = 0.

3.2. Passo a Passo da Conciliação

  1. Selecione lançamentos do extrato — marque os checkboxes no painel "Extrato Bancário".
  2. Selecione contrapartidas — marque recebimentos, ajustes e/ou cancelamentos nos painéis direitos.
  3. Observe o toast de diferença — ele muda de cor conforme o valor:
    • ⚪ Neutro (diferença = 0)
    • 🔴 Vermelho (diferença ≠ 0)
  4. Ajuste a seleção até a diferença ficar zero.
  5. Clique em "✅ Conciliar Seleção".
  6. Confirme a operação na caixa de diálogo.
  7. O sistema executa em transação:
    • Marca os lançamentos do extrato como conciliados (Status = 1)
    • Vincula recebimentos, ajustes e cancelamentos ao extrato
    • Invalida o cache
  8. Os itens conciliados somem da tela e as listas são recarregadas.

Validação extra: se você selecionar lançamentos do extrato com descrições diferentes, o sistema exibe um aviso de confirmação adicional.

3.3. Tratamento de Cancelamentos

Cancelamentos representam transações que foram estornadas/desfeitas. Eles aparecem no painel "Cancelamentos" com:

Como usar:

3.4. Tratamento de Ajustes

Ajustes representam taxas, tarifas ou correções aplicadas pela adquirente. Aparecem no painel "Ajustes" com:

Como usar:

4. Conciliação Saldo Zero (Recebimentos × Ajustes)

4.1. Quando Usar

Use a Conciliação Saldo Zero quando:

Exemplo típico: Um ajuste de taxa (negativo) compensa exatamente o valor de um recebimento (positivo), resultando em saldo zero. Não há lançamento correspondente no extrato bancário.

4.2. Passo a Passo

  1. Desmarque todos os lançamentos do extrato (o botão só fica ativo quando não há extrato selecionado).
  2. Selecione recebimentos e/ou ajustes cuja soma seja zero.
  3. Clique em "✅ Conciliar Saldo Zero".
  4. Confirme na caixa de diálogo.
  5. O sistema:
    • Cria um lançamento artificial no extrato com descrição "Recebimento saldo 0" e valor R$ 0,00
    • Vincula os recebimentos e ajustes a esse lançamento
    • Marca o lançamento artificial como conciliado

4.3. O que Acontece no Banco de Dados

  1. INSERT em extratoBanco com:
    • Descricao = 'Recebimento saldo 0'
    • Valor = 0.00
    • Status = 1 (conciliado)
    • vinculante = ID do próprio lançamento
  2. UPDATE nos recebimentos:
    • IdBancoExtrato = ID do lançamento criado
    • Baixa_Banco = '1'
    • BaixaExtrato = 1
    • DataDeposito = data do extrato
  3. UPDATE nos ajustesTaxas:
    • IdBancoExtrato = ID do lançamento criado

5. Ignorar Lançamentos do Extrato

5.1. O que é e para que serve

Ignorar um lançamento significa marcá-lo como desconsiderado para fins de conciliação, sem vinculá-lo a nenhuma contrapartida.

Quando usar:

Importante: Um extrato só é considerado conciliado quando todos os seus lançamentos receberam algum tratamento — seja conciliação com contrapartidas, seja ignorados.

5.2. Ignorar Lançamento Individual

  1. No painel "Extrato Bancário", localize o lançamento desejado.
  2. Clique no botão ⏭️ (ícone de ignorar) na coluna "Ação" do lançamento.
  3. Confirme na caixa de diálogo.
  4. O lançamento é marcado como ignorado (Status = 2) e exibe o badge "Ignorado".
  5. O checkbox fica desabilitado (não pode mais ser selecionado para conciliação).

5.3. Ignorar Lançamentos Selecionados (Grupo)

  1. No painel "Extrato Bancário", selecione (marque o checkbox) um ou mais lançamentos.
  2. Clique no botão "⏭️ Ignorar Selecionados" no rodapé.
  3. Confirme na caixa de diálogo.
  4. Todos os lançamentos selecionados são marcados como ignorados.

5.4. Ignorar Valores Negativos

  1. Clique no botão "⏭️ Ignorar Negativos" no rodapé.
  2. O sistema identifica automaticamente todos os lançamentos com valor negativo que ainda não foram ignorados.
  3. Confirme na caixa de diálogo.
  4. Todos os lançamentos negativos são marcados como ignorados de uma só vez.

Aviso: A operação de ignorar é irreversível pela interface. Uma vez confirmada, não pode ser desfeita pelo usuário.

5.5. Efeito no Banco de Dados

A API (POST /api/conciliation/manual/extrato/ignorar) executa:

UPDATE extratoBanco SET Status = 2 WHERE Id IN (id1, id2, ...)

6. Filtros e Agrupamento

6.1. Filtros

O botão 🔍 Filtros abre um drawer lateral com opções:

Filtro Descrição
Adquirente Filtra recebimentos por nome da rede (autocomplete)
Bandeira Filtra recebimentos por bandeira (autocomplete)
Serviço Filtra por tipo de serviço (multiselect: Débito, Crédito, PIX, etc.)
EC Filtra por código do estabelecimento (autocomplete)

6.2. Agrupamento

O botão 📊 Agrupar abre um drawer com opções de agrupamento dos recebimentos:

Opção Descrição
Adquirente Agrupa por rede (padrão)
Bandeira Agrupa por bandeira (padrão)
Serviço Agrupa por tipo de serviço (padrão)
Parcelamento Agrupa por número de parcelas (padrão)
Data Venda Agrupamento adicional
EC Agrupamento adicional por estabelecimento

7. Critério de Extrato Conciliado

Um extrato bancário é considerado conciliado quando todos os seus lançamentos receberam algum tratamento:

Tratamento Status no BD Descrição
Conciliado Status = 1 Vinculado a contrapartidas (recebimentos, ajustes, cancelamentos)
Ignorado Status = 2 Marcado como desconsiderado

Status do extrato (visível na tela de seleção):

Status Critério
🔴 Pendente Todos os lançamentos com Status = 0
🟡 Conciliando Pelo menos 1 lançamento com Status ≠ 0
🟢 Conciliado Todos os lançamentos com Status ≠ 0

Para finalizar a conciliação de um extrato:

  1. Para cada lançamento pendente, concilie com contrapartidas ou ignore.
  2. Quando todos os lançamentos tiverem Status ≠ 0, o extrato estará conciliado.

8. Abas Cartão e PIX

O workspace possui duas abas:

Aba Descrição
💳 Conciliação Cartão Conciliação de recebimentos de cartão (débito, crédito, voucher, etc.) com agrupamento
📱 Conciliação PIX Conciliação de recebimentos PIX (TpServico = 4), exibidos individualmente sem agrupamento

Diferenças entre as abas:

Característica Cartão PIX
Agrupamento Sim (adquirente, bandeira, serviço, parcelas) Não (cada recebimento é uma linha)
Filtros Sim Sim
Botão Conciliar Saldo Zero Sim Sim (específico para PIX)
Fonte de dados apiFetchRecebimentos apiFetchRecebimentosPix

9. Perguntas Frequentes

P: Posso conciliar sem selecionar nada no extrato? R: Sim, usando a opção "Conciliar Saldo Zero", desde que a soma dos recebimentos e ajustes selecionados seja zero.

P: O que acontece se eu ignorar um lançamento por engano? R: A operação é irreversível pela interface. Seria necessário reverter diretamente no banco de dados, alterando o Status de 2 para 0.

P: Por que o botão "Conciliar Seleção" está desabilitado? R: Verifique:

P: Como faço para ver extratos de meses anteriores? R: Na tela de seleção de extrato, clique em "📅 Extratos Mais Antigos" e escolha o mês desejado.

P: O que significa o badge "Ignorado" no extrato? R: Significa que o lançamento foi marcado como ignorado (Status = 2) e não será considerado para conciliação. Ele não pode mais ser selecionado.

P: Posso desmarcar um lançamento ignorado? R: Não pela interface. O checkbox fica desabilitado após ignorar.

P: A conciliação manual substitui a conciliação automática? R: Não. A conciliação manual é complementar, para casos em que a conciliação automática não conseguiu fazer o match ou quando o usuário precisa de controle granular sobre o que está sendo conciliado.

Documento gerado em 02/05/2026. Sistema de Conciliação Bancária — Manual de Uso da Conciliação Manual.

Tutoriais passo a passo