Як підключити Servio до finiq

Автоматизація ресторанів і готелів: каса й облік.

Як підключити Servio

Не змінюйте код карти цього користувача й не видаляйте термінал після підключення: синхронізація зупиниться, доки ви не введете нові дані.

  1. У finiq відкрийте «Інтеграції» → «Каси й CRM», знайдіть картку Servio і натисніть «Підключити».
  2. Дізнайтеся адресу служби POSExternal вашого закладу. Якщо Servio працює в хмарі Servio, адреса має вигляд https://possvc3.servio.support/<номер>/POSExternal — її дасть підтримка Servio (support@servio.com.ua, 097 537-01-68). Якщо служба стоїть на сервері закладу, потрібна адреса, доступна з інтернету (зовнішня IP-адреса чи домен і порт, наприклад http://203.0.113.7:29033/POSExternal): адреси локальної мережі (192.168…, 10…) не підійдуть.
  3. У Servio WorkDesk відкрийте «Довідники» → «Користувачі» й створіть окремого користувача для finiq (спершу додайте його в «Персони») з роллю, яка бачить закриті рахунки. Скопіюйте його «Код карти».
  4. Код терміналу (TermID) — ідентифікатор станції, від імені якої працює служба: термінал додається в Servio Desktop у вкладці «Адміністрування» → «Додати» (тип станції ANDROID). Якщо не знаєте, який код вказати, попросіть у підтримки Servio код терміналу для API-інтеграції.
  5. Вставте адресу, код карти й код терміналу нижче. finiq лише читає типи оплат, закриті рахунки й Z-звіти та нічого не змінює в Servio.
  6. Натисніть «Перевірити й продовжити» — finiq перевірить доступ і покаже рахунки.
  7. Для кожного рахунку виберіть «Новий рахунок», «Наявний рахунок» або «Не синхронізувати».
  8. У полі «Завантажити історію за» виберіть кількість місяців і натисніть «Почати синхронізацію». Операції з’являтимуться поступово.

Документація Servio POS API ↗

Що варто знати

  • Виручка приходить за кожен завершений день: окремо за типом оплати й юрособою (ФОП, ТОВ), повернення зменшують суму. Рахунки сьогоднішнього дня з’являться наступного дня. Службові внесення й видачі — із Z-звітів, якщо заклад працює через ПРРО Servio.
  • Кожен тип оплати Servio — окремий рахунок: готівка стає рахунком «Готівка», картки й агрегатори (Glovo, Bolt Food) — окремими рахунками. Бонуси — знижка, а не гроші, тож їх за замовчуванням не синхронізуємо. Якщо гроші за картками вже приходять у підключений банк від еквайра, позначайте зарахування переказом з рахунку термінала або виберіть «Не синхронізувати».
  • Servio віддає рахунки за один день на запит: рік історії завантажується приблизно 7 хвилин.
  • Каса чи CRM підключається ключем доступу: оплати замовлень і продажі стають операціями автоматично кожні 30 хвилин, покупці — контрагентами, а автоправила працюють так само, як для банків. Ключ зберігається зашифрованим.
  • Ключ шифрується й ніколи не показується повністю; при відключенні інтеграції він видаляється.

Хто може це зробити. Підключати каси й CRM можуть власник, адміністратор і фінансист.

Інші інструкції