Converter OFX para CSV

Aplicativos bancários e de finanças pessoais geralmente fornecem extratos no formato OFX, enquanto planilhas, importações contábeis e scripts de análise de dados frequentemente exigem CSV. A conversão do extrato torna as transações editáveis e mais fáceis de compartilhar ou processar, mas pode remover metadados da conta e das transações.

O que é o formato OFX

OFX (Open Financial Exchange) é um formato estruturado para a troca de dados bancários, de cartões de crédito, investimentos e outros dados financeiros. Um extrato pode conter detalhes da conta, saldos, datas das transações, valores, beneficiários, memorandos, tipos de transação, moedas e identificadores exclusivos, como FITID.

Portais de internet banking geralmente oferecem downloads .ofx. Arquivos .qfx usam uma versão ou variação específica da Intuit do OFX e podem exigir software compatível com importações QFX. Aplicativos de finanças pessoais, incluindo GnuCash, Quicken, Moneydance e Microsoft Money, podem importar alguns arquivos OFX ou QFX.

OFX 1.x é semelhante a SGML e pode omitir tags de fechamento; OFX 2.x é baseado em XML. Os bancos podem diferir nas tags, na codificação de caracteres, nos formatos de data e nos campos opcionais, portanto, um arquivo OFX é destinado à troca entre softwares, e não à edição direta em planilhas.

O que é o formato CSV

CSV (comma-separated values) é texto simples organizado em registros e campos. Uma exportação de transações geralmente contém colunas como data, valor, beneficiário, memorando, conta, tipo de transação e ID da transação. CSV não define um único esquema financeiro: um programa pode usar colunas separadas para débito e crédito, enquanto outro usa uma única coluna de valor com sinal.

Excel, LibreOffice Calc, Google Sheets, ferramentas de banco de dados e linguagens de programação podem abrir CSV. O formato é fácil de inspecionar, editar, filtrar e processar, mas normalmente não preserva saldos OFX, identificadores da conta, metadados bancários, moeda, tipos de transação ou regras de detecção de duplicatas, a menos que o conversor adicione colunas explícitas.

Converter com GnuCash

1. Instale o GnuCash a partir de gnucash.org e crie ou abra um arquivo de dados do GnuCash.
2. Use File → Import → Import OFX/QFX e selecione o arquivo .ofx ou .qfx compatível.
3. Atribua a importação à conta correta do GnuCash. Revise datas, beneficiários, valores, moedas, divisões e correspondências de transações duplicadas antes de aceitá-la.
4. Selecione a conta que contém as transações importadas e use File → Export → Export Transactions to CSV. Algumas versões disponibilizam o comando no registro da conta ou usam uma redação de menu ligeiramente diferente.
5. Escolha o nome do arquivo, a conta, o intervalo de datas, o delimitador e a codificação, se a caixa de diálogo de exportação fornecer essas opções; salve um arquivo como transactions.csv.

O GnuCash é adequado quando o extrato precisa ser revisado, quando é necessário verificar duplicatas, mapear contas ou fazer correções antes da exportação. Ele pode representar transações divididas de maneira diferente do OFX original, portanto, inspecione as linhas resultantes.

Converter com Moneydance

1. Abra o Moneydance e use o comando File → Import para .ofx ou .qfx.
2. Escolha a conta de destino e revise as transações importadas quanto a duplicatas, sinais, datas e categorias.
3. Use File → Export, selecione CSV se esse formato estiver disponível na versão instalada, escolha a conta e o intervalo de datas e salve o arquivo.

Os nomes dos menus e os formatos de exportação disponíveis do Moneydance variam conforme a versão. Se CSV não for oferecido, exporte para um formato intermediário compatível e use um conversor ou script dedicado; em seguida, verifique o mapeamento dos campos.

Usar um conversor online

Serviços como o Zamzar e o Convertio podem aceitar um arquivo OFX e retornar CSV. Envie o arquivo, escolha CSV, baixe o resultado e abra-o em um editor de texto ou planilha para inspeção. Arquivos no estilo SGML legado, codificações incomuns e tags específicas de bancos podem ser rejeitados ou convertidos incorretamente.

Extratos bancários contêm informações financeiras sensíveis. Prefira o GnuCash ou outro aplicativo local quando possível; caso contrário, verifique a política de privacidade, o período de retenção, a criptografia e os controles de exclusão do serviço e remova as cópias enviadas e baixadas após a verificação.

Automatizar conversões recorrentes

Para tarefas repetitivas, use um parser compatível com OFX em vez de dividir o texto por vírgulas ou presumir uma transação por linha. O parser deve lidar com variantes SGML e XML, caracteres escapados, memorandos multilinha, campos opcionais, deslocamentos de fuso horário, valores negativos, codificações de caracteres e identificadores duplicados.

Defina um mapeamento de saída fixo, preserve FITID quando disponível, coloque entre aspas os campos que contenham vírgulas ou aspas e grave um CSV em UTF-8 com um delimitador documentado e um formato de data como YYYY-MM-DD. Um comando como python convert_ofx.py statement.ofx transactions.csv é apenas um exemplo; o script deve implementar seu próprio parser, mapeamento de campos, validação e tratamento de erros.

Verificar o arquivo convertido

• Verifique os sinais dos valores e a moeda. Confirme se depósitos, saques, tarifas e reembolsos têm os sinais pretendidos. Adicione uma coluna de moeda se o CSV não deixar isso inequívoco.
• Verifique as datas e os fusos horários. Os registros de data e hora do OFX podem incluir deslocamentos, e o software de planilha pode exibi-los ou convertê-los usando o fuso horário local do computador.
• Preserve os identificadores. Mantenha FITID e os números das contas quando possível. Importe-os como texto para que o software de planilha não remova zeros à esquerda nem use notação científica.
• Verifique os delimitadores e a codificação. Uma instalação regional de planilha pode esperar ponto e vírgula em vez de vírgulas. Confirme se nomes com acentos e símbolos permanecem corretos após a abertura do arquivo.
• Espere perda de campos e estrutura. CSV pode omitir saldos inicial e final, metadados da conta, tipo de transação, moeda, referências bancárias e relações entre transações divididas.
• Concilie os totais. Compare a quantidade de linhas, os totais das transações e os saldos inicial ou final disponíveis com o OFX original antes de arquivá-lo ou excluí-lo.