Importar o extrato bancário e conciliar com as contas do sistema elimina digitação manual e reduz erro de fechamento.
Cadastrar conta bancária
Financeiro → Contas bancárias → Nova conta:
- Nome (ex.: “Banco do Brasil - corrente 12345-6”).
- Banco, agência, conta.
- Saldo inicial (opcional).
- Loja (opcional — útil pra filtrar).
Importar extrato
Conta bancária → Importar extrato. Aceita:
- OFX 1.x e 2.x (padrão dos bancos brasileiros).
- CSV brasileiro com:
- Separador
; - Data
DD/MM/YYYY - Decimal com vírgula
1.234,56 - Cabeçalho com colunas: Data, Descrição, Valor (positivo = crédito, negativo = débito).
- Separador
Arraste o arquivo e solte. O sistema:
- Parseia linha por linha.
- Cria uma
BankTransactionpor linha. - Idempotência via FITID — OFX tem FITID nativo, CSV gera SHA-1 sintético da linha + data + valor. Reimportar o mesmo arquivo não duplica.
- Mostra resumo:
X importadas, Y já existentes (ignoradas).
Matching automático
Cada transação importada ganha uma lista de candidatos a conciliar. O sistema busca contas a pagar (pra débito) ou receber (pra crédito) que:
- Estão com status
PENDING. - Têm valor pendente (
amount - paid_amount) próximo ao valor da transação (tolerância de R$ 0,02). - Têm
due_datedentro de ±15 dias da data da transação.
Quanto maior a pontuação de match, mais confiável.
Conciliar
Na lista de transações, clique na que quer parear:
- Mostra candidatos ordenados por relevância.
- Clique no candidato certo → Reconciliar.
- Sistema atualiza
paid_amountdo payable/receivable atomicamente ($transaction). Se ficou quite, marcaPAID. - Transação vira
reconciled: truee guarda opayable_idoureceivable_id.
Reverter
Se errou o pareamento, Desfazer reconciliação:
- Volta o
paid_amountprapaid_amount - valor. - Conta volta pra
PENDINGse ficou abaixo do total. - Transação volta pra não-reconciliada.
Regra 1:1
Cada transação pareia com exatamente uma conta (payable OU receivable, nunca os dois). Isso é uma decisão de design pra evitar ambiguidade — se um débito bancário corresponde a várias contas a pagar, você precisa:
- Pagar em uma delas com o total errado (antes de importar).
- Ou desmembrar manualmente as contas no sistema antes.
Pra casos raros de compensação múltipla, ainda é trabalho manual.
Só MANAGER
Criação de conta bancária, importação e conciliação requerem MANAGER (ou OWNER/ADMIN). Caixa e vendedor não tocam.