Como importar o extrato e conciliar o banco#

Esta página resolve a conferência do banco: cadastrar a conta financeira, importar o extrato OFX, casar lançamento, aprovar a conferência e ler o saldo conferido. Quem opera: a conciliação ou o responsável financeiro.

Antes de começar — você precisa de:

permissão financeiro.conciliacao_bancaria;
permissão financeiro.conta_saldo para a tela de saldos e extrato;
a conta financeira cadastrada, com ao menos uma loja atribuída;
o arquivo OFX original do banco.

Parte 1 — Cadastrar a conta financeira#

Passo a passo#

Abra Financeiro > Contas financeiras.
Clique em Nova conta.
Informe o Nome da conta.
Escolha o Tipo.
Informe Banco (código), Agência, Número da conta e, se houver, o Dígito.
Em Lojas atendidas, marque as lojas da conta.
Deixe Ativa marcada e salve.

Campos e o que significam#

Campo	O que é	Observação
Nome da conta *	nome de uso	ex.: "Banco X — conta movimento", "Caixa Loja Centro", "Cofre"
Tipo *	`Conta corrente (banco)`, `Poupança (banco)`, `Caixa da loja` ou `Cofre`	a dica do campo é decisiva: "Só corrente e poupança têm extrato e aceitam importação de OFX."
Banco (código) *	código do banco	o sistema guarda só os dígitos: zero à esquerda e pontuação são formatação do banco
Agência *	agência	idem: só dígitos
Número da conta *	conta	idem
Dígito	dígito da conta	—
Lojas atendidas	lojas da conta	a dica avisa: "Conta corrente e poupança precisam de ao menos uma: sem loja, a conta não aparece na conciliação."
Ativa	se a conta está em uso	a dica avisa: "Conta inativa não aceita importação de extrato; o que já foi importado continua conferível."

Chips: Todas, Bancárias, Caixa e cofre, Inativas.

Cartões: Contas ("cadastradas"), Bancárias ("ativas, conciliáveis por OFX"), Caixa e cofre ("sem extrato") e Inativas ("fora do uso").

Parte 2 — Importar o extrato e conciliar#

Passo a passo#

Abra Financeiro > Conciliação bancária.
Escolha a Conta.
Clique em Importar extrato.
Escolha a Conta bancária e o Arquivo do extrato (OFX).
Confirme. O sistema confere se o arquivo é da mesma conta e recusa extrato de outra.
Percorra os chips: comece por Precisam de você.
Para as linhas Sem contrapartida, clique em Resolver e informe a natureza, a loja e a classificação.
Vá para Prontos para aprovar e clique em Preparar conferência.
Encerre sua etapa de preparação e encaminhe a conferência para outro usuário autorizado.
O outro usuário deve abrir e revisar a conferência. Após conferir, ele clica em Aprovar conferência e confirma.
Confira o resultado no chip Já conciliados.

Campos e o que significam#

Campo	O que é	Observação
Conta	a conta do extrato	"— escolha a conta" quando vazio
Conta bancária *	conta do arquivo	a dica avisa: "O arquivo precisa ser desta mesma conta; a importação confere e recusa extrato de outra."
Arquivo do extrato (OFX) *	o arquivo do banco	aceita `.ofx`. A dica avisa: "O mesmo arquivo pode ser reenviado sem duplicar lançamento."

Filtros e cartões#

Chips: Prontos para aprovar (automatico), Precisam de você (ambiguo), Sem contrapartida (sem_contrapartida), Já conciliados (conciliado).

Cartão	O que é
Lançamentos	total de lançamentos do período
Prontos para aprovar	lançamentos com candidato único e identidade nos dois lados
Precisam de você	lançamentos com candidato, mas nenhum automático
Sem contrapartida	nada no caixa corresponde — tarifa, rendimento e afins

Situações do lançamento#

