↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Продажі та документи
    4. Каси ПРРО

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

    6 хв читанняОновлено

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

      Що це дає:

      • Каси ще немає — форма «3в1» у кабінеті сервісу реєструє торгову точку, касу й ключ касира за один раз.
      • Каса вже працює — вписуєте її токен, і чеки йдуть з Elbuz через неї.
      • Хочете спершу перевірити — тестова каса дає повний шлях, чек бачите в документі, а в податкову він не йде.

      З чого почати: згенеруйте токен тестової каси і впишіть його в Elbuz.

      Що вміє підключення Вчасно.Каси

      Де це і хто має доступ

      Меню
      Кабінет → Налаштування системи → «Інші налаштування» → «Зовнішні сервіси та інтеграції» → група «Фіскальні чеки» → Вчасно.Каса
      Право доступу
      вікно «API та токени доступу» у «Правах груп»
      Підготувати
      кабінет Вчасно.Каса; файл ключа КЕП/ЕЦП компанії для реєстрації

      Як зареєструвати касу у Вчасно.Каса

      Реєстрація проходить у кабінеті сервісу, не в Elbuz. Кроки нижче — за довідкою Вчасно.Каса станом на 06.11.2026; якщо кабінет виглядає інакше, орієнтуйтеся на перші кроки у сервісі.

      1. На kasa.vchasno.com.ua натисніть «Зареєструватися», вкажіть email і пароль, підтвердьте email із листа.
      2. Додайте файл ключа КЕП/ЕЦП компанії, введіть пароль і перевірте дані.
      3. Оберіть «Тестувати», щоб спершу працювати без податкової, або «Почати роботу» для справжніх чеків.
      4. Для справжньої каси заповніть форму «3в1»: торгова точка, каса, ключ касира. Для сайту тип каси — «Інтернет-торгівля». Натисніть «Зареєструвати у ДПС».
      5. Дочекайтеся відповіді податкової. Довідка називає до 3 хвилин для першого налаштування й близько 15 хвилин для окремих запитів до ДПС.

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

      Каса вже зареєстрована в податковій — кабінет пропонує імпортувати її: позначте потрібну точку й касу. Заново реєструвати не треба.

      Там само задайте типи оплат і податкові групи. Elbuz передає ставку ПДВ з документа, вона має підтримуватися касою.

      Де взяти токен каси

      Токен — окремий на кожну касу, зокрема тестову. За довідкою сервісу:

      1. У кабінеті Вчасно.Каса в меню зліва відкрийте «Торгові точки та каси».
      2. Виберіть касу й натисніть шестерню: відкриються налаштування.
      3. Прогорніть до пункту «Токен» і натисніть «Згенерувати токен», скопіюйте значення.
      Токен показується лише раз. Загубили — згенеруйте новий: старий перестане працювати, і його треба замінити в Elbuz. Сервіс радить міняти токен каси лише після закриття зміни.

      Як налаштувати касу в Elbuz

      Де: Кабінет → Налаштування системи → «Інші налаштування» → плитка «Зовнішні сервіси та інтеграції» → група «Фіскальні чеки» → рядок «Вчасно.Каса», олівець.

      Форма «Підключення Вчасно.Каса» з полями токена, фірми, ПДВ і закриття зміни
      1Де в кабінеті взяти токен
      2Токен каси
      3Платник ПДВ
      4Закривати зміну щовечора
      1. Підказка вгорі форми вказує, де в кабінеті Вчасно.Каса взяти токен і ключ підпису.
      2. Токен каси: збережене значення не показується, у полі лише крапки.
      3. Платник ПДВ: вимкнено — усі рядки чека йдуть без ПДВ.
      4. Закривати зміну щовечора: Z-звіт формується сам, опція увімкнена спочатку.

      Форма зберігається сама, кнопки «Зберегти» немає: унизу з’являється «Збережено». Збережений токен у полі не показується, у нього видно лише крапки.

      ПолеЩо робитьСпочатку
      АктивністьВимкнена — каса не пропонується, кнопка чека зникає. Уже видані чеки лишаються в документахвимкнено
      Токен касиКлюч каси з кабінетупорожньо
      Фірма«Будь-яка» — для всіх документів; конкретна — лише для документів цієї фірмиБудь-яка
      Платник ПДВУвімкнено — ставка береться з рядка документа або товару. Вимкнено — усі рядки йдуть без ПДВвимкнено
      Чек при оплаті за посиланнямЧек видається сам при оплаті через посилання на оплатувимкнено
      Закривати зміну щовечораЗавдання крона формує Z-звіт о 22:30 або 23:30 за Києвом залежно від сезонуувімкнено
      Накладений платіжРежим для посилок із післяплатою, його обирає бухгалтерЧек при відправці
      Платник ПДВ лишив перемикач «Платник ПДВ» вимкненим: чеки йдуть «Без ПДВ». Виданий чек не виправити, тому встановіть перемикач до першого справжнього чека. Ставки Вчасно.Каса приймає такі: 20, 14, 7 і 0 %. Інша ставка дасть помилку «VAT rate … is not supported».

      Блок «Зміна» під формою показує стан: «Зміну відкрито» або «Зміну закрито». Якщо там текст помилки — токен не підходить: перевірте його. Це перша перевірка ключа, чек для неї не потрібен.

      Як видати перший чек на тестовій касі

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

      1. Впишіть токен тестової каси, увімкніть «Активність».
      2. Відкрийте замовлення покупця в гривнях і натисніть «Фіскальний чек». Для перевірки візьміть своє замовлення.
      3. Перевірте спосіб оплати.
      4. Вимкніть «Надіслати чек на», якщо в документі контакт справжнього покупця.
      5. Натисніть «Видати чек».

      Результат видно у вікні й потім у діалозі документа: номер, сума, дата, позначка «тестовий, нефіскальний» і посилання «Відкрити чек». Блок «Зміна» в касі покаже «Зміну відкрито»: її відкрив перший чек.

      Результат видачі першого чека: тестовий, нефіскальний чек із посиланням «Відкрити чек»
      1Номер, сума й дата чека
      2тестовий, нефіскальний
      3Відкрити чек
      1. Номер, сума й дата зберігаються в документі.
      2. Такий чек не потрапляє в податкову і не заважає справжньому.
      3. Посилання на чек для перегляду й друку.

      Як перейти на справжню касу

      1. Закрийте зміну тестової каси кнопкою «Закрити зміну».
      2. Згенеруйте токен справжньої каси й впишіть його в поле «Токен каси» поверх старого.
      3. Перевірте «Платник ПДВ», «Фірма» й решту перемикачів: вони не залежать від каси й лишаються.
      4. Переконайтеся, що блок «Зміна» не показує помилку. Перший справжній чек сам відкриє зміну.

      Тестові чеки лишаються в документах із позначкою, а на справжній чек за тим самим продажем не впливають.

      Сценарії

      Каси ще немає

      Що зробити. Зареєструйтеся у Вчасно.Каса, виберіть «Тестувати», згенеруйте токен, перевірте в Elbuz один чек. Потім пройдіть форму «3в1» і замініть токен.

      Що вийде. Перший справжній чек — уже після того, як менеджери побачили весь шлях.

      Каса працює у Вчасно, чеки пробивають вручну

      Що зробити. Закрийте зміну, згенеруйте новий токен, якщо старий загублено, і впишіть у Elbuz.

      Що вийде. Чек із замовлення йде на ту саму касу. Чек продажу, виданий раніше в кабінеті, Elbuz не бачить: для повернення за ним є окремі поля.

      Оплата за посиланням через LiqPay

      Що зробити. Увімкніть «Чек при оплаті за посиланням» і підключіть платіжний сервіс.

      Що вийде. Чек зі способом оплати «LiqPay» видається сам після надходження оплати.

      Що робити, коли каса не працює

      Повідомлення при підключенні
      Що ви бачитеЧому такЩо зробити
      «Касу не підключено. Увімкніть її й впишіть ключ у «Зовнішні сервіси» → «Фіскальні чеки».» Каса вимкнена, токен порожній або фірма каси не підходить документу Перевірте форму каси (налаштування)
      «Вчасно.Каса: HTTP …» або «Вчасно.Каса: ‹код› ‹текст›» у блоці «Зміна» Сервіс не прийняв запит. Найчастіше токен старий або скопійований із зайвими символами Згенеруйте новий токен і впишіть його (де взяти)
      «Вчасно.Каса: VAT rate … is not supported» Ставка рядка не входить до 20, 14, 7 чи 0 % Виправте ставку в рядку документа або в товарі
      «Чек не видано: Вчасно.Каса: …» із текстом про ключ Сервіс не може підписати чек Перевірте ключ у сховищі ключів кабінету (реєстрація)

      Текст після назви сервісу формує сама Вчасно.Каса. Повідомлення про чек у документі розібрані в статті про чеки.

      Часті запитання

      Чи потрібно встановлювати Device Manager?

      Ні. Elbuz звертається до хмарного API Вчасно.Каса напряму, тому на комп’ютер нічого встановлювати не треба.

      У мене кілька кас у Вчасно. Як підключити другу?

      Один рядок — один токен, тобто одна каса. Другу додайте кнопкою «Додати API» над списком «Зовнішні сервіси та інтеграції», обравши «Фіскальні чеки — Вчасно.Каса». У документі з’явиться поле «Каса» для вибору.

      Чи треба щоранку відкривати зміну?

      Ні. Зміну відкриває перший чек, а закриває завдання крона, якщо не вимкнено «Закривати зміну щовечора».

      Що буде, якщо вимкнути «Активність»?

      Кнопка чека зникне з нових документів, автоматичні чеки припиняться. Документи з виданими чеками кнопку зберігають, а токен лишається у формі. Увімкнення повертає все, як було.

      Чи платні чеки в Elbuz?

      Видача чека нічого не списує з балансу Elbuz. Тариф каси встановлює Вчасно.Каса у вашому договорі.

      Суміжні теми

      Чи була стаття корисною?

      Зміст статті

      Спробувати безкоштовно