Імпорт виписки

Замість того щоб вбивати кожну банківську операцію руками, ви завантажуєте виписку з банку — і з неї автоматично створюються ваші транзакції. Це найшвидший спосіб наповнити список реальними даними. Підтримуються два сценарії: завантажити файл виписки (Monobank, ПриватБанк або УкрГазБанк) або підключити Monobank напряму — тоді нові операції надходять автоматично.

Людською мовою. Ваш банк уже знає всі ваші витрати і надходження. Він робить виписку — таблицю з усіма операціями. Ви її забираєте з банку і додаєте сюди: «Ось що було, додай у мій список». Операції розкладаються по категоріях, перекази між вашими картками помічаються автоматично — і ви одним кліком підтверджуєте увесь місяць.

Збільшити

Два режими: Файл і Monobank напряму

Перемикач у правому верхньому куті дає два способи отримати дані:

• Файл CSV/XLS/XLSX — універсальний разовий спосіб. Працює для Monobank (файл .csv або .xls/.xlsx — особиста картка чи ФОП), ПриватБанку (файл .xlsx з Приват24, або .xls/.csv з Клієнт-банку для бізнесу) і УкрГазБанку (файл .xls або .csv з Інтернет-банкінгу). У застосунку чи кабінеті банку ви вивантажуєте виписку → отримуєте файл → перетягуєте у зону завантаження на цій сторінці.
• Monobank напряму — для постійного користування. Ви один раз вставляєте особистий токен Monobank (як його отримати — покроково нижче), привʼязуєте свою картку до свого рахунку — і далі нові операції надходять автоматично за секунди після того, як ви розрахувались карткою.

Який обрати? Якщо у вас Monobank і ви плануєте користуватись постійно — підключіть напряму: один раз налаштували, працює без вашої участі. Якщо у вас ПриватБанк, УкрГазБанк, ФОП-каса, або імпортуєте виписки раз на місяць — файл універсальний і не потребує жодних токенів.

Файл виписки — повний шлях

Крок 1. Оберіть рахунок і завантажте файл

1. Випадаючий список «Рахунок» — обираєте, у який саме ваш рахунок підуть операції. Це обовʼязково: без рахунку немає куди класти транзакції.
2. Зона завантаження — перетягуєте файл або натискаєте і обираєте з компʼютера. Підтримуються:
   • Monobank — файл .csv або .xls/.xlsx. Підходить і особиста картка, і ФОП-рахунок (для ФОП застосунок Monobank віддає Excel-виписку — вона теж розпізнається автоматично).
   • ПриватБанк (особистий) — файл .xlsx з кабінету Приват24.
   • ПриватБанк (для бізнесу) — файл .xls або .csv з Клієнт-банку (Приват24-Бізнес). У такій виписці є окрема колонка з назвою контрагента — вона підставляється автоматично.
   • УкрГазБанк — файл .xls або .csv з Інтернет-банкінгу. Назва кореспондента і призначення платежу теж читаються автоматично.
3. Розмір файлу — до 10 МБ. Більший файл не приймається — побачите повідомлення «Файл завеликий».

Валюта виписки має збігатися з валютою рахунку. У вас гривнева картка Monobank — обирайте гривневий рахунок зі свого списку, і у виписці теж мають бути гривневі операції. Якщо у файлі є рядки в євро або доларах — вони потраплять у «Конфлікт валют» і не будуть імпортовані. Виключення — режим Monobank напряму, там закордонні покупки обробляються автоматично (детальніше нижче).

Банк визначається сам. Ви не обираєте «Monobank», «ПриватБанк» чи «УкрГазБанк» руками — файл читається і впізнається за вмістом. У результаті побачите бейдж «Розпізнано: ПриватБанк», «Розпізнано: УкрГазБанк» або «Розпізнано: Monobank».

Збільшити

Крок 2. Перевірте попередній перегляд і виправте, якщо треба

Після завантаження файлу зʼявляється попередній перегляд:

• Бейдж «Розпізнано» — який банк визначився.
• 4 картки з підсумками (детально нижче).
• Таблиця всіх рядків — кожен рядок це майбутня транзакція. Ви можете:
  • Зняти галочку — пропустити рядок (наприклад, особиста покупка у бізнес-виписці);
  • Змінити категорію — обрати з вашого списку або створити нову;
  • Перетворити на переказ — обрати інший власний рахунок як «куди надійшло». Тип зміниться з «Витрати» на «Переказ» (синя стрілочка ↔).

Крок 3. Натисніть «Імпортувати»

