Розлив за два нажатия: панель кранов для нового РМК 1С:Розница 2.3 с автосписанием литров с кег и Честным знаком

Зачем это понадобилось

Пиво в кегах продаётся с маркировкой «Честного знака», и разливной магазин живёт по правилам частичного выбытия: кегу подключают к оборудованию розлива, каждая продажа уходит в чек с кодом этой кеги, а продать больше объёма кеги нельзя. Типовая 1С:Розница 2.3 всё это умеет, но в новом РМК продажа разливного выглядит так: кассир ищет сорт в подборе, вводит литры, отдельно добавляет бутылку, а если РМК не сопоставил строку с подключённой кегой — идёт к крану сканировать марку. При десяти кранах и пятничной очереди это медленно.

Мы сделали расширение, которое добавляет в форму нового РМК панель розлива. Кассир нажимает «Кран 3», потом «1 л» — и в чеке оказываются пиво с кодом подключённой кеги и бутылка нужного объёма. После пробития чека литры списываются с конкретной кеги, остаток видно на плитке крана, а продать больше, чем осталось, касса не даст. Всё остальное — проверка кодов, ПИоТ, фискализация, уведомления в ГИС МТ — остаётся типовым.

Ниже — как это устроено внутри и на какие грабли мы наступили по дороге.

Как типовая Розница работает с кегами

Кега — номенклатура с категорией ЧЗ «Пиво в кегах». В ОписаниеНоменклатурыИС у неё ёмкость и вариант частичного выбытия «НастроеннаяНоменклатура», а в НастройкиЧастичногоВыбытияПродукцииИС — номенклатура, которой содержимое продаётся литрами.

Подключение кеги к крану — запись регистра ВскрытыеПотребительскиеУпаковкиИС: код маркировки (ссылка на элемент справочника ШтрихкодыУпаковокТоваров), склад, статус «Подключено», срок реализации, комментарий и полный код маркировки в base64. Комментарий — свободная строка, и типовое РМК использует её как имя оборудования розлива. На этом и построено наше расширение: кега, подключённая с комментарием «Кран 6», — это кега шестого крана.

Дальше важный момент. В форме РМК есть процедура ДополнитьСтрокуНаСервереПослеДобавленияНаКлиенте с параметром ОбновитьДанныеРазливногоПива. Она находит подключённую кегу по комментарию (имя элемента пивной палитры) и подставляет её код в строку чека. Но вызывается эта ветка только когда строка получена из кэша палитры — флаг СтрокаТовараПолученаИзКэша. Если товар добавлен любым другим способом, код кеги не подставится, и РМК попросит отсканировать марку.

Вторая тонкость: марки в табличную часть АкцизныеМарки чека записываются, только если у строки взведена НеобходимостьВводаКодаМаркировки. А она взводится по категории ЧЗ самой разливной позиции. Если у «литров» не указана категория «Пиво в кегах», в чек код кеги не попадёт вовсе, и частичное выбытие в ЧЗ не отразится.

И третья: кассир не видит, сколько литров осталось на каждом кране, — остаток всплывает только предупреждением при добавлении строки.

Архитектура расширения

Расширение «Розлив в РМК» (префикс рзл_) — адаптация, режим совместимости 8.3.27. Типовые объекты не меняются, только заимствуются для встраивания.

Свои объекты:

— общий модуль рзл_РозливСервер — вся серверная логика: данные кранов, товары вкладок, запись проданных литров, снятие кеги, API помощника настройки;
— регистр сведений рзл_НастройкиРозлива — число кранов, порог «мало литров», тара, группы для вкладок; измерение Магазин, пустой магазин — общие настройки;
— регистр сведений рзл_ПроданоИзКег — проданные литры с разбивкой «чек × кега». Независимый, измерения Чек и КодКеги, ресурс Литры;
— общая форма рзл_ПомощникНастройкиРозлива — помощник для внедренца.

Заимствованные объекты и точки встраивания:

— обработка РабочееМестоКассира, форма ФормаРМК:
  - &После("ПриСозданииНаСервере") — строим панель;
  - &После("ПриОткрытии") — первая загрузка данных через обработчик ожидания: магазин и вид цены РМК заполняет только после выбора кассы;
  - &Вместо("ПерейтиВРежимОплатыПоКнопкеОплатить") и &Вместо("ПробитьЧекКлиент") с ПродолжитьВызов() — проверка остатков кег перед оплатой;
  - &После("ПробитьЧекНаКлиентеЗавершение") — обновить плитки после чека;
