Банківські підключення

У цьому посібнику описано пряме підключення до банку через PSD2 open banking: як встановити з'єднання, як прив'язати банківські рахунки до вашої головної книги (ledger), як налаштувати синхронізацію для створення контрагентів (partners), зіставлення рахунків (invoices) та проводки платежів за допомогою шаблону імпорту, а також що повертає результат синхронізації. Деталі щодо API наведено в розділі Імпорт з банків та платіжних систем. Якщо ви використовуєте файли виписок замість прямого підключення, див. Імпорт банківських виписок (camt.053).

1. Підключення банку

У розділі Банк → Підключення (Bank → Connections) виберіть країну та натисніть Показати банки (Show banks). Знайдіть свій банк і тип власника рахунку (бізнес або приватна особа), а потім натисніть Підключити (Connect). Ви будете перенаправлені на сторінку автентифікації вашого банку, де потрібно увійти в систему та надати дозвіл на доступ. Після цього банк поверне вас назад до Nordlet. Підключення з'явиться в списку із зазначенням терміну дії згоди. Банки обмежують термін дії згоди (зазвичай 90 або 180 днів); після його закінчення з'єднання потрібно підключити знову.

Список банків формується на основі провайдера відкритого банкінгу (open banking provider), налаштованого для вашого екземпляра Nordlet. Якщо для обраної країни немає банків, це означає, що провайдер її поки не підтримує.

2. Прив'язка банківських рахунків

Під даними підключення відображається список усіх рахунків, які надає банк, із зазначенням їхніх IBAN та валют. Для кожного рахунку виберіть наявний банківський рахунок у головній книзі (ledger) або натисніть Створити новий банківський рахунок (Create a new bank account), за бажанням вкажіть дату початку синхронізації та натисніть Зв'язати (Link). Синхронізуються лише прив'язані рахунки. Якщо дату початку не вказано, перша синхронізація завантажить дані за останні 90 днів.

3. Створення шаблону імпорту

У розділі Банк → Шаблони імпорту (Bank → Import templates) натисніть Новий шаблон імпорту (New import template), виберіть тип Банківське підключення (Bank connection) та введіть його назву. Рядки відповідають атрибутам, які банківський фід (feed) передає для кожної транзакції. Поле Обов'язкове у файлі (Required in file) залишено для повноти структури; живий фід за ним не перевіряється.

Рахунок головної книги (Ledger account). Звичайний рядок суми transaction_amount.amount та рядки правил можна прив'язати до рахунку головної книги (ledger account): кожна синхронізована транзакція з такого рядка одразу проводиться в обліку та позначається як зіставлена з бухгалтерським записом (journal entry). Рядки правил відбирають транзакції за банківським кодом транзакції або напрямком:

Рядок	Що відбирає	Типовий рахунок
Банківські комісії (код CHRG)	транзакції, чия група кодів дорівнює CHRG	витрати на комісію банку (6800 у стандартному плані рахунків)
Відсотки (код INTR)	група кодів INTR	доходи або витрати за відсотками
Податки (код TAXE)	група кодів TAXE	сплачені податки
Інші вихідні кошти	будь-який інший дебіт	залиште значення "Не проведено" (Not posted), щоб платежі зіставлялися з вхідними рахунками покупців
Інші вхідні кошти	будь-який інший кредит	залиште значення "Не проведено" (Not posted), щоб надходження зіставлялися з рахунками постачальників
transaction_amount.amount	кожна транзакція, яку не відібрало жодне правило	зазвичай "Не проведено" (Not posted)

Транзакція спрямовується на рахунок того рядка, якому вона відповідає в першу чергу: спочатку за групою кодів, потім за напрямком і врешті за звичайним рядком суми. Код береться з поля банку bank_transaction_code; якщо банк не передає код, рядки за кодами залишаються без збігів.

Створення відсутніх покупців / постачальників. Установіть прапорець Створити відсутніх покупців (Create missing customers) у рядку debtor.name, щоб автоматично створювати картку покупця для кожного невідомого платника вхідних коштів, та Створити відсутніх постачальників (Create missing suppliers) у рядку creditor.name для кожного невідомого одержувача вихідних коштів. Контрагенти розпізнаються за IBAN (debtor_account.iban / creditor_account.iban, який зберігається в банківських реквізитах контрагента), а за їх відсутності - за точним найменуванням; якщо контрагента знайдено за назвою, до його профілю додається IBAN. Новий контрагент вважається компанією, якщо його назва містить організаційно-правову форму (UAB, MB, SIA, GmbH, Ltd, …), і фізичною особою в іншому разі.

