help.carbook.pro

Підтримка – База Знань – my.carbook.pro

Як налаштувати ПРРО від Каса.Вчасно?

Головна » Як налаштувати ПРРО від Каса.Вчасно?

Щоб інтегрувати ПРРО “Вчасно.Каса” в Carbook, потрібно виконати кілька кроків у кабінеті kasa.vchasno.com.ua. Нижче — покрокова інструкція, як це зробити. В CARBOOK реалізована схема роботи з хмарою від Вчасно.Каса.Схема роботи ПРРО CARBOOK з Вчасно.Каса.

Пояснення до схеми:
В даному випадку API запит відправляється з CARBOOK, наприклад на фіскалізацію чеку, на сервер Вчасно.Каса який тримає постійне підключення з ДМ (Device Manager) та може ним керувати. З серверу запит передається на ДМ який в свою чергу виконує оплату на терміналі (якщо в чеку оплата картою), фіскалізацію чеку та його друк як описано вище.

  • CARBOOK може відправляти запити на сервер Вчасно.Каса без необхідності відкривати доступ до ПК клієнта “в світ”.
  • Не потрібно локально підключати SSL сертифікат в ДМ для роботи API по HTTPS, так як при роботі з Вчасно.Каса використовується обов’язково лише HTTPS.
  • Клієнт в CARBOOK може мати повноцінне робоче місце з ПРРО, принтером і терміналом при цьому не ускладнюючи процес налаштування і роботи.
  • Спрощується процес першого налаштування для початку роботи.

Можливості роботи ПРРО Вчасно.Каса в CAROOK:​

  • Налаштувати касу
  • Відкрити зміну
  • Перевірити статус каси
  • Вимкнути чи приховати касу ПРРО в CARBOOK.
  • Переглянути X-звіт, Z-звіт та чеки по кожній зміні
  • Сформувати чек та фіскалізувати операцію.
  • Викликати прийняття оплати через термінал та автоматично передати дані про картку платника в чек. Автоматичний друк чека після успішної фіскалізації через принтер чи термінал.

Як налаштувати роботу ПРРО Вчасно.Каса в CARBOOK?

Крок 1. Реєстрація в сервісі “Вчасно.Каса”

  • Зареєструйтесь на сайті https://kasa.vchasno.com.ua/.

  • Після реєстрації підтвердьте вашу електронну пошту та номер телефону.

  • Зазначте дані про компанію, використовуючи електронний цифровий підпис (ЕЦП). Необхідно додати ключ ЕЦП й ввести пароль до нього для підтвердження даних компанії.​

Крок 2. Створення торгової точки, каси та пристрою

  • Для проведення всіх налаштувань можна скористатись інструкцією від Вчасно.Каса

  • Після додавання компанії перейдіть до створення торгової точки (“Торгові точки” → “Додати торгову точку”).

  • Заповніть усі обов’язкові поля: назва, адреса, тип тощо.

  • Створіть касу (“Каси” → “Додати касу”). Зверніть увагу, щоб назва не містила заборонених символів.wiki-kasa.vchasno​

Крок 3. Генерація токена для інтеграції

  • У властивостях створеної каси знайдіть розділ “Токен”.

    Налаштування каса -> генерація токена для налаштування Device manager від Вчасно.Каса.
    Налаштування каса -> генерація токена для налаштування Device manager від Вчасно.Каса.

  • Натисніть “Згенерувати токен” (або “Перегенерувати токен”, якщо він вже існує, але був втрачений).Налаштування каси в кабінеті Вчасно.Каса -> Згенерувати токен.

  • Скопіюйте отриманий токен та збережіть собі в надійному місці — після закриття сторінки він буде прихований, знадобиться повторна генерація при необхідності.​

  • Створення ПРРО в застосунку Device Manager. 

    • Необхідно встановити додаток з офіційного сайту «Device Manager» на ваш пристрій. Можна звернутись до підтримки Вчасно.Каса для допомоги з встановленням та налаштуванням. Після встановлення та налаштування натисніть на ярлик «Device Manager» на робочому столі, або перейдіть за прямим посиланням: http://localhost:3939/dm/vchasno-kasa/dashboard.html

    • Далі необхідно додати пристрій. Можна використати інструкцію від ВчасноКаса Додавання в «Device Manager» пристрій.
    • Після натискання на кнопку “Додати пристрій” буде відкрито модальне вікно в якому треба буде ввести імʼя пристрою. Вікно додавання пристрою в Device manager
      1. В полі «Ім’я пристрою» придумайте та введіть назву для каси (ПРРО). Звертаємо увагу що назва ПРРО не має містити заборонені символи, детальніше на інструкції Вчасно.Каса.
      2. У поле «Токен ПРРО сформований в кабінеті Вчасно.Каса» введіть токен, який скопіювали раніше у кабінеті Вчасно.Каса.
      3. Знизу на сторінці відобразиться повідомлення що касу успішно створено і відкриється сторінка інформації про ПРРО де потрібно буде завантажити ключ ЕЦП.Завантаження ключа, для остаточного налаштування пристрою в Device Manager.
      4. Далі повертаємось в кабінет та знаходимо розділ “Адміністрування DM” або переходимо в нього прямо з застосунку Device Manager, скориставшись кнопкою в правому верхньому куті.Додати пристрій до адміністрування DM
      5. Далі додаємо DM. Це імʼя потім знадобиться для налаштування каси в CARBOOK. Нижче показано, звідки взяти ідентифікатор. Отримуємо його натискаючи на кнопку Адміністрування ДМ в девайс менеджері -> Отримати ідентифікатор DM -> копіюємо цей ідентифікатор і вставляємоВікно додавання DM в кабінеті Вчасно.Каса
      6. Ідентифікатор DM береться в застосунку Device Manager. Для перевірки звʼязку з терміналом, можна натиснути іконку в правому верхньому куті.Застосунок Device Manager
      7. Далі скопіювати звідси id.Копіювання id пристрою для налаштування.

