Інтеграція з системою Checkbox для POS

  • Версія Odoo

12 000,00 ₴ 12 000,00 ₴ 12000.0 UAH

12 000,00 ₴

Такая комбинация не существует

Купити

Реалізація програмного РРО з підтримкою реєстрації чеків в податковій через API Checkbox та друком QR коду на чеку


Опис Модуля

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

    Інтеграція Odoo з програмною касою (POS - Point of Sale) через API дозволяє забезпечити зв'язок між системою Odoo та програмною касою для обробки операцій продажу в магазині або ресторані.

    Одним із способів здійснення інтеграції є використання REST API, який надає Odoo. Цей API дозволяє здійснювати HTTP-запити для отримання та відправки даних між Odoo і програмною касою.

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

    Модуль “CheckBox” від компанії “Kitworks Systems” вирішує всі питання інтеграції Odoo з програмною касою. Саме він дозволяє фіскалізувати продажі, робити повернення, розраховувати податки. Модуль “CheckBox” має також додатки, які розрізняються за своїм функціоналом:

  • «CheckBox» базовий - його функціонал додає інтеграцію з Odoo.

  • «CheckBox Account» - інтегрує з фінансовими модулями в Odoo.

  • «CheckBox by Invoice» - додає фіскалізацію чека від грошових коштів в Odoo.

  • «CheckBox in Point of Sale» - інтегрує з модулем “Точка продаж” в Odoo.

  • «СheckBox product «UKTZED» - додає можливість вказати УКТ ЗЕД в Odoo для передачі коду підакцизного товару в ДПС України.

