O 1M Finance usa um formato CSV em seções. Cada seção começa com uma linha marcadora SECTION , seguida do nome da seção, depois os cabeçalhos das colunas e, em seguida, as linhas de dados. Para importações confiáveis, inclua as seções de contas e categorias usadas pelas suas transações.

Estrutura do arquivo

Um arquivo pode conter até cinco seções, nesta ordem:

TRANSACTIONS contém as linhas que você quer importar. Inclua ACCOUNTS e CATEGORIES para os nomes referenciados por essas transações, para que a importação possa mapeá-los corretamente. BUDGETS e RECURRING_TRANSACTIONS são opcionais.

Cada seção segue este padrão:

SECTION,,,,,
SECTION_NAME,,,,,
Column Header 1,Column Header 2,...
data row 1
data row 2

Se você estiver criando isso em uma planilha, basta deixar em branco as células extras nas linhas SECTION. O app as ignora.

Contas

Defina suas contas financeiras. Inclua todos os nomes de conta referenciados pelas suas transações.

Exemplo

SECTION,,,,,,,,,,,
ACCOUNTS,,,,,,,,,,,
Account Name,Account Type,Starting Balance,Current Balance,Currency,Include In Total,Display In Expenses,Is Archived,Max Credit Balance,Description,Color,Initial Balance Date
Checking,regular,0.0,5200.0,USD,true,true,false,,Main checking,4280391411,
Savings,savings,1000.0,8500.0,USD,true,true,false,,Emergency fund,4283215168,
Credit Card,debt,0.0,-1200.0,USD,true,true,false,-5000.0,Visa card,4294930688,
Euro Account,regular,500.0,250.0,EUR,true,true,false,,Travel fund,4284890654,2024-06-01

Categorias

Defina as categorias de despesas e receitas. Se omitidas, o app cria categorias a partir dos nomes usados nas suas transações.

Exemplo

SECTION,,,,,
CATEGORIES,,,,,
Category Name,Category Type,Color,Is Archived,Parent Category
Food & Dining,expense,4294924066,false,
Transportation,expense,4282339765,false,
Salary,income,4283215168,false,
Coffee,expense,4294924066,false,Food & Dining
Fuel,expense,4282339765,false,Transportation

Neste exemplo, Coffee é uma subcategoria de Food & Dining e Fuel é uma subcategoria de Transportation. As categorias principais devem ser listadas antes das suas subcategorias.

Transações (obrigatório)

Esta é a única seção que você precisa incluir. Cada linha é uma transação.

Como funcionam os tipos de transação

• income — O dinheiro entra na From Account. Use uma categoria de receita como Salary.
• expense — O dinheiro sai da From Account. Use Category e, opcionalmente, Subcategory para descrever o gasto.
• transfer — O dinheiro vai da From Account para a To Account. Deixe Category e Subcategory em branco. Isso não deve contar como gasto.
• expenseTransfer — O dinheiro vai de uma conta para outra e também conta como despesa. Use isso para pagamentos de empréstimo ou cartão, em que o saldo da conta de destino muda, mas o pagamento deve aparecer nos gastos.

Exemplos

SECTION,,,,,,,,,,,,,
TRANSACTIONS,,,,,,,,,,,,,
Date,Type,From Account,To Account,Category,Subcategory,Amount,Currency,To Account Amount,To Account Currency,Amount USD,Amount Home Currency,Notes,Recurring Ref
2025-01-03,expense,Checking,,Food & Dining,,52.0,USD,,,52.0,52.0,Trader Joe's,
2025-01-15,income,Checking,,Salary,,3200.0,USD,,,3200.0,3200.0,Monthly salary,RT-1
2025-01-15,transfer,Checking,Savings,,,500.0,USD,500.0,USD,500.0,500.0,Monthly savings,
2025-01-20,expenseTransfer,Checking,Credit Card,Card Payment,,250.0,USD,250.0,USD,250.0,250.0,Credit card payment,
2025-01-10,transfer,Checking,Euro Account,,,1000.0,USD,920.0,EUR,1000.0,1000.0,Travel fund top-up,

Para uma transferência na mesma moeda, defina Amount, Currency, To Account Amount e To Account Currency com o mesmo valor e moeda. Para uma transferência entre moedas, Amount e Currency descrevem o que saiu da conta de origem, enquanto To Account Amount e To Account Currency descrevem o que chegou à conta de destino. As transferências normalmente deixam Category e Subcategory em branco, exceto expenseTransfer.

A coluna Recurring Ref vincula uma transação a um modelo recorrente (por exemplo, RT-1 corresponde ao modelo de salário abaixo).

Orçamentos (opcional)

Defina metas de orçamento mensais por categoria. Uma linha por categoria por mês.

Exemplo

SECTION,,,,,
BUDGETS,,,,,
Category Name,Amount,Currency,Year,Month
Food & Dining,550.0,USD,2025,3
Transportation,250.0,USD,2025,3
Entertainment,150.0,USD,2025,3

Transações recorrentes (opcional)

Configure transações que se repetem automaticamente.

Exemplo

SECTION,,,,,,,,,,,
RECURRING_TRANSACTIONS,,,,,,,,,,,
Notes,Type,From Account,Category,Amount,Currency,Frequency,Interval,Start Date,End Date,Max Occurrences,Auto Create,Is Active,To Account,To Account Currency,Ref
Monthly rent,expense,Checking,Housing,1200.0,USD,monthly,1,2025-01-01,,,true,true,,,RT-0
Monthly salary,income,Checking,Salary,1600.0,USD,monthly,1,2025-01-01,,,true,true,,,RT-1

Validação e dicas

Linhas completas

Garanta que cada linha tenha um valor (ou uma vírgula vazia) para cada coluna do cabeçalho. As linhas com colunas faltando são ignoradas silenciosamente durante a importação.

Correspondência de nomes

Os nomes de conta e de categoria nas suas transações devem corresponder exatamente (diferenciando maiúsculas de minúsculas) aos nomes definidos nas seções ACCOUNTS e CATEGORIES. Mapeamentos de conta ou categoria ausentes podem fazer com que as linhas afetadas sejam ignoradas.

O que acontece na importação

• Linhas malformadas são ignoradas — a importação não falha por completo.
• Os saldos iniciais são recalculados automaticamente para manter a consistência.
• O app detecta automaticamente a sua moeda principal pela frequência das transações.
• Mantenha Amount USD e Amount Home Currency preenchidos sempre que possível. Em um arquivo inicial de moeda única em USD, eles podem coincidir com Amount.