¶ Інтеграція Checkbox із 1С через REST API
¶ Про обробку
Обробка Checkbox FiscalPrinter REST_1.0.epf забезпечує фіскалізацію документів у 1С через локальний REST API каси Checkbox. Для документів «Чек ККМ» використовується стандартний механізм фіскалізації, а для документів «Видаткова накладна» - зовнішня друкована форма. Вона замінює CheckboxFiscalPrinter 1.0.x.epf і не потребує драйвера фіскального реєстратора.
ℹ️ Перед початком роботи: Переконайтеся, що Checkbox Kasa Manager встановлено, налаштовано, а каса доступна для роботи. Завантажте файл CheckboxFiscalPrinter_REST_1.0.epf для подальшого додавання в 1С.
¶ Підтримувані конфігурації 1С
Обробка підходить для таких конфігурацій:
- 1С УТП 1.x — Управління торговим підприємством 1.x.
- 1С УПП 1.x — Управління виробничим підприємством 1.x.
- 1С УТ 2.x — Управління торгівлею 2.x.
- 1С Роздріб 1.x — Роздрібна торгівля для України 1.x.
¶ Додавання ПРРО Checkbox до торгового обладнання
-
Зареєструйте обробку обслуговування торгового обладнання
У 1С відкрийте «Подключение и настройка торгового оборудования» → «Обработки обслуживания» → довідник «Обработки обслуживания торгового оборудования». Створіть новий запис із файлом CheckboxFiscalPrinter_REST_1.0.epf. У списку обробка відображається як «Checkbox: Fiscal Printer (REST)».
-
Додайте фіскальний реєстратор
У розділі «Фискальные регистраторы» додайте фіскальний реєстратор, виберіть модель «Checkbox Kasa (REST API)» та прив’яжіть його до відповідної торгової точки (ТТ).
-
Налаштуйте підключення до каси
У параметрах фіскального реєстратора задайте IP-адресу та порт локального API. На вкладці «Налоги» перевірте відповідність податкових груп і ставок ПДВ параметрам обліку.
-
Увімкніть відкриття зміни фіскальним чеком
На вкладці «Прочее» встановіть прапорець «Открытие смены фискальным чеком» та збережіть налаштування фіскального реєстратора.
Примітка. Збережіть налаштування фіскального реєстратора перед переходом до реєстрації зовнішньої друкованої форми.
¶ Фіскалізація документа «Чек ККМ»
Фіскалізація документа «Чек ККМ» виконується стандартним способом - через кнопку «Видати чек» або «Фіскалізувати чек», залежно від конфігурації 1С.
Використання зовнішньої друкованої форми для цього документа не потрібне.
-
Відкрийте довідник зовнішніх друкованих форм
Зверніть увагу! Використання зовнішньої друкованої форми необхідне лише для фіскалізації документа «Видаткова накладна», оскільки він не належить до блоку роздрібних продажів і не передбачає стандартного механізму фіскалізації. Для фіскалізації такого документа необхідно натиснути «Друк» та вибрати відповідний ПРРО Checkbox. Обробка автоматично ініціює процес фіскалізації, використовуючи дані документа.У меню «Сервіс» перейдіть до «Внешние печатные формы и обработки» → «Внешние печатные формы».
-
Зареєструйте зовнішню друковану форму Checkbox
Створіть новий запис і завантажте той самий файл CheckboxFiscalPrinter_REST_1.0.epf. Збережіть запис.
¶ Як це працює?
-
Виконайте фіскалізацію документа “Видаткова накладна”
Відкрийте документ «Реализация товаров и услуг». Натисніть «Печать», у списку форм оберіть «Checkbox: Fiscal Printer (REST)», потім натисніть «Печать». Після відкриття вікна вибору фіскального реєстратора оберіть «Checkbox Kasa (REST API)», що відповідає потрібній торговій точці, і підтвердіть вибір.
-
Перевірте результат
У властивостях документа з’являються додаткові поля «Checkbox_FiscalNumber» (фіскальний номер) та «Checkbox_Status» (статус фіскалізації).
Примітка. Статус у документі допомагає перевірити результат фіскалізації. Перед повторним надсиланням документа перевірте, чи не створено чек у Checkbox, щоб уникнути дублювання.
¶ Важливо
- Для реєстрації торгового обладнання та зовнішньої друкованої форми використовується один і той самий файл .epf.