Чи є готовий модуль інтеграції SMPOS для BAS?

Готового модуля під конкретну конфігурацію немає, і він не потрібен. Обмін працює на рівні універсального протоколу: JSON-запити по HTTPS на одну адресу. Тому механізм не залежить від версії й конфігурації облікової системи та не потребує оновлення після кожного її релізу.

Як передати номенклатуру з облікової системи на касу з ПРРО?

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

Як забрати продажі з каси в облік?

Двома способами: поточні продажі секції в реальному часі або продажі за період у розрізі товарів, із розділенням на продажі й повернення. Окремо доступний повний протокол зміни з чеками, типами оплат, знижками та Z-звітом.

Чи потрібно платити окремо за доступ до API?

Ні. Доступ до API кабінету входить у ліцензію каси з ПРРО SMPOS — за підпискою (250 грн на місяць / 600 грн на квартал / 1950 грн на рік) або за рахунок разової купівлі за 4800 грн. Окремого тарифу, плати за запити чи ліміту звернень немає. Кабінет без каси окремо не постачається.

Чи передаються через API контрагенти та взаєморозрахунки?

Ні. Через API Кабінету рухаються товари, залишки, зображення, продажі, протоколи змін і фіскальні підсумки. Контрагенти, взаєморозрахунки й первинні документи лишаються в обліковій системі. Якщо потрібні первинні документи на касі, використовується канал POSClient/POSServer.

Хто виконує підключення — ваша команда чи наш програміст?

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

Скільки часу займає підключення обміну?

Залежить від обсягу сценарію. Базовий контур — вивантаження номенклатури й завантаження продажів за зміну — це два запити з боку облікової системи. Оцінити роботу точно допоможе технічна документація: у ній описані всі поля й наведені приклади JSON.

Чи працює каса, якщо зв'язок із сервером пропав?

Так. Каса продовжує фіскалізувати чеки офлайн, а після відновлення зв'язку дані синхронізуються. Обмін з обліковою системою підхопить їх під час наступного запиту.

Каса з ПРРО SMPOS для бізнесу на BAS

Каса з ПРРО SMPOS обмінюється даними з обліковими системами трьома способами: через API Кабінету, через власний POSServer користувача або напряму по HTTP/HTTPS/TCP. API Кабінету — це 17 JSON-запитів на одну адресу, тому обмін не залежить від конфігурації облікової системи й не потребує окремого модуля під кожну версію BAS. Доступ до API входить у ліцензію Каси без доплати.

Ключові факти 3 способи обміну 17 запитів API JSON по HTTPS API без доплати Обмін у два боки

Як каса SMPOS обмінюється даними з обліковою системою

SMPOS не вимагає, щоб ви змінювали облікову систему. Застосунок працює як ПРРО та каса, а дані про товари та продажі автоматично передаються між ним і вашою системою обліку. Механізм обміну обирається один раз під час налаштування — далі він працює у фоні.

Рекомендовано API Кабінету Взаємодія з Кабінетом SMPOS.APP

Довідники та звіти, що зберігаються на пристрої з SMPOS, синхронізуються з хмарним сервером, доступним через Кабінет. Ваша облікова система працює з тим самим сервером напряму: надсилає JSON-запити методом POST на https://smpos.app/api та отримує JSON-відповіді.

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

Доступ надається за обліковими даними зареєстрованого користувача Кабінету, якому в розділі «Адміністрування» встановлено права з приміткою API. Кабінет при цьому лишається повністю робочим: монітор кас, чеки, звіти й довідники доступні одночасно з роботою обміну.

Повний опис усіх запитів — у документації API Кабінету.

POSClient / POSServer Взаємодія з власним POS-сервером користувача

Довідники та звіти синхронізуються з вашою системою товарного обліку через POSServer — сервер, який ви розгортаєте у себе. POSClient/POSServer розповсюджується вільно, встановлює й адмініструє його сам користувач.

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