Крок 4. Отримання назви каси, пристрою та API токена

  • Відразу після додавання пристрою, треба скопіювати API токен, для налаштування в CARBOOK. Генерація API токена для налаштування каси в CARBOOK.

  • Запишіть точну назву каси та пристрою так, як ви їх вказали під час створення. На прикладі вище, CARBOOK-TER та CARBOOK-PRO.

  • Ці дані разом із токеном необхідні для налаштування на стороні Carbook.

Крок 5. Створення каси в CARBOOK.

  • Увійдіть у систему Carbook.ua
  • Зайдіть у свій обліковий запис Carbook.ua з Права доступу “Керівник”, “Адмін”, “Бухгалтер”.
  • Налаштуйте каси в Carbook
    • Перейдіть у розділ «Налаштування» → «Каси».Інші налаштування – Каси – створення/редагування, налаштування каси.
    • У вікні керування касами CARBOOK – натисніть кнопку «Додати касу». У відкритому модальному вікні заповніть необхідні поля, як показано на скріні.
    • Вписати назву ПРРО каси, яку буде відображати в CARBOOK.
    • Обрати тип каси для ПРРО: Готівка, Карта, Безготівка. Інші типи кас, не можуть використовуватись для ПРРО.
    • Обрати реквізити, які будуть за замовчуванням застосовуватись при створенні касового ордера (За потреби).
    • Облік по бух рахунку (За потреби).
    • Опис – додати за потреби
    • РРО — Для роботи з ПРРО від Вчасно.Каса – заповнювати “Вчасно”.
    • Назва девайса – має відповідати назві девайса в розділі “Адміністрування DM” в кабінеті Вчасно.Каса.
    • Токен – згенерувати в розділі “Адміністрування DM” в кабінеті Вчасно.Каса.
    • Унікальний код податку – прописати за потреби, взяти з налаштувань каси – в кабінеті Вчасно.Каса – розділ “Податкові групи”.Кабінет ВчасноКаса - налаштування кодів податкових ставок
    • Період автозакриття (поле в розробці).
    • “Еквайєр/Мерчант:” — в кабінеті Вчасно.Каса, поле не обовʼязкове, але використовується для ручного введення даних про картку платника перед створенням фіскального чека.
    • Банк — з яким договір на проведення розрахунків. Поле не обовʼязкове, так само як “Еквайєр/Мерчант:”
    • Термінал – В це поле треба вписати назву пристрою з застосунку Device Manager. Якщо назва пристрою містить пробіл, то замість пробіла треба проставити %20. Приклад, “Термінал Приват” –> в CARBOOK, поле термінал, треба вписати так: “Термінал%20Приват”.
      *Приклад на скріні, правильний в тому випадку, якщо в Device Manager назва пристрою CARBOOK-TER, якщо ні, то в поле Термінал, треба прописати назву пристроя з застосунку Device Manager.

      Вікно створення каси в системі CARBOOK, для роботи з ПРРО Вчасно.Каса.

    • Після заповнення, каса буде готова до відкриття.

Крок 6. Налаштування працівника в CARBOOK, для роботи з ПРРО.

    • У розділі «Налаштування» → «Працівники» → створити або редагувати поточного працівника.
    • Крім загальної інформації про працівника в картці працівника, для налаштування касира потрібно в табі “посада” – обрати посаду “Касир”, після чого в картці працівника зʼявиться новий таб “РРО”.Налаштування посади "Касир" в картці працівника. Обовʼязково, якщо потрібно налаштувати РРО.
    • В табі “РРО”, до відповідної каси ПРРО обрати постачальника послуг Вчасно і додати токен до відповідної каси. В цьому ж рядку натиснути кнопку “Зберегти”.Картка працівника – налаштування доступу до керування касою ПРРО в CARBOOK.

Крок 7. Перевірка роботи ПРРО створеної каси в CARBOOK.

  • Увійдіть у систему Carbook.ua під логіном та паролем касира та відкрийте зміну, щоб переконатися, що каса працює коректно. Для цього перейдіть у вікно “Каси” та натисніть в рядку необхідної каси кнопку “Відкрити зміну”. Зелений індикатор — зміна відкрита, червоний — закрита.Вікно керування касами – можливості: статус зміни, відкрити зміну, внести кошти, видати кошти, перемістити, х-звіт та закрити зміну.

