Импорт транзакций (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!.
Экран импорта закроется автоматически, а списки транзакций и аналитика на главном экране обновятся в фоновом режиме.
Все новые категории будут автоматически созданы и доступны для использования.