Еквайринг: завантаження оплат із CSV-реєстру

Реєстр платіжної системи пояснює, хто і за що заплатив, навіть якщо провайдер потім переказує гроші в банк однією сумою. Спочатку налаштуйте профіль, рахунок та статті комісії.

Доступність оновлення. Автоприв’язка за ТТН і CheckoutID та нові статуси нижче потребують відповідного оновлення QFin. Якщо у вашому середовищі їх ще немає, використовуйте ручний вибір документа або покупця та уточніть у підтримки доступність оновлення.

1. Підготуйте файл

Вивантажте CSV із кабінету потрібної платіжної системи. Зберігайте оригінальні назви колонок та ідентифікатори: не перетворюйте ID на числа і не редагуйте файл в Excel без потреби.

Підтримується UTF-8, файл до 5 МБ і до 5 000 оплат. Якщо файл більший, вивантажте коротший період. XLS/XLSX потрібно повторно експортувати у підтриманому CSV-форматі, а не просто перейменувати.

Формат визначається вибраним провайдером. Інший звіт того самого провайдера з іншим набором колонок може не підходити.

2. Відкрийте попередній перегляд

1. Перейдіть у Гроші → Клієнт-банк.
2. Натисніть Реєстр платіжної системи.
3. Виберіть Профіль. Перевірте організацію та валюту.
4. Виберіть CSV і натисніть Завантажити реєстр.
5. Перевірте назву файлу, кількість рядків, колонку Статус і підсумки Оплата клієнта, Комісія, До виплати.

На цьому кроці фінансових документів ще немає. Закриття вікна або Очистити перегляд не скасовує вже проведених документів; очищається лише перегляд файлу.

Підсумки у шапці стосуються всіх рядків файлу, а не лише успішних або вибраних оплат і не окремого зарахування з банківської виписки. Один файл може містити оплати з кількох виплат та відхилені операції. Для WayForPay, якщо хоча б в одному рядку комісія невідома, загальні Комісія та До виплати не показуються як повний підсумок. Остаточну суму вибраних проведених оплат перевіряйте під час звіряння виплати з банком.

3. Вкажіть, за що отримано гроші

У колонці Клієнт / оплачуваний документ перевірте запропонований зв’язок або виберіть один із варіантів:

• Документ - виберіть неоплачений документ покупця. Повна сума оплати буде зарахована в оплату цього документа, а не лише сума після комісії.
• Покупець (аванс) - виберіть покупця, потім його договір із потрібною організацією. Оплата враховуватиметься як аванс за цим договором.

Перевірте Статтю руху коштів для надходження. Пріоритет такий: вибрана в рядку → стаття договору → вхідна стаття за замовчуванням поточного користувача. Стаття має бути активною, вхідною та не групою. Якщо придатної статті немає, виберіть її кнопкою в рядку. Статті комісії беруться з профілю — це інші налаштування.

Організація й валюта документа або договору повинні відповідати рахунку профілю. Сума не може перевищувати неоплачений залишок вибраного документа. Не вибирайте довільного покупця лише для обходу цієї перевірки.

Як знаходиться документ

Спочатку QFin шукає відомий платіж у вибраній інтеграції. Якщо його немає і рядок ще не імпортовано, для двох провайдерів передбачено додатковий пошук:

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

Часткові оплати не отримують таку автоприв’язку за ТТН або CheckoutID. Їх можна прив’язати вручну після перевірки, якщо сума не перевищує неоплачений залишок. Ім’я платника, маскована картка, схожа сума чи довільний номер замовлення не є підставою для автоматичного вибору покупця. Не додавайте вигадані ТТН або CheckoutID для обходу перевірок.

Як читати підсумки й статуси

«Знайдено в інтеграції: 0» не означає, що CSV не прочитано. Дивіться також Прив’язано до документа / покупця, Потребує уточнення та статус кожного рядка. Наприклад, оплату може бути знайдено за ТТН, хоча її немає в історії платежів інтеграції.

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

Якщо оплата вже оформлена через callback або вручну, спочатку перевірте її існуюче надходження. Захист повторного імпорту працює для оплат, уже зареєстрованих цим CSV-механізмом; він не є універсальним пошуком усіх ручних надходжень за схожою сумою.

4. Уточніть дані провайдера

plata by mono

Виберіть профіль Plata, навіть якщо файл зовні схожий на реєстр іншої системи. Hutko і Plata залишаються різними провайдерами з окремими профілями та історією імпорту.

Підтриманий експорт починається службовим рядком «RT виписка за перiод…». Залишайте його та багаторядкові заголовки без змін. Основні колонки:

Валюти в цьому CSV немає: вона береться з рахунку профілю. Перед проведенням перевірте організацію та валюту. Для кожного рядка має виконуватися сума платежу − комісія = сума виплати.

