Інтеграція з Вчасно.Каса у Skynum — налаштування ПРРО, токена і фіскалізації

Вчасно.Каса — це програмний РРО для створення фіскальних чеків і передавання даних до Державної податкової служби України. Інтеграція з Вчасно.Каса у Skynum дозволяє фіскалізувати продажі, платежі та повернення без ручного дублювання даних між обліковою системою і фіскальним сервісом.

Важливо: ця стаття описує платформну фіскалізацію у вебверсії Skynum. Це не налаштування Skynum.Каса, не підключення локального Device Manager і не інструкція для роботи з POS-касою.

Для чого потрібна інтеграція з Вчасно.Каса

Інтеграція потрібна, коли компанія веде продажі в Skynum і хоче створювати фіскальні чеки через Вчасно.Каса без повторного введення товарів, сум, податків і оплат у кабінеті фіскального сервісу.

Після налаштування Skynum передає у Вчасно.Каса дані з документа або платежу: товари, кількість, суму, податки, спосіб оплати і контактні дані покупця для надсилання чека, якщо це ввімкнено в інтеграції.

У Skynum така інтеграція використовується для:

фіскального чека продажу за товарною накладною;
повернення фіскального чека;
фіскалізації платежу в замовленні або товарній накладній;
автоматичної фіскалізації інтернет-замовлень, якщо це налаштовано в інтеграції інтернет-магазину;
фіскалізації платежів післяплати Нової пошти, якщо для доставки налаштоване створення і фіскалізація платежу;
надсилання вже фіскалізованого чека клієнту через можливості Вчасно.Каса.

Обмеження і відповідальність

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

Перед роботою з реальними продажами обов'язково перевірте тестовий продаж, тестове повернення і фіскалізацію платежу. Після фіскалізації дані чека передаються до ДПС через Вчасно.Каса, тому неправильний мапінг податків або способів оплати може призвести до некоректного фіскального чека.

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

Що підготувати у Вчасно.Каса

Перед підключенням у Skynum підготуйте обліковий запис, ключ, касу і токен у Вчасно.Каса. За офіційними інструкціями Вчасно.Каса для роботи через API потрібен токен конкретної каси, а для фіскалізації чеків ключ має бути доданий у сховище ключів Вчасно.Каса.

Зареєструйтесь або увійдіть у кабінет Вчасно.Каса.
Додайте ключ у розділі Ключі, щоб каса могла підписувати фіскальні документи.
Створіть або перевірте господарську одиницю і торгову точку.
Зареєструйте програмний РРО у ДПС через Вчасно.Каса або перевірте, що потрібний ПРРО уже зареєстрований і активний.
Перевірте касира або підпис, який буде використовуватися для фіскалізації чеків.
Перевірте податкові групи, які будуть використовуватися у товарних рядках чека.
Підключіть у Вчасно.Каса види оплати, які будуть передаватися у фіскальні чеки.
Замовте або підключіть послугу SMS-доставки чеків напряму у Вчасно.Каса, якщо компанія буде надсилати фіскальні чеки клієнтам через SMS.
Налаштуйте автоматичне закриття зміни у Вчасно.Каса в кінці робочого дня.
Відкрийте налаштування конкретної каси і скопіюйте токен з блоку Токен.

Skynum автоматично відкриває зміну, коли це потрібно для фіскалізації, але не закриває зміну в кінці дня. Щоб зміни не залишалися відкритими після завершення роботи, налаштуйте автоматичне закриття зміни саме у Вчасно.Каса.

Токен належить конкретній касі. Якщо у Вчасно.Каса перегенерувати токен, старий токен перестане працювати, і в Skynum потрібно буде вставити новий токен.

Офіційні інструкції Вчасно.Каса:

Як підключити Вчасно.Каса у Skynum

У Skynum інтеграція налаштовується в розділі Налаштування → Інтеграції → Фіскалізація.

Відкрийте Налаштування → Інтеграції.
Перейдіть у категорію Фіскалізація.
Натисніть Додати інтеграцію.
Виберіть Вчасно.Каса.
Заповніть поля інтеграції.
Збережіть інтеграцію.
Відкрийте збережену інтеграцію і натисніть Перевірити підключення.

Поля інтеграції

Назва інтеграції — внутрішня назва у Skynum. Вкажіть її так, щоб було зрозуміло, до якої філії, юридичної особи або каси Вчасно.Каса належить ця інтеграція.
Інтеграція активна — вмикає використання інтеграції у фіскалізації. Не вмикайте її для реальної роботи, доки не перевірили токен, податки і способи оплати.
За замовчуванням — дозволяє Skynum автоматично підставляти цю інтеграцію для відповідної філії або юридичної особи, якщо у документі або платежі не вибрано інший ПРРО.
Безготівковий вид оплати за замовчуванням — код виду оплати Вчасно.Каса, який буде використовуватися для безготівкової оплати без окремого способу оплати. Цей вид оплати має бути підключений у Вчасно.Каса.
Надсилати SMS — дозволяє передавати у Вчасно.Каса команду надсилання чека клієнту SMS, якщо у клієнта є номер телефону і послуга SMS-доставки чеків окремо підключена напряму у Вчасно.Каса.
Надсилати email — дозволяє передавати у Вчасно.Каса команду надсилання чека клієнту на email, якщо у клієнта є email і надсилання налаштоване у Вчасно.Каса.
Філія, юридична особа — філія або юридична особа Skynum, для якої працює ця каса Вчасно.Каса.
Токен — токен конкретної каси з кабінету Вчасно.Каса.

