↑↓ выборEnter открытьEsc закрыть

    1. Elbuz

    Как подключить кассу Checkbox к Elbuz

    6 мин чтенияОбновлено

    Checkbox (Чекбокс) — программный РРО: касса подключается к Elbuz данными кассира и ключом лицензии, после чего фискальный чек выдаётся прямо из карточки заказа. Кассу, кассира и подпись вы настраиваете в кабинете my.checkbox.ua, смену Elbuz открывает сам.

    Что это даёт:

    • Кассы ещё нет — кабинет сам подаёт формы в налоговую, бесплатный ключ DepositSign не требует файла.
    • Хотите сначала попробовать — тестовые касса и кассир появляются сразу после регистрации, налоговая не нужна.
    • Касса уже работает — вписываете её данные, и чеки идут из Elbuz через неё.

    С чего начать: возьмите данные тестового кассира и впишите их в форму Checkbox в Elbuz.

    Что умеет подключение Checkbox

    Как зарегистрировать кассу и кассира в Checkbox

    Регистрация проходит в кабинете Checkbox, формы в налоговую он подаёт сам. Шаги ниже — по справке Checkbox на 06.11.2026: начало работы, кассы, кассиры. Надписи кабинета Checkbox приведены так, как они выглядят в кабинете, по-украински.

    1. Кабинет. Зарегистрируйтесь на my.checkbox.ua и добавьте данные компании из налоговой: понадобится ключ директора.
    2. Торговая точка. Точки, уже зарегистрированные в налоговой, подтягиваются при синхронизации. Новая регистрируется формой 20-ОПП из кабинета.
    3. Касса. Раздел «Каси» → «Додати касу», торговая точка из списка, тип ПРРО «Інтернет-торгівля». Запрос подписывается файловым ключом, Дія.Підписом или SmartID. Статус «На реєстрації» меняется на «Активна» примерно за 5–10 минут.
    4. Кассир и ключ. Раздел «Касири» → «Додати касира», дальше «Створити ключ DepositSign» или «Через ключ ЕЦП». Придумайте логин, пароль и подпишите запрос.
    5. Checkbox.Підпис. Если ключ файловый: в строке кассира три точки → «Запустити Checkbox.Підпис на захищеному хмарному сервісі», АЦСК, файл, пароль, «Запустити». Через 3–5 минут у кассира появится статус «Агент підпису працює».
    6. Ставки. По умолчанию в кабинете есть только «Без ПДВ». Плательщик НДС добавляет свои ставки: менять их можно при закрытой смене, изменения действуют со следующей.
    Для DepositSign не пропустите последний шаг в кабинете: после согласия с условиями нажмите чёрную кнопку статуса «Відправити в ДПС». Пока кассир не зарегистрирован, смена не откроется и чек не выйдет. Подробности — в справке о кассирах.

    Кассир работает только с одной кассой одновременно. ФЛП (ФОП) может регистрировать кассира на собственный ключ, для ТОВ справка требует отдельную печать на каждую кассу.

    Какие данные нужны Elbuz и где они лежат

    Поле в ElbuzЧто вписатьГде взять
    Логин кассираЛогин кассира. Оставьте пустым, если входите по PINпридумали при добавлении кассира, раздел «Касири»
    Пароль кассира или PINПароль кассира или, при пустом логине, PIN-кодпридумали при добавлении кассира; пароль не восстанавливается, только заменяется: «Касири» → «Дії» → «Редагувати» → «Новий пароль»
    Ключ лицензии кассыКлюч той кассы, через которую идут чекикабинет my.checkbox.ua, раздел «Каси»
    Ключ интеграции (необязательно)Оставьте пустым, если служба поддержки Checkbox его не выдаваласлужба поддержки Checkbox

    Логин кассира уникален во всём Checkbox. Где именно на экране лежат ключ лицензии и PIN-код, опубликованная справка не показывает. Не нашли их в кабинете — спросите службу заботы Checkbox.

    Как настроить кассу в Elbuz

    Где: Кабинет → Настройки системы → «Прочие настройки» → плитка «Внешние сервисы и интеграции» → группа «Фискальные чеки» → строка «Checkbox», карандаш.

    Форма «Подключение Checkbox»: переключатель активности, логин кассира, пароль или PIN, ключ лицензии кассы, ключ интеграции, фирма и переключатели настроек
    1Логин кассира
    2Пароль кассира или PIN
    3Ключ лицензии кассы
    4Ключ интеграции (необязательно)
    1. Логин кассира — оставьте пустым, чтобы входить только по PIN, вписанному в соседнее поле пароля.
    2. Пароль кассира или PIN — сохранённое значение больше не показывается.
    3. Ключ лицензии кассы — у каждой кассы свой.
    4. Ключ интеграции — заполняйте, только если его выдала служба поддержки Checkbox.

    Форма сохраняется сама: внизу появляется «Сохранено». Сохранённые пароль и ключ лицензии в полях не показываются. Новые значения сбрасывают сессию кассира, и следующий запрос войдёт уже с ними.

    ПолеЧто делаетСначала
    АктивностьВыключена — касса не предлагается, кнопка чека пропадает. Уже выданные чеки остаются в документахвыключено
    Фирма«Любая» — для всех документов; конкретная — только для документов этой фирмыЛюбая
    Плательщик НДСВключено — ставка берётся из строки документа или товара. Выключено — все строки идут без НДСвыключено
    Чек при оплате по ссылкеЧек выдаётся сам при оплате через ссылку на оплатувыключено
    Закрывать смену каждый вечерЗадание крона формирует Z-отчёт в 22:30 или 23:30 по Киеву. Кроме того, при открытии смены Checkbox получает время автозакрытия 23:30включено
    Наложенный платёжРежим для посылок с наложенным платежом, его выбирает бухгалтерЧек при отправке
    Плательщик НДС включил переключатель, а в кабинете Checkbox осталось только «Без ПДВ». Чек остановится на ошибке «VAT rate … is not set up». Добавьте ставку в кабинете при закрытой смене: Elbuz ищет там точно такую же ставку, как в строке.

    Блок «Смена» под формой показывает «Смена открыта» или «Смена закрыта». Если там текст ошибки, данные кассира или ключ лицензии не подходят. Это первая проверка, чек для неё не нужен.

    Как выдать первый чек в тестовом режиме

    Тестовые касса и кассир появляются в разделах «Каси» и «Касири» сразу после регистрации, КЭП для них не нужен. Лимит — 100 тестовых чеков в месяц. Покупателю тестовый чек выдавать нельзя: это не расчётный документ.

    1. Впишите в форму Checkbox данные тестового кассира и ключ лицензии тестовой кассы, включите «Активность».
    2. Откройте заказ покупателя в гривнах, нажмите «Фискальный чек». Для проверки возьмите свой заказ.
    3. Проверьте способ оплаты.
    4. Выключите «Отправить чек на», если в документе контакт настоящего покупателя.
    5. Нажмите «Выдать чек» и подождите. Первый чек за смену идёт дольше: сначала Elbuz открывает смену.

    Результат: номер, сумма, дата, пометка «тестовый, нефискальный» и ссылка «Открыть чек». Тот же чек с пометкой «Тестовий чек» есть в кабинете, в «Архіві чеків». Он не мешает выдать настоящий чек по этому документу.

    Результат фискального чека: номер чека продажи, сумма и дата, пометка «тестовый, нефискальный» и ссылка «Открыть чек»
    1Номер чека
    2тестовый, нефискальный
    3Открыть чек
    1. Номер, сумма и дата чека сохраняются в документе.
    2. «тестовый, нефискальный» — это тестовая касса: чек не уходит в налоговую.
    3. «Открыть чек» — ссылка на выданный чек.

    Чтобы перейти на настоящую кассу, закройте тестовую смену, замените в форме данные кассира и ключ лицензии и убедитесь, что блок «Смена» не показывает ошибки.

    Сценарии

    ФЛП сам продаёт через сайт

    Что сделать. Зарегистрируйте кассу с типом «Інтернет-торгівля», кассира на собственный ключ, запустите Checkbox.Підпис, впишите данные в Elbuz.

    Что получится. Чеки подписываются сами, держать включённым компьютер с ключом не нужно.

    Кассир не хочет передавать пароль от кабинета

    Что сделать. Оставьте «Логин кассира» пустым, а в «Пароль кассира или PIN» впишите PIN-код.

    Что получится. Elbuz входит по паре «ключ лицензии + PIN». Этот способ справка Checkbox называет рекомендованным.

    Касса уже работает в приложении Checkbox

    Что сделать. Закройте смену и подключите в Elbuz того же кассира или второго на вторую кассу: один кассир одновременно работает только с одной кассой.

    Что получится. Чеки из заказов видны и в Elbuz, и в кабинете. Чеки, выданные раньше в приложении, Elbuz не видит, а данные такого чека Checkbox от Elbuz не принимает. Как оформить возврат по нему, описано в разделе о чеке другой программы.

    Что делать, если касса не работает

    Сообщения при подключении
    Что вы видитеПочему такЧто сделать
    «Касса не подключена. Включите её и впишите ключ во «Внешние сервисы» → «Фискальные чеки».» Касса выключена, не вписан пароль или ключ лицензии либо фирма кассы не подходит документу Проверьте форму кассы (настройки)
    «Checkbox: sign in HTTP …» Checkbox не принял логин, пароль, PIN или ключ лицензии Перепишите данные (где они лежат). Для PIN оставьте логин пустым
    «Checkbox: shift was not opened, check the signing key in the Checkbox account» Сервис отказал в открытии смены, обычно из-за ключа подписи Проверьте статус «Агент підпису працює» и срок ключа в кабинете (регистрация)
    «Checkbox: VAT rate … is not set up in the Checkbox account» Такой ставки нет в кабинете Checkbox Добавьте ставку при закрытой смене и нажмите «Выдать чек» ещё раз
    «Чек не подтверждён: Checkbox: receipt is still being fiscalized. Нажмите ещё раз: повтор не создаст второй чек.» Сервис не успел обработать чек за время ожидания Подождите несколько минут и нажмите «Выдать чек» снова: Elbuz найдёт тот же чек

    Сообщения о самом чеке в документе разобраны в статье о чеках.

    Частые вопросы

    Что такое «Ключ интеграции» и где его взять?

    Это необязательный ключ, который выдаёт служба поддержки Checkbox. Если вам его не давали, оставьте поле пустым: касса работает и без него.

    Кто отправляет чек покупателю?

    Сам Checkbox, на email и телефон, которые Elbuz передал из документа. Передаётся только украинский телефон, в формате +380.

    Нужно ли открывать смену перед чеком?

    Нет. Если смена закрыта, Elbuz сам откроет её перед чеком и дождётся подтверждения сервиса.

    Закончился срок действия ключа КЭП. Что изменится в Elbuz?

    В Elbuz ничего менять не нужно. Замените ключ в кабинете Checkbox при закрытой смене. Пока ключ не заменён, смена может не открыться.

    Что будет, если выключить «Активность»?

    Кнопка чека пропадёт из новых документов, автоматические чеки прекратятся. Документы с выданными чеками кнопку сохраняют, данные в форме остаются. Включение возвращает всё как было.

    Где это и у кого доступ

    Меню
    Кабинет → Настройки системы → «Прочие настройки» → «Внешние сервисы и интеграции» → группа «Фискальные чеки» → Checkbox
    Право доступа
    окно «API и токены доступа» в «Правах групп»
    Подготовить
    кабинет my.checkbox.ua; для настоящей кассы — ключ КЭП/ЭЦП директора или ФЛП

    Смежные темы

    Статья оказалась полезной?

    Не хватает функции? Напишите нам.

    Мы добавим её бесплатно, если она пригодится и другим.

    Если это нужно только вам — договоримся отдельно.

    Содержание статьи

    Предложить доработку

    Попробовать бесплатно