Импорт транзакций

В данном разделе описываем как загрузить несколько транзакций одним файлом.

Импорт транзакций позволяет быстро загрузить большое количество операций с помощью CSV-файла без ручного ввода каждой записи.

Если данные выгружены из банка в другом формате, используйте парсер выписок, чтобы подготовить файл для импорта.

Импорт фактических транзакций

Используется для загрузки уже выполненных операций, например:

  • банковских выписок
  • доходов и расходов
  • исторических финансовых данных

Импорт плановых транзакций

Используется для загрузки ожидаемых операций, например:

  • будущих платежей
  • регулярных расходов
  • планируемых поступлений

Как работает импорт

transactions-import

1. Выберите тип транзакций

Выберите вкладку:

  • Факт — фактические транзакции
  • План — плановые транзакции

2. Нажмите Импорт

transactions-import-modal

3. Выберите локацию, в которую будут импортированы транзакции.

4. Выберите аккаунт для импортируемых транзакций.

  • доступны только аккаунты выбранной локации
  • можно выбрать только один аккаунт

5. Загрузите CSV-файл размером до 30 MB.

6. Нажмите Применить.

После успешной проверки модальное окно закроется, появится уведомление об успешном импорте, а транзакции сразу отобразятся в списке.

Требования к CSV-файлу

Общие правила

1. Используйте точку . как десятичный разделитель суммы.

2. Знак суммы определяет тип операции:

  • + — доход
  • - — расход

3. Одна категория может использоваться одновременно для доходных и расходных операций. Тип операции определяется знаком суммы.

4. Дата и время транзакций обрабатываются в таймзоне выбранной локации.

5. Дефолтные категории не могут быть использованы для импорта

Поля CSV для фактических транзакций

ПолеОписание
categoryIdID категории
amountСумма транзакции
yearГод
monthМесяц
dayДень
hourЧас (необязательное поле)
minuteМинуты (необязательное поле)
commentКомментарий (необязательное поле, до 250 символов)
tagsТеги (необязательное поле)

Особенности

Время

Поля hour и minute можно не заполнять.

Если время отсутствует, система автоматически устанавливает значение 12:00.

Теги

  • поле необязательное
  • можно указать несколько тегов через запятую
  • теги должны существовать для выбранной локации
  • проверка чувствительна к регистру

Пример CSV

CSV
year,month,day,hour,minute,categoryId,amount,comment,tags
2025,07,29,14,00,101,-1200.50,Аренда самокатов,
2025,07,29,09,10,102,18000,,IT,Salary
2026,07,30,,,103,-500000,Аренда помещения,

Поля CSV для плановых транзакций

ПолеОписание
categoryIdID категории
plan_amountСумма плановой транзакции
yearГод
monthМесяц
dayДень
commentКомментарий (необязательное поле)
overdue_actionДействие при просрочке
tagsТеги (необязательное поле)

Значения overdue_action

Поле определяет, что произойдет с транзакцией при просрочке. Используется только для плановых транзакций.

ЗначениеДействие
0Не переносить
1Переносить на следующий календарный день до конца недели
2Переносить на следующий календарный день до конца месяца
3Переносить на следующий рабочий день до конца недели
4Переносить на следующий рабочий день до конца месяца

Пример CSV

CSV
year,month,day,categoryId,plan_amount,comment,overdue_action,tags
2025,07,29,101,-1200.50,Аренда самокатов,0,
2025,07,29,102,18000,,1,IT,Salary
2026,07,30,103,-500000,Аренда помещения,4,

Ошибки при импорте

ОшибкаОписание
Ошибка при чтении файлаСистема не смогла прочитать файл или обработать данные документа.
Файл пустЗагруженный файл не содержит данных.
Файл содержит некорректные данныеВ файле присутствуют неверные значения, некорректные форматы или отсутствуют обязательные поля.
Тип категории не соответствует знаку суммыТип категории не совпадает со знаком суммы. Например, расходная категория указана с положительной суммой.
Неизвестная категорияУказанный categoryId не существует в системе для выбранной локации.
Тег не существует для выбранной локацииВ файле указан тег, отсутствующий для выбранной локации.
Категория недоступна для выбранной локацииКатегория скрыта или недоступна для выбранной локации.
Дата транзакции не может быть в будущемДата фактической транзакции превышает текущую дату. Проверяется только для фактических транзакций
Структура файла не соответствует выбранному режиму импортаПользователь загрузил файл другого типа или в файле отсутствуют обязательные поля для выбранного режима импорта.



Читайте дальше:

— Парсер выписок