Тестирование проводилось на платформе 1С:Предприятие 8.3 (8.3.27.1719)

Расширение содержит структуры и алгоритмы для работы с маркировкой в самописной конфигурации:

1. API ТС "ПИоТ" v2:
   1. Проверка кода (/api/v2/codes/check).
   2. Регистрация продажи (/api/v2/lmSell).
   3. Регистрация возврата (/api/v2/lmReturn).
2. Форма сканирования марок:
   1. Работа со сканером штрихкодов.
   2. Автоматическая проверка дублей.
   3. Цветовая индикация статуса ввода.
3. Пример для ККТ:
   1. Готовый кусок кода получения Base64 марки для встраивания в вашу фискализацию.
   2. Сама отправка в ККТ не реализована (только шаблон).

Что нужно доделать программисту

1. Перенести недостающие реквизиты в ваш документ “Чек”.
2. Настроить условное оформление строк.
3. Встроить получение Base64 в процедуру печати фискального чека вашей конкретной ККТ.

Для применения этого расширения к вашей конфигурации требуются интеграционные работы.

В данном расширении нет реализации ФФД. Подразумевается, что формат ФФД 1.2 уже реализован в вашей конфигурации. В модуле формы документа r1065_Чек в области ДляККТ оставлен пример получения кода маркировки в формате Base64 для передачи в ККТ.

Расширение НЕ отправляет теги ФФД в ККТ. Разработчик должен самостоятельно встроить полученный Base64 (из примера в модуле) в структуру фискального документа согласно требованиям вашей ККТ.

В этом расширении реализованы три api ТС “ПИоТ” версии v2 на основании документа “Протокол интеграции ЕСМ для разработчиков ПМСР v1.1” скачать протокол

1. /api/v2/codes/check - проверка кода.
2. /api/v2/lmSell - регистрация продажи.
3. /api/v2/lmReturn - регистрация возврата.

Вы можете самостоятельно запросить актуальную версию протокола и другую информацию для организации взаимодействия с ТС “ПИоТ”, отправив запрос на адрес эл. почты разработчика integration@ao-esp.ru.

Тесты проводились только на эмуляторе “ЕСМ”  https://esm-emu.ao-esp.ru/.

в онлайн: https://esm-emu.ao-esp.ru/api/v2/codes/check

в офлайн: https://esm-emu.ao-esp.ru/api/v2/codes/ checkoffline.

Подготовительный этап для внедрения расширения

1. Для наглядного отображения строк табличной части вашего документа добавьте условное оформление как в образце (документ расширения r1065_Чек). Условное оформление не влияет на логику работы, но необходимо для корректного отображения статуса строки оператору.
   1. Условное оформление строк ТЧ Товары:
      1. Если Маркировка = Истина И МаркировкаЗаполнена = Истина - светло зеленый.
      2. Если Маркировка = Истина И МаркировкаЗаполнена = Ложь И КодМаркировкиОтсутствует = Истина - светло зеленый.
      3. Если Маркировка = Истина И МаркировкаЗаполнена = Ложь И КодМаркировкиОтсутствует = Ложь - светло красный.
2. Если при попытке проведения документа будет не заполнена маркировка или не установлена галочка КодМаркировкиОтсутствует, тогда автоматически откроется форма ввода маркировки и документ не будет проведен. Допишите код, чтобы перед фискализацией выполнялась такая проверка.
3. В табличную часть документа Чек добавить следующие реквизиты (пример и типы данных см. в расширении):
   1. УидСтроки
   2. Маркировка - если товар подлежит маркировке, тогда этот реквизит имеет значение Истина.
   3. КодМаркировкиОтсутствует - в этом реквизите галочка Истина если товар маркируемый, но код отсутствует. Если товар не маркируемый, тогда эта галочка недоступна.

Форма ввода кода маркировки

1. Для ввода кода маркировки в форме документа Чек нажмите команду ДобавитьДанныеМаркировки. Ее нажатие открывает специальную форму, в которой отображается информация о текущей номенклатуре:
   1. наименование
   2. наименование производителя
   3. номер производителя
