Інтеграція з Checkbox

Ця інструкція описує підключення Checkbox саме для фіскалізації документів і платежів у платформі Skynum.

Це інструкція для платформної фіскалізації

Ця інтеграція використовується для фіскалізації документів і платежів у платформі Skynum: товарних накладних, оплат, повернень, передплат, післяплат і фіскальних ланцюжків.

Це не налаштування Skynum.Каса. Для касового сценарію потрібно налаштувати фіскальний реєстратор у картці комп'ютера касира.

Докладніше: Фіскалізація у Skynum.Каса і Фіскалізація та програмний РРО.

Відповідальність

Компанія самостійно відповідає за правильність налаштувань Checkbox і за коректне використання фіскалізації: вибір каси / ПРРО, торгової точки, касира, податкових груп, способів оплати і сценарію продажу або повернення.

Skynum передає у Checkbox дані так, як вони вказані користувачами компанії в документах, платежах і налаштуваннях. Skynum не визначає замість компанії, які фіскальні значення є правильними для її товарів, оплат, податків і бізнес-сценаріїв.

Після фіскалізації дані чека передаються до Державної податкової служби України через Checkbox. Неправильні налаштування або неправильне використання фіскалізації можуть призвести до некоректного фіскального чека, помилкової передачі даних до ДПС і податкових наслідків для компанії, зокрема штрафів у випадках, передбачених законодавством.

Перед роботою з реальними продажами перевірте налаштування на тестовому сценарії і переконайтеся, що чек у Checkbox відповідає обліку компанії.

Після підключення Checkbox у платформі можна фіскалізувати товарні накладні, повернення продажу, платежі, передплати, післяплати і фіскальні ланцюжки.

Що потрібно підготувати

Перед налаштуванням у Skynum підготуйте в Checkbox:

• активний кабінет Checkbox;
• зареєстровану торгову точку;
• активну касу / ПРРО;
• ключ ліцензії каси;
• касира з логіном і паролем касира;
• налаштоване підписання чеків для касира Checkbox;
• податкові групи в касі Checkbox (їх потрібно буде зіставити в Skynum на вкладці API мапінг — коди вручну вводити не треба);
• способи оплати Skynum для оплат, які будуть фіскалізуватися через Checkbox;
• підключену послугу SMS/Viber-доставки, якщо потрібно надсилати чеки клієнтам через SMS або Viber.

Що зробити в Checkbox

У кабінеті Checkbox потрібно підготувати касу і касира. Не потрібно повторювати це перед кожним чеком: це базове налаштування інтеграції.

1. Зареєструйтесь або увійдіть у кабінет Checkbox.
2. Перевірте, що компанія і торгова точка додані в кабінет.
3. Створіть або активуйте касу / ПРРО.
4. Скопіюйте ключ ліцензії каси. У Skynum він вводиться в поле Ідентифікатор каси.
5. Створіть касира або відкрийте наявного касира.
6. Перевірте логін касира.
7. Встановіть або змініть пароль касира, якщо його не пам'ятаєте.
8. Налаштуйте підписання чеків для касира, щоб Checkbox міг підписувати і передавати чеки в ДПС.
9. Перевірте податкові групи, які має використовувати каса.

Логін і пароль касира Checkbox — це окремі дані касира, через якого інтеграція відкриває зміну і створює фіскальні чеки.

Каса в Checkbox

Каса / ПРРО в Checkbox має бути активною.

У Checkbox потрібне значення називається ключ ліцензії каси.

У Skynum цей ключ вводиться в поле Ідентифікатор каси. Якщо в компанії кілька кас або кілька філій, для кожної робочої каси створіть окрему інтеграцію в Skynum.

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

Касир у Checkbox

Касир має бути зареєстрований і готовий до підписання чеків.

У Skynum потрібно ввести:

• Логін касира Checkbox;
• Пароль касира Checkbox.

Не плутайте пароль касира

У Skynum потрібно вводити саме пароль касира Checkbox.