Якщо немає ні платежу інтеграції, ні єдиного сумісного замовлення за CheckoutID, виберіть документ або покупця з договором вручну. Перевіряйте коментар оригінального замовлення, а не скопійований коментар реалізації. Наявність ID у файлі сама по собі не визначає покупця. Суму та дату фактичної виплати перевіряйте за банківською випискою; один CSV може охоплювати кілька виплат.

WayForPay

У налаштуваннях звіту WayForPay виберіть колонки нижче, додайте Комісія та повторно експортуйте оригінальний CSV у UTF-8. Порядок колонок довільний, додаткові колонки не заважають. Підтримано українські, російські та англійські заголовки стандартного експорту.

Перші шість колонок обов’язкові. Час запиту та Дата відшкодування не замінюють Час платежу. Ім’я клієнта та референс виплати не є обов’язковими для читання файлу. Не перейменовуйте колонки вручну й не додавайте повторні колонки з тим самим змістом.

Потрібне оновлення QFin. Автоматичне читання колонки «Комісія» доступне після встановлення відповідного оновлення. Якщо програма й далі пропонує ручне введення для заповненої комісії, уточніть у підтримки версію вашого середовища.

• Якщо комісія заповнена, вона автоматично з’явиться в колонці Комісія, а До виплати дорівнюватиме оплаті мінус комісія. Наприклад: 6 120,00 − 122,40 = 5 997,60 грн. Значення 122,4 читається як 122,40, 0 — як нульова комісія.
• Якщо колонки немає або клітинка порожня, для цього рядка введіть точну суму в Комісія вручну. Порожня клітинка не означає нуль. У змішаному файлі ручне поле є лише в рядках без комісії; якщо всі комісії заповнені, ручна колонка не показується.
• Комісія має бути невід’ємною, не більшою за оплату та містити не більше двох десяткових знаків. Некоректна комісія у файлі блокує рядок, а не замінюється ручною чи нульовою сумою. Повторно експортуйте коректний звіт.
• Проводяться лише звичайні оплати PURCHASE / Approved. Declined, повернення й інші непідтримані операції не проводяться як надходження, навіть якщо в них указано суму.

Вводьте 0 лише тоді, коли комісії справді немає. Не підставляйте приблизний відсоток і не розподіляйте загальну суму довільно: від цього залежить подальше звіряння з банком.

NovaPay, післяплата

Перевірте Джерело даних, Дату виплати, Реєстр / референс виплати та ЕН / ТТН. Для проведення потрібно підтвердити прапорець Підтверджую облік на дату виплати NovaPay….

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

5. Проведіть оплати

1. Позначте готові рядки вручну або натисніть Вибрати прив’язані оплати.
2. Перевірте вибір: за один раз можна провести від 1 до 100 оплат. Наявність прив’язки не замінює перевірку комісії та інших реквізитів.
3. Натисніть Провести оплати і підтвердьте дію.
4. Перевірте статус Уже завантажено та посилання на створене надходження.

Для кожної проведеної оплати створюється звичайний документ Надходження на рахунок на рахунок платіжної системи:

• розрахунки з покупцем змінюються на повну суму оплати;
• утримана комісія відображається окремим рухом витрат у тому самому документі;
• залишок коштів у платіжній системі збільшується на суму після комісії.

Окрему Витрату з рахунку на ту саму комісію додавати не потрібно: це подвоїть витрати.

Повторне завантаження та виправлення

Повторне завантаження того самого платежу в тому самому профілі не повинно створювати ще одне надходження: він показується як Уже завантажено. Для продовження великого реєстру повторно відкрийте файл і виберіть наступні непроведені оплати.

Захист не об’єднує історію різних профілів або провайдерів. Якщо той самий платіж раніше внесли через інший профіль, не проводьте його ще раз: спочатку перевірте наявні документи. Зміна провайдера не переносить попередні надходження автоматично.

Якщо джерело платежу змінилося або його документ змінено чи скасовано, система повідомить про конфлікт. Не змінюйте ID та не створюйте інший профіль для обходу перевірки. Відкрийте первинне надходження й з’ясуйте причину. Видалення документа не означає, що історію імпорту можна стерти повторним завантаженням.

Наступний крок

Натисніть Завантажені оплати та виплати, щоб переглянути проведені надходження. Для зарахувань у банк переходьте до звіряння виплат із банківською випискою.

Після відповідного оновлення QFin цей журнал можна відфільтрувати за Дата з, Дата до та Статус, наприклад залишити лише Очікує виплати за потрібний день. Це фільтри журналу вже завантажених оплат, а не попереднього перегляду CSV. Правила дат, вибору рядків і очищення фільтра.

Повний процес і підтримані системи: облік еквайрингу та післяплат. Практичний приклад сум: стаття про облік еквайрингових платежів.