Кнопка «Імпортувати N» запише обрані рядки одним пакетом, баланс рахунку автоматично перерахується, і вас перекине на сторінку «Транзакції». Якщо щось пішло не так — увесь імпорт можна відкотити одним кліком з журналу дій (вкладка «Історія імпортів»).

4 картки з підсумками — що показують

Над таблицею попереднього перегляду — підсумок, який допомагає одразу зрозуміти стан файлу:

Під «До імпорту» дрібним текстом — підсумок «Надходження X · Витрати Y» у валюті рахунку. Зручно, щоб одразу прикинути загальний результат.

Як розпізнаються дублі

Кожен рядок виписки отримує свій унікальний відбиток — як у людей різні відбитки пальців. Відбиток складається з: рахунку + дати + типу + суми + опису. Якщо у вашій базі вже є рядок із таким самим відбитком — новий помічається як дубль і повторно не імпортується.

Це означає:

• Завантажили той самий файл вдруге? Усі рядки — дублі, нічого не задвоїться. Безпечно.
• Виписки з пересічними періодами (січень + грудень-січень)? Пересічні дні автоматично розпізнаються.
• Імпорт через Monobank напряму, потім файл за той самий день? Теж сходиться.

Уважно. Якщо ви відредагували опис транзакції після імпорту, повторний імпорт того ж рядка вже не зловиться як дубль (бо опис змінився — змінився і відбиток). Це маленьке обмеження, з яким легко жити.

Категорії підставляються самі — три рівні

Перш ніж відкрити попередній перегляд, для кожного рядка виписки підбирається можлива категорія. Як це працює:

1. Спочатку — переказ між вашими рахунками. Якщо у описі є фрази як «Переказ між власними рахунками», «Переказ з картки», «Поповнення власної картки» (для Monobank) або категорія виписки = «Переказ на свою картку» (для особистої виписки ПриватБанку) — рядок отримує синій бейдж «Можливий переказ». Категорія не призначається — ви самі обираєте «куди надійшло». У бізнес-виписках ПриватБанку і УкрГазБанку перекази між власними рахунками автоматично не помічаються — їх ви самі перетворюєте на переказ у попередньому перегляді.

2. Потім — категорія з самої виписки (тільки для особистої виписки ПриватБанку — Приват24). У такій виписці є колонка «Категорія» (наприклад, «Продукти», «Транспорт»). Якщо у вашому списку вже є категорія з такою назвою — вона підставиться автоматично. Якщо ні — нова створиться автоматично у вашому бізнесі.

3. Нарешті — ваші правила (для Monobank, бізнес-виписок ПриватБанку і УкрГазБанку — у цих файлах колонки «Категорія» немає). Ви налаштовуєте правила у Довідниках → Правила імпорту: «якщо в описі є слово АТБ — це Закупівлі», «якщо MCC код 4121 — це Транспорт». Працюють і ваші правила, і вбудовані глобальні (на старті є набір популярних: АТБ → Закупівлі, Uber → Транспорт, ФОП-податки → Податки тощо).

Чому категорія іноді залишається порожньою? Це нормально, особливо для нових типів операцій — на такий опис у вас іще немає правила. У таблиці попереднього перегляду кожен рядок має поле «Категорія» — поставите вручну, а потім зайдіть у Довідники → Правила імпорту і створіть правило для майбутніх імпортів.

Переказ між своїми рахунками

Окрема історія, яка трапляється часто: ви перекинули гроші зі своєї дебетової картки на свою кредитну. Банк бачить це як «витрати» з однієї картки і «надходження» на іншу — без розуміння, що це той самий ваш капітал, який просто перейшов з кишені в кишеню.

Якщо імпортувати таке як два звичайні записи — ваш бюджет покаже «−5 000» витрат і «+5 000» надходжень, які нічого не значать.

Як це виглядає у попередньому перегляді. Рядки з ознаками переказу отримують синій бейдж ↔ «Можливий переказ», а у колонці «Категорія» зʼявляється не звичний вибір категорії, а «Рахунок-призначення»:

• Обираєте інший власний рахунок — рядок стає переказом (синя стрілочка ↔), категорія — системна «Переказ», контрагент і проєкт прибираються.
• Залишаєте «Без переказу» — рядок повертається до звичайних витрат з підставленою категорією.

