Entre os relatos que mais recebemos do apoio ao cliente e da investigação, há uma categoria que se repete há anos: os problemas na importação de CSV quando é exigido o formato padrão da Finbooks.
Porque existe o formato Finbooks
O principal problema, infelizmente, está do lado dos fornecedores de dados: as ligações.
As exchanges, os brokers e as wallets mudam constantemente o formato dos seus ficheiros CSV, muitas vezes sem aviso e muitas vezes em ligações muito utilizadas.
Cada alteração ao formato de origem pode quebrar o mapeamento de dados no nosso sistema de aquisição, que tem de conhecer na perfeição o formato de ficheiro de cada ligação e guardar, para cada uma, instruções separadas sobre como a importar.
Manter esta infraestrutura para milhares de ligações é um custo insustentável para a empresa, e é por isso que a nossa equipa se concentra sobretudo nas ligações mais utilizadas, para garantir um mapeamento excelente e sempre atualizado.
Para todas as outras ligações, porém, e de forma a permitir que qualquer pessoa possa usar mesmo as fontes de exportação de dados menos conhecidas e/ou menos estáveis, sempre existiu o formato CSV da Finbooks: um ficheiro padrão que o nosso sistema reconhece em qualquer situação.
Apesar de ser uma solução válida, nem toda a gente estava disposta a converter o seu ficheiro para o formato que disponibilizávamos. Perfeitamente compreensível.
Um serviço de conversão manual
Durante muito tempo, a solução foi oferecer a todos os clientes um serviço adicional por um valor limitado (que cobria apenas parte dos nossos custos internos com o trabalho de conversão feito em nome do cliente).
Em resumo: o ficheiro é-nos enviado com alguns detalhes, convertemo-lo para o formato Finbooks e carregamo-lo na conta do cliente.
Embora fosse uma solução para o cliente final, não era um serviço muito utilizado.
As pessoas continuavam a preferir tratar dos ficheiros por si próprias, muitas vezes com repetições de trabalho causadas por erros de formatação difíceis de detetar.
Tínhamos de encontrar uma solução alternativa.
Um motor poderoso: o Finbooks Intelligence
Neste caso não fizemos qualquer questionário, mas colocámos a nós próprios a pergunta: como podemos resolver este problema aplicando o nosso novo motor inteligente, o mesmo que também dá vida a outras funcionalidades do sistema?
O problema já estava suficientemente documentado pela investigação e pelo apoio ao cliente: conhecíamos os casos, sabíamos onde se concentravam os erros, tínhamos dados sobre que percentagem de importações falhava e por que tipo de motivo.
Construímos uma ferramenta que usa o Finbooks Intelligence para ler os ficheiros CSV dos clientes, identificar os erros, apurar as correções possíveis e agir de forma inteligente para corrigir tudo o que conseguir e apresentá-lo no formato Finbooks.
O CSV fixer funciona assim: analisa o ficheiro, verifica se há erros e, nos casos em que a solução é clara, aplica-a diretamente (com confirmação prévia). Quando a correção não é 100% certa, seja porque há várias interpretações possíveis, seja porque o contexto é ambíguo, o sistema deixa a decisão ao cliente.
Testámos o agente internamente em centenas de ficheiros construídos propositadamente com erros de vários tipos, como formatos errados, dados em falta, colunas renomeadas, valores fora do intervalo. O resultado: o CSV fixer consegue cobrir sozinho cerca de 90% dos casos de erro.
Há um caso em que o agente para: quando o ficheiro tem mais linhas com erro do que linhas válidas. Nessa situação, a correção automática não é fiável, e dizemo-lo com clareza. O sistema sinaliza o problema e gera um ficheiro descarregável com a lista de erros, para que o cliente possa intervir manualmente, sabendo exatamente onde procurar.
O que existe agora
Desde julho de 2026, o CSV fixer com Finbooks Intelligence está disponível para todos os clientes nas ligações de cripto, no formato CSV da Finbooks.
Vais encontrá-lo dentro do próprio fluxo de importação, ao carregares um ficheiro CSV. Se o ficheiro tiver problemas, o agente deteta-os, mostra-te o que encontrou e, na maioria dos casos, sugere as soluções que podes aplicar com um único clique.