NovaPay Business: завантаження банківських виписок
Інтеграція NovaPay Business підключає бізнес-рахунок NovaPay до нового Клієнт-банку QUINCEFIN. Після налаштування можна завантажувати банківські операції за вибраний період через API, перевіряти їх і створювати грошові документи без ручного перенесення виписки.
Не плутайте дві інтеграції. NovaPay Business у розділі Клієнт-банк завантажує виписки з бізнес-рахунку. NovaPay у розділі Платіжні системи створює платіжні посилання для покупців. Для них використовуються різні профілі та різні параметри доступу.
Що передається з виписки
QUINCEFIN отримує з NovaPay Business доступні дані банківської операції, зокрема:
- дату, час і номер операції;
- суму та напрям руху коштів;
- валюту;
- призначення платежу;
- назву, код ЄДРПОУ та IBAN контрагента;
- початковий і кінцевий залишок, якщо вони є у відповіді NovaPay.
Кожна операція отримує стабільний зовнішній ідентифікатор. Повторне завантаження того самого періоду не повинно створювати другий грошовий документ для вже імпортованої операції.
Що потрібно до початку
Підготуйте:
- Активний бізнес-рахунок і доступ до NovaPay Business.
- Увімкнений API-доступ у бізнес-кабінеті NovaPay.
- Параметри Login, Refresh token і Public certificate.
- Банківський рахунок у QUINCEFIN з тим самим IBAN, що й рахунок NovaPay Business.
NovaPay публічно описує можливості бізнес-рахунку та API на сторінці Рахунок NovaPay для бізнесу. Якщо розділ API або потрібні параметри недоступні для вашої ролі в кабінеті, зверніться до підтримки NovaPay.
Для цієї інтеграції не підходять Merchant ID, приватний ключ і публічний ключ інтернет-еквайрингу. Вони використовуються окремою інтеграцією NovaPay для платіжних посилань.
Перевірте банківський рахунок у QUINCEFIN
- Відкрийте Налаштування → Компанія → Банківські рахунки.
- Відкрийте рахунок, на який надходять кошти NovaPay.
- Перевірте організацію, валюту та IBAN.
- Збережіть рахунок.
Під час перевірки з’єднання QUINCEFIN шукає доступний у NovaPay Business рахунок саме за IBAN. Якщо значення не збігаються, профіль не буде активовано.
Детальніше: Банківські рахунки.
Створіть профіль NovaPay Business
- Відкрийте Налаштування → Інтеграції → Клієнт-банк.
- Створіть новий профіль NovaPay Business.
- Вкажіть зрозумілу назву профілю.
- У полі Банк. рахунок/Каса виберіть підготовлений банківський рахунок.
- Введіть Login, Refresh token і Public certificate з NovaPay Business.
- Натисніть Перевірити з’єднання.
Під час успішної перевірки QUINCEFIN:
- авторизується в NovaPay Business;
- знаходить рахунок за IBAN;
- визначає внутрішні ідентифікатори клієнта й рахунку;
- отримує оновлені Refresh token і Public certificate та безпечно зберігає їх у профілі.
Після повідомлення про успішне з’єднання профіль уже збережено. Поля Client ID і Account ID заповнюються автоматично, редагувати їх вручну не потрібно.
Не повертайте в профіль старі значення Refresh token або Public certificate після успішної перевірки: NovaPay може оновлювати їх під час авторизації.
Завантажте виписку
- Перейдіть у Гроші → Клієнт-банк.
- Виберіть банківський рахунок, до якого прив’язано профіль NovaPay Business.
- Вкажіть період виписки.
- Натисніть Завантажити.
- Перевірте завантажені операції, партнерів, договори, статті руху коштів та документи-підстави.
- Позначте готові рядки й натисніть Створити документи.
Надходження, витрати та переміщення опрацьовуються за стандартними правилами Клієнт-банку. Детальніше про вкладки, правила розпізнавання та створення документів: Клієнт-банк.
Як працює співставлення оплат
NovaPay Business передає банківську виписку, а QUINCEFIN опрацьовує її стандартним механізмом Клієнт-банку:
- знаходить контрагента за доступними реквізитами;
- підтягує збережені правила класифікації;
- дозволяє вибрати договір, статтю руху коштів і документ-підставу;
- розпізнає вже створений з цієї самої банківської операції документ за зовнішнім ідентифікатором.
Це не означає автоматичне співставлення профілю платіжного сервісу NovaPay з кожним рядком виписки. Якщо надходження вже було створене callback-ом платіжної інтеграції, перевірте рядок виписки перед створенням нового документа.
Чи можна співставити післяплату з банківською випискою
Так, зарахування післяплати, яке потрапило на рахунок NovaPay Business, буде доступне у виписці як банківська операція. Її можна опрацювати в Клієнт-банку та вручну пов’язати з потрібним документом-підставою.
Водночас поточна інтеграція не завантажує окремий реєстр післяплат і не розподіляє автоматично одне зведене зарахування між кількома ТТН, замовленнями або продажами. Якщо NovaPay перерахував одну суму за кількома відправленнями, рознесення потрібно перевірити й виконати в QUINCEFIN вручну.
Типові помилки
З’єднання не підтверджується
Перевірте:
- чи активовано API-доступ у NovaPay Business;
- чи правильно введені Login, Refresh token і Public certificate;
- чи не були повторно вставлені старі параметри після попередньої авторизації;
- чи збігається IBAN у QUINCEFIN та NovaPay Business;
- чи має користувач NovaPay доступ до потрібного підприємства і рахунку.
Виписка порожня
- перевірте вибраний період;
- переконайтеся, що рухи є саме по прив’язаному рахунку;
- повторно перевірте з’єднання профілю;
- перевірте, чи не були операції вже створені раніше.
Післяплата не розподілилася по замовленнях
Це очікувана межа поточного сценарію. Завантаження виписки працює на рівні банківських операцій, а не реєстру ТТН. Виберіть документ-підставу вручну або виконайте рознесення платежу у відповідному грошовому документі.