Фіскалізація
Підключення фіскальних реєстраторів і хмарних шлюзів для відповідності податковому законодавству.
1. Огляд#
Фіскалізація — законодавча вимога в багатьох країнах: кожен розрахунок із покупцем має бути зареєстрований у податковій системі та підтверджений фіскальним чеком.
Cenaly підходить до цього двома шляхами:
| Шлях | Як працює | Де налаштовується |
|---|---|---|
| Власний фіскальний реєстратор через міст | Фіскальний реєстратор стоїть у вас у залі, а браузерна каса Cenaly керує ним через Cenaly Hardware Bridge — маленький додаток на комп'ютері точки | Розділ Обладнання |
| Чужий сертифікований фіскальний реєстратор по API | Чек іде в хмарний сервіс фіскалізації, який має потрібну сертифікацію у вашій країні | Інтеграції локації / розділ API каси |
Що підтримано сьогодні:
| Країна | Рішення | Статус |
|---|---|---|
| 🇬🇪 Грузія | Фіскальні реєстратори Daisy eXpert SX через міст | ✅ Перевірено на живому фіскалізованому реєстраторі |
| 🇧🇬 Болгарія | Те саме сімейство Daisy | ✅ Драйвер той самий |
| 🇵🇱 Польща | Фіскальні реєстратори за протоколом POSNET Thermal (Posnet, Emar, Innova, Torell, Elzab Mera) через міст | ✅ Реалізовано |
| 🇵🇱 Польща | API чужої сертифікованої kasa online → CRK | 🛠 У розробці: підключення поки недоступне |
| 🇰🇿 Казахстан | Хмарний шлюз ККМ (Webkassa) | 🛠 У розробці: підключення поки недоступне |
| 🇷🇺 Росія | Фіскальні реєстратори АТОЛ, Меркурий, ШТРИХ-М, Pirit / Viki Print через міст + власна хмарна каса 54-ФЗ | ✅ Реалізовано, частину драйверів перевірено на живому залізі |
Суміжний, але інший контур — електронний документообіг із державою (не чек покупцю):
| Країна | Що | Де в панелі |
|---|---|---|
| 🇬🇪 Грузія | rs.ge — вхідні електронні товарні накладні від постачальників | Розділ rs.ge |
| 🇵🇱 Польща | KSeF — B2B-фактури (FA(3)) | Розділ Контрагенти |
Kasa fiskalna ≠ KSeF: перше — чек фізичній особі, друге — фактура юридичній особі. Одне не замінює інше.
2. Як це працює#
Гість оплачує замовлення
↓
Каса Cenaly збирає товари, ставки податку та способи оплати
↓
Чек іде на фіскальний реєстратор (через міст) або в хмарний шлюз
↓
Пристрій/сервіс реєструє розрахунок у податковій
↓
Гість отримує фіскальний чек
Важлива деталь: фіскальний реєстратор належить вам і зареєстрований на ваші реквізити. Cenaly — транспорт і черга, а не оператор фіскальних даних.
3. Підключення фіскального реєстратора через міст#
Підтримувані сімейства#
| Сімейство | Моделі / протокол | Країни |
|---|---|---|
| Daisy | Daisy eXpert SX (serial-режим «Fiscal printer») | Грузія, Болгарія |
| POSNET Thermal | Posnet, Emar, Innova (DF300/DF301/THERMAL), Torell, Elzab Mera | Польща |
| АТОЛ | Драйвер ДТО 10 / fptr10 (наприклад, АТОЛ 25Ф) | Росія |
| Меркурий | Інкотекс/Mertech через службу INECRMAN | Росія |
| ШТРИХ-М | Протокол ККТ v1.18 з ФН | Росія |
| Pirit | Пирит 2Ф, FM16, Punix, Дримкас Viki Print | Росія |
Звичайні (нефіскальні) чекові принтери, сумісні з ESC/POS, підключаються тим самим мостом окремим пристроєм і друкують пречеки, кухонні бегунки та товарні чеки.
Якщо чекового принтера на точці немає, рахунок гостя (пречек) друкує сам фіскальний реєстратор — ширина рядка береться в апарата, щоб колонка із сумами не обрізалася. Це вміють Daisy, АТОЛ і ШТРИХ-М; польські Thermal довільний текст не друкують і чесно відмовляють. Фіскальний реєстратор при цьому залишається реєстратором: звичайні наші документи (кухонні бегунки, копії чеків) на нього не йдуть — лише тестовий друк і пречек.
Покрокове підключення#
Крок 1. Встановіть міст#
Відкрийте Обладнання в панелі: якщо міст ще не встановлено, сторінка сама запропонує завантаження під вашу ОС — інсталятор для Windows або portable-архів, для Linux x64/ARM — однорядковий інсталятор служби. Міст працює на тому самому комп'ютері, до якого підключено фіскальний реєстратор.
Крок 2. Підключіть фіскальний реєстратор до комп'ютера#
Підтримуються послідовний порт (COM/USB-COM), мережеве підключення та системний принтер-спулер — залежить від моделі. Міст уміє сам знаходити обладнання: кнопка автосканування пропонує знайдені пристрої, їх можна додати в конфігурацію в один клік.
Крок 3. Перевірте#
На картці фіскального реєстратора видно модель, серійний номер, податкові ставки, статус паперу та номер останнього Z-звіту. Тут же — кнопки тестового друку, відкриття грошової шухляди та зняття X-звіту.
Для фіскальних реєстраторів Daisy у панель вбудовані окремі гіди: як перевести реєстратор у режим фіскального принтера і що робити з типовими помилками.
Крок 4. Налаштуйте кліше та ставки#
Кнопка «Налаштування реєстратора» відкриває порядковий редактор шапки й підвалу чека, прапорці (порожні рядки, роздільник, логотип, детальний чек), режим відрізу, податкові ставки та дані оператора (номер, пароль, ім'я).
4. Налаштування за країнами#
🇬🇪 Грузія — Revenue Service#
Вимоги:
- каса, зареєстрована в rs.ge, з фіскальним модулем (перевірено на Daisy eXpert SX);
- ідентифікаційний номер (საიდენტიფიკაციო ნომერი).
Налаштування:
- Переведіть касу в serial-режим «Fiscal printer» (у панелі є гід із точною послідовністю на клавіатурі).
- Додайте її в розділі Обладнання як фіскальний реєстратор.
- Пробийте тестовий чек і зніміть Z-звіт — суми мають зійтися.
Окремо від чеків у Грузії працює розділ rs.ge: вхідні електронні товарні накладні від постачальників, їх підтвердження та відхилення, довідники, перевірка ІН і статусу платника ПДВ.
🇵🇱 Польща — kasa fiskalna online#
З 2021 року ресторани, бари та кафе зобов'язані мати онлайн-касу, що передає дані до CRK (Centralne Repozytorium Kas). Написати свою віртуальну касу без сертифіката GUM не можна, тому шляхів два:
- Свій фіскальний принтер за протоколом POSNET Thermal — підключається мостом (див. розділ 3). Один драйвер закриває більшу частину парку: Posnet, Emar, Innova, Torell, Elzab Mera. Сьогодні в Польщі працює лише цей шлях.
- API чужої сертифікованої каси — 🛠 у розробці. Шлюз написано, але його серверну частину не розгорнуто, а адаптера під конкретну сертифіковану касу поки немає: у польських віртуальних кас немає публічної специфікації, і адаптери (XKasa, WKF, Aclas) додаються в міру отримання їхньої документації. Картки підключення в інтеграціях локації немає.
Ставку ПДВ шлюз не вигадує: канальну матрицю (їжа 8 %, навиніс 5 %, кава та алкоголь 23 %) рахує сама платформа, шлюз лише переводить відсоток у літеру PTU конкретної каси.
KSeF (B2B-фактури) — окремий контур у розділі Контрагенти: XML формату FA(3) будується з виставленого документа, шифрується й вирушає до системи Мінфіну, статус і номер UPO повертаються в картку.
🇰🇿 Казахстан — ККМ#
З 01.01.2026 статті 110–111 НК РК вимагають чек ККМ у день покупки на будь-який грошовий розрахунок — включно з картою на сайті, Kaspi Pay/QR та Apple/Google Pay.
🛠 Підключення поки недоступне. Шлюз до оператора ККМ (перший драйвер — Webkassa) написано, але його серверну частину не розгорнуто: картки підключення в інтеграціях локації немає, і завести реквізити сьогодні не можна. Коли шлюз відкриється, працюватиме він так: реквізити оператора ККМ → перевірка зв'язку → чек вирушає автоматично, а ПДВ рахується за податковим режимом локації. Потрібен Казахстан — напишіть у підтримку, пріоритети розставляються за попитом.
🇷🇺 Росія — 54-ФЗ#
Два способи, їх можна поєднувати:
- Своя ККТ через міст — АТОЛ, Меркурий, ШТРИХ-М, Pirit/Viki Print. Підтримано ФФД 1.05 і 1.2, чеки корекції, маркування «Честный ЗНАК», ЕГАИС УТМ.
- Хмарна каса — розділ API каси (Росія): HTTP-API, сумісний із протоколом АТОЛ Онлайн (v5 = ФФД 1.2, v4 = ФФД 1.05). Ваш сайт або CMS надсилає JSON-чек, сервіс ставить його в чергу, чек пробивається на вашій же ККТ. Каса залишається вашою і зареєстрована на ваш ИНН — платформа лише транспорт і черга.
Суміжні російські контури: перевірка статусу кодів маркування «Честный ЗНАК» і погашення вхідних ВСД у ФГІС «Меркурий» (вкладка «Входящие ВСД» на складі).
5. Пробиття чеків і звіти#
На касі (POS)#
Чек пробивається під час оплати в розділі Каса. Там же: повторний друк (під PIN менеджера), повернення — повне або часткове, обмін із перепродажем, пошук за історією чеків і пречек («рахунок гостя» до оплати).
Пречек друкується на чековому принтері, а якщо його на точці немає — на самій фіскальній касі (див. розділ 3). Завдання при цьому не стає в чергу офлайн-принтера: гість чекає на рахунок зараз, а не «коли принтер повернеться».
З розділу «Замовлення»#
Для онлайн-замовлення чек можна випустити прямо з картки замовлення — команда вирушає через хмарний канал на міст потрібної точки, навіть якщо ви зараз за іншим комп'ютером.
X- і Z-звіти#
- X-звіт — проміжний, без закриття зміни. Кнопка є і в розділі Обладнання, і в касі.
- Z-звіт — закриття зміни з підтвердженням; у касі він поєднаний із закриттям касової зміни та звіркою факт/очікування (нестачі та надлишки видно одразу).
Журнал закритих касових змін — касир, розмінний фонд, продажі готівкою та карткою, очікувана й фактична готівка, розбіжності — лежить у розділі Фінанси, вкладка «Каса».
Якщо чек не пробився#
Каса — це залізо, і вона відмовляє: скінчився папір, не закрито зміну, на апараті висить незакритий чек, минуло більше доби без Z-звіту. Раніше на такий випадок спливала зникаюча підказка з текстом драйвера — з неї не можна було зрозуміти ні причини, ні що робити.
Тепер замість неї відкривається вікно «Чек не пробито»: там написано, що саме сталося, і покроково — що зробити. Касі вірять за її власним кодом помилки, а не за формулюванням драйвера: вона нерідко радить не те (у деяких моделей підказка «переключіть режим» приходить разом із кодом «доба без Z-звіту», хоча режим гаразд).
- Якщо причину видно з хмари — вікно дає кнопки «Зняти Z-звіт» і «Повторити чек».
- Якщо лагодити треба біля самого апарата (немає паперу, незакритий чек, помилку потрібно скинути клавішею на касі), вікно так і каже і веде покроково.
- Якщо це поломка для сервіс-інженера (модем, SIM, пам'ять), повтор не пропонується — він нічого не дасть.
- Технічні подробиці сховані в рядок «подробиці» — їх зручно додати до звернення в підтримку.
Вікно можна закрити будь-якої миті: продаж уже записано в історію чеків і оплату проведено, а пробити фіскальний чек повторно можна звідти ж, коли каса буде готова. Черга чекати не повинна.
6. Що друкується на чеку#
Склад фіскального чека визначає закон країни, а все, чим можна керувати, зібрано в «Налаштуваннях реєстратора» розділу Обладнання:
- рядки шапки та підвалу (порядковий редактор);
- логотип, розділювач, порожні рядки;
- детальний або згорнутий чек;
- режим відрізу;
- податкові ставки та їх прив'язка до груп;
- дані оператора.
7. Електронні чеки#
- У Росії електронний чек покупцю надсилає ОФД — на телефон або e-mail, які вводяться під час розрахунку; це частина 54-ФЗ, а не окрема функція панелі.
- Незалежно від фіскалізації Cenaly сам надсилає гостю підтвердження замовлення та повідомлення про оплату на e-mail, а посилання на екран замовлення гість може зберегти закладкою.
- E-mail гостя збирається на чекауті, якщо ви увімкнули це поле в налаштуваннях вітрини.
8. Звітність для бухгалтерії#
Реєстр чеків ведеться за кожною точкою, і на ньому будуються:
- Фінанси → Каса — журнал касових змін, готівка, розбіжності;
- Фінанси → Огляд / Продажі — виторг, податки, способи оплати, канали;
- Фінанси → P&L — спрощений звіт про прибуток із ручними витратами;
- Налаштування → Експорт даних — ZIP-архів з усіма даними облікового запису, замовлення та каталог зокрема у CSV (відкривається в Excel і «Google Таблицях») — див. Експорт даних.
Вивантажень у форматах DSFinV-K і SAF-T платформа не формує — це частина німецького та загальноєвропейського контурів, яких поки немає.
9. Часті питання#
Чи обов'язкова фіскалізація?#
Залежить від країни та виду діяльності: у Польщі та Росії онлайн-каса для громадського харчування обов'язкова, у Казахстані з 2026 року чек ККМ потрібен на будь-який грошовий розрахунок. Точні вимоги щодо вашого бізнесу уточнюйте в бухгалтера або в податковій.
Чи можна працювати без фізичного принтера?#
Сьогодні — ні: хмарні шлюзи Казахстану (Webkassa) і Польщі (kasa online за API) ще не відкриті для підключення, тому в усіх підтриманих країнах потрібен власний апарат. У Росії фізична ККТ потрібна в будь-якому разі, але керувати нею можна з хмари через розділ «API каси» — комп'ютер із касою стоїть в одному місці, а чеки в нього надсилає хоч сайт, хоч 1С.
Що робити при поломці каси?#
Міст чесно показує статус пристрою та текст помилки, а не мовчки «ковтає» збій. Поки каса недоступна, замовлення та оплати продовжують жити в системі — але фіскальний документ без справної ККТ не з'явиться, і в більшості країн це привід призупинити розрахунки та повідомити податкову.
Як підключити кілька кас?#
Обладнання ведеться за точками: у кожній локації свій міст (або кілька — універсальний, для обладнання, для камер, для телефонії), а в реєстрі обладнання облікового запису видно всі мости та всі пристрої всіх точок одразу, з призначенням моста додатковим локаціям.
Чим kasa fiskalna відрізняється від KSeF?#
Kasa fiskalna — це чек фізичній особі, регулятор GUM і KAS, репозиторій CRK. KSeF — електронна фактура юридичній особі, система Мінфіну. Різні документи та різні обов'язки; наявність одного не скасовує іншого.
10. Підтримка#
- Cenaly: support@cenaly.com → тема «Фіскалізація»
- З питань реєстрації кас — до податкової вашої країни
- Суміжні розділи: Обладнання, Каса (POS), Чеки, rs.ge