Вся документация плагина «Чеки 54-ФЗ на кассе Дримкас» — на одной странице. Разделы ниже, можно перейти сразу к нужному:
Если ответа здесь нет — напишите в поддержку: адрес и список данных, которые стоит приложить, — на странице Поддержка по продукту.
Установка
Порядок установки
- Установите плагин в Shop-Script: через «Инсталлер» (архив
kassa-<версия>.tar.gz) или распакуйте архив в каталогwa-apps/shop/plugins/kassa/. - Зарегистрируйте плагин в файле
wa-config/apps/shop/plugins.php:
Пользовательский плагин в этот реестр сам не попадает — без строки он не появится в магазине.return array('kassa' => true); - Очистите кэш: Webasyst → Настройки → Очистить кэш.
- Откройте Магазин → Плагины → «Чеки 54-ФЗ на кассе Дримкас» и заполните настройки (раздел Настройка).
Проверка после установки
- Настройки сохранены, касса выбрана, в карточке устройства — статус «в сети».
- Тестовый заказ: оплатите заказ на небольшую сумму — должен уйти чек-аванс; в карточке заказа появится «чек-аванс — пробит», на кассе — бумажный чек. Автооткрытие смены сработает первым документом (оно должно быть включено на самой кассе).
- Переведите заказ в «Отправлен» или «Выполнен» — уйдёт чек-расчёта с зачётом предоплаты; в чеке «наличными 0, безналичными 0, сумма зачётом».
- Верните заказ — уйдёт чек возврата, сумма со знаком минус.
- Сверьтесь с ОФД: отчёт «Чеки» должен показать все документы со статусом «Принят».
Только после этой проверки переводите магазин на рабочий режим.
Настройка
Как получить токен Дримкас
- Войдите в Кабинет Дримкас под аккаунтом, к которому подключена касса.
- Настройки аккаунта → «API-токены» → «Сгенерировать токен».
- Скопируйте токен в настройки плагина и сохраните.
- Плагин сам загрузит список касс аккаунта — выберите нужную. ID кассы и ID магазина подставятся автоматически, рядом отобразится состояние устройства.
Токен выдаётся владельцу аккаунта, партнёрские договоры не нужны. Держите его в секрете: это доступ к вашим чекам. Плагин хранит токен в настройках магазина и никуда, кроме API Кабинета Дримкас, не передаёт.
Параметры плагина
| Параметр | Что означает |
|---|---|
| Токен Дримкас API | Bearer-токен вашего аккаунта Дримкас. |
| ID кассы (deviceId) | Подставляется автоматически при выборе кассы из списка; вручную — только если список получить не удалось. |
| ID магазина (shopId) | Подставляется автоматически из выбранной кассы; обязателен в запросе на печать чека. |
| API base URL | https://kabinet.dreamkas.ru/api — обычно не меняется. |
| Система налогообложения | Значение taxMode в чеке: ОСНО, УСН
(доходы), УСН (доходы минус расходы), ЕНВД, ЕСХН, патент. |
| НДС по умолчанию | Запасная ставка для позиций без своего налога: без НДС, 0, 5, 7, 10 или 22 %. |
| Форма оплаты в закрывающем чеке | «Аванс (предоплата)» — по умолчанию и рекомендуется; «Взаимозачёт» — если касса вашей модели иначе считает зачёт предоплаты. |
| Признак расчёта в «Интернет» (тег 1125) | Включён по умолчанию. Ставится только на онлайн-оплаты; для оплаты по счёту и наличных в пункте выдачи не добавляется. |
| Показывать блок чеков в карточке заказа | Галочка (по умолчанию включена). Если снять — блок не отображается, а чеки продолжают пробиваться автоматически; вручную пробить чек можно на странице настроек в блоке «Повторить фискализацию». |
Что проверить после сохранения
- в карточке устройства — модель, фискальный накопитель, срок ККТ, поддерживаемые системы налогообложения и статус «в сети»;
- «НДС по умолчанию» совпадает с вашей ставкой (с 01.01.2026 стандартная — 22 %);
- система налогообложения в настройках плагина совпадает с той, что зарегистрирована на кассе;
- на кассе включено автооткрытие смены — иначе первый чек не напечатается.
Чеки, налоги и возвраты
Какой чек на какое событие
| Событие в заказе | Чек | Признак расчёта |
|---|---|---|
| Заказ оплачен | Приход (чек-аванс) | Предоплата 100 % — тег 1214 = 1 |
| Заказ передан, выдан или «Выполнен» | Приход (чек-расчёта) | Полный расчёт — 1214 = 4, плюс зачёт предоплаты корневым тегом 1215 |
| Возврат заказа | Возврат прихода | Полный расчёт |
| Отмена заказа | Возврат прихода | Полный расчёт |
Зачёт предоплаты корневым тегом 1215 нужен, чтобы деньги в чеке не считались дважды: в чеке видно «наличными 0, безналичными 0, сумма зачётом». Если ваша касса считает зачёт иначе, в настройках есть вариант формы оплаты «Взаимозачёт (встречное предоставление)».
НДС
Плагин берёт налог каждой позиции из данных Shop-Script о заказе. Если у позиции нет своего налога — подставляется «НДС по умолчанию» из настроек плагина (по умолчанию 22 %, стандартная ставка с 01.01.2026). Ставки 0, 5, 7, 10 и 22 % распознаются автоматически, ставка 20 % приводится к действующей 22 %.
Система налогообложения чека (taxMode) задаётся в настройках плагина и должна
совпадать с той, что зарегистрирована на кассе: ОСНО, УСН (доходы), УСН (доходы минус расходы),
ЕНВД, ЕСХН или патент.
Признак расчёта в «Интернет» (тег 1125)
Тег 1125 ставится только на онлайн-оплаты — картой или через СБП. При оплате по счёту для юрлица и при наличных в пункте выдачи признак не добавляется: это соответствует приказу ФНС от 26.03.2025 № ЕД-7-20/236@. Настройка включена по умолчанию; отключать её стоит только если касса вашей модели не принимает такой чек.
Возвраты
- Возврат или отмена заказа в Shop-Script → чек возврата прихода с суммой со знаком минус.
- Частичный возврат плагин не оформляет: он закрывает заказ целиком, частичные суммы возвращаются вручную на кассе.
- Если чек возврата нужно пробить повторно (например, первый не напечатался), используйте «Повторить фискализацию» на странице настроек плагина — по номеру заказа.
Проверка чеков
В карточке заказа есть блок «Чеки Дримкаса»: строка на каждый чек со статусом «пробит / не пробит», идентификатором в Дримкасе и временем. Кнопка «Проверить чеки заказа в Дримкасе» спрашивает кабинет и показывает состояние: напечатан, в очереди или ошибка с причиной. Там же кнопка «Пробить» — отправляет недостающий чек.
Итоговая сверка — в личном кабинете ОФД: отчёт «Чеки» должен показывать все документы со статусом «Принят».
Ошибки и решения
Порядок разбора простой: сначала смотрим состояние чека в карточке заказа или кнопкой «Проверить чеки заказа в Дримкасе», затем — журнал плагина на странице настроек. Почти все случаи перечислены ниже.
Токен не принят (ошибка 401)
Токен неверный или отозван. Сгенерируйте новый в Кабинете Дримкас (Настройки аккаунта → «API-токены») и сохраните его в настройках плагина. После сохранения плагин заново загрузит список касс — убедитесь, что выбрана нужная.
Касса отклонила чек (ошибка 400)
Касса не принимает состав чека: чаще всего причина в системе налогообложения, форме оплаты или недопустимом для этой модели способе расчёта. Текст ответа API виден в журнале плагина и в блоке «Чеки Дримкаса». Что проверить:
- система налогообложения в настройках плагина совпадает с настройками кассы;
- форма оплаты в закрывающем чеке — «Аванс» или «Взаимозачёт» (попробуйте второй вариант);
- признак расчёта в «Интернет» (тег 1125) — включён для онлайн-оплат и выключен, если касса не поддерживает этот тег;
- ставка НДС позиции соответствует разрешённым на кассе.
Чек «в очереди»
Дримкас принял задание, касса ещё не напечатала. Это не ошибка: подождите и проверьте статус кнопкой «Проверить чеки заказа в Дримкасе». Повторять отправку в это время нельзя — касса может забрать первое задание, и получится два чека.
Чек не печатается, смена закрыта
Плагин не открывает смену. Включите автооткрытие смены на самой кассе: первый документ тогда откроет смену автоматически. Если автооткрытие выключено, чек не напечатается, сколько бы раз его ни отправляли.
Касса офлайн
Плагин отправляет задание в Кабинет Дримкас, а касса забирает его, когда появляется связь. Если касса давно офлайн, чек останется «в очереди» до её подключения. Проверьте интернет на кассе и статус устройства в настройках плагина (карточка устройства должна быть «в сети»).
Дубли чеков и принудительный повтор
От дублей защищает штатный механизм Shop-Script: отметка о фискализации хранится в заказе, и повторно чек не отправляется. Галочка «Перебить принудительно» нужна только в аварийном случае: Дримкас принял задание, но операция завершилась ошибкой на кассе — чека нет, а отметка стоит. Перед принудительным повтором убедитесь, что операция не висит в состоянии «в очереди», иначе касса напечатает второй чек.
Что смотреть и что прислать
- журнал плагина — последние строки на странице настроек плагина;
- блок «Чеки Дримкаса» в карточке заказа — статусы и идентификаторы чеков;
- статус кассы в карточке устройства (в сети / офлайн, срок ККТ, ОФД).
Если причина не нашлась — напишите в поддержку и приложите эти данные: без них разбор будет дольше.
Частые вопросы
Вопросы и ответы
Работает ли плагин с кассами других производителей?
Нет. Плагин работает только с кассами Дримкас (Дримкас-Ф и Касса-Ф) через API Кабинета Дримкас. С облачными кассами и кассами других вендоров он не взаимодействует.
Поддерживается ли маркировка и акцизы?
Нет. Плагин не передаёт в чек коды маркировки и данные об акцизе, поэтому для маркированных и подакцизных товаров чек будет неполным. Это ограничение зафиксировано сознательно: поддержка маркировки появится в следующих версиях, если будет востребована у покупателей.
Какую ставку НДС ставит плагин?
Ставка берётся из налога, который Shop-Script посчитал для позиции заказа. Если налога нет (старые заказы, товары без налога), подставляется «НДС по умолчанию» из настроек — по умолчанию 22 % (стандартная ставка с 01.01.2026). Ставки 0, 5, 7, 10 и 22 % распознаются автоматически, 20 % приводится к действующей 22 %.
Оформляет ли плагин частичный возврат?
Нет. Чек возврата пробивается при переводе заказа в «Возврат» или отмену и закрывает заказ целиком. Частичный возврат оформляется вручную на кассе.
Нужно ли открывать смену?
Отдельного открытия смены плагин не делает. Автооткрытие смены должно быть включено на самой кассе — Дримкас это поддерживает. Иначе первый чек не напечатается.
Что значит «чек в очереди»?
Кабинет Дримкас принял задание, но касса ещё не напечатала чек. Проверьте статус кнопкой «Проверить чеки заказа в Дримкасе»; повторять отправку в это время не нужно.
Куда уходят данные из магазина?
Только в API Кабинета Дримкас по HTTPS. Плагин не отправляет данные в сторонние сервисы, не требует подписок и не проксирует чеки через чужие серверы. API-токен хранится в настройках магазина.
Плагин официальный от Дримкаса?
Нет. Это разработка Q3T, совместимая с кассами Дримкас-Ф и Касса-Ф. Плагин не является официальным продуктом Дримкаса, партнёрские договоры для работы не нужны.