Отже, плагін:
Працювати з ним можна починаючи з версії Syrve 8.2.3, проте з 8.1.3 теж працюэ
Додатково ніяких ліцензій замовляти не потрібно (CheckBoxCashRegisterUA - потрібна для роботи, але завжди наявна)
Для версій Syrve нижче 9.0.2 - прошу брати плагіни за прямими посиланнями нижче
Або ж на нашому ФТП
Для версій Syrve 9.0.2 та вище - з репозиторію
*Для 917: v9 preview 2*Для 936: v9 preview 4
Розглянемо трошки детальніше вміст папки з плагіном. В новій редакції плагіну, в папці всього 3 файли і 1 папка
1) В старій редакції плагіну значно більше файлів
2) На фронті плагін не треба додатково налаштовувати
3) В бекофісі при встановленні податків, вони залізно зашиті в плагіні
Детальніше про це - згодом, а поки що перейдемо до процедури налаштування плагіну
Налаштування з боку CheckBox
Першочергово, щоб CheckBox налаштував на терміналі додаток Kasa Manager і додав туди необхідну касу. Це актуально як при заміні, так і при встановлені нової каси
Після цього, CheckBox має додати консольною командою COM-об’єкт в саму ОС. Це необхідно для того, щоб плагін побачив налаштовану касу. Далі - підхоплюємо ми
Налаштування плагіну на касі
- Розархівувати плагін
- Підкинути по шляху встановлення фронту (по замовчуванню це С://Program Files/iiko/iikoRMS/Front.Net/Plugins).
Якщо налаштовуємо старий плагін, то на цьому моменті можна запускати фронт і переходити до налаштування каси у SyrveOffice. Якщо плагін новий, то йдемо далі
Потрібно доналаштувати конфіг файл
Другий - це шлях до папки з профілем і конфігом самого менеджера каси
Ці дані можна знайти на касі клієнта. Відкриваємо менеджер каси Чекбокс, натискаємо справа зверху на кнопку Налаштування, зліва вибираємо вкладку Загальні. Там буде ключ ліцензії каси
<setting name="APIKey" serializeAs="String">
<value />
Стало лось так:
<setting name="APIKey" serializeAs="String">
<value>ac9e0cf3ae08f086a73d015f</value>
Обов'язково дописуємо \config.json
Було ось так:
<setting name="CheckBoxConfigPath" serializeAs="String">
<value />
Стало ось так:
<setting name="CheckBoxConfigPath" serializeAs="String">
<value>C:\checkbox.kasa.manager\profiles\ФОП Голуб\config.json</value>
На цьому все. Закриваємо конфіг із збереженням всього, стартуємо фронт і йдемо в бекофіс
Декілька ключів і шляхів в конфігу ми вказати НЕ МОЖЕМО. Тому якщо у клієнта декілька кас чекбокса має працювати (наприклад ТОВ/Алкогольний ФОП і поряд ще звичайний ФОП по кухні) - то в такому випадку ми беремо дані саме від ТОВ/Алкогольного фопу. Так треба, тому що ставка 8 - Без ПДВ є по замовчуванню на всіх касах і її рідко видаляють, а от ставки для акцизу/ПДВ - тільки на ТОВ/Алко ФОП
Треба також назначити принтер, на який друкуватимуться чеки. Для цього в налаштуваннях менеджера каси треба перейти на вкладку Друк, вибрати тип друку POS-принтер 80 (або POS-принтер 58, якщо ширина друку 58 мм) і вибрати один з встановлених Windows-драйверів принтера. Якщо драйвера ще немає - встановити.
Якщо у клієнта принтер підключений по COM-порту - попередити що друкувати буде повільно і порекомендувати підключити його по USB
1) стояти плагін округлення
2) Версія каса менеджера, версія програми і версія плагіну заокруглення, яка підтримує округлення до 50 копійок
то в такому випадку треба ОБОВ'ЯЗКОВО перевірити наявність відповідного налаштування в конфігу профілю каси
Наша задача - перевірити в ньому наявність в блоці custom, параметру "force_rouding_mode": "ROUND_50". Якщо є - значить все добре. Якщо ні - треба вписати. Правильний конфіг виглядає ось так:
"custom": {
"async_x_report": false,
"invert_nlpr": false,
"invert_conf_zeroing": false,
"open_shift_on_service_receipt": false,
"echo_command_extend_mode": false,
"discount_per_good_mode": false,
"ignore_cashier_info": true,
"tax_priority": [],
"x_report_when_shift_closed": false,
"alt_rounding": false,
"force_rounding": true,
"online_receipt_mode": true,
"online_receipt_timeout": 4,
"online_timeout": 6,
"shift_open_possibility": false,
"armo_mode": 0,
"format_exist_receipt_header": false,
"create_receipts_in_shift_day": true,
"run_from_any_user": false,
"replace_nullable_quantity": true,
"print_receipt_barcode": true,
"check_for_receipt_duplicate_by_header": false,
"parse_cashless_info_by_footer": false,
"save_in_txt_option": false,
"uknown_cash_register_key_position": false,
"extended_nbu_rounding": false,
"optimization_mode": false,
"force_non_fiscal_document": false,
"technical_return_description": true,
"use_service_receipt_value_validation": false,
"hide_service_information": false,
"force_rouding_mode": "ROUND_50" // <-- наше налаштування
}
Налаштування каси у SyrveOffice
Якщо після запуску фронта і плагіна додати нове обладнання, то у виборці ККМ, Принтер чеків буде в самому низу пункт CheckBox CashRegister (UA). Це саме те що нас цікавить.
ВАЖЛИВО
Починаючи з деяких версії плагіну, зокрема:- CheckBoxCashRegisterUA.V9Preview2.2.1.60
- CheckBoxCashRegisterUA.V9Preview4.2.1.68
- CheckBoxCashRegisterUA.V9Preview6.2.1.69
Налаштування проводимо згідно домовленостей про “Захист від дурня”
ВАЖЛИВО №2
В редакціях плагінів є відмінність в налаштуваннях податків. Нова версія плагіну тягне податки безпосередньо з порталу чекбокс, тому при виборі це виглядає ось так
Знати який код податку відповідає за який рядок
- ПДВ 0% = Код 8
- ПДВ 20% = Код 7
- ПДВ 0%+5% = Код 2
- ПДВ 20%+5% = Код 1
Налаштувати коди податків відповідно до таблички вище на порталі чекбоксу, тобто щоб між порталом і вибраним податком в плагіні була повна відповідність. Це робить клієнт, ми йому маємо тільки пояснити який податок на якому коді ма бути
На цьому налаштування завершене. Залишилось тільки вточнити у клієнта як він буде використовувати цю касу і виконати його побажання)