Перейти до основного вмісту

Модуль підпису SmartSign​

Призначення модуля підпису SmartSign​

інформація

SmartSign — модуль, який підписує чеки та інші документи КЕП.

КЕП / ЕЦП — електронний підпис, без якого чек не потрапить у ДПС.

Агент підпису — активований ключ у SmartSign для автоматичного підписання.

Інтеграція через API — коли облікова система відправляє чеки в CashDesk програмно.

Повний глосарій термінів

Для власників бізнесу та адміністраторів​

SmartSign забезпечує фіскалізацію чеків і коректну роботу інтеграцій з сервісом CashDesk. Якщо SmartSign не налаштований або ключ неактивний, чеки не будуть підписані та не потраплять до серверів Державної податкової служби (ДПС), а отже — не вважатимуться фіскальними. Модуль необхідний у двох основних випадках:

  • коли ви працюєте через інтеграцію з обліковою системою (BAF / ERP, інші API‑інтеграції);
  • коли налаштовано автозакриття зміни — без активного ключа SmartSign ця функція не спрацює.

SmartSign гарантує, що кожен чек буде правильно підписаний і відправлений до ДПС, а ваш бізнес — у правовому полі.

Для бухгалтерів та фінансових спеціалістів​

Модуль підпису SmartSign накладає кваліфікований електронний підпис (ЕЦП / КЕП) на розрахункові документи (чеки) в сервісі CashDesk.

Після підписання чек надсилається до ДПС, де проходить фіскалізацію, а у відповідь повертаються фіскальні реквізити (номер, дата, час, MAC, дані для QR‑коду).

Також SmartSign використовують для підпису електронних рецептів у сервісі SkarbCloud. Це допомагає працювати за правилами електронного документообігу в медичній сфері.

Для вас це означає:

  • коректний електронний підпис усіх чеків та документів;
  • можливість підтвердження відправлення даних у ДПС;
  • зменшення ризиків претензій з боку податкових органів.

Для розробників та інтеграторів​

Якщо ваша облікова система (BAF / ERP або інше рішення) надсилає чеки до CashDesk через API, SmartSign є проміжною ланкою для підписання даних перед фіскалізацією. У цьому потоці саме Агент підпису (активований КЕП у SmartSign) виконує операцію накладання підпису.

Варіанти роботи з модулем​

Ви можете реалізувати інтеграцію з урахуванням того, що SmartSign може працювати як:

  1. Web‑модуль
  2. Десктоп‑застосунок
  3. Docker‑контейнер.

Варіанти встановлення модуля підпису SmartSign​

Схема варіантів встановлення модуля SmartSign

Варіанти встановлення SmartSign для різних сценаріїв використання.

Сценарій роботи SmartSign​

Типовий сценарій роботи виглядає так:

  1. Облікова система (BAF / ERP) формує JSON‑чек і надсилає HTTPS‑запит методом POST/sale до сервера CashDesk.
  2. Портал CashDesk передає отриманий JSON‑чек до модуля SmartSign на ПК клієнта для накладання КЕП.
  3. Агент підпису в SmartSign підписує чек і повертає підписані дані назад до сервера CashDesk.
  4. Сервер CashDesk надсилає підписаний чек до Податкової служби (ДПС) для фіскалізації.
  5. ДПС повертає відповідь із фіскальними реквізитами (MAC, дані для QR‑коду, номер, дата / час).
  6. Сервер CashDesk формує фінальну відповідь і повертає її до облікової системи у відповіді на запит POST/sale разом із фіскальними реквізитами.
інформація

Якщо виникли помилки, дивіться опис помилок і способи вирішення.

Потрібно більше пояснень?

Перегляньте глосарій термінів CashDesk, де простими словами пояснені основні терміни.