Це не пароль входу в кабінет Checkbox, не пароль користувача Skynum і не пароль до КЕП. Пароль касира задається під час створення або редагування касира в Checkbox.

Якщо ви не пам'ятаєте пароль касира, не підбирайте пароль від кабінету Checkbox. Відкрийте в Checkbox розділ Касири, натисніть Дії біля потрібного касира, виберіть Редагувати, введіть новий пароль касира і збережіть. Потім введіть цей самий новий пароль у полі Пароль в інтеграції Skynum.

Підписання чеків у Checkbox

Для фіскалізації чеків касир має підписувати документи перед передачею в ДПС.

У Checkbox є кілька способів підписання чеків. Можна налаштувати підписання через локальний пристрій або програму Checkbox, а можна завантажити КЕП / ЕЦП касира у захищене хмарне сховище Checkbox.

Skynum не вимагає конкретного способу підписання. Головне, щоб Checkbox міг підписати чек у момент фіскалізації. Для платформенної інтеграції хмарний варіант зазвичай простіший: не потрібно встановлювати і постійно тримати запущеною окрему програму на комп'ютері.

Загальний порядок у Checkbox:

1. Відкрийте Касири.
2. Біля потрібного касира натисніть Дії.
3. Виберіть спосіб підписання чеків. Для хмарного варіанта виберіть дію для завантаження ключа касира у захищене хмарне сховище Checkbox.
4. Оберіть АЦСК і додайте файл КЕП / ЕЦП касира.
5. Введіть пароль до ключа і підтвердьте завантаження.
6. Переконайтесь, що ключ доступний для підписання чеків.

Підключення до Checkbox не перевіряє підписання чеків касира. Якщо підписання чеків для касира не налаштоване, фіскалізація чека не завершиться, тому що чек не буде підписаний і переданий у ДПС.

Податкові ставки

Для платформної фіскалізації коди податків вручну не вводяться. Замість цього ви зіставляєте свої податки з податковими групами Checkbox на вкладці API мапінг.

Перелік груп підтягується з вашого кабінету Checkbox для конкретної каси. Відкрийте API мапінг → Податкові групи і для кожного податку з довідника Податки виберіть відповідну групу Checkbox зі списку.

Якщо список порожній або групи змінилися — натисніть Завантажити з Checkbox, щоб оновити його. Після зміни каси перелік теж потрібно оновити: він прив'язаний до конкретної каси (ПРРО).

Докладніше: Податкові ставки для фіскалізації.

Способи оплати

Перед фіскалізацією оплат через Checkbox налаштуйте способи оплати у Skynum.

У способі оплати виберіть Тип і Касу або Банківський рахунок. Потім у цій інтеграції Checkbox на вкладці API мапінг зіставте спосіб оплати Skynum зі значенням Checkbox для чека.

Відкрийте API мапінг → Способи оплати і для кожного способу оплати виберіть відповідне значення Checkbox. У полі можна вибрати стандартне значення зі списку або ввести власне. Для Checkbox значенням є текстова назва виду оплати в чеку.

Важливо правильно вибрати фіскальне значення

Вид оплати у фіскальному чеку — це фіскальне і податкове значення. Skynum передає у Checkbox те значення, яке зіставлене у мапінгу, але не визначає замість компанії, який вид оплати правильний для конкретного бізнес-сценарію. За правильність вибору відповідає користувач або відповідальна особа компанії.

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

Докладніше: Способи оплати для фіскалізації.

Що зробити в Skynum