Податкові групи

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

Виберіть групу, яка відповідає податку у Skynum і налаштуванням вашої каси Вчасно.Каса. Наприклад, для товарів з ПДВ 20% може використовуватися група 1 — ПДВ 20% (А), а для товарів без ПДВ — 2 — Без ПДВ (Б).

Якщо податки ще не створені у Skynum, налаштуйте їх у довіднику Налаштування → Довідники → Податки. Докладніше: налаштування податків.

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

У секції Способи оплати зіставте способи оплати Skynum з кодами Вчасно.Каса. У Skynum способи оплати налаштовуються в розділі Налаштування → Довідники → Способи оплати. У Вчасно.Каса відповідний вид оплати має бути підключений для каси, через яку ви фіскалізуєте чеки.

Для Вчасно.Каса значенням способу оплати має бути числовий код. Наприклад:

0 — готівка;
1 — безготівка;
2 — картка;
3 — передплата;
4 — післясплата;
16 — інтернет-еквайринг;
20 — NovaPay.

Щоб замапити спосіб оплати, відкрийте поле навпроти потрібного способу оплати Skynum і виберіть код зі списку. Якщо у Вчасно.Каса підключений власний код, якого немає у списку Skynum, введіть цей числовий код вручну у полі мапінгу і збережіть інтеграцію.

Вид оплати у фіскальному чеку має податкове значення. Перед запуском реальних чеків перевірте, що кожен код у мапінгу відповідає підключеному виду оплати у Вчасно.Каса.

Фіскалізація товарної накладної

Продаж фіскалізується з товарної накладної. Відкрийте Торгівля → Продажі → Товарна накладна, створіть або відкрийте документ і перевірте основні умови перед фіскалізацією.

Документ активований.
Дата документа відповідає дню фіскалізації.
Валюта документа — гривня.
У документі заповнені товарні рядки, кількість, ціни і податки.
Для документа вибраний або автоматично підставлений фіскальний сервіс у полі ПРРО.
Податкові групи і способи оплати заповнені в API мапінгу інтеграції.

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

Докладніше про товарну накладну: робота з товарною накладною.

Як відкрити, роздрукувати або надіслати фіскальний чек

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

Переглянути чек — відкриває фіскальний чек у Вчасно.Каса. З цієї сторінки чек можна переглянути і роздрукувати засобами браузера або сторінки чека.
Копіювати — копіює посилання на фіскальний чек, щоб його можна було передати клієнту вручну.
Надіслати — відкриває форму Надіслати чек клієнту. У формі можна вибрати Надіслати SMS, Надіслати email, перевірити телефон або email клієнта і натиснути Надіслати.
Відкрити у ДПС — відкриває чек у сервісі ДПС, якщо для цього чека доступне окреме посилання ДПС.

Для надсилання чеків через SMS компанія має окремо замовити або підключити послугу SMS-доставки напряму у Вчасно.Каса. Skynum не підключає цю послугу і не надсилає SMS власною розсилкою: він тільки передає у Вчасно.Каса команду надсилання для вже фіскалізованого чека.

Для друку відкрийте фіскальний чек через Переглянути чек і друкуйте саме сторінку чека Вчасно.Каса.

Повернення фіскального чека

Вчасно.Каса у Skynum підтримує повернення за окремим документом. Це сценарій, коли потрібно повернути продаж за конкретною товарною накладною, а не розгорнути весь ланцюжок передплати або післяплати.

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

Якщо продаж був частиною ланцюжка передплати або післяплати, використовуйте сценарії фіскальних ланцюжків. Для Вчасно.Каса такі ланцюжки не підтримуються. Докладніше: передплати, післяплати і фіскальні ланцюжки.

Докладніше про повернення продажу: повернення продажу.

Фіскалізація платежу

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

Платежі відкриваються в розділі Фінанси → Каса або Фінанси → Банк. У формі платежу перевірте Спосіб оплати, Касу або банківський рахунок, Тип платежу, Філію, юридичну особу, Суму і валюту. Після активації платежу запустіть фіскалізацію, якщо цей платіж має створити фіскальний чек.

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

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

Докладніше про платежі: платежі та пов'язані платежі.

Автоматична фіскалізація інтернет-замовлень

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

Щоб такі операції проходили через Вчасно.Каса, у правилах автоматичної фіскалізації потрібно використовувати цю фіскальну інтеграцію і ті самі мапінги податків та способів оплати. Докладніше: автоматична фіскалізація інтернет-замовлень.

Післяплата Нової пошти

Післяплата Нової пошти — окремий сценарій, у якому важливо правильно пов'язати доставку, оплату і фіскалізацію. Якщо компанія використовує післяплату, спочатку налаштуйте інтеграцію з Новою поштою і правила створення платежів.

Докладніше: інтеграція з Новою поштою та післяплата Нової пошти.

Підсумок

Для інтеграції Вчасно.Каса зі Skynum потрібні три ключові речі: готова каса у Вчасно.Каса, токен цієї каси і заповнений API мапінг податків та способів оплати у Skynum. Після цього можна фіскалізувати продажі, повернення і платежі, а також надсилати клієнту вже створений фіскальний чек через Вчасно.Каса.

Інтеграція з Вчасно.Каса