Налаштування плагіна ПриватБанк для Syrve

Швидке переміщення по статті:

• Налаштування плагіна
• Підключення терміналу
• Визначення ідентифікаційного номера юридичної особи
• Налаштування типу оплати

     Важливо! Інтеграція за допомогою плагіна PrivatBank працює тільки з банківськими терміналами PAX ПриватБанк.
     Змінам в конфігураційному файлі підлягають тільки ті рядки, котрі вказані у інструкції, зміна інших рядків може порушити файл налаштувань (конфігураційний) а також роботу самого плагіна.

     Встановлення плагіна

     Для того, щоб встановити плагін PrivatBank, необхідно виконати наступні дії:

1. Завантажити архів з плагіном Resto.Front.Api.PrivatBankPlugin за посиланням котре можна отримати у вашого дилера Syrve.
2. Вимкнути Syrve POS та розархівувати завантажений архів у директорію Resto.Front.Api.PrivatBank, котру необхідно створити в каталозі плагінів з встановленим Syrve POS (...Front.Net\Plugins).
3. Встановити драйвер для інтеграції банківського термінала genericDriverJsonUSB для підключення (котрий також можна запросити у вашого диллера Syrve).

     Налаштування плагіна

1. Налаштувати конфігураційний файл плагіна Resto.Front.Api.PrivatBankPlugin.dll
   Для коректної роботи термінала потрібно вказати True у рядку:

   <setting name="use_merchants" serializeAs="String">
        <value>True</value>

2. Налаштувати суміщення юридичних осіб і торгових відділень, котрі налаштовані в Syrve Office:

   <setting name="merchants" serializeAs="Xml">
        <value>
             <ArrayOfString
   xmlns:xsi="http://www.w3.org/2001/XMLScema-instance"
   xmlns:xsd="http://www.w3.org/2001/XMLScema">
                  <string>pos3|1</string>
                  <string>pos4|2</string>
             </ArrayOfString>
        </value>
   </setting>

   Де pos3 та pos4 - назва торгового відділення у налаштуваннях торгового підприємства Syrve Office, а 1 та 2 - ідентифікаційні номери юридичної особи у терміналі, котрі можна дізнатись за допомогою дій, що описані далі у розділі Визначення ідентифікаційного номера юридичної особи.
        Зверніть увагу, що поміж назвою торгової точки pos3 та ідентифікатором юридичної особи 1, повинен обов’язково бути присутній розділювач (символ)  | .

     Підключення терміналу

• Підключення по USB:
  1. Підключити термінал до комп'ютера за допомогою кабеля USB.
  2. У терміналі перейти у застосунок Касове суміщення, після чого натиснути кнопку Встановити підключення, та у новому вікні обрати варіант Підключення USB.
  3. Відкрити файл genericDriverJsonUSB.
  4. Після відкриття файлу драйвер знайде емульований ком порт, по котрому відбувається підключення термінала до комп'ютера та встановить з’єднання з плагіном.
• Підключення по WiFi:
  1. Звернутися в банк, для того щоб дізнатися IP адресу термінала.
  2. Необхідно завантажити файли genericDriverJsonETH та BAT ETH (котрі можна запросити у вашого диллера Syrve).
  3. Відкрити файл BAT ETH за допомогою блокнота.
     
  4. У файлі BAT ETH потрібно вказати шлях до файлу genericDriverJsonETH, а також замінити IP адресу термінала в файлі, на адресу термінала, яку повідомив банк.
  5. В терміналі потрібно перейти у застосунок Касове суміщення, після чого натиснути кнопку Встановити підключення, і у новому вікні обрати варіант Підключення WiFi.
  6. Відкрити файл BAT ETH, після чого виконається автоматичне підключення.

     Визначення ідентифікаційного номера юридичної особи

1. Для того щоб дізнатись ідентифікаційний номер юридичної особи (від 0 до 255) необхідно підключити до комп'ютера банківський термінал, та у будь-якому браузері ввести команду 

   localhost:3000

2. У вкладці, котра відкриється необхідно натиснути кнопку OPEN.
3. Натиснути кнопку GetMerchantList.
4. У списку, який з’явиться на екрані необхідно знайти мерчанти, котрі відповідають за операцію оплати по відповідним юридичним особам. Ідентифікувати їх можна за словом ОПЛАТА, котре буде поруч із назвою юридичної особи.
5. Поруч з відповідною юридичною особою вказаний номер від 1 до 255 - цей номер і  являється ідентифікаційним номером юридичної особи.

     Налаштування типу оплати

1. Запустити Syrve POS після налаштування плагіна.
2. Запустити Syrve Office.
3. Перейти у Роздрібні продажі →Типи оплати.
4. Налаштувати тип оплати згідно прикладу: