Traga o seu histórico para o Topf

O Topf lê CSV, um formato de tabela comum. Se o seu banco ou app oferece CSV entre os formatos de exportação, escolha esse. As colunas podem ser separadas por vírgula, ponto e vírgula ou tabulação, e o Topf descobre sozinho.

• Excel: “Arquivo”, “Salvar como”, formato CSV UTF-8.
• Numbers: “Arquivo”, “Exportar para”, CSV.
• Planilhas Google: “Arquivo”, “Fazer download”, formato CSV.

Um arquivo pode ter até 50.000 linhas e 20 MB. Uma tabela maior fica melhor dividida em vários arquivos, um por ano, por exemplo.

Se as letras viram símbolos estranhos, o arquivo não está em UTF-8, e sim numa codificação mais antiga. O Topf não chuta: mostra como as palavras do seu arquivo ficam em cinco codificações, e você escolhe aquela em que estão certas.

Acima da tabela de um extrato costuma haver algumas linhas sobre a conta. O Topf encontra a linha com os nomes das colunas; se errou, abra o menu abaixo do nome do arquivo e escolha outra linha, ou indique que não há cabeçalho.

Cada campo de um lançamento recebe uma coluna do arquivo. Só a data e o valor são obrigatórios; sem os outros, acontece o seguinte:

• Conta: você escolhe uma para o arquivo inteiro no próximo passo.
• Categoria: as despesas vão para “Outras despesas” e as receitas para “Outras receitas”.
• Nota: nenhuma.
• Moeda: a da conta.
• Hora: a da data, ou meio-dia.

O Topf preenche um campo sozinho só quando tem certeza: uma coluna com o nome exato do campo e com todos os valores legíveis. Um arquivo exportado pelo Topf é reconhecido por inteiro, em qualquer um dos idiomas dele. O que você escolhe fica escolhido.

Os arquivos escrevem valores de três jeitos, e o menu do valor cobre todos:

• “Uma coluna com sinal”: despesas com menos, receitas sem. Nada a fazer.
• “Despesas sem sinal de menos”: para arquivos em que o gasto aparece positivo. Sem isso, as suas despesas chegariam como receitas.
• “Despesas e receitas em colunas separadas”: para extratos com uma coluna de débito e outra de crédito. Escolha as duas.

Um valor escrito 1,234 vale 1234 se a vírgula separa os milhares, e um vírgula duzentos e trinta e quatro se a vírgula é o separador decimal. Quando uma coluna pode ser lida dos dois jeitos, o Topf pergunta e mostra como um valor fica em cada caso.

Uma data como 05/04/2026 é 5 de abril num país e 4 de maio em outro. O Topf decide pela coluna inteira: se todo valor pode ser lido dos dois jeitos, ele pergunta e mostra as duas leituras.

Um lançamento sem hora entra ao meio-dia; um de hoje, no máximo no minuto atual. Datas futuras não são importadas.

Em “Contas e categorias”, cada conta e cada categoria do arquivo ganha uma linha, e você diz para onde vai: para uma conta ou categoria do seu livro, para uma nova, ou “Não importar”.

O Topf associa sozinho só quando há uma resposta só: a mesma conta por nome e moeda, a mesma categoria por nome e tipo, ou o que a última importação deste arquivo criou. Se várias servem, a linha pede que você escolha, e o botão espera.

Uma conta nova começa com saldo zero, e o saldo dela passa a ser a soma dos lançamentos: um CSV não tem saldo inicial. Você pode corrigir depois na própria conta.

Na versão gratuita, a importação cria tantas contas novas quanto essa versão permite; as outras ficam em “Não importar” com o Plus ao lado. As categorias não têm limite.

Um arquivo exportado pelo Topf é reconhecido por inteiro: as colunas são associadas sozinhas, e contas e categorias são encontradas pelo ID. É assim que se levam lançamentos para outra conta de usuário ou se traz de volta o que foi exportado. O arquivo traz só lançamentos: orçamentos, lançamentos recorrentes e saldos iniciais não vão junto, e os valores na moeda principal não são lidos, porque o câmbio é tomado de novo para cada data.

Numa exportação de todas as contas, uma transferência aparece em duas linhas, e o Topf junta de novo numa transferência só. A exportação de uma única conta traz só o lado dela, que vira transferência se a outra conta já estiver no livro com a mesma moeda. Arquivos de bancos e de outros apps não têm esses pares: cada linha vira uma despesa ou uma receita, porque juntar linhas por data e valor seria um chute.

Importar duas vezes o mesmo arquivo na mesma conta não acrescenta nada na segunda vez. Extratos que se sobrepõem, como dois meses que dividem alguns dias, acrescentam cada lançamento uma vez só. Em outra conta, o mesmo arquivo entra de novo. O mesmo vale para uma importação feita sem uma conta de usuário do Topf: quando você entrar no Topf, o mesmo arquivo pode adicionar as linhas de novo.

O Topf reconhece uma linha pelo conteúdo inteiro. Se um banco renumera ou muda as linhas a cada extrato, essas linhas podem entrar uma segunda vez. Antes de importar, confira quantos lançamentos a linha do alto de “Contas e categorias” diz que vão entrar; se o resultado estiver errado, desfaça a importação inteira.

Um lançamento que você apagou no Topf não volta com outra importação: importar traz dados, não restaura um backup.

O Topf não chuta uma linha que não consegue ler com exatidão. A linha do alto de “Contas e categorias” conta essas linhas; “Detalhes” diz qual é cada uma e o motivo:

• sem data ou sem valor, ou uma data que não existe;
• uma data futura, ou um valor zero;
• mais casas decimais do que a moeda tem;
• uma moeda não reconhecida ou diferente da moeda da conta;
• uma nota com mais de 280 caracteres.

A moeda pode vir como código, por exemplo EUR, ou como símbolo, por exemplo €. Os símbolos $ e ¥ são de várias moedas, então para eles é preciso o código.

Abra a importação de novo, toque em “Desfazer a importação” abaixo de “Última importação” e confirme. Os lançamentos dessa importação saem do livro, até os editados depois; as contas e categorias que ela criou também saem, a menos que algo ainda as use.

O desfazer fica guardado neste aparelho até a próxima importação. Ele não existe nos seus outros aparelhos, e uma importação feita sem uma conta de usuário do Topf não pode mais ser desfeita quando você entra no Topf. Depois de desfazer, o mesmo arquivo pode ser importado de novo com quaisquer escolhas.

Se o Topf foi fechado no meio de uma importação, o que já foi gravado fica no livro e se desfaz do mesmo jeito: a tela de importação diz quantos de quantos foram gravados.

A importação é gratuita. Cada lançamento entra na moeda da sua conta, e o câmbio para a sua moeda principal é o da data do lançamento, como quando você registra um de um dia que já passou.