2. Код маркировки вводится сканером. Ввод тестировался на драйвере “1С:Сканеры штрихкода (COM)” скачать драйвер.
3. Код маркировки хранится в регистре сведений ДанныеМаркировкиНоменклатуры.
4. После сканирования перед добавлением кода выполняется автоматическая проверка:
   1. Не был ли такой код добавлен ранее другой номенклатуре в текущем чеке. Если был, то выводится сообщение: "Такой код маркировки уже присвоен!" и код не присваивается повторно.
   2. Не был ли присвоен код номенклатуре ранее в текущем чеке. Если был, то выводится сообщение: "Этой номенклатуре уже присвоен код маркировки!" и код не присваивается повторно.
   3. Если код был присвоен по ошибке, то красным крестиком отменяется его связь с номенклатурой.

5. Кнопками Далее и Назад можно переключаться между номенклатурой, для которой требуется присвоить код маркировки.
6. Маркировка присваивается “на лету”, т.е. при чтении кода она автоматически записывается в регистр сведений ДанныеМаркировкиНоменклатуры.
7. Если код не присвоен, то напротив наименования номенклатуры отображается желтый восклицательный знак.

8. Если маркировка для номенклатуры присвоена, то рядом с названием номенклатуры отображается зеленая галочка.

9. После присвоения кода зеленая галочка отображается одну секунду  и выполняется автоматический переход к следующей номенклатуре.
10. Нажатие кнопки Ок закрывает форму ввода маркировки и обновляет условное оформление в форме документа Чек.

.

11. Если в документе нет номенклатуры, подлежащей маркировке, тогда после нажатия команды ДобавитьДанныеМаркировки открывается окно с сообщением: “Отсутствует маркируемая номенклатура”.

12. Рекомендованный порядок заполнения данных маркировки.
    1. Сначала через форму ввода маркировки вводятся коды сканером.
    2. Затем устанавливаются галочки об отсутствии маркировки в форме документа (если это актуально).

ТС ПИоТ

1. Для работы с “ТС ПИоТ” используется стандарт API v2.
2. Для активации проверки кодов маркировки требуется установить галочку Использовать "ТС ПИоТ". 

3. Проверка выполняется (/api/v2/codes/check):
   1. В форме ввода маркировки. 
      1. Если введена маркировка которую невозможно продать, тогда появляется сообщение с описанием причины запрета или с описанием ошибки, препятствующей этому и маркировка не присваивается.
      2. Если запись в РС ДанныеМаркировкиНоменклатуры существует, значит проверка была пройдена успешно. В комментарии сохраняется история добавления строки.

2. Также в карточке записи регистра сведений ДанныеМаркировкиНоменклатуры можно выполнить все три запроса - check, lmSell, lmReturn.

4. Учитывая то, что есть условия при которых ТС “ПИоТ” может разрешить продажу маркировки в ОнЛайн, ОффЛайн и в Аварийном режиме (без ее проверки), то в записи регистра сведений ДанныеМаркировкиНоменклатуры в поле Комментарий ведется история и результаты выполнения запросов ТС “ПИоТ”.

5. Перед отправкой чека на фискализацию проверка кодов маркировки не выполняется, т.к. они проверяются перед добавлением в Чек в форме ввода маркировки.
6. Рекомендуется в случае ошибок lmSell, lmReturn при закрытии кассовой смены или регламентным заданием выполнять повторную отправку запроса. В расширении реализована обработка только отправки запроса в момент фискализации. Механизм повторной отправки (регламентное задание) не входит в данное расширение и должен быть реализован отдельно.

7. Если ТС “ПИоТ” не используется тогда:
   1. Проверка кода маркировки выполняться не будет. В регистр сведений ДанныеМаркировкиНоменклатуры будет добавляться маркировка с соответствующем Комментарием.

2. При продаже или возврате такой маркировки обращение к ТС “ПИоТ” тоже не будет выполняться, а в регистр сведений ДанныеМаркировкиНоменклатуры будут добавлены соответствующие сообщения с признаком “Ошибка”.

8. Запросы в ЛМ ЧЗ lmSell, lmReturn выполняются только после успешной фискализации чека на ККТ.

Если используется ТС “ПИоТ”, то при недоступности сервера ТС “ПИоТ” выводится сообщение об ошибке и маркировка не присваивается номенклатуре.