У цьому режимі взаємодія з Кабінетом SMPOS не використовується. Всі дані живуть на вашому сервері.

Пряма взаємодія HTTP / HTTPS / TCP, режим JSON+WEB

Облікова система звертається безпосередньо до пристрою з SMPOS і керує ним JSON-запитами по HTTP, HTTPS або TCP. У касі це вмикається режимом JSON+WEB: керування йде по JSON, а Кабінет одночасно лишається доступним для моніторингу звітів, чеків і товарів.

Опис протоколу наведено в Керівництві користувача SMPOS. У Кабінеті доступні демонстраційні реалізації взаємодії по HTTP/HTTPS та по TCP.

Критерій	API КабінетуРекомендовано	POSClient / POSServer	Пряма взаємодія
Де зберігаються дані	хмарний сервер SMPOS	ваш сервер	пристрій із касою
Кабінет працює одночасно	Так	Ні	Так, режим JSON+WEB
Що потрібно з вашого боку	вміння надіслати HTTP-запит	розгорнути POSServer	доступ до пристрою по мережі
Первинні документи каси	Ні	Так	Залежить від сценарію
Дисконтні картки	Ні	Так	Залежить від сценарію
Мережа точок	без обмежень	десятки й сотні об'єктів	локальні сценарії
Хто адмініструє	ніхто, працює як сервіс	ви	ви
Вартість	без доплати до ліцензії	без доплати, ПЗ вільне	без доплати до ліцензії

Що саме передається під час обміну

Нижче — повний перелік того, що рухається між обліковою системою і касою через API Кабінету. Усі 17 запитів описані в публічній технічній документації.

Дані	Напрямок	Що це дає
Довідник товарів — повне завантаження	облік → каса	разова заливка номенклатури
Довідник товарів — додавання позицій	облік → каса	нові товари без перезаливки
Довідник товарів — коригування полів	облік → каса	зміна цін, кількостей, назв точково
Довідник товарів — видалення позицій	облік → каса	зняття з продажу
Довідник товарів — читання	каса → облік	звірка того, що реально на касі
Кількості товарів	у два боки	контроль залишків
Зображення товарів	у два боки	картинки в інтерфейсі касира
Поточні продажі секції	каса → облік	залишки в реальному часі
Продажі за період	каса → облік	продажі й повернення в розрізі товарів
Протоколи змін — список	каса → облік	які зміни закриті, які відкриті
Протокол зміни — повний	каса → облік	чеки, оплати, знижки, надбавки, службові внесення й вилучення, вхід і вихід касира
Підсумки зміни, Z-звіт	каса → облік	номер Z-звіту, суми за податковими групами й відділами, готівка в сейфі
Податкові групи ПРРО	каса → облік	ставки податку й збору для звірки
Структура мережі, секції, пристрої	каса → облік	прив'язка кас до точок
Стан протоколу — читання й зміна	у два боки	керування тим, чи впливає зміна на залишки

Обмін двосторонній. Номенклатура й ціни йдуть з обліку на касу, продажі й фіскальні підсумки — з каси в облік.

Не передається через API

→ Контрагенти й дані про партнерів→ Взаєморозрахунки, борги, оплати постачальникам→ Первинні документи обліку: надходження, списання, переміщення, переоблік

Передається через API

→ Довідник товарів: назви, ціни, штрих-коди, податкові групи→ Залишки й кількості товарів→ Продажі й повернення в розрізі товарів→ Протоколи змін: чеки, типи оплат, знижки→ Z-звіти й підсумки за податковими групами та відділами

Кому підходить

Роздріб і торгові мережі Номенклатура ведеться в обліковій системі, каса отримує актуальний довідник і повертає продажі по кожній точці. Для мережі з централізованим обліком підходить як API Кабінету, так і власний POSServer.

Стрітфуд і заклади з доставленням Каса працює на смартфоні, планшеті, POS-терміналі або банківському терміналі — там, де фізично відбувається продаж. Дані про виторг потрапляють в облік без ручного перенесення.