Налаштування Модуля

     Першим етапом буде реєстрація на порталі CheckBox. Для цього необхідно слідуючи підказкам пройти легку реєстрацію.  При реєстрації Торгової точки (форма 20-ОПП), каси (форма 1-ПРРО) і касира (форма 5-ПРРО) - всі дані автоматично відправляються в Державну Податкову Службу України.

    Форма реєстрації в кабінет CheckBox наведена нижче.

    Далі необхідно зробити деякі базові налаштування в самому інтерфейсі кабінету Сheckbox, для цього слід виконати покрокову інструкцію «Як почати».

    Якщо у Вас відсутня торгова точка, то необхідно створити «Торгову точку» згідно інструкції. Дочекайтесь її підтвердження з ДПС зі статусом «Активна». Цей крок необов’язковий, якщо Ви раніше реєстрували торгові точки в податковій установі та хочете додати програмну касу до існуючої торгової точки.


    Після активації торгової точки, необхідно додати касу та касира. Інтерфейс «Checkbox» пропонує касу відразу з двома «Статусами»: Активна - для роботи та Тестова каса - використовується для проведення тестових платежів.

   З налаштувань каси в розділі «Каси» важливі такі поля, як «Фіскальний номер» та «Ключ ліцензії». Їхні значення використовуються для реєстрації каси в системі Odoo. «Ключ ліцензії» - це 24-ох символьний ключ, який використовується для отримання доступу з’єднання з касою, з модуля «CheckBox» в Odoo.


    Наступний крок – додати касирів для вашої каси. Зареєструйте касирів в меню “Касири”, для цього перейдіть в меню «Каси» та натискаєте кнопку «Додати касира» і виконуєте всі дії в покроковій інструкції CheckBox. Після завершення касир буде доданий в список касирів.

  Потрібно звернути увагу на те, що для «Тестового касира» Логін та Пароль - аналогічно-ідентичні і вони будуть використовуватись для інтеграції в системі Odoo, щоб додати тестового касира. При налаштуванні активних кас та касирів використовуються значення із поля Логін та Пароль, які відрізняються один від одного.
    Для того щоб змінити Логін чи Пароль касира, необхідно перейти в Налаштовання, в розділі «Редагування касира».

    Обов’язковим елементом налаштування касира - це задати спосіб підпису чеків. Рекомендовано обирати «Запустити CheckboxПідпис на захищеному хмарному сервісі», для того щоб зменшити кількість додаткових операцій при проведені оплати. 

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

     Другим етапом буде встановлення Модулів «CheckBox» в систему Odoo. Для цього відкрийте Odoo та перейдіть в модуль «Додатки».  В пошуковому рядку введіть «checkbox» та натисніть пошук. Всі знайдені модулі мають бути в статусі «Встановлено». 

   Модуль «CheckBox» не працюватиме через стандартного користувача OdooBot, тому Вам необхідно здійснити вхід під реальним користувачем, щоб продовжувати взаємодію між модулями системи.

    Головне меню модуля «CheckBox» складається з наступних розділів: 

  • Надходження – відображається список всіх надходжень;

  • Z-Звіт – список всіх Z-звітів;

  • X-Звіт – список всіх X-звітів;

  • Налаштування – розділ налаштувань  основної функціональності модулю «CheckBox». Дана вкладка доступна для користувачу з правами доступу «Чекбокс. Адміністратор».

    Для початку роботи з модулем необхідно додати касира в систему Odoo.  Для цього слід перейти в головне меню «Checkbox» - «Налаштування» – «Касир». Натиснути кнопку «Створити».

    В вікні редагування, в поле «Ім’я користувача» - вставити значення з поля «Логін» в кабінеті Checkbox-у. В поле «Пароль» - вставити значення з поля «Пароль» в кабінеті Checkbox-у.  В полі «Користувач» вкажіть всіх користувачів системи Odoo, які будуть працювати під даним Логіном. Після введення всіх даних  натисніть кнопку «Зберегти».

    Наступна дія - натисніть кнопку «Оновити інформацію» для додавання касира в систему та синхронізації даних з сервісом Checkbox.  Після успішної синхронізації в карточку касира підтягнуться додаткові необхідні дані та організація, до якої належить касир. На початку роботи рекомендовано увімкнути логування. Для цього необхідно увімкнути функцію «Is Log Enabled».
    З налаштувань касира  також можна оновити інформацію актуального статуса зміни, для цього потрібно натиснути кнопку «Оновлення змін» та перейти до списку всіх змін даного касира. Натиснути «Зміни».

    Зміна (сесія) - це період часу, зазвичай це один день, протягом якого касир здійснює  продажі через Точку продаж. В розділі «Зміни» в табличному вигляді відображається список всіх змін, які були відкриті в Checkbox.  Натиснувши на будь-який запис можна перейти до перегляду деталізованої інформації по кожній зміні.
    В Точці продажу зміни відкриваються автоматично, але можна відкрити зміну і не через точку продажу.  Для цього необхідно натиснути кнопку «Створити».  У вікні створення нової зміни обрати касира та касовий апарат.  Натиснути кнопку «Оновити інформацію» та «Зберегти».


    Далі наступним важливим кроком  в налаштуванні Модуля є додавання до системи Odoo касового апарату. Для цього необхідно перейти в меню Налаштування – Касовий апарат  та натиснути кнопку «Створити». В поле «Ключ ліцензії» необхідно додати значення поля «Ключ ліцензії» з кабінету  Checkbox.  Виберіть відповідну організацію. На початку впровадження рекомендуємо  увімкнути логування,  для цього вмикаємо функціональність «Is Log Enable». 

    Після додавання всіх даних натискаємо кнопку «Оновити інформацію» та «Зберегти». Після збереження даних автоматично підтягується додаткова інформація по касі з кабінету Checkbox.

 

  • Кнопка «Оновити інформацію» - оновлює інформацію по касі в системі Odoo.

  • Кнопка «Оффлайн режим»  - дозволяє перевести касу в оффлайн роботу в ручному режимі. Після ввімкнення оффлайн режиму з’являється кнопка «Онлайн режим», яка надає можливість повернути касу до онлайн роботи.

  • Кнопка «Запит фіскальних номерів» -  ініціює запит фіскальних номерів.

  • Кнопка «Отримати фіскальні номери» -  ініціює отримання фіскальних номерів.

  • Кнопка «Отримування налаштувань податків»  - ініціює отримання налаштувань податків в кабінеті Checkbox для подальшого відображення в чеках при проведені оплати. Відображається в розділі «Налаштування» - «Податки»

  • Кнопка «Х-Звіти» - ініціює отримання Х-Звітів.  Відображається в розділі «Налаштування» - «Х-Звіт» 

  • Кнопка «Створення сервісного чеку» -  ініціює створення сервісного чеку. 

Увага!