Situação	O que significa	O que fazer
`automatico`	Prontos para aprovar: identidade nos dois lados	preparar e aprovar a conferência
`ambiguo`	Precisam de você: há candidato, mas nenhum é automático	decidir manualmente
`sem_contrapartida`	nada no caixa corresponde (tarifa, rendimento)	Resolver, criando o título
`conciliado`	já existe vínculo: o dinheiro é um evento conciliado	nada

Resolver um lançamento sem contrapartida#

Campo	O que é	Observação
Natureza *	`Tarifa bancária (saiu da conta)`, `Rendimento (entrou na conta)` ou `Ajuste do banco`	—
Loja	loja do lançamento	"Obrigatória quando a conta atende mais de uma loja."
Classificação	conta do plano de contas	"Escolha a conta do plano compatível com o sentido do lançamento."

O aviso da ação explica o efeito: ao resolver, o sistema cria um título — a pagar ou a receber, conforme o sentido.

Conferência#

Ação	O que faz
Preparar conferência	gera a conferência do período a partir do que está pronto
Abrir conferência nova	abre uma conferência nova para o período. A anterior continua no histórico
Aprovar conferência	aprova a conferência preparada por outra pessoa

Parte 3 — Saldos e extrato das contas#

Passo a passo#

Abra Financeiro > Saldos e extrato das contas.
Escolha a Conta no filtro, ou leia o consolidado.
Clique em Novo lançamento.
Escolha a Operação.
Preencha os campos conforme a operação.
Salve.

Campos e o que significam#

Campo	O que é	Observação
Operação *	`Saldo inicial`, `Transferência entre contas` ou `Ajuste (administrador)`	vem com Saldo inicial selecionado. A dica avisa: "Tudo aqui vira lançamento imutável no ledger."
Conta *	conta do lançamento	usado em saldo inicial e ajuste
Conta de origem * / Conta de destino *	as duas pontas da transferência	usados só na operação de transferência
Valor (R$) *	valor	a dica avisa: "Ajuste aceita negativo (ex.: -50,00) para correção de saída."
Data do lançamento	data do lançamento	—
Motivo	justificativa	"Obrigatório no ajuste; vai gravado no lançamento."

Chips: Todas, Bancárias, Caixa e cofre, Sem saldo inicial.

Cartões: Saldo das contas, Bancárias ("corrente e poupança"), Caixa e cofre ("guardado na operação") e Sem saldo inicial.

A ação Estornar transferência aparece na linha e pede confirmação: "Estornar a transferência INTEIRA (as duas contas, sinal contrário)?"

Resultado esperado#

A conta aparece na conciliação depois de ter ao menos uma loja atribuída.
O extrato importado aparece como Extrato do período, com os lançamentos classificados por situação.
A conferência aprovada muda o estado dos lançamentos para Já conciliados.
No extrato da conta, o cartão Saldo da conta mostra o saldo e Lançamentos a quantidade.
O resumo da tela de saldos informa quantas contas existem, o total e quantas estão Sem saldo inicial.

Se algo der errado#

