1M Finance utilise un format CSV par sections. Chaque section commence par une ligne marqueur SECTION , suivie d'un nom de section, puis des en-têtes de colonnes, puis des lignes de données. Pour des imports fiables, incluez les sections de comptes et de catégories utilisées par vos transactions.

Structure du fichier

Un fichier peut contenir jusqu'à cinq sections, dans cet ordre :

TRANSACTIONS contient les lignes que vous souhaitez importer. Incluez ACCOUNTS et CATEGORIES pour les noms référencés par ces transactions afin que l'import puisse les associer correctement. BUDGETS et RECURRING_TRANSACTIONS sont facultatives.

Chaque section suit ce schéma :

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

Si vous créez cela dans un tableur, laissez simplement vides les cellules supplémentaires des lignes SECTION. L'application les ignore.

Comptes

Définissez vos comptes financiers. Incluez chaque nom de compte référencé par vos transactions.

Exemple

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

Catégories

Définissez les catégories de dépenses et de revenus. En cas d'omission, l'application crée des catégories à partir des noms utilisés dans vos transactions.

Exemple

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

Dans cet exemple, Coffee est une sous-catégorie de Food & Dining et Fuel est une sous-catégorie de Transportation. Les catégories parentes doivent être listées avant leurs sous-catégories.

Transactions (obligatoire)

C'est la seule section que vous devez inclure. Chaque ligne correspond à une transaction.

Comment fonctionnent les types de transaction

• income — L'argent entre dans le From Account. Utilisez une catégorie de revenus comme Salary.
• expense — L'argent quitte le From Account. Utilisez Category et, en option, Subcategory pour décrire la dépense.
• transfer — L'argent passe du From Account vers le To Account. Laissez Category et Subcategory vides. Cela ne doit pas être comptabilisé comme une dépense.
• expenseTransfer — L'argent passe d'un compte à l'autre et compte aussi comme une dépense. Utilisez ceci pour les paiements de prêt ou de carte, où le solde du compte de destination change mais où le paiement doit apparaître dans les dépenses.

Exemples

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,

Pour un virement dans la même devise, définissez Amount, Currency, To Account Amount et To Account Currency sur la même valeur et la même devise. Pour un virement multidevise, Amount et Currency décrivent ce qui a quitté le compte source, tandis que To Account Amount et To Account Currency décrivent ce qui est arrivé sur le compte de destination. Les virements laissent normalement Category et Subcategory vides, sauf expenseTransfer.

La colonne Recurring Ref relie une transaction à un modèle récurrent (par exemple, RT-1 correspond au modèle de salaire ci-dessous).

Budgets (facultatif)

Définissez des objectifs de budget mensuels par catégorie. Une ligne par catégorie et par mois.

Exemple

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

Transactions récurrentes (facultatif)

Configurez des transactions qui se répètent automatiquement.

Exemple

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

Validation et conseils

Lignes complètes

Assurez-vous que chaque ligne possède une valeur (ou une virgule vide) pour chaque colonne de l'en-tête. Les lignes dont des colonnes manquent sont ignorées sans avertissement lors de l'import.

Correspondance des noms

Les noms de compte et de catégorie de vos transactions doivent correspondre exactement (en respectant la casse) aux noms définis dans les sections ACCOUNTS et CATEGORIES. Des correspondances de compte ou de catégorie manquantes peuvent entraîner l'omission des lignes concernées.

Ce qui se passe à l'import

• Les lignes mal formées sont ignorées — l'import n'échoue pas entièrement.
• Les soldes initiaux sont recalculés automatiquement pour assurer la cohérence.
• L'application détecte automatiquement votre devise principale en fonction de la fréquence des transactions.
• Conservez Amount USD et Amount Home Currency renseignés autant que possible. Pour un fichier de départ monodevise en USD, ils peuvent correspondre à Amount.