← Документація / Посібники
Імпорт банківських виписок (camt.053)
Завантажте виписку ISO 20022 camt.053 зі свого банку, налаштуйте шаблон імпорту та дозвольте Nordlet створювати контрагентів, зв'язувати рахунки та проводити платежі.
У цьому керівництві описано імпорт банківських виписок у форматі ISO 20022 camt.053 за допомогою шаблону імпорту: що саме завантажувати, як налаштувати шаблон і що створюється в результаті імпорту. Відомості про API наведено в розділі Банківські та платіжні імпорти. Інформацію щодо прямого підключення до банку замість файлів дивіться в розділі Банківські з'єднання.
1. Завантажте виписку з банку
У своєму інтернет-банку відкрийте експорт виписок та виберіть формат ISO 20022 camt.053 (XML). Литовські банки зазначають його як „ISO 20022 XML“ або „camt.053“; більшість банків ЄС пропонують його в розділі корпоративного банкінгу. Виберіть діапазон дат і завантажте файл. Один файл може містити кілька виписок (наприклад, по одній на кожний валютний рахунок); виписки, IBAN яких не збігається з вибраним банківським рахунком, пропускаються.
Імпортуються лише проведені записи (Ntry/Sts = BOOK). Незавершені записи ігноруються.
2. Створіть банківський рахунок
Кожний імпорт здійснюється на банківський рахунок. Створіть його в розділі Банк (Bank), зазначивши IBAN та валюту рахунку. Після встановлення IBAN під час імпорту перевіряється, чи належить виписка саме до цього рахунку, і файли з іншим IBAN відхиляються.
3. Створіть шаблон імпорту
У розділі Банк → Шаблони імпорту (Bank → Import templates) натисніть Новий шаблон імпорту (New import template), виберіть тип ISO 20022 camt.053 та вкажіть назву.
Поля. Кожний елемент виписки, який зчитує імпортер, є рядком. Прапорец у полі Обов'язкове у файлі (Required in file) означає, що цей елемент має бути присутнім у завантаженому файлі; файл, у якому бракує обов'язкового елемента, відхиляється із зазначенням пропущених назв. Елементи, які містить кожна виписка (Stmt/Id, Stmt/Acct/Id/IBAN, залишки, Ntry/Amt, Ntry/CdtDbtInd, Ntry/Sts, Ntry/BookgDt), позначені за замовчуванням. Необов'язкові поля - назва банку, код транзакції, назви та IBAN дебітора й кредитора, текст призначення платежу та посилання - не позначені, оскільки їх заповнюють не всі банки; позначте ті, які надає ваш банк.
Рахунок обліку. Рядки з грошовими сумами можна призначити на рахунок обліку (ledger account) - існуючий або новий, створений безпосередньо з цього рядка. Кожний рух коштів, сформований з призначеного рядка, проводиться під час імпорту: надходження коштів дебетує рахунок обліку банківського рахунку та кредитує призначений рахунок, списання працює навпаки, а банківська транзакція позначається як зведена з цим записом журналу. Окрім рядка звичайної суми Ntry/Amt, існують рядки правил, які вибирають записи за їхнім кодом транзакції або напрямком:
| Рядок | Що вибирає | Типовий рахунок |
|---|---|---|
| Банківські комісії (BkTxCd CHRG) | записи, родина коду транзакцій яких є CHRG |
витрати на банківські послуги (6800 у стандартному плані рахунків) |
| Відсотки (BkTxCd INTR) | записи, родина яких є INTR |
доходи або витрати за відсотками |
| Податки (BkTxCd TAXE) | записи, родина яких є TAXE |
сплатити податки |
| Інші списання | будь-який інший дебетовий запис | залиште „Не проведено“, щоб платежі зіставлялися з рахунками від постачальників |
| Інші надходження | будь-який інший кредитовий запис | залиште „Не проведено“, щоб надходження зіставлялися з рахунками покупцям |
Ntry/Amt |
кожний запис, не охоплений жодним правилом | зазвичай „Не проведено“ |
Запис проводиться на рахунок першого рядка, якому він відповідає: спочатку родина коду транзакції, потім напрямок, і в кінці рядок звичайної суми. Рядки правил не перевіряються на наявність у файлі. Код транзакції походить із Ntry/BkTxCd/Domn/Fmly/Cd; банк, який його не передає, залишає рядки кодів без збігів.
Створювати відсутніх покупців / постачальників. Позначте пункт Створювати відсутніх покупців (Create missing customers) у рядку назви дебітора (…/RltdPties/Dbtr/Nm), щоб створювати покупця для кожного невідомого платника вхідних коштів, та Створювати відсутніх постачальників (Create missing suppliers) у рядку назви кредитора (…/RltdPties/Cdtr/Nm) для кожного невідомого отримувача вихідних коштів. Контрагенти розпізнаються спершу за IBAN (IBAN зберігається в банківських рахунках контрагента), а потім за точним ім'ям; контрагент, знайдений за ім'ям, отримує доданий IBAN, тож наступний імпорт розпізнає його вже за IBAN. Новий контрагент вважається компанією, якщо його назва містить організаційно-правову форму (UAB, MB, AB, VšĮ, SIA, OÜ, GmbH, Ltd, …), і фізичною особою в іншому разі.
Створити контрагента для банку. Позначте це на рядку правила банківських комісій. Імпорт один раз створює постачальника з назвою банку (Stmt/Acct/Svcr/FinInstnId/Nm або назвою банківського рахунку, якщо у виписці немає назви банку) і реєструє кожну комісію в журналі з цим контрагентом.
Зв'язувати рахунки за цим полем. Позначте це на рядку призначення платежу (…/RmtInf/Ustrd), рядку структурованого посилання (…/RmtInf/Strd/CdtrRefInf/Ref) або рядку скрізного посилання (…/Refs/EndToEndId). Це поле може бути вибране лише в одному рядку; імпорт зчитує всі три тексти незалежно від того, який рядок позначено. З'являються ще два параметри:
- Створювати авансові рахунки для незіставлених вхідних платежів - вхідний платіж, який не відповідає жодному рахунку та надходить від відомого контрагента, отримує виставлений авансовий рахунок (серія AV) на суму платежу з датою платежу, і платіж зв'язується з ним. Контрагент має бути відомим, тому також позначте Створювати відсутніх покупців.
- Ставка ПДВ та Товар каталогу для таких авансових рахунків. Якщо вибрано товар, використовуються його рахунок обліку та, за відсутності ставки, його ставка ПДВ.
Збережіть шаблон.
4. Імпортуйте файл
У розділі Банк виберіть банківський рахунок, шаблон і файл, а потім натисніть Імпортувати (Import). У підсумковому рядку зазначається, скільки транзакцій імпортовано, скільки вже існувало, скільки рухів проведено, скільки контрагентів створено та скільки рахунків зв'язано або створено. У попередженнях перелічено платежі, які не вдалося зіставити, та причини цього.
Повторний імпорт того самого файлу є безпечним: записи розпізнаються за посиланням банку на запис (NtryRef, AcctSvcrRef або ідентифікатором транзакції TxId) або, за їхньої відсутності, за хешем дати проведення, суми, валюти, IBAN контрагента й тексту з урахуванням кількості входжень, щоб однакові записи в межах одного файлу залишалися різними. Контрагенти розпізнаються за IBAN та ім'ям. Проведені записи з нульовою сумою пропускаються з виведенням попередження.
5. Що робить функція „Зв'язувати рахунки за цим полем“
Кожний новий банківський запис перевіряється на відповідність відкритим документам:
- надходження коштів звіряються з виставленими рахунками покупцям, які не сплачені повністю, за номером рахунка (наприклад,
SF-123), знайденим у тексті призначення платежу, структурованому посиланні або скрізному посиланні; - списання коштів звіряються із зареєстрованими рахунками постачальників, які не сплачені повністю, за номером документа постачальника.
Збіг фіксує оплату рахунка та проводить надходження або виплату; запис відображається як зіставлений у розділі Банк → Транзакції (Bank → Transactions) із посиланням на рахунок. Записи без розпізнаного номера залишаються незіставленими та можуть бути зіставлені вручну зі списку транзакцій або, у випадку вхідних коштів від відомого покупця, перетворені на авансовий рахунок, якщо ввімкнено відповідний параметр.
6. Де шукати результати пізніше
- Банк → Транзакції (Bank → Transactions) - кожний імпортований запис; зіставлені запису посилаються на рахунок або запис журналу.
- Рахунки (Invoices) - авансові рахунки, створені для незіставлених надходжень.
- Контрагенти (Partners) - створені покупці та постачальники, кожний з IBAN у банківських рахунках.
- Головна книга → Журнал (Ledger → Journal) - проводки за комісіями (з банком як контрагентом), відсотками, податками та платежами.
Біллінг
Файли розміром до 10 МБ і до 50 000 записів. Кожні 10 імпортованих записів зараховуються як один запит API.