Створити контрагента для банку. Установіть цей прапорець у рядку правила банківських комісій. Під час синхронізації буде створено постачальника з назвою підключеного банку, а всі комісії будуть записані до журналу на цього контрагента.

Зіставляти рахунки за цим полем. Установіть цей прапорець у рядку remittance_information або reference_number. Кожна нова транзакція, чиє призначення платежу або посилання містить номер відкритого виставленого рахунку покупцю (надходження) чи зареєстрованого рахунку від постачальника (виплата), автоматично зіставляється з ним, а платіж проводиться. Якщо платник є відомим контрагентом (за збереженим IBAN, точною назвою чи кодом), рахунок має належати саме цьому контрагенту. Платіж від невідомого платника зіставляється лише тоді, коли його сума дорівнює залишку заборгованості, а номер рахунку включає префікс серії. Платіж, який перевищує залишок заборгованості, не зіставляється ніколи. Транзакції, які не пройшли ці перевірки, залишаються незіставленими, щоб ви могли опрацювати їх вручну. Опція Створювати авансові рахунки для незіставлених вхідних платежів (Create advance invoices for unmatched incoming payments) перетворює незіставлене надходження від відомого контрагента на виставлений авансовий рахунок на відповідну суму з датою платежу за вказаною ставкою ПДВ або обраною товарною позицією; для цього також потрібно ввімкнути параметр Створити відсутніх покупців, щоб контрагент був розпізнаний.

Збережіть шаблон.

4. Застосування шаблону та вибір розкладу

Повернувшись до розділу Банк → Підключення (Bank → Connections), ви побачите, що для кожного прив'язаного рахунку можна вибрати шаблон і розклад. Виберіть потрібний шаблон, встановіть режим Синхронізувати вручну (Sync manually), Синхронізувати щодня (Sync daily), Синхронізувати щотижня (Sync weekly) або Синхронізувати щомісяця (Sync monthly) та натисніть Застосувати (Apply). Прив'язаний рахунок без шаблону також синхронізується, але тільки зберігає транзакції: жодні проводки, зіставлення чи створення об'єктів не виконуються.

У разі вибору щоденного, щотижневого чи щомісячного розкладу API виконує синхронізацію самостійно: раз на годину система перевіряє рахунки, час останньої синхронізації яких перевищує встановлений період (24 години, 7 днів або 30 днів), і запускає синхронізацію аналогічно до кнопки Синхронізувати зараз (Sync now), після чого застосовує шаблон. Планова синхронізація зараховується до лімітів використання так само, як і ручна (кожні 10 завантажених транзакцій дорівнюють одному запиту). Якщо банк відхиляє синхронізацію, наприклад через закінчення терміну дії згоди, на підключенні з'являється позначка про помилку, і воно пропускається до наступного повторного підключення.

5. Синхронізація

Натисніть Синхронізувати зараз (Sync now) для потрібного підключення. Nordlet завантажує нові проведені транзакції для кожного прив'язаного рахунку; транзакції в очікуванні (pending) пропускаються, доки банк не проведе їх остаточно. Система завантажує їх (з моменту останньої синхронізації із захопленням тижневого інтервалу, щоб не пропустити пізні проводки), реєструє їх один раз (транзакції розпізнаються за унікальним посиланням запису банку) і виконує шаблон рахунку. У рядку результату зазначається, скільки транзакцій було імпортовано, а скільки вже існувало в системі. Через API синхронізація також повертає кількість створених рухів по рахунках, нових контрагентів, прив'язаних і створених рахунків, зіставлених платежів, а також попередження щодо платежів, які не вдалося зіставити.

Синхронізацію можна запускати автоматично через API (bank/feeds/sync) за розкладом; кожні 10 отриманих транзакцій таруються як один запит API.

6. Де дивитися результати

• Банк → Транзакції (Bank → Transactions) - усі синхронізовані транзакції, розбиті за вкладками рахунків; зіставлені транзакції містять посилання на рахунок або бухгалтерський запис.
• Рахунки (Invoices) - авансові рахунки, створені для незіставлених надходжень.
• Контрагенти (Partners) - створені покупці та постачальники, кожен із яких має IBAN у розділі банківських реквізитів.
• Головна книга → Журнал (Ledger → Journal) - проводки за комісіями (з банком як контрагентом), відсотками, податками та платежами.

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

У разі невдалої синхронізації на підключенні відображається текст помилки від банку. Найчастішою причиною є закінчення терміну дії згоди: натисніть Підключити (Connect) для цього банку знову та підтвердіть доступ; прив'язані рахунки та їхні шаблони при цьому збережуться. Кнопка Відключити (Disconnect) видаляє підключення та зв'язки його рахунків, але не видаляє вже записані транзакції.