— документ ЧекККМ, модуль объекта: &После("ПриЗаписи") — запись проданных литров;
— план обмена ПоМагазину — в состав добавлены оба регистра расширения (для РИБ).

Общий модуль расширения нельзя пометить как привилегированный, поэтому экспортные методы, которые вызывает кассир, начинаются с УстановитьПривилегированныйРежим(Истина). Методы помощника, наоборот, сначала проверяют право пользователя на настройку и только потом включают привилегированный режим.

Панель в форме РМК

Форма нового РМК большая и живая — от релиза к релизу 1С переставляет в ней группы. Поэтому мы не правим форму в конфигураторе, а строим панель программно в ПриСозданииНаСервере. Если в форме не нашлись ожидаемые типовые группы, панель просто не создаётся и РМК работает как обычно: обновление конфигурации не превращается в «касса не открывается».

Первая версия добавляла панель внутрь страницы чека — и её не было видно на стартовом экране с пустым чеком. Решение — горизонтальная обёртка: создаём группу рзл_ОберткаСтраниц, переносим в неё типовую группу «Страницы» через Элементы.Переместить, а справа кладём панель фиксированной ширины.

Внутри панели — страницы «Краны · N», «Тара», «Фасовка», «Снеки», а под ними блок, видный всегда: выбранный кран, порции 0,5 / 1 / 1,5 л, «Пакет», «Стакан» и переключатель автотары.

Кнопки создаются сразу с запасом: 24 плитки кранов и по 36 плиток на каждую товарную вкладку, у каждой своя команда формы. На клиенте мы только меняем заголовки, цвета и видимость — это не требует серверных вызовов. Раскладка кранов адаптивная: до 8 кранов — по 2 в ряд, до 12 — по 3, больше — по 4. Перестановка кнопок между группами-рядами возможна только на сервере, поэтому делается один раз при смене раскладки, а не на каждую отрисовку.

Цвет плитки — состояние кеги: оранжевая — остаток меньше порога, красная — последний день срока реализации, серая — кега пустая, срок истёк или для кеги не настроена разливная номенклатура. Нажатие на пустой кран открывает типовую форму подключения кеги с уже подставленным комментарием «Кран N»; сканирование, документ и уведомление в ГИС МТ — типовые.

Горячие клавиши Alt+1…5 (порции, пакет, стакан) назначаются через СочетаниеКлавиш у созданных команд.

Плитка показывает остаток кеги за вычетом того, что уже лежит в текущем чеке. Чтобы цифра не врала после удаления строки или отмены чека, на клиенте раз в секунду работает лёгкий обработчик ожидания: он считает «снимок» чека (число строк и сумму количеств) и перерисовывает плитки, только если снимок изменился. На сервер он не ходит.

Подстановка кода кеги в чек

Кнопка порции делает следующее:

1. Проверяет, что в кеге хватит литров с учётом текущего чека.

2. Если включена автотара — добавляет бутылку нужного объёма. Тару добавляем первой, чтобы текущей осталась строка пива.

3. Добавляет строку разливной позиции через типовую процедуру СписокТоваровВыборКлиент, передавая в данных выбора ИмяЭлемента = «Кран N».

4. Подставляет код кеги.

С четвёртым пунктом пришлось повозиться. Как уже говорилось, типовая подстановка срабатывает только для товара из кэша пивной палитры. Подделывать флаг кэша не хотелось, поэтому мы делаем ровно тот шаг, который РМК выполнил бы для палитры: находим добавленную строку, делаем её текущей и вызываем ДополнитьСтрокуНаСервереПослеДобавленияНаКлиенте(Истина). Нюанс — строка появляется в чеке после завершения типовой обработки подбора, поэтому вызов идёт через ПодключитьОбработчикОжидания с задержкой 0,2 с.

Если код всё равно не подставился, есть запасной путь: берём полный код маркировки подключённой кеги из регистра (он хранится в base64), декодируем через МенеджерОборудованияКлиентСервер.Base64ВШтрихкод, нормализуем разделитель GS1 типовым ИнтерфейсРМКСлужебныйКлиентСервер.ЗаменитьСимволGS1 и кладём в КодМаркировки строки с флагом ТребуетсяПроверкаКодаМаркировки. Дальше код проверяет типовой механизм — так же, как если бы его отсканировали.

Грабли, на которые мы наступили:

— Кега подключена «вручную», без сканирования. Тогда в регистре нет ПолныйКодМаркировки, и типовое ОбщегоНазначенияРМКРТ.ЗаполнитьКодыМаркировкиПоДаннымИБ такую кегу молча пропускает. Касса просит скан марки, хотя кега на кране. Лечится переподключением кеги сканером; помощник настройки такие кеги подсвечивает.
— Нет категории ЧЗ у разливной позиции — код не попадает в АкцизныеМарки (см. выше). Проверяется помощником.
— Касса с типом «ККМ Offline» в новом РМК не видна вообще: выборка касс в СформироватьЗапросДанныеКассыККМ её исключает. Для тестов без оборудования подходит тип «ККМ без подключения оборудования».
— Данные выбора без ключа Упаковка дают «Поле объекта не обнаружено» в типовом коде — передаём ключ всегда.

Учёт проданных литров

Мы ведём свой маленький регистр рзл_ПроданоИзКег: в &После("ПриЗаписи") чека пишется набор записей с отбором по чеку. Учитываются только пробитые и архивные чеки продажи без пометки удаления; если чек перезаписан или отменён — набор перезаписывается, и литры «возвращаются» в кегу.

Литры берутся из табличной части АкцизныеМарки: ЧастичноеВыбытиеКоличество по каждой строке с кодом кеги.

Здесь мы наступили на самые неприятные грабли. В тесте литры исправно записывались, а остаток на плитке не уменьшался. Оказалось, РМК при пробитии может записать в чек код кеги другим элементом справочника ШтрихкодыУпаковокТоваров — например, нормализованным «(01)…(21)…», — а не тем, на который ссылается запись подключения. Ссылки разные, код по сути один.

Поэтому продажу сопоставляем с подключённой кегой не по ссылке, а по ключу кода: «01» + GTIN + «21» + серийный номер, без скобок, разделителей и криптохвоста. Функция понимает три формы записи:

Функция КлючКодаМаркировки(Знач Значение)
    Значение = СокрЛП(Строка(Значение));
    Если Лев(Значение, 4) = "(01)" Тогда
        // скобочный формат: всё до первого «(9…» (криптохвост)
        Позиция = СтрНайти(Значение, "(9", НаправлениеПоиска.СНачала, 19);
        Если Позиция > 0 Тогда
            Значение = Лев(Значение, Позиция - 1);
        КонецЕсли;
        Значение = СтрЗаменить(СтрЗаменить(Значение, "(", ""), ")", "");
        Возврат ?(СтрДлина(Значение) > 18, Значение, "");
    КонецЕсли;
    Если Лев(Значение, 2) <> "01" Тогда
        Возврат "";
    КонецЕсли;
    ПозицияGS = СтрНайти(Значение, Символ(29));
    Если ПозицияGS > 0 Тогда
        Значение = Лев(Значение, ПозицияGS - 1);
        Возврат ?(СтрДлина(Значение) > 18, Значение, "");
    КонецЕсли;
    // сырой код без разделителя: у пива серийный номер 7 символов
    Возврат ?(СтрДлина(Значение) >= 25, Лев(Значение, 25), "");
КонецФункции

Карта «ключ → кега» строится одним запросом по подключённым кегам, и только если в чеке вообще есть розлив.

Остаток кеги для панели — один запрос с временными таблицами: подключённые кеги с комментарием ПОДОБНО «Кран %», их разливная номенклатура и объём из НастройкиЧастичногоВыбытияПродукцииИС и ОписаниеНоменклатурыИС, плюс сумма проданных литров из нашего регистра. Кеги чужих магазинов отсекаются по складу (РМК пишет туда то магазин, то его склад продажи — проверяем оба).

Контроль перед оплатой. Если в чеке есть розлив, перед оплатой (и ещё раз перед пробитием) берём свежие остатки — из той же кеги может наливать соседняя касса — и сверяем с литрами в чеке по каждому крану. Не хватает или истёк срок — не пускаем дальше и пишем, что именно не так.

Помощник настройки

Настройку розлива в нашей сети будут делать не программисты, поэтому всё собрано в одну форму из пяти шагов: магазин; краны и тара; группы для вкладок; связка «кега → разлив»; проверка. Открывается кнопкой «b81; Настройка» прямо на панели РМК. Кнопка видна только тому, у кого есть право изменять магазины и номенклатуру (или администрирование), — кассир её не видит.

Форма в конфигураторе пустая: реквизиты создаются через ИзменитьРеквизиты, элементы — через Элементы.Добавить, события — через УстановитьДействие. Два наблюдения, которые сэкономят вам время:

