
Плагин для Shop-Script (Webasyst), который пробивает чеки по 54-ФЗ на вашей
физической ККТ Дримкас-Ф / Касса-Ф. Плагин общается напрямую с API Кабинета
Дримкас (kabinet.dreamkas.ru/api) под вашим API-токеном: без облачных касс,
сторонних сервисов и подписок — всё внутри вашего магазина.
Возможности
- Чек-аванс — при оплате заказа (тег 1214 = 1, полная предоплата).
- Чек-расчёта — при передаче товара: полный расчёт (1214 = 4) с зачётом предоплаты корневым тегом 1215; деньги в чеке не считаются дважды.
- Чек возврата — при возврате или отмене заказа (возврат прихода).
- Признак расчёта в «Интернет» (тег 1125) — для онлайн-оплат картой и через СБП; при оплате по счёту и наличными в пункте выдачи не ставится.
- Защита от дублей — контроль через штатный механизм Shop-Script
shopFiscalization. - Кнопки в карточке заказа: «Пробить» недостающий чек и «Проверить чеки заказа в Дримкасе» — показывает состояние чека: напечатан, в очереди или ошибка с причиной.
- Повтор фискализации на странице настроек, включая принудительный повтор для случая, когда Дримкас принял задание, а касса его не выполнила.
- Автоподбор кассы: после сохранения токена плагин запрашивает список касс аккаунта и показывает карточку устройства — модель, ФН, ФФД, ОФД, статус, срок ККТ, поддерживаемые системы налогообложения. Числовые ID вводить вручную не нужно.
- Журнал плагина — последние строки прямо на странице настроек.
Как это работает
Плагин подписывается на события заказа Shop-Script и на каждое отправляет документ в Кабинет Дримкас, а касса печатает чек и передаёт его в ОФД и ФНС.
| Событие заказа | Чек | Признак расчёта |
|---|---|---|
| Оплата | Приход | Предоплата 100 % (1214 = 1) |
| Передача, выдача, «Выполнен» | Приход | Полный расчёт (1214 = 4) и зачёт предоплаты (тег 1215) |
| Возврат | Возврат прихода | Полный расчёт |
| Отмена | Возврат прихода | Полный расчёт |
Ставка НДС каждой позиции берётся из налога, который Shop-Script посчитал при оформлении заказа. Если налога нет — подставляется запасная ставка из настроек (по умолчанию 22 %).
Требования
- Shop-Script 11 и выше (Webasyst Framework).
- PHP 7.4 и выше с расширениями
curlиjson(проверено на PHP 8.x). - ККТ Дримкас (Касса-Ф или Дримкас-Ф) в режиме фискального регистратора, подключённая к интернету, с фискальным накопителем и договором с ОФД.
- API-токен Кабинета Дримкас, сгенерированный владельцем аккаунта.
- Исходящий HTTPS-доступ сервера магазина к
kabinet.dreamkas.ru.
Ограничения
- Маркированные и подакцизные товары не поддерживаются: плагин не передаёт в чек коды маркировки и данные об акцизе. Для такого ассортимента чек будет неполным.
- Работает только с кассами Дримкас через API Кабинета Дримкас.
- Схемы налогообложения — ОСНО и УСН; ставка НДС берётся из позиции заказа.
- Частичный возврат плагин не оформляет: чек возврата закрывает заказ целиком, частичный возврат делается вручную на кассе.
Лицензия и покупка
Лицензия — стандартная лицензия Webasyst (проприетарная). Плагин продаётся в магазине Webasyst; ссылка на карточку появится на этой странице после публикации. Вопросы о покупке и лицензии — на support@dilibom.ru.
Документация
Установка, настройка, чеки и налоги, разбор ошибок — в разделе Документация. Перед покупкой можно оценить, подходит ли плагин: требования и ограничения выше.
Что менялось в версиях — на странице Обновления. Если что-то не работает: порядок обращения и список данных, которые нужно приложить, — на странице Поддержка по продукту.
Дримкас и Касса-Ф — товарные знаки их правообладателей. Q3T — разработчик плагина и не является производителем касс, ОФД или официальным представителем Дримкаса.
