¶ Продажа маркированных товаров. Разрешительный режим.
Минимальные системные требования
Платформа:
- Windows 10 версии 1607 или более поздней
- Windows 11
Разрядность: x64
Процессор: 4-ядра
ОЗУ \ ПЗУ: 8GB \ SSD 120 ГБ
Скачать модуль DkLinkMark:
dklinkmark_v1.1.7z
dklinkmark_(1.2).7z
С 1 апреля 2024 года начинает действовать разрешительный режим розничной продажи маркированных товаров.
Теперь при продаже маркированного товара на кассе будет проверяться код маркировки: если проверка не пройдена, продажа товара будет запрещена.
В статье расскажем, что потребуется для работы в кассовом модуле билетно-пропускной системы Барс.
¶ Принцип работы
1. Кассир продает товар, подлежащий обязательной маркировке
2. Кассовый модуль Барс потребует считать код маркировки товара
3. При считывании кода маркировки – он проверяется при помощи метода API ГИС МТ codes/check
4. При успешной проверке – позиция товара добавляется в спецификацию чека для дальнейшего расчета клиента
- Если код маркировки не проходит проверку – кассир увидит ошибку с соответствующим текстом
- Если ответ на запрос от ГИС МТ не получен дольше 1,5 секунд, то товар добавляется в спецификацию чека
¶ Режимы работы
| Режим работы | Интеграция с системой общепита | Работа с маркированными товарами через кассу Барс |
|---|---|---|
| Режим HoReCa (передача только GTIN) | Да | Нет |
| Режим розницы (передача полного кода маркировки) | Да | Да |
Режим HoReCa
Подразумевает связку ПО Барс – ПО R-keeper.
Принцип работы:
- Кассир на кассе r-keeper продает маркированный товар, считывает марку
- Код маркировки проверяется на валидность (разрешительный режим) посредством модуля RKdexch
- Код маркировки передается в ПО Барс посредством сервиса Bars.Http.Service
- При расчете долга за маркированный товар на кассе Барса - код маркировки отправляется в составе чека в ОФД
Для работы требуется:
- СПК Барс.Кассир версии не ниже 5.164
- Чековый принтер с ФН, подключенный к кассе Барса. ФН должен быть прошит в ЦТО для работы с маркированными товарами
- СПК Барс.Администратор версии не ниже 164
- Bars.Http.Service версии не ниже 5.164
- r_keeper — версии 7.07.00.336 или выше
- драйвер UniFR.7.73.460.0 или выше
- rkDExch — версии 1.0.4.5 или выше
Для работы разрешительного режима – на кассе R-keeper потребуется установить и настроить модуль RKdexch.
На стороне R-keeper выбирается режим работы - передача только GTIN или передача полного кода маркировки.
Режим розницы
Принцип работы:
- Кассир на кассе Барса продает маркированный товар, считывает марку.
- Код маркировки проверяется на валидность(разрешительный режим) посредством модуля Bars.DKLink. На кассе получаем ответ по итогам проверки.
- При расчете за товар - код маркировки передается в составе чека в ФОД.
Для работы требуется:
- СПК Барс.Кассир версии не ниже 5.164
- Чековый принтер с ФН, подключенный к кассе Барса. ФН должен быть прошит в ЦТО для работы с маркированными товарами.
- СПК Барс.Администратор версии не ниже 164
- Сервис Bars.DKLink.Mark версии не ниже 164
¶ Настройка и инструкции
Проверить работу разрешительного режима
- Продаем на кассе маркированные товар и оплачиваем, фискальный документ (чек) появляется в ЛК ОФД
- Заходим в личный кабинет ОФД
- При расчете за маркированную продукцию - в составе каждого чека есть тег 2107 Статус проверки в Честном знаке
Описание параметров Bars.DKLink.Mark
<?xml version="1.0" encoding="utf-8"?>
<Configuration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<ApiHost>https://markirovka.sandbox.crptech.ru</ApiHost>
<Timeout>10000</Timeout>
<ServicePort>50199</ServicePort>
<ServicePortNoSsl>50198</ServicePortNoSsl>
<HealthTimer>600000</HealthTimer>
<ClientTokens>
<ClientToken>
<Token>8b2b94c1-7032-4e34-979f-ed48a7332e00</Token>
<ClientId>35CF4068-A230-4433-AD84-437B5B5695D9</ClientId>
</ClientToken>
</ClientTokens>
<ServiceUrl>VID</ServiceUrl>
<Certificate>DKLinkMark.pfx</Certificate>
<Password>JKjk8*%h9k8^hm_2k</Password>
</Configuration>
| Параметр | Тип | Описание | Обязателен? | Пример |
|---|---|---|---|---|
| ApiHost | Строка | Хост сервиса ЦРПТ | Да | https://markirovka.sandbox.crptech.ru |
| Timeout | Строка | Тайм-аут запроса КМ, указывается в миллисекундах | Да | 10000 |
| ServicePort | Строка | Порт, на который служба принимает подключения по https | Да | 50199 |
| ServicePortNoSsl | Строка | Порт, на который служба принимает подключения по http | Да | 50198 |
| HealthTimer | Строка | Интервал обновления списка площадок, указывается в миллисекундах | Да | 600000 |
| ClientTokens | Объект | Авторизационные токены клиентов | Да | Отдельная сущность |
| ServiceUrl | Строка | url, которому выдан сертификат | Нет | Сетевое имя компьютера, где установлен сертификат |
| Certificate | Строка | Файл сертификата. Если не существует, будет создан | Нет | DKLinkMark.pfx |
| Password | Строка | Пароль к сертификату | Нет | JKjk8*%h9k8^hm_2k |
ClientsTokens
| Параметр | Тип | Описание | Обязателен? | Пример |
|---|---|---|---|---|
| Token | Строка | Токен доступа из ЛК ЧЗ | Да | 8b2b94c1-7032-4e34-979f-ed48a7332e33 |
| ClientsId | Строка | GUID организации в ПО Барс ВАЖНО! Для версии ПО БАРС 165 и выше, ClientsId должен быть указан в нижнем регистре без дефисов. |
Да | 35CF4068-A230-4433-AD84-437B5B569500 35cf4068a2304433ad84437b5b569500 - для Барс версии 165 и выше |
Установка сертификата
Для работы по подключению через https требуется установка сертификата. Для этого необходимо:- Добавить в файл конфигурации dklinkmark.cfg строки:
<ServiceUrl>VID</ServiceUrl> - имя локального компьютера
<Certificate>DKLinkMark.pfx</Certificate> - имя файла сертификата
<Password>JKjk8*%h9k8^hm_2k</Password> - пароль к сертификату
- Запустить модуль DkLinkMark
- После первого запуска, в папке DKLinkMark будет создан файл сертификата DKLinkMark.pfx
- Остановить модуль DkLinkMark
- Установить сертификат DKLinkMark.pfx от локального пользователя. При установке указать пароль из поля Password файла конфигурации dklinkmark.cfg
- Запустить модуль DkLinkMark
Настройка работы программного модуля Барс.Кассир с маркировкой товаров
1. Для начала потребуются установленные программные модули Барс – Барс.Администратор, Барс.Кассир, Bars.DKLink.Mark
2. Необходимо сконфигурировать сервис Bars.Dklink через файл конфигурации - dklinkmark.cfg
3. В программном модуле Барс.Администратор перейти в раздел Настройки и на вкладке Касса выбрать необходимый режим работы и указать порт сервиса Bars.DKLink.Mark
Пример: Выбор режима для версии ПО БАРС 5.164 и выше
Пример: Выбор режима для версии ПО БАРС 0.165 и выше
Где,
- Не контролировать: контроль доступа не осуществляется
- Онлайн режим проверки:
-- Запрет продажи. Если продажа товара с данным кодом маркировки ранее уже фиксировалась в системе, на кассе открывается сообщение «Продажа товара с данным кодом маркировки запрещена» и отображается причина блокировки, текст которой возвращается в поле description ответа сервиса DKLinkMark. При этом продажа данного товара будет невозможна.
-- Разрешение продажи с подтверждением. Если система не может проверить производилась ли ранее продажа товара с данным кодом маркировки (allowed=false и code с одним из значений 408, 7001 или 9000), на кассе открывается окно выбора: «Продать данный товар (возможен штраф)?»
-- Разрешение продажи. Проверка КМ успешно завершена. Товар разрешен к продаже (allowed = true) - Оффлайн режим проверки:
-- Запрет продажи. Если продажа товара с данным кодом маркировки ранее уже фиксировалась в системе, на кассе открывается сообщение «Продажа товара с данным кодом маркировки запрещена» и отображается причина блокировки, текст которой возвращается в поле description ответа сервиса DKLinkMark. При этом продажа данного товара будет невозможна (allowed = false)
-- Разрешение продажи. Проверка КМ успешно завершена. Товар разрешен к продаже (allowed = true)
4. Перейти в Справочники, Типы штучных товаров и в столбце Маркировка указать тип товарной группы для данного товара
Процесс продажи маркированного товара в программном модуле Барс.Кассир.
1. Выбираем нужный товар из списка номенклатуры или среди горячих клавиш
2. Считываем код маркировки с данного товара в появившемся окне
3. При успешной проверке кода маркированного товара – позиция товара добавится в спецификацию чека
4. При возникновении какой-либо проблемы при проверке кода маркировки – система сообщит об этом всплывающим информационным окном или ошибкой с соответствующим текстом.
¶ Особенности
- Для работы потребуется актуальные версии прошивок ФР: АТОЛ 5.8.100+ | Штрих: прошивка от 2023
- Swagger доступен по адресу: http://URL:ПОРТ/swagger/index.html
¶ Выбор площадки
- Для проверки КМ выбирается хост со статусом 0 с минимальным временем отклика
- Состояние площадок обновляется с интервалом, указанным в параметре <HealthTimer>
- Список площадок загружается при старте службы или если доступных площадок в списке не осталось
- Площадка помечается недоступной, если при проверке КМ она не ответила вовремя или ответила кодом ошибки до следующего обновления статуса
¶ История изменений
Версия 1.1
1. Отключена подпись разработчика
2. Реализована работа по протоколу HTTPS
3. Исправлен функционал запуска сервиса в виде службы