Налаштування фіскального сервісу
Фіскальний сервіс підключається в налаштуваннях інтеграцій.
Відкрийте Налаштування → Інтеграції → Фіскалізація і натисніть Додати інтеграцію.
У Skynum можна підключити:
- Checkbox;
- Вчасно.Каса.
Фіскальний сервіс у цьому розділі використовується для документів і платежів у платформі Skynum: товарних накладних, оплат, повернень і фіскальних ланцюжків.
Це налаштування не підключає фіскалізацію у Skynum.Каса. Для касового сценарію потрібно налаштувати фіскальний реєстратор у картці комп'ютера касира.
Докладніше: Фіскалізація у Skynum.Каса і Фіскалізація та програмний РРО.
Компанія самостійно відповідає за правильність налаштувань фіскального сервісу і за коректне використання фіскалізації: вибір ПРРО, філії, юридичної особи, касира, податкових груп, способів оплати, ставок податків і сценарію продажу або повернення.
Skynum передає у фіскальний сервіс дані так, як вони вказані користувачами компанії в документах, платежах і налаштуваннях. Skynum не визначає замість компанії, які фіскальні значення є правильними для її товарів, оплат, податків і бізнес-сценаріїв.
Після фіскалізації дані чека передаються до Державної податкової служби України через обраний фіскальний сервіс. Неправильні налаштування або неправильне використання фіскалізації можуть призвести до некоректного фіскального чека, помилкової передачі даних до ДПС і податкових наслідків для компанії, зокрема штрафів у випадках, передбачених законодавством.
Перед роботою з реальними продажами перевірте налаштування на тестовому сценарії і переконайтеся, що чек у фіскальному сервісі відповідає обліку компанії.
У документах і платежах фіскальний сервіс вибирається в полі ПРРО. Для користувача це поле означає інтеграцію, через яку Skynum створить фіскальний чек.
Докладні інструкції з підключення конкретних сервісів:
Загальні поля
У картці фіскального сервісу заповніть:
- Назва інтеграції — назва, яку користувачі бачитимуть у документах і платежах;
- Інтеграція активна — дозволяє використовувати сервіс у фіскалізації;
- За замовчуванням — сервіс буде підставлятися автоматично для своєї філії, якщо користувач не вибрав інший;
- Безготівковий вид оплати за замовчуванням — значення фіскального сервісу, яке використовується для безготівкової оплати без вибраного способу оплати;
- Надсилати SMS — позначка за замовчуванням у вікні надсилання чека;
- Надсилати email — позначка за замовчуванням у вікні надсилання чека;
- Філія, юридична особа — філія, для якої доступний сервіс.
Поля Надсилати SMS і Надсилати email не забороняють користувачу змінити вибір під час надсилання чека. Вони лише визначають початковий стан позначок у вікні надсилання.
Податкові групи і способи оплати для фіскального чека налаштовуються не на основній вкладці інтеграції, а на вкладці API мапінг.
Назва інтеграції
Назва має бути зрозумілою для користувачів, які працюють із документами.
Добрі приклади:
Checkbox магазин Київ;Checkbox склад Львів;Вчасно.Каса ФОП Іваненко;Основний ПРРО.
Якщо в компанії кілька фіскальних сервісів, назва допомагає не вибрати не той сервіс у документі або платежі.
Активність
Неактивний фіскальний сервіс не використовується для нової фіскалізації.
Якщо сервіс уже використовується у фіскальному ланцюжку, його вимкнення не перемикає ланцюжок на інший сервіс. Skynum заблокує продовження такого ланцюжка і попросить увімкнути сервіс або перевірити налаштування.
Це потрібно, щоб один продаж не складався з чеків різних сервісів.
За замовчуванням
Позначка За замовчуванням визначає сервіс, який Skynum підставить автоматично для філії.
Skynum обирає фіскальний сервіс у такому порядку:
- якщо документ або платіж уже входить у фіскальний ланцюжок — використовується сервіс цього ланцюжка;
- якщо користувач вибрав сервіс у полі ПРРО — використовується вибраний сервіс;
- якщо для філії є сервіс за замовчуванням — використовується він;
- якщо для філії доступний тільки один активний сервіс — використовується він.
Якщо сервіс визначити неможливо, Skynum покаже помилку про відсутність активного фіскального сервісу.
Філія і юридична особа
Фіскальний сервіс доступний тільки для своєї філії.
Якщо документ створений в іншій філії, Skynum не дозволить фіскалізувати його через цей сервіс. У такому випадку потрібно вибрати сервіс потрібної філії або додати окрему інтеграцію.
Checkbox
Для Checkbox заповніть:
- Ідентифікатор каси — ключ ліцензії каси з кабінету Checkbox;
- Логін;
- Пароль.
Ці дані беруться в кабінеті Checkbox. Після заповнення натисніть Перевірити підключення.
Покрокова інструкція: Інтеграція з Checkbox.
Checkbox підтримує прості чеки, передплатні та післяплатні ланцюжки, повернення окремого чека і повернення всього фіскального ланцюжка.
Що перевірити в Checkbox
Перед першим чеком перевірте в кабінеті Checkbox:
- каса створена і доступна;
- касир має право працювати з цією касою;
- попередня зміна закрита або готова до роботи;
- податкові групи налаштовані в Checkbox і зіставлені зі ставками Skynum на вкладці API мапінг;
- для SMS/Viber-доставки чека підключена відповідна послуга в Checkbox.
Якщо Checkbox повертає помилку про зайняту касу або зміну, завершіть поточну операцію в Checkbox і повторіть фіскалізацію в Skynum.
Вчасно.Каса
Для Вчасно.Каса заповніть:
- Токен.
Після заповнення натисніть Перевірити підключення.
Покрокова інструкція: Інтеграція з Вчасно.Каса.
Вчасно.Каса у Skynum підтримує прості одиничні чеки продажу, прості одиничні повернення і надсилання чека клієнту. Ланцюжки передплати, післяплати та повернення всього ланцюжка для Вчасно.Каса не підтримуються, тому такі сценарії Skynum блокує до відправлення даних у сервіс.
Що перевірити у Вчасно.Каса
Перед першим чеком перевірте:
- токен активний;
- ПРРО доступний у Вчасно.Каса;
- податки Skynum зіставлені з податковими групами Вчасно.Каса на вкладці API мапінг;
- у Вчасно.Каса підключена доставка чеків, якщо потрібно надсилати їх SMS/Viber або e-mail.
Податкові групи
Для платформної фіскалізації через Checkbox або Вчасно.Каса податки налаштовуються через API мапінг інтеграції.
Відкрийте фіскальний сервіс, перейдіть на вкладку API мапінг і в секції Податкові групи зіставте кожен податок Skynum з групою фіскального сервісу. Для Checkbox за потреби натисніть Завантажити з Checkbox, щоб оновити перелік груп поточної каси.
Поле Унікальний код податку в довіднику Податки використовується для Skynum.Каса. Для платформної фіскалізації Checkbox/Вчасно.Каса воно не замінює API мапінг.
Докладніше: Податкові ставки для фіскалізації.
Способи оплати
Для фіскалізації оплат через Checkbox або Вчасно.Каса потрібно зіставити способи оплати Skynum зі значеннями фіскального сервісу.
- Спочатку створіть способи оплати у Налаштування → Довідники → Способи оплати.
- Відкрийте фіскальний сервіс.
- Перейдіть на вкладку API мапінг.
- У секції Способи оплати для кожного способу оплати виберіть значення сервісу.
- Збережіть мапінг.
Для Checkbox значенням є текстова назва виду оплати у чеку. Для Вчасно.Каса значенням є числовий код. Якщо спосіб оплати не зіставлено, фіскалізація зупиниться з підказкою налаштувати мапінг.
Поле Безготівковий вид оплати за замовчуванням використовується тільки для безготівкової оплати без вибраного способу оплати. Для інтеграційних оплат і автофіскалізації налаштовуйте явний спосіб оплати і його мапінг.
Докладніше: Способи оплати для фіскалізації.
Як сервіс потрапляє в документ або платіж
У товарній накладній, поверненні продажу або платежі є поле ПРРО. У ньому можна вибрати фіскальний сервіс вручну.
Якщо поле ПРРО не заповнене, Skynum використовує сервіс за замовчуванням для філії. Якщо в ланцюжку уже є фіскальний чек, усі наступні чеки цього ланцюжка виконуються через той самий сервіс.
Коли поле ПРРО краще заповнювати вручну
Заповнюйте ПРРО вручну, якщо:
- у філії кілька активних фіскальних сервісів;
- потрібно провести продаж через конкретний сервіс;
- у компанії різні сервіси для різних юридичних осіб;
- ви тестуєте нову інтеграцію.
Якщо ланцюжок уже почався, ручний вибір іншого сервісу не змінить фіскальну історію. Skynum вимагатиме продовжити роботу через сервіс, з якого почався ланцюжок.
Перевірка підключення
Кнопка Перевірити підключення перевіряє, чи може Skynum звернутися до фіскального сервісу з введеними даними.
Успішна перевірка означає, що доступи працюють. Вона не замінює перевірку податків, способів оплати, товарів і конкретного сценарію продажу.
Якщо підключення не проходить
Перевірте:
- чи активна інтеграція;
- чи правильно введені дані доступу;
- чи вибрана філія;
- чи доступний ПРРО або відкрита зміна у фіскальному сервісі;
- чи налаштований API мапінг податкових груп і способів оплати.
Якщо сервіс повертає тимчасову помилку, наприклад касир зайнятий або зміна ще відкривається, повторіть фіскалізацію після завершення поточної операції.