Сфера послуг і сервіс Невеликий довідник послуг заливається одноразово, далі потрібен лише зворотний потік — фіскальні чеки й Z-звіти для звірки з обліком.

Скільки коштує

Ліцензія Каси з ПРРО від 250 грн на місяць

Доступ до API Кабінету входить у ліцензію: окремої плати, окремого тарифу чи ліміту запитів немає. POSClient/POSServer розповсюджується вільно.

Кількість фіскальних чеків не обмежена. Доступні гнучка підписка й купівля ліцензії без абонплати — деталі на сторінці тарифів.

API без доплати POSServer вільний Чеки без обмежень

Порівняти тарифи Купити ліцензію

Як почати

1 Заявка й вибір способу обміну Залиште заявку або напишіть у Viber — ми уточнимо, який зі способів обміну підходить під вашу конфігурацію та кількість точок.

2 Технічна документація Завантажте технічну документацію обміну на сторінці або в Кабінеті SMPOS / Завантаження та передайте її своєму програмісту або інтегратору.

3 Користувач із правами API Створіть у Кабінеті користувача з правами API у розділі «Адміністрування».

4 Реалізація обміну Реалізуйте обмін на боці облікової системи: вивантаження номенклатури й завантаження продажів.

5 Тестова зміна і звірка Проведіть тестову зміну на касі та звірте підсумки в обліку.

Чи є готовий модуль інтеграції SMPOS для BAS?
Готового модуля під конкретну конфігурацію немає, і він не потрібен. Обмін працює на рівні універсального протоколу: JSON-запити по HTTPS на одну адресу. Тому механізм не залежить від версії й конфігурації облікової системи та не потребує оновлення після кожного її релізу.
Як передати номенклатуру з облікової системи на касу з ПРРО?
Через запит повного завантаження довідника облікова система надсилає масив товарів із кодом, назвою, ціною, штрих-кодом, податковою групою й відділом. Далі можна не перезаливати весь довідник, а додавати, коригувати або видаляти окремі позиції.
Як забрати продажі з каси в облік?
Двома способами: поточні продажі секції в реальному часі або продажі за період у розрізі товарів, із розділенням на продажі й повернення. Окремо доступний повний протокол зміни з чеками, типами оплат, знижками та Z-звітом.
Чи потрібно платити окремо за доступ до API?
Ні. Доступ до API кабінету входить у ліцензію каси з ПРРО SMPOS — за підпискою (250 грн на місяць / 600 грн на квартал / 1950 грн на рік) або за рахунок разової купівлі за 4800 грн. Окремого тарифу, плати за запити чи ліміту звернень немає. Кабінет без каси окремо не постачається.
Чи передаються через API контрагенти та взаєморозрахунки?
Ні. Через API Кабінету рухаються товари, залишки, зображення, продажі, протоколи змін і фіскальні підсумки. Контрагенти, взаєморозрахунки й первинні документи лишаються в обліковій системі. Якщо потрібні первинні документи на касі, використовується канал POSClient/POSServer.
Хто виконує підключення — ваша команда чи наш програміст?
Обмін реалізується на боці облікової системи, тому роботу виконує ваш програміст або інтегратор. Ми надаємо технічну документацію, опис усіх запитів із прикладами запитів і відповідей.
Скільки часу займає підключення обміну?
Залежить від обсягу сценарію. Базовий контур — вивантаження номенклатури й завантаження продажів за зміну — це два запити з боку облікової системи. Оцінити роботу точно допоможе технічна документація: у ній описані всі поля й наведені приклади JSON.
Чи працює каса, якщо зв'язок із сервером пропав?
Так. Каса продовжує фіскалізувати чеки офлайн, а після відновлення зв'язку дані синхронізуються. Обмін з обліковою системою підхопить їх під час наступного запиту.

Оновлено: 07 серпня 2026

Поставити запитання

Ми зв'яжемося з вами найближчим робочим днем