Інструкція з підключення Android-термінала PAX A930 до програми Торгсофт через протокол JSON по Wi-Fi. Термінал PAX A930 може працювати з Торгсофт у двох різних схемах:
1.
напряму по JSON (COM/TCP) — це рекомендований і стабільніший варіант;
2.
через WebSocket і додаток «Касове суміщення» — це старіший і менш стабільний спосіб.
Перед налаштуванням обов’язково з’ясуйте, який саме режим увімкнув банк.
Ця інструкція передбачає зміну налаштувань банківського термінала, мережі та параметрів інтеграції в Торгсофт, тому виконувати її слід уважно. Якщо переплутати режим підключення, IP-адресу, порт або тип протоколу, термінал може повністю перестати приймати команди з каси, а оплати почнуть завершуватися таймаутами або помилкою DeviceBusy. Перед внесенням змін переконайтеся, що банк уже повідомив, у якому саме режимі має працювати термінал — прямий JSON чи WebSocket через «Касове суміщення». Якщо у вас немає доступу до мережевих налаштувань або параметрів термінала, зверніться до технічної підтримки банку чи системного адміністратора.
Коли потрібно підключати або переналаштовувати PAX A930
•
При підключенні через Wi-Fi або Ethernet: після зміни роутера, інтернет-провайдера або зміни налаштувань локальної мережі (коли змінюється IP-адреса).
•
При підключенні через USB: після зміни СОМ-порту. Це трапляється при заміні комп'ютера, використанні іншого USB-перехідника, або якщо кабель термінала просто переставили в інший USB-порт і не пам'ятають, де він був підключений раніше.
•
Якщо виникають помилки зв'язку («Пристрій зайнятий», тайм-аути).
Згідно з практикою техпідтримки, при дротовому (USB) підключенні номер СОМ-порту часто змінюється операційною системою Windows автоматично, якщо кабель вставляють в інший роз'єм або використовують новий перехідник. Програма Торгсофт у такому разі «губить» термінал, тому налаштування доводиться оновлювати. Зміни для Wi-Fi/Ethernet стосуються виключно мережевих параметрів (IP, роутер, порти).
Як зрозуміти, що термінал налаштований неправильно
•
Помилка DeviceBusy («Пристрій зайнятий») при спробі оплати.
•
Повідомлення «Час очікування відповіді вичерпано» (гроші списалися, а чек не вийшов).
•
Термінал не «прокидається» при натисканні кнопки «Оплатити» в касі.
Чому PAX A930 втрачає зв’язок із Торгсофт
•
Зміна IP-адреси термінала (DHCP) після перезавантаження роутера.
•
На терміналі не запущено (або згорнуто) додаток «Касове суміщення».
•
Блокування портів 3000/2000 антивірусом або брандмауером.
•
Занадто малий тайм-аут очікування в налаштуваннях Торгсофт.
Як налаштувати PAX A930 для роботи з Торгсофт
1. Як підготувати мережу для роботи термінала
•
Підключіть PAX A930 до тієї ж Wi-Fi мережі, що і комп'ютер з Торгсофт.
•
Обов'язково: встановіть статичну IP-адресу на терміналі або зарезервуйте її на роутері по MAC-адресі.
•
Ризик: без резервування IP-адреса термінала може змінитися після перезавантаження роутера або закінчення DHCP-оренди, і зв’язок із Торгсофт зникне.
2. Який спосіб підключення використовувати
Спосіб 1: Як працює пряме підключення JSON (COM/TCP)
Це сучасний і більш надійний метод інтеграції. Він дозволяє програмі Торгсофт взаємодіяти з терміналом напряму, без необхідності встановлювати та постійно тримати запущеними додаткові програми-посередники (наприклад, WebSocket-сервери) на комп'ютері касира.
•
Що потрібно зробити: зверніться до технічної підтримки вашого банку з проханням налаштувати термінал PAX A930 на роботу саме за протоколом JSON (TCP/COM) через Wi-Fi.
•
Мережа: обов'язково зарезервуйте IP-адресу термінала в налаштуваннях вашого роутера, щоб вона не змінювалася після перезавантажень.
•
У Торгсофт: у налаштуваннях банківського термінала в Торгсофт достатньо обрати протокол JSON (COM/TCP) і просто вказати IP-адресу та порт.
•
Переваги: цей спосіб працює стабільніше, дозволяє програмі вести детальний журнал операцій на терміналі та суттєво знижує ризик виникнення помилок та втрати зв'язку.
Спосіб 2: Коли використовується WebSocket через «Касове суміщення»
Цей метод досі використовується, але технічна підтримка вважає його застарілим і менш стабільним, оскільки він вимагає запущеного WebSocket-сервера на ПК.
•
На головному екрані Android вашого термінала відкрийте додаток «Касове суміщення».
•
Оберіть тип: «WIFI ПІДКЛЮЧЕННЯ».
•
Перевірте статус: на екрані має блимати зелений індикатор підключення.
•
Критично важливо (ризики): термінал завжди має залишатися із відкритим додатком у цьому режимі. Якщо касир вийде в головне меню Android, випадково згорне додаток, або якщо на терміналі запуститься якась інша фонова операція — спроба передати суму з Торгсофт призведе до помилки «Пристрій зайнятий» (DeviceBusy), і програма довго очікуватиме на відповідь.
Додаткова порада. Якщо ви наразі стикаєтеся з постійними зависаннями або помилками на кшталт «DeviceBusy», фахівці техпідтримки Торгсофт наполегливо рекомендують переналаштувати роботу вашого термінала PAX A930 зі старого протоколу JSON (WebSocket) на прямий JSON (COM/TCP).
3. Як налаштувати термінал у Торгсофт
Меню: Налаштування → Параметри → Додаткові функції → Банківський термінал.
Далі налаштування залежать від того, який тип підключення налаштував вам банк:
Спосіб 1: Налаштування для прямого підключення JSON (TCP/COM) — Рекомендовано
Цей спосіб використовується, якщо термінал взаємодіє з Торгсофт напряму по мережі.
•
Тип протоколу: оберіть JSON (COM/TCP).
•
IP-адреса: введіть статичну IP-адресу самого банківського термінала, яку ви попередньо закріпили за ним у налаштуваннях роутера.
•
Порт: зазвичай використовується порт 2000 (або 2001, 2100 тощо — точний порт має надати техпідтримка банку при налаштуванні).
•
Мерчант: залиште порожнім або вкажіть 0. У випадку з терміналом PAX A930 вибір мерчанта (якщо у вас кілька ФОП) часто відбувається безпосередньо на екрані самого термінала під час оплати.
Спосіб 2: Налаштування через WebSocket/JSON (Застарілий спосіб)
Цей спосіб використовується, якщо для зв'язку з терміналом на комп'ютері касира обов'язково має бути запущена фонова програма від банку (WebSocket-сервер, наприклад genericDriverJson або POSsvc.exe).
•
Тип протоколу: оберіть WebSocket/JSON.
•
IP-адреса хоста: тут вводиться IP-адреса комп'ютера, на якому запущено WebSocket-сервер (якщо програма-драйвер запущена на тому ж комп'ютері, що і Торгсофт, вводиться локальна адреса, наприклад localhost або 127.0.0.1).
•
Порт: завжди 3000 (це стандартний порт для служби WebSocket).
•
Мерчант: залиште порожнім або вкажіть 0.
Критично важливо не плутати IP-адреси: при прямому підключенні (Спосіб 1) вказується IP термінала, а при роботі через вебсокет (Спосіб 2) — IP комп'ютера, на якому працює драйвер.
4. Який тайм-аут потрібно встановити
•
Встановіть параметр «Тайм-аут відповіді»: мінімум 180 секунд.
•
Чому: Торгсофт отримує сигнал успіху тільки після друку чека на терміналі. Якщо тайм-аут малий (60 с), програма розірве з'єднання і скасує чек у базі, хоча гроші з клієнта вже спишуться.
5. Що врахувати при поверненні товару
•
Увімкніть опцію: «Використовувати сервіс».
•
Для повернення потрібен код RRN (код авторизації) з паперового чека продажу.
•
Цей код касир вводить вручну на клавіатурі термінала, коли той надішле запит.
Як перевірити, що термінал працює правильно
1.
Переконайтеся, що на терміналі активний зелений індикатор.
2.
Проведіть тестовий продаж на 1.00 грн.
3.
Термінал має активувати зчитувач карток.
4.
Після оплати чек у Торгсофт має закритися автоматично.
Як уникнути збоїв у роботі PAX A930
•
Не дозволяйте персоналу грати в ігри або сидіти в YouTube на терміналі (це Android-пристрій, але він має бути в режимі каси).
•
Слідкуйте за зарядом: при <15% Wi-Fi модуль може працювати зі збоями.
Що важливо запам’ятати
Якщо термінал не відповідає — спочатку перевірте, чи запущено додаток «Касове суміщення» і чи не змінилася IP-адреса.
Повернутися до попереднього кроку