Призначення
Плагін для України, який підключає банківські термінали PrivatBank (JSON protocol) до Syrve POS і дозволяє створити зовнішній тип оплати в Syrve Office. Забезпечує передачу банківських реквізитів для друку у фіскальному чеку відповідно до вимог законодавства.
Вимоги та сумісність
Починаючи з версії Syrve 9.3.6+.
На банківському терміналі має бути налаштований JSON protocol.
Підтримуються моделі на кшталт Newland N950, PAX A920 та інші сумісні з JSON.
Встановлення плагіну (Syrve POS)
Вимкніть SyrvePOS перед інсталяцією.
Завантажте архів із плагіном Resto.Front.Api.PrivatBankPlugin.V9Preview6.2.0.4 від 02.02.2026.
Створіть папку Resto.Front.Api.PrivatBankPlugin і розпакуйте туди архів.
Відредагуйте конфігураційний файл плагіна (приклад структури див. у документації).
Налаштування конфігурації
Оберіть спосіб підключення: по IP (Wi‑Fi/Ethernet) або по COM/USB. Далі заповніть відповідні параметри в конфізі плагіну.
Підключення по IP (Wi‑Fi / Ethernet)
UseIpConnection=True (увімкнути IP‑підключення).
Ip= – IP має пінгуватись з ПК.
Port=<порт> – зазвичай 2000 або 2100.
Забезпечте стабільну мережу/інтернет, щоб уникати розривів з’єднання.
Підключення по COM/USB
Перевірте номер COM‑порту в Windows Device Manager і вкажіть його в полі COM (наприклад, COM2).
Налаштування Merchant (якщо їх декілька)
UseMerchants=True.
DefaultMerchant=<номер>.
Merchants заповнюється у форматі: merchantNumber|Actual name of Point of sales in Syrve Office.
Якщо мерчант один – поле Merchants залишають порожнім.
<string>
merchant number|Actual name of Point of sales in Syrve Office
</string>
<string>
2|CASH_TOV
</string>
Налаштування типу оплати в Syrve Office
Перейдіть: Retail Sales → Payment types і додайте External payment type.
Forbid manual input = вимкнено.
У полі Non-cash type виберіть Resto.Front.Api.PrivatBankPlugin.
Прапорець Fiscal = увімкнено.
Перевірка роботи на Syrve POS
Запустіть SyrvePOS – плагін має підвантажитись і створити тип безготівкової оплати.
На POS відкрийте вікно Plugins та натисніть Check connection – після успішного handshake з’явиться підтвердження.
На терміналі індикатор з’єднання має стати зеленим.
Особливості роботи (X/Z, повернення)
При відкритті касової зміни на SyrvePOS друкується X‑звіт також і на терміналі.
При закритті зміни друкується Z‑звіт.
X/Z можна надрукувати вручну через меню Plugins.
Повернення можливе лише на ту саму картку, якою оплачували замовлення.
Типові проблеми та діагностика
Немає з’єднання / розрив під час роботи: перевірте, чи правильно обрано IP/COM, актуальність IP/COM, стабільність мережі.
Плагін не завантажується: перевірте конфіг, цілісність файлів плагіна та системні залежності.
Помилка друку звіту: зміна може бути закрита, не було продажів, або є проблеми передачі даних/мережі.
Оплата пройшла на терміналі, але SyrvePOS показав помилку: зв’язок міг пропасти – виконайте refund останньої транзакції на терміналі, відновіть з’єднання та повторіть оплату в SyrvePOS.
Довгі очікування (таймаути): за нестабільної мережі очікування може тривати понад 2 хвилини – перевірте інтернет/мережу (кабель або Wi‑Fi).
Історія змін
V9Preview6build2.0.4 (Jan 30, 2026): прибрано обов’язкове використання консолі для підключення – термінал можна підключати через плагін.