07 - Importação e Conciliação de CSV Bancário¶

Este fluxo de trabalho traz novas transações da Sparkasse para o Beancount e confirma que o livro-razão ainda corresponde à conta bancária real.

Onde ocorrem as importações¶

Antes de exportar da Sparkasse¶

1. Abra o arquivo do livro-razão correto.
2. Encontre a seção Balance Checks (Verificações de Saldo).
3. Encontre a data do último saldo para a conta Sparkasse.
4. Verifique também a seção Bank Dump (Depósito Bancário) na parte inferior para a última data importada.
5. Use a data posterior dessas como seu ponto de partida.

Isso evita a perda de transações ou a importação do mesmo período duas vezes.

Exportando da Sparkasse¶

1. Abra a visão geral da conta.
2. Filtre por intervalo de datas.
3. Comece a partir da última data verificada ou importada.
4. Termine com hoje ou a data de conciliação desejada.
5. Exporte como Excel (CSV-CAMT V2).
6. Copie o CSV baixado para a pasta test correta.

Os scripts esperam o formato Sparkasse CSV-CAMT-V2 com colunas separadas por ponto e vírgula.

Convertendo o CSV¶

Abra um terminal na pasta test correta e execute:

python csv2bean.py "NOME-DO-ARQUIVO-BAIXADO.CSV"

Exemplo:

python csv2bean.py "20260312-1894137139-umsatz.CSV"

Se funcionar, o script imprimirá Process finished. (Processo concluído) e criará ou substituirá beancount_file.beancount.

O que o conversor faz¶

O conversor cria entradas básicas do Beancount:

• Valores recebidos vão para a conta de ativo Sparkasse e Einnahmen:Sonstiges (Receitas: Outros) por padrão.
• Valores enviados vão para Ausgaben:Sonstiges (Despesas: Outras) e a conta de ativo Sparkasse por padrão.
• Algumas descrições de receita são automaticamente classificadas como Einnahmen:Vereinsbeitrag (Receitas: Contribuição da Associação).
• Alguns textos relacionados ao Tohuwabohu podem ser classificados como uma conta de receita de projeto.

O conversor é apenas uma primeira passagem. Ele não conhece o significado contábil final de cada transação.

Copiando para o livro-razão principal¶

1. Abra test/beancount_file.beancount.
2. Ignore o cabeçalho de opções gerado.
3. Copie apenas as transações.
4. Cole-as no livro-razão principal, primeiro sob Bank Dump.
5. Adicione um separador datado para a data de importação, se necessário.

****************************************************************************
** 2026-01-13
****************************************************************************

O Bank Dump é uma área de preparação. As transações importadas podem ser movidas posteriormente para a seção temática ou de projeto correta.

Classificando entradas importadas¶

Para cada transação importada, decida:

• É em nível de associação ou de projeto?
• É receita ou despesa?
• É um reembolso ou pagamento de responsabilidade?
• Pertence ao Freies-Geld (Dinheiro Livre) ou a uma conta de ativo específica do projeto?
• Existe um recibo ou fatura para anexar?

Substitua contas genéricas de fallback, como Ausgaben:Sonstiges, quando existir uma conta mais precisa.

Adicionando uma verificação de saldo¶

Exemplo NICA:

2026-03-13 balance Vermoegen:Bank:Sparkasse-NICA 1234.56 EUR

Exemplo Tohuwabohu:

2026-03-13 balance Vermoegen:Bank:Sparkasse-Tohuwabohu 2345.67 EUR

Use o saldo exibido pela Sparkasse para essa data exata.

Validando no Fava¶

1. Salve o arquivo do livro-razão.
2. Recarregue o Fava.
3. Verifique se há erros na parte superior da página do Fava.
4. Abra a página da conta Sparkasse.
5. Confirme o saldo corrente e as últimas transações.
6. Verifique o Balanço Patrimonial.
7. Verifique os painéis de projetos se as contas de projeto foram afetadas.

Se a verificação de saldo falhar¶

Causas comuns:

• A exportação CSV perdeu um dia no início ou no fim.
• Uma transação foi importada duas vezes.
• Uma transação foi colada no livro-razão da associação errada.
• Um número foi editado incorretamente.
• Uma divisão de projeto usou o sinal errado.
• Movimentações do PayPal ou em dinheiro não foram registradas também.

Não remova a verificação de saldo apenas para fazer o erro desaparecer. Corrija a diferença subjacente da transação.