Уявіть Сергія. Сергій 5-го числа переклав 10 000 ₴ з Monobank ФОП на свою кредитку (закрив частину ліміту). У виписці Monobank це: «−10 000 ₴, переказ між власними рахунками для поповнення картки». Ця фраза розпізнана автоматично, рядок отримав бейдж «Можливий переказ». Сергій обирає рахунок-призначення = «Кредитка Універсал». Рядок став переказом — у звітах він не зменшує і не збільшує загальний капітал, просто показує внутрішній рух між кишенями.

Тільки в одній валюті. Якщо у файловому імпорті ви оберете рахунок-призначення з іншою валютою (UAH → USD) — побачите повідомлення «Валюта рахунку-призначення має збігатися з валютою рахунку імпорту». Закордонні переклади між картками поки що не підтримуються.

Контрагенти підставляються або створюються

Якщо у виписці є колонка з назвою контрагента (Monobank ФОП — обовʼязково, бізнес-виписка ПриватБанку — обовʼязково, УкрГазБанк — обовʼязково, особиста виписка ПриватБанку з Приват24 — частково), під час імпорту:

1. Назва зіставляється з вашим списком контрагентів. Регістр і зайві пробіли не важливі: «ТОВ Ромашка», «ТОВ ромашка», «ТОВ РОМАШКА» — це той самий контрагент.
2. Якщо такий уже є — підставляється у транзакцію.
3. Якщо немає — створюється новий контрагент і одразу підставляється у рядок.

Якщо у виписці 5 рядків від одного «ТОВ Ромашка» — створиться один контрагент, а не пʼять однакових.

Що НЕ автоматизується. Покупки в торгових мережах без явного контрагента (АТБ, Сільпо) — поле «Контрагент» залишається порожнім. Це нормально: щоденні витрати не потребують контрагентів, вони класифікуються лише категорією.

Перевірка балансу до імпорту

Якщо рахунок налаштований як «Дозволити відʼємний баланс» = вимкнено — перш ніж записати рядки у вашу базу, баланс перераховується наперед: «чи стане він відʼємним після цього імпорту?». Якщо так — ви побачите зрозуміле повідомлення, а у базу нічого не потрапляє:

«Імпорт неможливий: після імпорту мінімальний баланс рахунку Monobank UAH стане −1 234.56. Рахунок не дозволяє відʼємний баланс.»

Уявіть Анну. На картці зараз 200 ₴. У виписці є рядки: «−500 за каву», «+5 000 від клієнта», «−800 на бензин». Якщо рахунок не дозволяє мінус — підсумок буде 200 − 500 + 5 000 − 800 = 3 900 ₴ у кінці. Але в середині дня баланс міг би стати −300 (200 − 500 до надходження від клієнта). Це теж враховується, і ви побачите повідомлення, якщо буде проблема.

Що робити, якщо побачили це повідомлення:

• Увімкнути «Дозволити відʼємний баланс» у налаштуваннях рахунку (для кредиток і овердрафтів — це нормально).
• Або завантажити лише частину виписки — спочатку надходження окремо, потім витрати.
• Або обрати інший рахунок для імпорту.

Monobank напряму — коли підключати

Якщо ви активно користуєтесь Monobank і ведете свої записи щодня, файлова виписка стає рутиною. Підключення напряму робиться один раз і далі:

• Завантажити вручну за період — обираєте картку Monobank і період (до 31 дня за раз — таке обмеження банку), отримуєте такий самий попередній перегляд, як для файлу.
• Автоматично у режимі живих сповіщень — коли ви розрахуєтесь карткою Monobank, операція автоматично зʼявиться у вашому списку за кілька секунд. Без вашої участі. Без файлів.

Що таке «токен» і навіщо він

Щоб ваші операції надходили сюди напряму з банку, потрібен токен — так Monobank називає особистий код доступу до вашого рахунку (на сайті банку всюди це слово, тому й тут вживаємо його). Уявіть токен як окремий пароль, який ви видаєте лише для перегляду своїх операцій: переказати чи зняти гроші з ним неможливо. Токен створюється на окремій сторінці банку за кілька хвилин.

Не лякайтесь слова «токен». Це не складно і безпечно. На сторінці підключення є така сама покрокова підказка «Звідки взяти токен?» — розгорнете й пройдете крок за кроком, не виходячи з форми.

Як отримати токен — крок за кроком