Якщо все працює, ви готові до повноцінної роботи!

Як проводити оплату через ПРРО?

Спочатку відкрити зміну, якщо цього не було зроблено. На скріні вище показано, як це зробити. Після відкриття зміни індикатор має бути зеленим. Далі можна з будь-якого місця клікнути іконку з доларом та побачити відкриття модального вікна для сторення/редагування касового ордера.

Через готівку.

Для проведення оплати через готівку, необхідно обрати касу, обрати спосіб оплати, внести суму отриману від клієнта і заповнивши всі інші необхідні поля натиснути на гаразд. Чек від ПРРО буде містити в собі дані про оплату та решту, яку ви надали клієнту. Після натискання на “гаразд” – буде відкрито наступний крок, в якому автоматично буде створено касовий ордер та буде проводитись фіскалізація через ПРРО, в разу успіху, модальне вікно буде закрите та завантажено чек. Модальне вікно створення/редагування касового ордера.

Через Безготівку

Якщо необхідно провести безготівкову оплату, потрібно відкрити модальне вікно стоворення/редагування касового ордера –> обрати необхідну касу, -> обрати реквізити з списку, в селекті типу оплати обрати “Безготівка” і задати спосіб отримання коштів:Модальне вікно створення касового ордера з можливістю подальшої фіскалізації.

  • “Карткою через POS-термінал” ⮕ або занести дані про картку платника вручну або скористатись автоматичним заповненням (Працює тільки для ПРРО Вчасно.Каса), при оплаті через термінал, у фіскальному чеку будуть відображені введені вами дані про картку або ж передані з терміналу.
  • Карткою безпосередньо на рахунок (IBAN) продавця” – в чеку буде написано ⮕ “Переказ з картки”.
  • “Додатком в смартфоні за посиланням через QR-код” – в чеку буде написано ⮕ “Переказ через QR-код”.
  • “Через Інтернет-сайт за посиланням” – в чеку буде написано ⮕ “Інтернет еквайринг, оплата карткою в Інтернет.
  • “Інтернет еквайринг та платіжний кюар” ⮕ “Платіж Interkassa, Portmone, LiqPay, mono checkout, Novapay, EasyPay, Platon тощо”.
    • Додатково обирається / задається: Interkassa, Portmone, LiqPay, mono checkout, Novapay, EasyPay, Platon тощо.
  • “Сервіс переказу коштів” ⮕ “Сервіс переказу коштів PrivatMoney; Western Union; MoneyGram; RIA; IntelExpress; MEEST; Welsend тощо”.
    • Додатково обирається / задається: PrivatMoney; Western Union; MoneyGram; RIA; IntelExpress; MEEST; Welsend тощо.
  • Прикріпити фіскальний чек (Працює тільки для checkbox.ua) ⮕ До замовлення можна прикріпити фіскальний чек створений через кабінет checkbox.ua, а не через CARBOOK. При обраному типі каси “безготівка” та активації в селекті способу оплати обрати “Прикріпити фіскальний чек”, будуть доступні  фіскальні чеки, створені сьогодні та відсортовані, спочатку найновіші. Прикріплений чек до замовлення, в системі буде відображатись, як звичайний фіскальний чек, але без повторної фіскалізації.

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

Якщо хочете сплатити через термінал, з автоматичним заповненням даних про картку платника, то оберіть касу  з ПРРО Вчасно.Каса в CARBOOK, додайте  реквізити якщо необхідно, оберіть в способі оплати “через POS термінал” та активуйте селект “Виберіть термінал” і вкажіть мерчант. Якщо він у вас лише один, то він автоматично підтягнеться. Після того як ви натиснете “гаразд” буде відправлено запит на термінал, про прийняття коштів, після успішної відповіді буде автоматично відправлено запит на фіскалізацію. В разі помилки, при отриманні оплати з термінала, модальне вікно буде відкрите на кроці 2 та дозволить обрати іншого мерчанта з селекту або викликати повторну оплату через термінал. 

Список помилок при роботі з Вчасно.Каса можна знайти на сторінці wiki-kasa.vchasno.ua.

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

Якщо фівскалізувати операцію, зроблену через термінал, з ручним заповненням даних про картку платника, то оберіть касу  з ПРРО Вчасно.Каса в CARBOOK, додайте  реквізити якщо необхідно, оберіть в способі оплати “через POS термінал” та активуйте селект “Вручну”. Далі необхідно ввести дані з чека отриманого в терміналі в поля модалки стоврення/редагування касового ордера і натиснути кнопку “Гаразд”. Після чого відбудиться фіскалізація та завантажиться чек з введеними вами даними.Ручне внесення даних про картку платника, для фіскалізації операції.

Якщо виникнуть труднощі з отриманням токена чи налаштуванням пристроїв, рекомендується звернутися до документації “Вчасно.Каса” або в підтримку сервісу.vchasno.