Nordlet

← Документация / Руководства

Банковские подключения

Подключение банка через открытый банкинг (open banking), привязка его счетов, выбор шаблона импорта и синхронизация проводок с Главной книгой.

В этом руководстве описано постоянное подключение к банку по стандарту PSD2 (open banking): как настроить соединение, как привязать банковские счета к вашей Главной книге, как сделать так, чтобы каждая синхронизация создавала контрагентов, сопоставляла счета и проводила платежи с помощью шаблона импорта, а также что возвращает результат синхронизации. Технические детали API описаны в разделе Импорт банковских выписок и платежей. Если вы хотите загружать файлы выписок вместо использования прямого подключения, см. раздел Импорт банковских выписок (camt.053).

1. Подключение банка

В разделе Банк → Подключения (Bank → Connections) выберите страну и нажмите Показать банки (Show banks). Выберите свой банк и тип владельца счета (бизнес или личный), затем нажмите Подключить (Connect). Вы будете перенаправлены на страницу авторизации банка, где нужно войти в систему и подтвердить доступ, после чего банк вернет вас обратно в Nordlet. Подключение появится в списке с указанием срока действия согласия на доступ. Согласия имеют ограниченный срок действия, устанавливаемый банком (обычно 90 или 180 дней); по истечении срока подключение потребуется обновить.

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

2. Привязка банковских счетов

Под каждым подключением отображается список всех доступных в банке счетов с указанием их IBAN и валюты. Для каждого счета выберите существующий банковский счет из Главной книги или нажмите Создать новый банковский счет (Create a new bank account), при необходимости укажите дату, с которой нужно начать синхронизацию, и нажмите Привязать (Link). Синхронизируются только привязанные счета. Если дата начала синхронизации не указана, первая синхронизация загрузит данные за последние 90 дней.

3. Создание шаблона импорта

В разделе Банк → Шаблоны импорта (Bank → Import templates) нажмите Новый шаблон импорта (New import template), выберите тип Банковское подключение (Bank connection) и задайте название. Строки шаблона соответствуют атрибутам, которые банковская лента передает для каждой транзакции. Поле Обязательно в файле (Required in file) оставлено для совместимости; для прямых банковских лент валидация по нему не проводится.

Счет в Главной книге. Для обычной строки суммы transaction_amount.amount и для строк правил можно указать счет Главной книги. Каждая синхронизированная транзакция, обработанная по такой строке, проводится автоматически и помечается как сопоставленная с проводкой журнала. Строки правил отбирают транзакции по банковскому коду операции или направлению потока средств:

Строка Отбирает Типичный счет
Банковские комиссии (код 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) полностью удаляет подключение и привязку его счетов, но не затрагивает уже записанные в систему транзакции.