1. Відкрийте сторінку банку. У браузері перейдіть на api.monobank.ua — це офіційна сторінка Monobank, де створюються токени.
2. Увійдіть через застосунок. На сторінці зʼявиться QR-код. Наведіть на нього камеру телефона — відкриється застосунок Monobank, де ви підтверджуєте вхід.
3. Підтвердьте новий браузер через пошту. Monobank може попросити підтвердити вхід із нового браузера — для цього банк надішле вам лист. Перейдіть за посиланням із листа.
4. Відкрийте «Мої токени». Праворуч угорі, під вашим номером телефона, відкрийте меню й оберіть пункт «Мої токени».
5. Активуйте токен і скопіюйте його. У вікні натисніть «Активувати токен» — зʼявиться довгий набір літер і цифр. Скопіюйте його одразу: банк показує токен лише раз (це і є та сама «активація», про яку питають).
6. Вставте у формі підключення. На вкладці «Monobank API» натисніть «Підключити Monobank», вставте токен у поле й натисніть «Підключити». Зʼявиться список ваших карток.
7. Привʼяжіть картку до рахунку. Оберіть, який ваш рахунок відповідає якій картці Monobank (валюта має збігатися).
8. За бажанням — увімкніть живі сповіщення, щоб нові операції зʼявлялись автоматично.

Токен показується лише раз — одразу після активації. Якщо не встигли його скопіювати, нічого страшного: активуйте новий (на одну компанію Monobank дозволяє до 5 токенів). А якщо у вас ще немає рахунку для бізнесу (ФОП), банк запропонує його відкрити — для звичайних карток це не обовʼязково.

Безпека токена:

• Токен зберігається у зашифрованому вигляді. Навіть якщо хтось зазирне у наші файли — побачить набір символів без сенсу.
• Токен ніколи не показується у вашому браузері — інтерфейс отримує лише факт підключення і список привʼязаних карток.
• Токен дає доступ лише до перегляду ваших операцій. Нікому не передавайте свій токен — як і будь-який пароль.

Обмеження банку:

• Не частіше ніж раз на 60 секунд можна оновлювати виписку. Друга спроба швидше — банк відмовить. Лічильник зворотного відліку показується у потрібний момент.
• 31 день за раз — більший період запитати не можна. Хочете рік історії — імпортуйте по місяцях.
• Живі сповіщення працюють, коли ви заходите з публічного інтернет-адреса (не з тестового вікна на власному компʼютері).

Збільшити

Закордонні покупки — обробляються самі

Якщо ви розрахувались карткою UAH у магазині Берліна, у застосунку Monobank це виглядає як «−45.00 EUR», але з гривні списано конкретну гривневу суму (банк сам зробив конвертацію). У файловій виписці така операція може потрапити у «Конфлікт валют» і не імпортуватись.

Через Monobank напряму ця ситуація вирішується автоматично: у транзакцію підставляється гривнева сума (як банк уже списав), а в опис додається примітка «(45.00 EUR)» — щоб ви бачили оригінал. Жодних конфліктів.

Історія імпортів і відкат

Кожен успішний імпорт залишає слід — окремий запис у Журналі дій → вкладка «Історія імпортів». Запис містить:

• коли був імпорт;
• з якого банку (Monobank / ПриватБанк);
• у який рахунок;
• скільки рядків було у файлі і скільки записалось;
• хто запустив (актуально для бізнесу з кількома працівниками);
• який саме файл (monobank-march.csv тощо).

Відкат — кнопка біля кожного запису. Натискаєте — підтверджуєте у віконці «Буде видалено N транзакцій» — і усі операції цього імпорту видаляються разом, баланс рахунку повертається на попередній рівень.

Уявіть Олексія, який імпортував не той файл. Завантажив виписку зі своєї особистої картки замість бізнес-картки. 47 особистих транзакцій потрапили у бізнес-список. Олексій іде у Журнал дій → Історія імпортів → знаходить останню сесію → «Відкатити» → «Буде видалено 47 транзакцій?» → «Так». Через секунду все на місці, баланс відновлений, історія чиста.

Уважно з пізнішими транзакціями. Якщо після імпорту ви додали свої власні транзакції, які залежать від тих імпортованих (наприклад, баланс став плюсовим завдяки імпорту і ви витратили цей плюс), відкат може заблокуватись з повідомленням «Недостатньо коштів». Спочатку видаліть свої пізніші транзакції, потім спробуйте відкат знову.

Хто може імпортувати

Спробуйте у демо. На сторінці є блок «Немає своєї виписки під рукою?» з двома кнопками-завантаженнями: monobank-example.csv і privatbank-example.xlsx. Скачуєте → перетягуєте у зону завантаження → проходите повний шлях з попереднім переглядом, без потреби йти у банк за справжньою випискою.

Сценарії з життя

