Extratos bancários
Extratos bancários importam o extrato de uma conta e criam lançamentos a partir dele. Os formatos aceitos são OFX e QIF.
Onde fica
Extratos não é uma tela própria e não tem item de menu. É uma aba dentro da conta:
Contas financeiras → abra a conta → aba Extratos.
Por isso não existe passo de "escolher a conta de destino": a conta é aquela em que você já está. É preciso ter uma empresa específica selecionada no cabeçalho — em "todas as empresas" o painel apenas avisa isso.
Formatos aceitos
| Formato | Extensão | Descrição |
|---|---|---|
| OFX | .ofx | Open Financial Exchange — padrão da maioria dos bancos |
| QIF | .qif | Quicken Interchange Format — formato legado, ainda usado por alguns bancos |
O botão Baixar exemplo oferece um arquivo de cada formato. São exemplos para você conhecer o formato, não modelos para preencher — um extrato se exporta do banco, não se escreve à mão.
Importar
- Exporte o extrato do seu banco em OFX ou QIF.
- Na aba Extratos da conta, envie o arquivo.
- O sistema lê o arquivo e mostra o que encontrou: quantos lançamentos são importáveis e quantos foram ignorados.
- Todas as linhas já vêm marcadas. Clique numa linha para desmarcá-la se não quiser importá-la.
- Clique em Importar N lançamentos.
A importação roda em segundo plano: você recebe o aviso "Importação iniciada em segundo plano" e acompanha por um diálogo de progresso — a tela não fica travada esperando.
Os lançamentos importados entram não conciliados. Para ligá-los aos títulos, use a Conciliação.
O que é ignorado
Três casos são descartados na leitura e contados, com o resumo na tela — "Ignorados: 2 com data futura, 1 com valor zero, 0 com data inválida.":
- Data futura
- Valor zero
- Data inválida (um valor ilegível também cai aqui)
Deduplicação
A dedup identifica a linha pelo identificador que o banco dá a ela (o FITID do OFX) — não por "mesmo valor, data e descrição". Quando o arquivo não traz esse identificador (o que é sempre o caso no QIF), o sistema gera uma chave a partir de data, valor e descrição mais a ordem de ocorrência, justamente para que duas linhas idênticas não sejam confundidas.
O que a deduplicação garante: reenviar o mesmo arquivo para a mesma conta não duplica nada. As linhas já conhecidas são puladas, e o histórico informa quantas foram.
O que ela não garante — e importa saber:
- Dois lançamentos genuinamente iguais entram os dois. Dois saques de R$ 50 no mesmo dia, com a mesma descrição, são dois lançamentos reais. O sistema os preserva de propósito.
- Não há dedup entre origens diferentes. O mesmo lançamento vindo por OFX, por QIF e pela sincronização do Gateway Bancário conta como três — cada origem gera sua própria chave.
- A dedup é por conta, não por espaço de trabalho.
- Nada é marcado na tela. A verificação acontece no servidor, na hora de importar — não no momento em que você revisa a lista.
Histórico
Abaixo do painel de importação, a seção Histórico lista os arquivos já importados: data, arquivo, status, quantos lançamentos entraram do total, e quem pediu. A seção só aparece quando há histórico.
Os status são Na fila, Processando, Concluído, Falha e Cancelado.
Desfazer
A ação Desfazer apaga os lançamentos que aquele arquivo criou e remove o extrato do histórico. O diálogo avisa: "Isso exclui os N lançamentos importados deste extrato. Não dá para reverter."
Se algum desses lançamentos já estava conciliado, desfazer também desmancha a conciliação.
A ação não aparece enquanto o extrato está Na fila ou Processando — espere terminar. Também não aparece em extratos vindos do Fintera: "Extratos vindos do Fintera não podem ser desfeitos aqui — desfaça no Fintera."
Apagar um lançamento do extrato
Apagar um lançamento que veio de um extrato é diferente de desfazer o extrato inteiro, e a diferença aparece na próxima importação:
- Apagou o lançamento — ele não volta. Importar o mesmo arquivo de novo, ou sincronizar o Gateway Bancário outra vez, não o traz de volta: o sistema lembra que você o removeu.
- Desfez o extrato — aí sim, importar o arquivo de novo traz tudo. É o caminho para recomeçar.
É por isso que apagar a linha resolve, mesmo sem Desfazer. O extrato do Gateway Bancário não tem lote para desfazer, e a sincronização traz o histórico inteiro da conta toda vez. Sem essa garantia, a linha que você apagasse voltaria na sincronização seguinte — e se você já tivesse lançado a correção à mão, o valor apareceria duas vezes.
Outras origens de extrato
Além do arquivo, o extrato pode vir de:
- Gateway Bancário — o botão Sincronizar extrato, na tela de integração, traz os lançamentos das contas vinculadas da empresa selecionada.
- Fintera — importa o extrato espelhado da plataforma.
Nenhuma das duas roda sozinha. Não há agendamento: as duas são um botão que você aperta.
O extrato do Gateway Bancário não aparece no Histórico desta aba. Ele não é um arquivo — o gateway devolve uma lista de lançamentos, sem o conceito de "extrato importado". Os lançamentos aparecem normalmente na conta; o lote não, e por isso não há Desfazer para ele. Para tirar uma linha, apague o lançamento: ele não volta na próxima sincronização (ver Apagar um lançamento do extrato). O registro dessas execuções fica na própria tela do Gateway Bancário.