BankReconciliation (Conciliacao Bancaria)

O BankReconciliation representa o processo de conciliacao entre extratos bancarios e transacoes do sistema.

Descricao

A conciliacao bancaria permite comparar o extrato do banco com as transacoes registradas no sistema, identificando divergencias e garantindo a acuracidade dos registros financeiros.

Dados

Informacoes da Conciliacao

Campo	Tipo	Obrigatorio	Descricao
reference_date	Data	Sim	Data de referencia
status	Selecao	Sim	Status da conciliacao
bank_balance	Monetario	Sim	Saldo no extrato bancario
system_balance	Monetario	Calculado	Saldo no sistema
difference	Monetario	Calculado	Diferenca entre saldos
notes	Texto	Nao	Observacoes

Status

Status	Descricao
pending	Aguardando conciliacao
in_progress	Em andamento
completed	Conciliada
with_difference	Concluida com diferenca

Relacionamentos

Pertence a

Entidade	Obrigatorio	Descricao
Account	Sim	Conta do petshop
Store	Sim	Filial
FinancialAccount	Sim	Conta bancaria
User	Sim	Usuario que fez a conciliacao

Possui

Entidade	Descricao
ReconciliationItems	Itens conciliados
ReconciliationAdjustments	Ajustes feitos

ReconciliationItem

Descricao

Cada item representa uma transacao sendo conciliada.

Dados

Campo	Tipo	Descricao
financial_transaction_id	Referencia	Transacao do sistema
bank_transaction_id	Texto	ID no extrato bancario
bank_date	Data	Data no extrato
bank_value	Monetario	Valor no extrato
system_value	Monetario	Valor no sistema
status	Selecao	conciliated, pending, divergent
notes	Texto	Observacoes

Status do Item

Status	Descricao
pending	Aguardando verificacao
conciliated	Valores conferem
divergent	Valores divergem
not_found	Nao encontrado no sistema
duplicate	Possivel duplicidade

Fluxo de Conciliacao

Importacao de Extrato

Formatos Suportados

Formato	Extensao	Descricao
OFX	.ofx	Open Financial Exchange
CSV	.csv	Valores separados por virgula
PDF	.pdf	Extrato em PDF (OCR)

Campos do Extrato

Campo	Descricao
date	Data da transacao
description	Descricao/Historico
value	Valor (positivo/negativo)
balance	Saldo apos transacao
reference	Numero de referencia

Match Automatico

Criterios de Match

O sistema tenta conciliar automaticamente por:

1. Valor exato + Data: Mesmo valor na mesma data
2. Valor exato + Range de data: Mesmo valor em +/- 3 dias
3. Referencia: Numero de referencia igual
4. Descricao: Palavras-chave na descricao

Regras de Match

Prioridade	Criterio	Confianca
1	Referencia identica	Alta
2	Valor + Data exatos	Alta
3	Valor + Data proxima	Media
4	Descricao similar	Baixa

Ajustes

ReconciliationAdjustment

Quando ha diferenca, pode-se criar ajustes:

Campo	Tipo	Descricao
type	Selecao	Tipo do ajuste
value	Monetario	Valor do ajuste
description	Texto	Justificativa
financial_category_id	Referencia	Categoria do ajuste

Tipos de Ajuste

Tipo	Descricao	Exemplo
bank_fee	Taxa bancaria	Tarifa de manutencao
interest	Juros	Juros de aplicacao
correction	Correcao	Erro de lancamento
rounding	Arredondamento	Diferenca de centavos
other	Outro	Justificar

Geracao de Transacao

Ajustes geram transacoes financeiras automaticamente:

Ajuste de taxa bancaria R$ 25,00
  -> Cria FinancialTransaction
     type: expense
     value: 25.00
     category: "Tarifas Bancarias"

Calculo de Saldos

Saldo do Sistema

saldo_sistema = soma(transacoes_confirmadas) no periodo

Saldo do Banco

saldo_banco = ultimo_saldo no extrato importado

Diferenca

diferenca = saldo_banco - saldo_sistema

Relatorio de Conciliacao

Dados do Relatorio

Secao	Conteudo
Resumo	Saldos, diferenca, status
Conciliados	Itens conferidos
Pendentes	Itens nao conciliados
Divergentes	Itens com diferenca
Ajustes	Ajustes realizados

Exportacao

Disponivel em PDF e Excel.

Validacoes

Campo	Regra
reference_date	Obrigatorio
financial_account_id	Obrigatorio
bank_balance	Obrigatorio para concluir

Regras de Negocio

Periodo de Conciliacao

1. Recomendado: mensal
2. Pode ser feito por periodo customizado
3. Nao pode sobrepor conciliacoes anteriores

Transacoes Elegiveis

Apenas transacoes com:

• Status: confirmed ou done
• Conta: a conta sendo conciliada
• Data: dentro do periodo

Finalizacao

Para concluir:

1. Todos os itens devem estar conciliados ou justificados
2. Diferenca deve ser zero ou ter ajuste registrado
3. Usuario deve confirmar

Reabertura

Conciliacoes finalizadas podem ser reabertas por:

• Administradores
• Com justificativa obrigatoria

Automacoes

Ao Importar Extrato

1. Parseia arquivo
2. Carrega transacoes do sistema
3. Executa match automatico
4. Marca itens pendentes

Ao Concluir

1. Marca transacoes como conciliadas
2. Gera transacoes de ajuste
3. Atualiza saldo da conta
4. Registra historico

Permissoes

Acao	Descricao
Criar	Iniciar conciliacao
Importar	Importar extrato
Conciliar	Marcar itens como conciliados
Ajustar	Criar ajustes
Concluir	Finalizar conciliacao
Reabrir	Reabrir conciliacao fechada