Перший імпорт за квартал

1. Анна вивантажує з Monobank виписку за 90 днів — отримує файл monobank-q1.csv.
2. Перетягує файл у зону завантаження → попередній перегляд показує 200 рядків. У картках з підсумками: «До імпорту 195», «Дублі 0», «Конфлікт валют 5» (5 покупок у EUR на гривневій картці під час відрядження).
3. Для 5 EUR-рядків Анна знімає галочки (запише на USD-рахунок окремою випискою пізніше).
4. Перевіряє автокатегоризацію — більшість АТБ/Сільпо/Uber вгадались, кілька підставляє вручну.
5. 3 рядки з фразою «Переказ між власними рахунками» — обирає рахунок-призначення «Кредитка Універсал», вони стають синіми ↔.
6. Натискає «Імпортувати 195» → перекидає на /transactions, баланс Monobank ФОП оновлено.

Підключаю Monobank напряму

1. Сергій відкриває api.monobank.ua, сканує QR-код застосунком Monobank, підтверджує вхід, відкриває «Мої токени» → «Активувати токен» і одразу копіює свій токен.
2. На вкладці «Monobank API» → «Підключити Monobank» → вставляє токен → бачить список своїх карток (Біла, Чорна, ФОП).
3. Привʼязує «Біла карта» до свого рахунку «Monobank UAH» (валюти збігаються — обидві гривневі).
4. Натискає «Завантажити» за останні 7 днів → переглядає попередній перегляд, імпортує.
5. Налаштовує живі сповіщення → нові операції тепер тягнуться автоматично.

Помилковий імпорт — треба відкотити

1. Олексій імпортував не той файл (особиста виписка замість бізнес-).
2. Іде у Журнал дій → «Історія імпортів».
3. Знаходить останню сесію, натискає «Відкатити».
4. Віконце: «Буде видалено 47 транзакцій. Підтвердити?» → «Так».
5. Транзакції зникли, баланс рахунку повернувся, новий запис у журналі: «Відкат імпорту».

Кілька імпортів — головне не задвоїти

• Виписки з пересічними періодами — без проблем: дублі ловляться за відбитком.
• Той самий файл повторно — теж: усі рядки = дублі, нічого не додасться.
• Імпорт через Monobank напряму + потім файл за той самий день — сходиться.
• Винятки: ви вручну змінили опис транзакції після імпорту (відбиток інший); або одна й та сама операція з різними сумами через коригування банку (це різні транзакції).

Звʼязок з іншими сторінками

• Транзакції — кінцева точка імпорту. Після підтвердження вас перекидає сюди, нові рядки одразу видно.
• Мої рахунки — джерело для вибору рахунку. Параметр «Дозволити відʼємний баланс» визначає, чи спрацює перевірка балансу. У привʼязаних до Monobank рахунків зʼявляється кнопка sync.
• Журнал дій — друга вкладка «Історія імпортів» з відкатом. Кожен імпорт = один запис у журналі.
• Довідники → Правила імпорту — налаштування правил автокатегоризації для Monobank (бо там колонки «Категорія» немає).
• Звіти — імпортовані транзакції одразу потрапляють у Прибутки і витрати, Рух грошей, Баланс, по контрагентах і проєктах.

Що поки не вміємо

• Wise, Revolut та інші банки — поки що підтримуються Monobank, ПриватБанк (особистий і для бізнесу) і УкрГазБанк. Інші банки додамо пізніше.
• Імпорт у валюті, що відрізняється від рахунку (з конвертацією за курсом) — поки що блокується. Через Monobank напряму закордонні покупки обходяться автоматично (валюта рахунку, оригінал у описі).
• Переказ між рахунками у різних валютах — теж поки що ні.
• Час транзакції з виписки використовується для правильної послідовності, але не зберігається — у списку всі операції одного дня матимуть однакову дату без часу.
• Регулярні вирази у правилах — поки що тільки пошук підстроки. Тобто правило «АТБ» спрацює на будь-який опис, де є «АТБ», але побудувати правило типу «номер квитанції, що починається з 2025/» — ні.
• Редагування вбудованих правил — глобальні правила лише для перегляду. Можна створити власне правило з тим самим словом і іншою категорією — воно матиме пріоритет.
• Дозвіл імпортувати працівникам — тільки власник.
• Масові дії у попередньому перегляді (наприклад, «всі АТБ → категорія Закупівлі одним кліком») — поки що поодинці. Спосіб обходу: створити правило у Довідниках, повторно завантажити файл.

Часті запитання