Общая информация
| Параметр | Значение |
|---|---|
| Протокол | https://api.checkbox.in.ua/api/redoc |
| API URL | https://api.checkbox.in.ua/api/v1/ |
| Версия модуля | 1.01 |
| Версия биллинга | >1.10.00 |
Checkbox – программный сервис регистрации расчётных операций.
Сервис состоит с портала пользователя, транзакционного процессинга, агентов подписи та фронт-агентов.
Через портал my.checkbox.in.ua происходит регистрация торговца в системе и управления его точками продажи, кассами и кассирами.
Обеспечивается взаимодействие с ДПС.
Настройка модуля
- Завести модуль Extreceipt вместе с API и KKT. Объяснение данных которые нужно внести с checkbox: В API Логин и Пароль это Логін касира і пароль касира. В KKT ККТ Лицензия это Ключ ліцензії каси. Если у Вас одна касса, но нужно несколько админов, просто создатйте несколько ККТ с тем же ККТ Лицензия.
- Скопировать файл Checkbox.pm в папку /usr/abills/Abills/modules/Extreceipt/API/
- Добавить в crontab запуск следующей команды - обновление смен кассиров.
0 1 * * * /usr/abills/libexec/billd extreceipt_payments_reg RENEW_SHIFT=1
Далее через cpan Perl нужно установить модуль модуль
cpan install UUID::Tiny
Параметры в config.pl
| Параметр | Значение | Пример |
|---|---|---|
$conf{CHECKBOX_CARD_PAYMENT} | виды оплаты которые будут при созданнии чека с методом оплаты 'CASHLESS', вместо 'CASH' | '1, 2, 3, 5, 0' |
Управление кассами
Обслуживание>Чеки>Касса есть возможность посмотреть текущую сумму в кассе, а также в начале смены. Можно сделать полную инкассацию или внести-забрать определенную сумму с кассы.
Нажав на крестик можно сделать полную икассацию кассы.
Добавление или снятие сумм. Чтобы внести в кассу введете нужную сумму в целочисленном формате, а чтобы снять деньги с кассы, внесите сумму со знаком -
Чеки вносятся как служебные. Пример:
Также можно включить отображение в Быстрых отчётах.
Если платеж поступил не наличкою (метод оплаты 'CASH') в кассу, а карточкой (метод оплаты 'CARD') в кассе сумма не будет добавляться!
Отправка чеков через SMS или на вайбер
Чтобы начать отправку чеков, нужно подключить SMS-серсис, можно почитать здесь
| Параметр | Значение | Пример |
|---|---|---|
$conf{EXTRECEIPTS_SEND_USER} | Вид отправки чеков через SMS сервис, Viber или Sms | 'Viber' |
Налоговая ставка
Настроить налоговую ставку можно в настройках ККТ, после сохранение действительной лицензии кассы. После этого вы сможете выбрать вашу налоговую ставку в чеке. Включенные налоговые ставки получаются через API Checkbox. Включить необходимую налоговую ставку можете по ссылке https://my.checkbox.ua/dashboard/taxrates.
На примере указаны налоговые ставки "Без ПДВ" та "ПДВ 20%"
Исправление возможных ошибок
Если во время добавления платежа возникла одна из следующих ошибок:
- Зміна відкрита більше 24 год тому
- Зміна не відкрита
Запустите руками
/usr/abills/libexec/billd extreceipt_payments_reg RENEW_SHIFT=1 DEBUG=2
Если смена была открыта в Checkbox, то там и должна быть закрытой.
Если у вас возникла ошибка:
- Касир уже працює з даною касою
Закройте смену которую вы открыли в checkbox Каса
Ошибка:
- Ви видалили ККТ або АПІ, тому дії з даним чеком недоступні
Это ошибка со стороны биллинга, вы удалили API или KKT которое относилось к этому платежу, потому действия уже с этим платежом невозможны со стороны биллинга.
Не вижу раздел "чеки" в настройках?
Включите модуль в config.pl или права в администратора
Видео настройки модуля.