Импорт на транзакции (CSV)

Как да прехвърлите данните си от други системи в Small Metrics

Внимание: Ролеви достъп Функцията за импортиране на данни е достъпна само за потребители с роля Администратор (Admin). Ако сте обикновен Член (Member), тази функция няма да ви бъде достъпна.

Къде се намира

Отворете приложението и отидете в раздела Money (Пари).
Изберете желаното пространство на главния екран (например „Family“).
В горния десен ъгъл натиснете иконата Шестоъгълник / Зъбно колело (Settings).
В отвореното меню, точно под раздела Members, натиснете бутона Import Data (придружен от икона за качване на файл).

За какво е необходимо

Функцията за импортиране ви позволява бързо и безопасно да прехвърлите историята на вашите приходи и разходи от други банкови приложения, електронни таблици в Excel или стари системи за финансов отчет директно в Small Metrics.

Импортирането е изградено на базата на безопасен модел „Предварителен преглед“ (Dry-Run) с логика „Запазваме това, което можем“ (Best-effort). Системата първо прочита вашия файл, без да променя базата данни, и показва резултатите от проверката. Ако във файл с хиляди редове има няколко грешки, системата няма да блокира целия процес, а ще предложи да импортира само валидните транзакции, игнорирайки некоректните.

Потребителска нужда

Преминаването към ново приложение за проследяване на финанси често е съпроводено със страх от загуба на натрупаната историческа статистика. Потребителите трябва да избегнат ръчното въвеждане на стотици стари транзакции и бързо да прехвърлят целия си паричен поток (Cash Flow) в новата система. Това позволява безпроблемно продължаване на управлението на бюджета и незабавен достъп до задълбочени анализи въз основа на минали данни.

Стъпки за качване и изисквания към файла

Файлът трябва да бъде строго във формат .csv (Comma-Separated Values) с разделител запетая (,) и кодиране UTF-8.

1. Изтеглете шаблон (Download template)

Натиснете бутона Download Template (CSV). Ще се изтегли референтният файл smallmetrics_money_import.csv с правилните заглавки.

Файлът трябва строго да съдържа следните колони:

Date (Задължително): Строго в ISO формат YYYY-MM-DD (например 2026-03-01).
Type (Задължително): Посока на плащането, строго income (приход) или expense (разход). Бекендът чете това поле без значение от малки/главни букви.
Category (Задължителна колона): Текстово име. Ако категорията е непозната на системата, тя ще бъде създадена автоматично. Ако оставите клетката празна, транзакцията ще бъде причислена към системната категория Uncategorized.
Amount (Задължително): Десетично число с точка (.). Сумата трябва строго да бъде положителна. Отрицателни стойности (например -500) ще предизвикат грешка. Посоката на парите се определя единствено от колоната Type.
Currency (Задължително): 3-буквен ISO код на валутата (например EUR, USD).
Comment (По избор): Текстов коментар с произволна дължина.

2. Подгответе вашия файл (Prepare your file)

Сверете данните си с инструкциите на екрана и се уверете, че отговарят на правилата за форматиране.

3. Качете готов файл (Upload ready file)

Натиснете върху зоната за качване, за да изберете вашия файл, или просто го плъзнете и пуснете (Drag & Drop) в това поле.

4. Проверка на данни (Data validation)

След като качите файла, системата ще покаже резултатите от проверката:

Existing categories: Списък на съществуващите категории, в които ще попаднат данните.
New categories to create: Списък на категориите, които системата ще създаде автоматично.
Таблица с примери на първите 5 успешно разпознати транзакции.
Ако във файла има грешки, най-отдолу ще се появи червен блок File contains errors. Please fix them and try again, описващ грешките ред по ред.

5. Запазване на данни (Save data)

Ако файлът съдържа поне една валидна транзакция, бутонът Save ще бъде отключен. Натиснете го, за да завършите импортирането. Ако във файла е имало грешки, точно над бутона ще се появи червено предупреждение, че ще бъдат импортирани само успешните редове.

Очакван резултат

Ако се опитате да качите файл, който не е CSV, ще се появи изскачащо известие: Please select a .csv file.
След успешно натискане на бутона Save, ще се появи зелено известие: Data imported successfully!.
Екранът за импортиране ще се затвори автоматично, а списъците с транзакции и анализите на главния екран ще се актуализират във фонов режим.
Всички нови категории ще бъдат автоматично създадени и готови за използване.