1. Відкрийте Налаштування → Інтеграції → Фіскалізація.
2. Натисніть Додати інтеграцію.
3. Виберіть Checkbox.
4. Заповніть Назва інтеграції.
5. Увімкніть Інтеграція активна.
6. За потреби увімкніть За замовчуванням для філії.
7. Виберіть Філія, юридична особа.
8. У полі Ідентифікатор каси вставте ключ ліцензії каси Checkbox.
9. У полі Логін введіть логін касира Checkbox.
10. У полі Пароль введіть пароль касира Checkbox.
11. За потреби виберіть Безготівковий вид оплати за замовчуванням.
12. Увімкніть Надсилати SMS або Надсилати e-mail, якщо ці варіанти мають бути вибрані за замовчуванням у вікні надсилання чека.
13. Натисніть Перевірити підключення.
14. Якщо перевірка успішна, збережіть інтеграцію.
15. Перейдіть на вкладку API мапінг.
16. У секції Податкові групи зіставте податки Skynum з групами Checkbox. Якщо список порожній, натисніть Завантажити з Checkbox.
17. У секції Способи оплати зіставте способи оплати Skynum зі значеннями Checkbox.
18. Збережіть мапінг.

Позначки Надсилати SMS і Надсилати e-mail не забороняють користувачу змінювати спосіб надсилання. Вони лише визначають початковий стан позначок у вікні надсилання чека.

Коли вмикати "За замовчуванням"

Увімкніть За замовчуванням, якщо це основний фіскальний сервіс для філії.

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

Перевірка після підключення

Після збереження інтеграції перевірте не тільки підключення, а й реальний тестовий сценарій:

1. Створіть товарну накладну на поточну дату.
2. Вкажіть оплату в документі.
3. Перевірте, що валюта документа — гривня.
4. Активуйте документ.
5. Натисніть Фіскалізувати.
6. Після успіху відкрийте меню Фіскалізовано і перевірте чек у Checkbox або ДПС.

Якщо фіскалізація повертає помилку, відкрийте Помилки фіскалізації і перевірте текст помилки.

Надсилання чеків клієнту

Для надсилання фіскального чека клієнту після фіскалізації натисніть Фіскалізовано → Надіслати і виберіть SMS, e-mail або обидва канали. Skynum передає в Checkbox команду надсилання для вже фіскалізованого чека.

Якщо компанія хоче надсилати чеки через SMS або Viber, ця послуга має бути підключена в Checkbox. Skynum не надсилає такі повідомлення власною SMS-розсилкою.

Докладніше: Надсилання фіскального чека клієнту.

Типові проблеми

Перевірка підключення не проходить

Перевірте ключ ліцензії каси, логін і пароль касира. Також переконайтеся, що каса активна, а касир не деактивований.

Пароль касира неправильний

Перевірте, що в Skynum введений пароль касира Checkbox, а не пароль входу в кабінет Checkbox. Якщо є сумнів, змініть пароль касира в Checkbox через Касири → Дії → Редагувати → Новий пароль → Зберегти і введіть новий пароль у Skynum.

Чек не підписується або не передається в ДПС

Перевірте, що в Checkbox налаштоване підписання чеків для касира. Якщо використовуєте хмарний спосіб, переконайтесь, що КЕП / ЕЦП касира завантажений у хмару Checkbox і доступний для підписання.

Касир уже працює з цією касою

Checkbox повідомляє, що каса або касир зайняті іншою операцією. Завершіть поточну дію в Checkbox або повторіть фіскалізацію після короткої паузи.

Податкова група не зіставлена або застаріла

Відкрийте вкладку API мапінг, оновіть перелік через Завантажити з Checkbox і виберіть актуальну групу для кожного податку Skynum.

Спосіб оплати не зіставлений

Відкрийте вкладку API мапінг і в секції Способи оплати виберіть значення Checkbox для способу оплати Skynum.

Чек не надсилається SMS або Viber

Перевірте, що послуга доставки чеків підключена в Checkbox і що телефон введений у форматі 380XXXXXXXXX.

Корисні посилання Checkbox

• Початок роботи з Checkbox
• Реєстрація каси / ПРРО в Checkbox
• Касири в Checkbox
• API-авторизація касира Checkbox

Підсумок

Для фіскалізації платформи Skynum через Checkbox потрібні три головні дані: ключ ліцензії каси, логін касира і пароль касира. Окремо перевірте, що в Checkbox налаштоване підписання чеків для касира. Після підключення обов'язково зіставте податкові групи і способи оплати на вкладці API мапінг, а потім проведіть тестову фіскалізацію документа.