1M Finance używa formatu CSV podzielonego na sekcje. Każda sekcja zaczyna się wierszem znacznika SECTION , po którym następuje nazwa sekcji, następnie nagłówki kolumn, a potem wiersze danych. Aby import był niezawodny, dołącz sekcje kont i kategorii używane przez Twoje transakcje.

Struktura pliku

Plik może zawierać maksymalnie pięć sekcji, w tej kolejności:

TRANSACTIONS zawiera wiersze, które chcesz zaimportować. Dołącz sekcje ACCOUNTS oraz CATEGORIES dla nazw, do których odwołują się te transakcje, aby import mógł je poprawnie powiązać. BUDGETS oraz RECURRING_TRANSACTIONS są opcjonalne.

Każda sekcja ma następujący wzór:

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

Jeśli tworzysz to w arkuszu kalkulacyjnym, po prostu zostaw puste dodatkowe komórki w wierszach SECTION. Aplikacja je zignoruje.

Konta

Zdefiniuj swoje konta finansowe. Dołącz każdą nazwę konta, do której odwołują się Twoje transakcje.

Przykład

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

Kategorie

Zdefiniuj kategorie wydatków i przychodów. W razie pominięcia aplikacja utworzy kategorie na podstawie nazw użytych w Twoich transakcjach.

Przykład

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

W tym przykładzie Coffee jest podkategorią Food & Dining a Fuel jest podkategorią Transportation. Kategorie nadrzędne muszą być wymienione przed swoimi podkategoriami.

Transakcje (wymagane)

To jedyna sekcja, którą musisz dołączyć. Każdy wiersz to jedna transakcja.

Jak działają typy transakcji

• income — Pieniądze wpływają na From Account. Użyj kategorii przychodów, takiej jak Salary.
• expense — Pieniądze wypływają z From Account. Użyj Category i opcjonalnie Subcategory, aby opisać wydatek.
• transfer — Pieniądze przechodzą z From Account na To Account. Pozostaw Category i Subcategory puste. To nie powinno liczyć się jako wydatek.
• expenseTransfer — Pieniądze przechodzą między kontami i jednocześnie liczą się jako wydatek. Użyj tego do spłat pożyczek lub kart, gdy saldo konta docelowego się zmienia, ale płatność ma pojawić się w wydatkach.

Przykłady

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,

Przy przelewie w tej samej walucie ustaw Amount, Currency, To Account Amount oraz To Account Currency na tę samą wartość i walutę. Przy przelewie międzywalutowym Amount i Currency opisują, co opuściło konto źródłowe, natomiast To Account Amount i To Account Currency opisują, co dotarło na konto docelowe. Przelewy zwykle pozostawiają Category i Subcategory puste, z wyjątkiem expenseTransfer.

Kolumna Recurring Ref łączy transakcję z szablonem cyklicznym (na przykład RT-1 odpowiada szablonowi wynagrodzenia poniżej).

Budżety (opcjonalne)

Ustaw miesięczne cele budżetowe dla każdej kategorii. Jeden wiersz na kategorię na miesiąc.

Przykład

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

Transakcje cykliczne (opcjonalne)

Skonfiguruj transakcje, które powtarzają się automatycznie.

Przykład

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

Walidacja i wskazówki

Kompletne wiersze

Upewnij się, że każdy wiersz ma wartość (lub pusty przecinek) dla każdej kolumny z nagłówka. Wiersze z brakującymi kolumnami są po cichu pomijane podczas importu.

Dopasowywanie nazw

Nazwy kont i kategorii w Twoich transakcjach muszą dokładnie odpowiadać (z uwzględnieniem wielkości liter) nazwom zdefiniowanym w sekcjach ACCOUNTS i CATEGORIES. Brakujące powiązania kont lub kategorii mogą spowodować pominięcie odpowiednich wierszy.

Co dzieje się podczas importu

• Nieprawidłowe wiersze są pomijane — import nie kończy się całkowitym niepowodzeniem.
• Salda początkowe są automatycznie przeliczane dla zachowania spójności.
• Aplikacja automatycznie wykrywa Twoją walutę główną na podstawie częstości transakcji.
• W miarę możliwości utrzymuj wypełnione Amount USD i Amount Home Currency. W jednowalutowym pliku startowym w USD mogą być równe Amount.