Sintoma	Causa provável	O que fazer
"escolha o arquivo OFX do extrato para importar"	nenhum arquivo escolhido	selecione o OFX
"nao consegui ler o arquivo enviado; envie o OFX original do banco"	arquivo corrompido ou não é OFX	envie o arquivo original
Erro informando que "banco, agência ou conta do arquivo não conferem"	extrato da conta B enviado na conta A	escolha a conta certa, ou corrija o cadastro
"a identidade declarada no arquivo serve a mais de uma conta"	o arquivo omite a agência e o tenant tem a mesma conta em duas agências, ou duas agências colidem depois de normalizadas	conserte o cadastro; a recusa é deliberada, porque item de extrato é append-only
"esta conta bancária não tem loja atribuída. Atribua as lojas que ela atende antes de conciliar"	conta sem loja	edite a conta e marque as lojas
"conta de caixa ou cofre não tem extrato bancário. Escolha uma conta corrente ou poupança para conciliar"	tipo de conta errado para conciliação	escolha uma conta corrente ou poupança
"você preparou esta conferência, então não pode aprová-la"	segregação preparador ≠ aprovador	outra pessoa com o direito aprova
"esta conferência não registrou quem a preparou e por isso não pode ser aprovada"	sessão sem preparador	clique em Abrir conferência nova
"a conferência mudou desde que esta tela carregou. Atualize, revise de novo e aprove"	conflito de versão: outra pessoa agiu no meio	recarregue, revise e aprove
"o extrato ou o caixa mudaram depois desta conferência"	o hash das entradas venceu	clique em Abrir conferência nova
"esta conferência já foi aprovada. Abra uma conferência nova para conferir de novo"	sessão aprovada é terminal	Abrir conferência nova
"esta linha do extrato já foi conciliada; recarregue a tela para ver o estado atual"	lançamento já vinculado	recarregue a tela
"nao consegui confirmar o valor do lancamento; recarregue a tela e tente de novo"	valor do lançamento mudou	recarregue e tente de novo
"Período amplo demais: conciliar meio período em silêncio esconderia dinheiro que existe."	período maior que o permitido	reduza o período
"Período inválido: a data final não pode ser anterior à inicial."	datas invertidas	corrija as datas
"Conta sem loja atribuída: a conciliação não roda até o cadastro declarar quais lojas ela atende."	conta sem loja	edite a conta
"Conta caixa/cofre não tem extrato: dizer \"nenhum lançamento\" aqui afirmaria um estado que ninguém mediu."	tipo de conta sem extrato	escolha conta corrente ou poupança
"Conciliação bancária indisponível: o banco de dados do domínio financeiro não está configurado aqui."	ambiente sem banco	acione o suporte
"sem permissao para lancar em conta financeira"	falta `financeiro.conta_saldo`	peça a permissão
"ajuste exige a permissao financeiro.conta_ajuste"	falta a permissão de ajuste	peça a permissão
"informe um valor diferente de zero"	valor zerado	informe um valor
"ajuste exige motivo"	ajuste sem motivo	escreva o motivo
"somente transferencia estorna pela tela; lancamento de perna unica e revertido por ajuste"	tentou estornar um lançamento de perna única	reverta com um Ajuste
"esta transferencia ja tem o estorno total da tela registrado"	estorno já feito	não repita
"escolha a operacao: saldo inicial, transferencia ou ajuste"	operação não escolhida	escolha a operação

Como funciona por dentro#

Estados do arquivo importado#

Estado	O que significa
`recebido`	arquivo recebido, ainda não validado
`validado`	arquivo validado, ainda não processado
`processado`	importação concluída
`falhou`	importação falhou

Em operação normal o arquivo vai de recebido a processado na mesma transação: uma linha parada não é lentidão, é anomalia. O sistema considera "preso" um arquivo em recebido ou validado há mais de 15 minutos.

Idempotência#

Reimportar o mesmo arquivo é seguro e é a saída padrão: a idempotência é por (empresa, conta, sha256) e por (empresa, conta, identificador), então nada duplica.

Conferência e reversão#

A conferência é append-only por estado: aberta → gerada → aprovada, de mão única, e aprovada é terminal.
Cada reabertura cria uma sessão nova, com preparador próprio, hash próprio e histórico preservado.
Nunca apague nem edite sessão, candidato ou vínculo para "refazer": o vínculo é único por ponta e vale entre sessões, então a linha já conciliada continua conciliada.
Linha conciliada por engano não se apaga: o caminho é o estorno pelo livro, que é append-only.

Trava contra duplicidade#

Existe um parâmetro da empresa que, ligado, faz a conciliação recusar resolver manualmente um item de extrato que já tem uma transferência de caixa candidata vinculada — a sangria já creditou aquele item. Ligar evita contar o mesmo valor duas vezes; desligar remove a trava e cabe ao operador não duplicar o lançamento.

O livro é imutável#

Tudo o que a tela de saldos grava vira lançamento imutável no livro. Por isso a correção se faz por estorno e ajuste, nunca por edição.