— в расширении обработчик ПриСозданииНаСервере собственной формы нужно связать с событием в свойствах формы — одного имени процедуры недостаточно, иначе форма откроется пустой;
— для поля ввода ссылочного типа свойство ВыборГруппИЭлементов имеет тип ГруппыИЭлементы, а не ИспользованиеГруппИЭлементов, — иначе «Несоответствие типов» при создании.

Шаг «кега → разлив» делает то же, что ссылка «Подробнее» в карточке кеги, но в одной транзакции: ставит в ОписаниеНоменклатурыИС вариант НастроеннаяНоменклатура и ёмкость, а в НастройкиЧастичногоВыбытияПродукцииИС — связку. Категорию ЧЗ помощник сам не ставит (это карточка товара), но без неё связать не даст и объяснит, что делать. При выборе уже связанной кеги разлив и объём подставляются из регистров.

Проверка — таблица «статус / раздел / подробно / ссылка». Серверная функция возвращает массив структур, форма раскладывает его по порядку: сначала ошибки, потом замечания, потом «ОК». Цвет статуса — условным оформлением. По двойному щелчку открывается навигационная ссылка на объект, где ошибка исправляется (карточка кассы, магазина, номенклатуры или список документов установки цен).

Проверяется всё, из-за чего розлив обычно «не едет»: вид цены магазина, тип и рабочее место кассы, тара и её цены, группы вкладок, для каждой связки — вариант выбытия, объём, категория ЧЗ и цена разлива, для каждой кеги на кране — срок, полный код маркировки и остаток.

Категория «Пиво в кегах» определяется по представлению ключа видов продукции и идентификаторов видов продукции из ОписаниеНоменклатурыИС — без привязки к конкретному значению перечисления, которое в разных релизах называется по-разному.

РИБ, ПИоТ, производительность, безопасный режим

РИБ. Расширение с флагом «Используется в распределённой информационной базе» уезжает в узлы магазинов вместе с обменом. Но данные собственных регистров расширения по умолчанию в обмен не попадают — и тогда настройки, сделанные в центре, касса в магазине не увидит, а проданные литры не вернутся в центр. Поэтому в расширении заимствован план обмена ПоМагазину и в его состав добавлены оба регистра с авторегистрацией. Типовые регистры кег и частичного выбытия обмениваются штатно. В узле магазина после получения расширения нужно принять обновление конфигурации — как с любым изменением структуры.

ПИоТ. С конца 2025 года проверка кодов на кассе идёт через ТС ПИоТ. Расширение в эту часть не вмешивается: код кеги попадает в строку чека тем же путём, что при сканировании или выборе из пивной палитры, и дальше его проверяет типовой механизм — ЛМ ЧЗ, ПИоТ, онлайн-проверка, как настроено в базе.

Производительность. На чек с розливом — два серверных вызова: остатки перед оплатой и обновление плиток после пробития. Товары вкладок грузятся один раз при открытии РМК. Всё остальное — на клиенте.

Безопасный режим. Расширение должно работать без безопасного режима: в нём не включается привилегированный режим, на котором держится запись остатков кег от имени кассира. При загрузке через конфигуратор флажок «Безопасный режим» по умолчанию стоит — его нужно снять.

Установка и требования

Требования:

— 1С:Розница 2.3 ПРОФ, проверено на 2.3.25.23;
— платформа 8.3.27;
— новое РМК (управляемый режим);
— настроенная работа с маркировкой пива в кегах.

Установка:

1. Конфигуратор → Конфигурация → Расширения конфигурации → Добавить → Загрузить конфигурацию из файла (.cfe).

2. Снять флажок «Безопасный режим»; для РИБ — поставить «Используется в распределённой информационной базе».

3. Обновить конфигурацию базы данных. Расширение добавляет регистры, поэтому понадобится монопольный режим.

4. Открыть РМК администратором → «b81; Настройка» → пройти пять шагов, пока в проверке не останется красных строк.

Ограничения, о которых честно предупреждаем:

— только ПРОФ: в базовой версии расширения такого типа не подключаются;

— до 24 кранов и до 36 товаров на вкладку — первые по алфавиту, поэтому для вкладок лучше завести отдельные группы с ходовыми позициями;

— возврат разлива литры в кегу не возвращает: пиво в кегу физически не вернётся, а ЧЗ контролирует именно продажу сверх объёма;

— Розница 3.0 пока не поддерживается.

В комплекте: файл расширения с открытым кодом и инструкция по настройке с картинками (PDF ) — её можно сразу отдать тому, кто будет настраивать магазины.

Если нужно подключить и настроить расширение в вашей сети, добавить свои кнопки, отчёт по кегам или сделать версию под другую редакцию — используйте кнопку "Заказать консультацию".