Converter CSV para TXF

Um programa de preparação de declarações fiscais pode exigir um arquivo TXF para importar transações bancárias, de corretoras ou contábeis com atribuições a linhas fiscais. A conversão é necessária quando o sistema de origem exporta apenas CSV e o software de destino não tem importação direta de CSV.

O que é o formato CSV

CSV, ou valores separados por vírgulas, é um formato de tabela em texto simples usado para exportações de transações, planilhas e transferências de bancos de dados. Bancos, corretoras, sistemas de contabilidade, Microsoft Excel, LibreOffice Calc e Google Sheets criam arquivos CSV com frequência.

Um CSV de transações pode conter datas, descrições, valores, nomes de contas, categorias, beneficiários e referências. A estrutura não é padronizada além de representar valores tabulares: os programas podem usar vírgulas, ponto e vírgulas ou tabulações como separadores; diferentes formatos de data; colunas separadas para débito e crédito; ou valores positivos e negativos. O CSV não possui um mapeamento universal de linhas fiscais ou categorias fiscais.

O que é o formato TXF

TXF significa Tax Exchange Format. É um formato de intercâmbio em texto simples usado por alguns programas de preparação de declarações fiscais e de contabilidade para importar transações relacionadas a impostos. Um registro pode conter uma data, um valor, um pagador ou beneficiário, uma descrição, informações da conta e um código de linha fiscal.

Ao contrário do CSV, o TXF foi projetado para preservar a atribuição ao formulário fiscal ou à linha fiscal de destino. Ele pode representar itens como despesas dedutíveis, juros, dividendos, rendimentos de investimentos e outros valores declarados. O TXF não é um padrão moderno universal: as versões compatíveis, os códigos de linha fiscal, o comportamento da importação e os mapeamentos do ano fiscal variam, e muitos aplicativos fiscais atuais removeram a importação de TXF ou a substituíram por uma conexão proprietária ou direta com dados financeiros.

Como converter CSV para TXF

Usar GnuCash para uma conversão baseada em contabilidade

GnuCash é uma opção adequada para desktop local quando o CSV contém transações contábeis e o programa fiscal de destino aceita TXF. Ele não é um reformatador genérico de arquivos; usa configurações de contas e fiscais para gerar uma saída relacionada a impostos.

1. Mantenha uma cópia intocada do CSV original e crie um arquivo separado do GnuCash ou uma cópia de trabalho das contas relevantes.
2. Importe os dados por meio de File → Import → Import Transactions from CSV. Selecione o delimitador, a codificação, a coluna de data, as colunas de valor ou de débito e crédito, a moeda e a conta de destino de acordo com o importador e o arquivo de origem.
3. Faça a conciliação das transações importadas com o extrato bancário ou da corretora. Corrija linhas duplicadas, sinais invertidos, datas inválidas, transferências entre suas próprias contas e transações que precisam de divisões.
4. Configure as informações fiscais das contas de receitas e despesas aplicáveis no GnuCash. Atribua códigos TXF relacionados a impostos somente depois de verificar o ano fiscal, a jurisdição, o tipo de entidade e as instruções do formulário fiscal. Uma categoria CSV como Meals, Travel ou Interest não é evidência suficiente para selecionar uma linha fiscal.
5. Execute o relatório de exportação TXF, normalmente encontrado em Reports → Income & Expense → TXF Export, e salve o texto gerado como um arquivo que termine em .txf. Os nomes dos menus podem variar entre versões do GnuCash e configurações regionais.
6. Use o comando de importação TXF do programa fiscal que receberá os dados, geralmente em File → Import. Verifique o ano fiscal, os totais importados, as datas e os destinos nos formulários fiscais antes de confiar nos dados.

Gerar TXF com um script controlado

Um script é apropriado quando o CSV tem colunas consistentes e a especificação TXF do programa que receberá os dados é conhecida. Um arquivo TXF geralmente contém um registro de versão como V041, campos de transação como D para data, T para valor, P para pagador ou beneficiário e L para código de linha fiscal, seguido por um ^ terminador. A versão exata, a ordem dos campos, os códigos, as regras de data e as convenções de valores devem corresponder à especificação do aplicativo de destino.

Antes de gravar os registros, normalize as datas, use pontos como separadores decimais, aplique a convenção de sinais do programa de destino, remova ou codifique quebras de linha nas descrições e rejeite linhas sem datas, valores ou códigos fiscais obrigatórios. Valide o arquivo gerado no software que receberá os dados, em vez de presumir que qualquer arquivo de texto com uma extensão .txf seja válido.

Conversores online e privacidade

Serviços genéricos, como sites comuns de conversão de CSV, geralmente convertem entre formatos tabulares ou de escritório; eles não atribuem códigos de linha fiscal de forma confiável nem produzem arquivos TXF aceitos por um aplicativo fiscal específico. Não há um serviço online universal de CSV para TXF amplamente confiável que possa ser recomendado para registros fiscais.

Um serviço web só deve ser considerado se documentar explicitamente o suporte à versão TXF exigida e ao software de destino, fornecer uma política de privacidade adequada para registros financeiros e permitir que a saída seja inspecionada e testada. Para dados bancários, de folha de pagamento, de corretoras ou que identifiquem o contribuinte, prefira o GnuCash ou um script executado localmente. Não carregue o arquivo original apenas para alterar seu nome ou extensão.

Verificações de qualidade e compatibilidade

A conversão de CSV para TXF é uma tarefa de mapeamento de dados, não apenas uma mudança de formato. O CSV de origem fornece valores, enquanto o TXF exige semântica fiscal que pode depender da jurisdição, do ano fiscal, da porcentagem dedutível, do tipo de investimento e da estrutura do contribuinte ou da empresa.

• Abra o arquivo exportado em um editor de texto simples e verifique seu registro de versão, datas, valores, códigos de linha fiscal, descrições e registros ^ terminadores.
• Importe uma pequena amostra antes de importar o arquivo completo e compare os totais das categorias fiscais com o CSV e com os extratos bancários ou da corretora originais.
• Verifique se os valores negativos representam despesas, reembolsos ou créditos de acordo com a convenção do programa de destino.
• Preserve o CSV original e os registros de conciliação como fonte de auditoria; não trate um arquivo TXF importado como prova de que o tratamento fiscal está correto.
• Se a importação falhar, confirme se o programa fiscal oferece suporte a TXF, à versão TXF exigida, ao ano fiscal relevante e aos códigos de linha fiscal específicos. Alguns produtos atuais exigem downloads diretos de instituições ou outro formato proprietário de importação.