Значення Вкладки «Налаштування автономного режиму” (Offline mode setting) з зазначеними «Кількість кодів» (Code Count) заповнюється автоматично на мінімальну та максимальну кількість кодів для фіскалізації. Ці коди використовуються для фіскалізації операцій, в момент коли електронна каса з якихось причин є «оффлайн» чи недоступна. При появі доступу до електронної каси по цим кодам всі операції будуть фіскалізовані та отримають QR-коди. Кількість необхідних кодів визначається кількістю операцій за одиницю часу і виставляється вручну. Програма замовить коди, коли їх кількість стане менше вказаної, і замовить стільки, щоб кількість дорівнювала максимально вказаній.

   

    В таблиці «Офлайн коди» відображається список оффлайн кодів, які були попередньо замовлені програмою для коректної роботи каси, якщо вона з якихось причин перейде в оффлайн режим роботи. При появі доступу до електронної каси  саме по цим кодам будуть фіскалізуватися всі офлайн оплати та отримувати QR-коди.
   В розділі «Податок» (вкладка "Налаштування") відображається список податків, які налаштовані в кабінеті Checkbox та отримані в систему Odoo після натискання кнопки «Отримування налаштувань податків» в налаштуваннях касового апарату.  

    В розділі «POS Checkbox категорія» (вкладка "Налаштування") відображається список категорій товарів налаштованих в кабінеті Checkbox.  Це категорії товарів по яким буде диференціюватися фіскалізація операцій. Наприклад: «Акцизні» та «Звичайні». Категорії фіскалізації застосовуються під різні податкові ставки для продажу товару, тобто підакцизні товари обліковуються по податковій ставці акцизу, товари з ПДВ відповідно до ставки податку на додану вартість, а для товарів, які підпадають під ставку єдиного податку - не використовується. Це меню не буде відображатись у вас на порталі. 

    Дані категорії доступні для подальшого налаштування в карточці товару на вкладці «Checkbox».

     В розділі «Log» фіксуються всі взаємодії  з модулем Checkbox.  В випадку виникнення будь-яких помилок на основі логів можна провести аналіз по усуненню помилок.

     Третім етапом буде створення «Журналу» для обліку коштів.  Перш за все перейдіть в модуль «Додатки» та в пошуковий рядок введіть «l10n_ua». Встановіть модуль фінансових журналів, якщо він ще не встановлений.

    Перейдіть в модуль «Виставлення рахунків» чи «Рахунки»,  назва залежить від версії Odoo,  далі в розділ «Налаштування» - «Журнали».  Натисніть кнопку «Створити». Вкажіть назву та тип журналу. Заповніть рахунки доходів та витрат.

    Перейдіть на вкладку «Checkbox» та встановіть галочку в полі «Квитанція Checkbox». Вкажіть організацію.  Для кожної точки продажу має бути створений свій набір журналів в яких буде фіксуватись оплата.
    Після заповнення всіх даних натисніть кнопку «Зберегти». 

    Четвертим етапом буде налаштування модуля "Точка продажу". Для цього слід перейти в головне меню модуля «Точка продажу», далі в розділ «Налаштування» - «Способи оплати». Натисніть кнопку «Створити». В полі «Метод» ввести назву способу оплати (наприклад, Готівка Чекбокс). В полі «Журнал» обрати журнал, який був створений в модулі «Виставлення рахунків» для цієї точки продажу з Checkbox.

    Увімкніть ознаку «Квитанція Checkbox» та в полі «Категорія товару» задайте категорію товару з якою буде працювати точка продажу. Якщо розподілу на акцизні і безакцизні товари не має, то слід залишити за замовчуванням «Default Category». Натисніть кнопку «Зберегти».  Аналогічно слід завести всі необхідні журнали. 
    Далі перейдіть на головну панель модуля Точки продажу та натиснувши три крапки в правому верхньому куті точки продажу, перейдіть до налаштувань.

    Прокручуєте в самий низ сторінки і в розділі «CheckBox Category» натискаєте кнопку «Додати рядок».  Обираєте касовий апарат, категорію товару та натискаєте кнопку «Зберегти та закрити».


    Перейдіть до розділу «Платежі» і додаєте методи оплати для цієї точки продажу. Касовий апарат підключений до точки продажу має співпадати з касовим апаратом вказаним в Журналі оплат. Натисніть «Зберегти». Дане налаштування підходить для 15 та 14 версії Odoo.

    

    Налаштування для Odoo версії 16. Перейти в головне меню модулю «Касовий термінал». Натиснути на три крапки в правому верхньому куті точки продажу та натиснути «Редагувати». У вікні редагування в розділі «CheckBox Category» натискаєте кнопку «Додати рядок»: Обираєте касовий апарат, категорію товару та натискаєте кнопку «Зберегти та закрити». Організація підтягується автоматично після вибору касового апарату.

    Після цього переходите в загальне меню  «Налаштування» – «Налаштування».  В розділі «Оплата» і додаєте методи оплати для цієї точки продажу. Касовий апарат підключений до точки продажу має співпадати з касовим апаратом, вказаним в Журналі оплат.

    Після завершення налаштувань натискаєте кнопку «Зберегти».

 Важливо! Якщо платіж пройшов в Odoo, але по якійсь причині не пройшов через Checkbox,  то в замовлені на вкладці "Checkbox" з'являється кнопка "Reshiping Checkbox". Натиснувши цю кнопку, платіж повторно надсилається в Checkbox і в полі "Recaipt"  з'являється номер чеку, а кнопка зникає.



    П'ятим етапом буде ознайомлення з Оплатою та Повернення товаруВ точці продажу надається можливість здійснення оплати та повернення товару наступних типів платежів: Готівковий, Безготівковий, Змішаний (готівковий + безготівковий). Для проведення оплати  необхідно перейти в модуль Точка продажу  - Точка продажу «Shop», натиснути кнопку «Нова сесія» - «Відкрити сесію». 
        Обираєте товар і натискаєте «Оплатити».  Вибираєте метод оплати з фіскалізацією: або Готівка чекбокс, або Банк Чекбокс, або  можете провести змішану оплату.


            Приклад тестового чеку:


    У випадку, якщо Ви закриваєте «Касу» - тобто «Сесію зміни каси» то потрібно натиснути «Закрити ctcs.» і «Підтвердити та зробити проведення», або також можете натиснути «Тримати сесію» та вийти в модуль «Точка продажу» і згодом продовжити роботу в поточній сесії.  Відповідно при продовженні продажу натискаєте «Продовжити продаж»,  щоб продовжити продаж.


    Щоб упевнитись, що фіскалізований продаж пройшов вдало в Точці продажу перейдіть  в розділ «Замовлення» та оберіть  «Замовлення». Відкрийте замовлення. На вкладці «CheckBox» в полі «Receipt» присутнє посилання на запис фіскалізованої оплати в модулі «CheckBox».  В полі «Kw CheckBox Organization» відображається назва організації, по якій була проведена оплата.

    Натиснувши на посилання в полі «Receipt» можна перейти на запис в модулі «CheckBox» та більш деталізовано переглянути посилання на фіскалізацію  в вкладці «URls», в розділі «Перегляд» чек та номер рахунка, якщо проводилась оплата з виставленням рахунку.

    Щоб здійснити операцію - Повернення,  необхідно відкрити сесію  в точці продажу. Натиснути кнопку «Refund» та в списку проведених замовлень обрати потрібне замовлення, ввести кількість до повернення та натиснути кнопку «Refund». У вікні оплати натиснути кнопку «Оплатити».

    Оберіть тип оплати «Готівка Чекбокс» та ввести значення, наприклад «-2»,  потім натиснути «Банк чекбокс» і автоматично порахується сума, яка має бути повернена безготівковим платежем.  Після цього натиснути кнопку «Підтвердити».    Оплата фіскалізується в Checkbox і проводиться як повернення. В Точці продажу відображається чек з QR кодом для клієнта. В модулі «CheckBox» дана операція проводиться з типом «Refund».

    Шостим заключним етапом буде ознайомлення з Модулем «Виставлення рахунків». Генерація оплати рахунка з фіскалізацією. Для цього перейдіть в меню Виставлення рахунків, перейдіть на вкладку Клієнти, та оберіть Рахунки. Натисніть кнопку «Створити». Заповніть всі необхідні дані для рахунку. Збережіть та підтвердіть створення рахунку. Після цього натисніть кнопку «Зареєструйте платіж».

    У вікні реєстрації  платежу заповніть всі поля та вкладки, натисніть кнопку «Створити платіж». В рахунку, на вкладці «Надходження» відображено запис про фіскалізацію по даному Рахунку.

    Щоб переконатись, що фіскалізація виставленого Рахунку пройшла вдало і зафіксувалась у модулі «Checkbox», необхідно перейти в модуль «Checkbox» - «Надходження». Відкрити запис з номером надходження із поля «Фіскальний код» в записі рахунку та перейти на вкладку «Рахунок-фактура». Вкладка містить запис-посилання на рахунок, по якому була здійснена оплата.