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