Converter IIF para CSV

Uma ferramenta de relatórios, planilha ou banco de dados pode exigir CSV quando os dados de origem estão disponíveis apenas como uma exportação IIF do QuickBooks. Converter o arquivo facilita a inspeção e a troca de registros delimitados por tabulação, mas isso não cria automaticamente uma tabela contábil normalizada.

O que é o formato IIF

IIF significa Intuit Interchange Format, um formato de intercâmbio de texto simples usado principalmente pelo QuickBooks Desktop para importar e exportar listas e transações. O QuickBooks Desktop e integrações contábeis mais antigas usam IIF para contas, clientes, fornecedores, faturas, contas a pagar, pagamentos, lançamentos contábeis e outros registros.

Um arquivo IIF normalmente usa caracteres de tabulação entre os campos. Linhas que começam com marcadores como !TRNS, !SPL, !ACCNT e !ENDTRNS identificam layouts ou seções de transações; as linhas seguintes contêm os registros correspondentes. Portanto, um arquivo pode conter vários tipos de registros com estruturas de colunas diferentes.

O que é o formato CSV

CSV representa dados tabulares como linhas e colunas, geralmente separados por vírgulas. Os campos que contêm vírgulas, quebras de linha ou aspas são delimitados por aspas, com as aspas incorporadas escapadas de acordo com o dialeto CSV. Excel, LibreOffice Calc, Google Sheets, bancos de dados, sistemas de relatórios e bibliotecas de programação oferecem suporte a CSV.

CSV é adequado quando cada linha de saída segue um layout de colunas consistente. Ele não preserva os relacionamentos entre transações do QuickBooks, as regras de lançamento, os marcadores de seção do IIF nem os metadados de importação.

Como converter um arquivo IIF

Usando o LibreOffice Calc

1. Faça um backup do arquivo .iif original.
2. Abra o LibreOffice Calc e escolha File → Open. Selecione o arquivo ou configure o seletor de arquivos para mostrar todos os arquivos caso a extensão .iif esteja oculta.
3. Na caixa de diálogo Text Import, selecione Separated by, habilite Tab e desabilite os separadores de vírgula, ponto e vírgula e espaço.
4. Defina identificadores, números de contas, códigos postais e quaisquer outros valores cujos zeros à esquerda devam ser mantidos como Text. Verifique as datas e os valores, em vez de permitir que a detecção automática de tipo os altere.
5. Confirme se os campos aparecem nas colunas pretendidas e escolha File → Save As.
6. Selecione Text CSV (.csv). Escolha a codificação UTF-8 quando o destino oferecer suporte a ela e confirme o formato CSV quando o Calc solicitar.

O Excel usa o mesmo fluxo geral: abra o arquivo por meio do processo de importação de texto, selecione tabulação como delimitador, revise os tipos de coluna e escolha File → Save As → CSV UTF-8. Não renomeie file.iif para file.csv; alterar a extensão não altera os delimitadores de tabulação nem a estrutura dos registros.

Usando um script local

Para um arquivo IIF simples com um único layout consistente, a biblioteca padrão do Python pode copiar campos separados por tabulação para um arquivo CSV sem fazer upload dos dados financeiros:

import csv

with open('input.iif', newline='', encoding='utf-8-sig') as source, open('output.csv', 'w', newline='', encoding='utf-8-sig') as target:
    rows = csv.reader(source, delimiter='\t')
    csv.writer(target).writerows(rows)

Isso realiza apenas a conversão de delimitadores. Não interpreta os relacionamentos entre !TRNS e !SPL, não combina cabeçalhos de transações com linhas divididas nem remove campos específicos do QuickBooks. Um script personalizado deve selecionar o tipo de registro necessário, definir suas colunas e mapear as linhas relacionadas para a estrutura de relatório desejada.

Exportando do QuickBooks Desktop

Se os dados ainda estiverem disponíveis no QuickBooks Desktop, a exportação direta geralmente é preferível à conversão de IIF. Abra o relatório necessário e use Reports → report name → Export → Export to Excel ou exporte uma lista pela janela de lista do QuickBooks. Salve a planilha resultante como CSV. Isso produz uma tabela orientada a relatórios, em vez de expor as seções e os marcadores mistos de um arquivo IIF.

Usando um conversor online

Serviços como CloudConvert e Convertio são provedores estabelecidos de conversão online, mas os formatos de entrada aceitos e o tratamento de IIF podem mudar. Use um deles somente quando a lista de formatos atual aceitar explicitamente IIF ou entrada de texto genérica e oferecer saída CSV; configure o delimitador de origem como tabulação, em vez de presumir que o serviço entenderá as seções do QuickBooks.

Faça upload do arquivo, selecione CSV como saída, verifique as opções de delimitador e codificação, execute a conversão e inspecione o arquivo baixado em um editor de texto ou planilha. Não faça upload de arquivos que contenham dados de folha de pagamento, bancários, de clientes, fornecedores ou outros dados financeiros confidenciais, a menos que a organização permita essa transferência. Um fluxo de trabalho local no Calc ou um script mantém a origem no computador.

Limitações de qualidade e compatibilidade

• Seções mistas: Um único CSV não consegue representar adequadamente seções IIF com colunas diferentes. Use arquivos CSV separados, adicione uma coluna de tipo de registro ou aceite campos vazios em uma tabela combinada.
• Estrutura das transações: Uma linha !TRNS e suas linhas !SPL são registros relacionados, não linhas independentes. Um CSV visualmente correto ainda pode ser inadequado para importação no QuickBooks ou em outro sistema contábil.
• Conversão automática: As planilhas podem alterar datas, valores monetários, valores negativos, números longos e identificadores com zeros à esquerda. Importe as colunas sensíveis como texto e compare as contagens de linhas e os totais com o original.
• Codificação: Use UTF-8 para caracteres acentuados e não latinos. Fluxos de trabalho mais antigos baseados no Windows podem esperar Windows-1252; teste o aplicativo de destino se os caracteres forem corrompidos.
• Dialeto CSV: Alguns programas esperam ponto e vírgula em vez de vírgulas, um final de linha específico ou uma marca de ordem de bytes UTF-8. Atenda aos requisitos do aplicativo de destino, em vez de confiar apenas na extensão .csv.
• Segurança da importação: CSV é texto simples e não retém a validação do QuickBooks nem os controles contábeis. Trate os dados convertidos como uma exportação para inspeção, geração de relatórios ou troca, a menos que o sistema receptor documente um layout de importação compatível.