Обязательная маркировка товаров -...

Утверждаю______________________

______________________

______________________

«___» ____________ 2018

ПРОЕКТМетодика тестирования процессов

генерации, нанесения и верификации криптозащищенного кода маркировки

Рабочая документация ООО «Оператор-ЦРПТ»

Содержание1. Термины и сокращения.....................................................................................................................2

2. Общая информация...........................................................................................................................5

3. Характеристика объекта автоматизации.........................................................................................7

4. Сетевое подключение комплекса технических средств РЭ...........................................................8

5. Порядок тестирования процессов при подготовке производства...............................................10

6. Порядок тестирования процессов при маркировке товаров.......................................................12

7. Порядок тестирования процессов оптового оборота и дистрибуции.........................................15

8. Общие требования к настройке оборудования сериализации и агрегации...............................15

9. Порядок подключения к тестовому стенду сервиса генерации...................................................18

1. Термины и сокращения

Термин или сокращение

Описание

Агрегирование Процесс объединения ЛП в групповую упаковку с сохранением информации о взаимосвязи средств идентификации каждого вложенного ЛП с групповым кодом создаваемой групповой упаковкой и нанесением соответствующего группового кода на групповую упаковку.

АСУТП Автоматизированная система управления технологическими процессами.

Вторичная (потребительская) упаковка

Упаковка, поступающая к потребителю и служащая для размещения единичной первичной упаковки ЛП или объединяющая несколько первичных упаковок ЛП.

Глобальный идентификационный номер торговой единицы (GTIN)

Уникальный код, позволяющий идентифицировать как минимум производителя, торговое наименование ЛП, лекарственную форму, дозировку лекарственного средства и комплектность упаковки ЛП.

Групповой код Уникальный идентификатор третичной (заводской, транспортной) упаковки ЛП; уникальная для каждой отдельной третичной (заводской, транспортной) упаковки ЛП комбинация символов, представленная в виде линейного штрихового кода.

ИС МДЛП, Система Федеральная государственная информационная система Мониторинга Движения Лекарственных Препаратов.

ИС МП Информационная система маркировки и

2


Описание

прослеживаемости, включающая в качестве подсистем ИС МДЛП и СЭ.

КЗКМ Криптозащищенный код маркировки; код маркировки, содержащий ключ проверки и криптографическую подпись. В терминах настоящего документа «КМ» и «КЗКМ» являются синонимами, КМ без криптозащиты в документе не рассматриваются.

КИЗ

Контрольный идентификационный знак. Синоним термина «средство идентификации», использовавшийся в нормативно-правовых акта до 2018 г.

КМ Код маркировки.

КП Код проверки, «крипто-хвост». Состоит из ключа проверки (поле 91) и криптоподписи (поле 92).

ЛВС Локальная вычислительная сеть.ЛП Лекарственный препарат.Оператор Системы, Оператор

С 01.11.2018 ООО «Оператор-ЦРПТ», согласно Постановления Правительства РФ от 28 августа 2018 г. №1018.

ПО Программное обеспечение.РЭ Регистратор эмиссии [кодов маркировки].Сериализация Выполняемый в рамках стадии производственного

цикла «фасовка/упаковка ЛП во вторичную упаковку» процесс генерации данных для средств идентификации и маркировки вторичных (потребительских) упаковок ЛП.

СИ Средство идентификации; нанесенный на упаковку ЛП КМ; уникальная последовательность символов в машиночитаемой форме или представленная с использованием иного средства (технологии) автоматической идентификации.

СКЗИ Средство криптографической защиты информации. Сертифицированный в соответствии с законодательством РФ программный или программно-аппаратный комплекс, выполняющий шифрование, расшифровку, подписывание электронной подписью и проверку электронной подписи данных.

СКЗКМ, СЭ Автоматизированная система Сервера криптографической защиты кодов маркировки, Сервер эмиссии. В терминах настоящего документа являются синонимами.

3


Описание

СУЗ Станция управления заказами.ТН ВЭД Товарная номенклатура внешнеэкономической

деятельности Евразийского экономического союза.Третичная (заводская, транспортная) упаковка

Упаковка, используемая для хранения, перевозки и перемещения ЛП между субъектами обращения и объединяющая произвольные наборы вторичных (потребительских) упаковок ЛП, или третичных (заводских, транспортных) упаковок ЛП.

ЦЭМ Центр этикетирования и маркировки. Сторонняя организация. Не является частью инфраструктуры Оператора. Осуществляет нанесение СИ на этикетки и другие носители.

Эмитент [средств идентификации]

Производитель ЛП, осуществляющий стадию «фасовка/упаковка ЛП во вторичную и/или третичную упаковку», осуществляющий формирование и нанесение КМ в виде СИ на вторичную (потребительскую) упаковку ЛП и/или на третичную (заводскую, транспортную) упаковку.

API Программный интерфейс приложения (англ. – Application Programming Interface).

ASCII Американский стандартный код для обмена информацией (англ. – American Standard Code for Information Interchange).

cURL Кроссплатформенная служебная программа командной строки, позволяющая взаимодействовать с множеством различных серверов по множеству различных протоколов с синтаксисом URL.

DataMatrix Двумерный матричный штрихкод.Ethernet Технология построения локальных вычислительных

сетей.HTTP Протокол прикладного уровня передачи данных,

использующийся также в качестве «транспорта» для других протоколов прикладного уровня (англ. – HyperText Transfer Protocol).

JSON Текстовый формат обмена данными, основанный на JavaScript (англ. – JavaScript Object Notation)

REST Архитектурный стиль взаимодействия компонентов распределённого приложения в сети (англ. – Representational State Transfer).

SSCC Серийный код транспортной упаковки, представленный в виде цифрового номера (англ. – Serial Shipping Container Code)

URL Унифицированный (единообразный) идентификатор

4


Описание

ресурса (англ. – Uniform Resource Identifier).UUID Стандарт идентификации, используемый в создании

ПО (англ. – Universally Unique Identifier).

2. Общая информация

В соответствии с постановлением Правительства Российской Федерации от 24 января 2017 г. № 62 «О проведении эксперимента по маркировке контрольными (идентификационными) знаками и мониторингу за оборотом отдельных видов лекарственных препаратов для медицинского применения» с 1 февраля 2017 г. вторичные (потребительские) упаковки части лекарственных препаратов для медицинского применения маркируются средствами идентификации, а согласно Федерального закона от 28 декабря 2017 г. № 425-ФЗ маркировка лекарственных препаратов станет обязательной с 01 января 2020 г.

Для реализации положений Федерального закона от 28 декабря 2017 г. № 425-ФЗ о внесении изменений в Федеральный закон от 12 апреля 2010 г. № 61-ФЗ «Об обращении лекарственных средств» в части введения обязательной маркировки лекарственных средств контрольными (идентификационными) знаками все производители лекарственных средств в Российской федерации должны быть оснащены специализированным оборудованием для нанесения средств идентификации не позднее декабря 2019 года.

В соответствии с требованиями регуляторов рынка (федеральных органов исполнительной власти), в состав КМ, наносимого производителем на вторичную упаковку ЛП, должны входить 4 группы данных:

1) Глобальный идентификационный номер торговой единицы, состоящий из 14 цифровых символов, которому предшествует идентификатор применения (01).

2) Индивидуальный серийный номер торговой единицы, состоящий из 13 символов цифровой или буквенно-цифровой последовательности (латинского алфавита), которому предшествует идентификатор применения (21). Завершающим символом для данной группы данных должен использоваться специальный символ-разделитель, имеющий код 29 в таблице символов ASCII. Серийный номер представляет собой массив символов в алфавите GS1 для серийного номера (GS1 AI encodable character set 82)

3) Ключ проверки, предоставляемый Эмитентам Оператором Системы в составе КП, состоящий из 4 цифровых символов, которому предшествует

5

идентификатор применения (91). Завершающим символом для данной группы данных должен использоваться специальный символ-разделитель, имеющий код 29 в таблице символов ASCII.

4) Электронная подпись, предоставляемая Эмитентам Оператором Системы в составе КП в соответствии с настоящим порядком, состоящая из 88 символов (цифр, строчных и прописных букв латинского алфавита, а также специальных символов), которому предшествует идентификатор применения (92). Завершающим символом для данной группы данных должен использоваться специальный символ-разделитель, имеющий код 29 в таблице символов ASCII.

Третья и четвертая группы данных составляют КП, сформированный согласно ГОСТ 34.10-2012.

Получение КП Эмитентами от Оператора осуществляется с использованием предоставляемых Оператором РЭ.

Эмитент , зарегистрированный в ИС МП, направляет Оператору через РЭ заявки на получение КП (при необходимости, могут быть также заказаны S/N), получает от Оператора через РЭ пулы КЗКМ в соответствии с заявками. Процесс обработки заявок может быть построен с использованием СУЗ, расширяющей функциональность РЭ. Вместо РЭ при определенных условиях, описанных ниже, может использоваться «облачный сервис».

Настоящий документ описывает процесс заказа эмитентом КП, процесс их предоставления Оператором и требования к технической инфраструктуре, используемой участниками оборота при выполнении этих операций.

3. Характеристика объекта автоматизации

Объектом автоматизации настоящего технического решения является бизнес-процесс маркировки, состоящий из запроса, нанесения и верификации КМ ЛП с использованием Российских криптографических технологий согласно ГОСТ 34.10-2012, как на производственных площадках внутри РФ, так и за ее пределами.

Процесс маркировки ЛП для международного производителя, имеющего производственные площадки в РФ, за ее пределами, а также пользующегося услугами временных (контрактных) производств для поставки ЛП на российский рынок, представляет собой последовательность следующих действий:

Размещение заказа на производство ЛП в АСУТП; Создание обязательных к нанесению в составе СИ полей (01 и 21

поля или 01 поле и количество заказываемых 21 полей) для единичного или группового заказа КП;

6

Передача созданной буквенно-цифровой последовательности через РЭ или «облачный сервис» в СКЗКМ для получения КП;

Передачу полученного от РЭ или «облачного сервиса» ответа в АСУТП предприятия для выполнения задачи нанесения и последующей верификации нанесенного КМ в составе СИ;

Передачу Оператору отчетов о нанесении КМ / пула КМ.

4. Сетевое подключение комплекса технических средств РЭ

Принципиальная схема взаимодействия информационной системы Эмитента и информационной системы Оператора (вне зависимости от его статуса и размера) показана на Рис. 1.

CLOUD SERVICE

MDLP

ENCODING SUBSYSTEM

ERPSGTIN GENERATION

subsystem

Line Manager

ISSUEREGISTRAR

INTERNATIONAL SITE DOMESTIC SITE.RU

API SW

DOMESTIC = TRUE

DOM

ESTI

C =

FALS

E

LEVEL 4

LEVEL 3

BORDER.RU

BORDER.RU

GLOBAL LEVEL

CONTRACT SITE

Line ManagerLEVEL 3LEVEL 3

LOCAL LEVEL

Line Manager

Рисунок 1

В случае наличия у производителя зарубежных производственных площадок (собственных или контрактных), обращение за централизованной генерацией КЗКМ для производства на таких площадках маршрутизируется на облачный сервис, расположенный за пределами РФ.

Для площадок как Российских, так и международных производителей, расположенных на территории РФ, маршрутизация производится на устройство, находящееся физически на территории предприятия (РЭ).

Важно: физическое расположение РЭ на территории предприятия не означает его включения в локальную или глобальную информационную сеть

7

производителя (или производственной площадки). Взаимодействие информационных систем Эмитента с РЭ производится посредством REST API, описанного далее в настоящем документе.

Комментарии к схеме взаимодействия через API:

1. Обращение к API в общем случае идет от глобальной системы управления сериализацией Эмитента. Возможно обращение к API с любого уровня информационной системы предприятия, на алгоритм работы РЭ это не влияет.

2. Маршрутизация процесса (для зарубежных или Российских площадок) происходит на уровне сервиса.

3. Предусмотрено два режима работы сервиса:a. В режиме генерации КП сервис получает от производителя

заранее сгенерированные коды, состоящие из серийного номера и GTIN. Сервис возвращает в информационную систему производителя полностью сгенерированный КМ, включая КП, готовый для нанесения на вторичную упаковку;

b. В режиме генерации полного состава КМ, сервис по заказу Эмитента, включающему GTIN и количество необходимых КМ, производит создание полного состава КМ, включая сгенерированные серийные номера и КП.

4. Генерация может вестись как поштучно, так и пакетами (пулами), содержащими большое количество КМ. РЭ обладает емкостью для хранения в защищенном режиме ранее сгенерированных КМ в количестве до 2-х миллионов штук в одном пуле, до 100 пулов одновременно. При передаче в информационную систему Эмитента, переданные КМ из памяти РЭ удаляются.

8

5. Порядок тестирования процессов при подготовке производства

Схема процесса

5., 6. Тестирование при подготовке производства и маркировке товаровПользователь Оборудование

сериализации АСУТП РЭ

6. М

арки

ровк

а тов

аров

. 6.1.

Сери

ализ

ация

5. По

дгот

овка

про

изво

дств

а

Автоматизировнная инициация процесса на

основании сообщения об исчерпании запаса

заказанных КМ

Обработка заявки на серивализацию,

формирование пула КЗКМ

Составление запроса в РЭ

Формирование задания на

нанесение КЗКМНанесение КЗКМ

на упаковку

Формирование заявки на КМ

Приняттие решения о необходимости выпуска

пула КМ

Проверка соответствия списку

сосканированнных КМ

Считывание нанесенных КМ

Формирование запроса на

закрытие пула кодов

Закрытие пула и формирование

отчета о закрытии пула кодов

Формирование сообщения оператору о

закрытии пула кодов, передача кодов на

агрегацию

Проверка параметров считывания

Проверяемая функция


Обработка ответа РЭ

Проверка времени

генерации пула КП КМ



Описание процессаКМ поступают в РЭ по заявке АСУТП или иной информационной

системы Эмитента. Когда заявка в РЭ выполнена, РЭ возвращает пул КМ. При этом пул КМ содержит идентификатор заявки на генерацию КМ, в результате которой был создан данный пул.

Заявка на получение КМ может находиться в одном из статусов, описанных ниже (Таблица 2):

Таблица 2Статус Описание

9

«REQUESTED»

(«Запрошен»)

Ожидается получение пула КМ от СЭ.

Автоматический переход в статус «RECEIVED» или

«REJECTED» по получении результата от сервера.

«RECEIVED»

(«Не

распределен»)

Пул КМ от СЭ поступил, но использование пула не

спланировано.

Из статуса «Не распределен» пул КМ может быть

переведен в статус «INUSE» подачей на РЭ команды

«Запланировать». Из статуса «Не распределен» пул КМ

может быть переведен в статус «CLOSED» подачей на

РЭ команды «Закрыть».

«REJECTED»

(«Пул не

создан»)

От СЭ получен отказ в генерации ответа на заявку с

указанием причины отказа. Статус может возникать при

обработке КМ, задаваемых пользователем. Заявка может

быть удалена после разбирательства по причине отказа

подачей на РЭ команды «Удалить».

«INUSE»

(«В

производстве»)

Пул может быть использован для раздачи КМ

технологическим станциям АСУТП.

Из статуса «В производстве» пул КМ автоматически

переходит в статус «EXHAUSTED» при исчерпании КМ

в процессе их раздачи.

Из статуса «В производстве» пул КМ переходит в статус

«CLOSED» при подаче на РЭ команды «Закрыть».

«EXHAUSTED»

(«Исчерпан»)

Запас заказанных КМ исчерпан. Из статуса «Исчерпан»

пул КМ переводится в статус «CLOSED» подачей на РЭ

команды «Закрыть».

«CLOSED»

(«Закрыт»)

Использование пула кодов завершено (пул может быть

закрыт при любой степени утилизации по команде

оператора «Закрыть»). РЭ отправляет на СЭ финальный

отчет о статусах КМ. После успешной отправки отчета

пул КМ автоматический переходит в статус

10

«REPORTED».

«REPORTED»

(«Отчет сдан»)

Отчет о статусах КМ успешно оправлен на СЭ. Пул в

данном статусе может быть удален командой РЭ

«Удалить».

В рамках проведения тестирования возможно выполнять передачу КМ

между информационной системой Эмитента и РЭ на электронных носителях.

Оцениваемые параметры и порядок оценки

В ходе тестирования взаимодействия с РЭ оцениваются следующие

параметры:

Время генерации пула КМ (сек);

Время выполнения операций цикла «Запрос на получение пула

КМ - Получение отчета о закрытии пула КМ».

Количество запрашиваемых кодов определяется в зависимости от

потребностей предприятия в каждом конкретном случае, для обеспечения

полного воспроизведения применяемых на конкретном производстве

технологических процессов, с учетом ограничений на размер пула и

количество хранимых пулов, описанных выше.

6. Порядок тестирования процессов при маркировке товаров

6.1. Тестирование процессов сериализации проводится путем определения влияния регистрации эмиссии на нанесение КМ средствами, предусмотренными технологическими процессами предприятия Эмитента.


Приведена в п. 5. настоящего документа.

Описание процесса

КМ наносятся на вторичную упаковку ЛП установкой сериализации либо иными техническими средствами, включающими в свой функционал нанесение маркировки и отвечающими техническим требованиям, указанным в Разделе 8 настоящего документа.

Перед началом проведения тестирования нанесения КМ в проекте протокола тестирования фиксируются следующие параметры, характерные для конкретного объекта проведения тестирования:

Тип подачи (Ручная; Автоматическая);11

Скорость подачи (пачек/мин.); Используемый тип нанесения (лазерный, капле-струйный, термо-

трансферный, термо-струйный).

Оцениваемые параметры и порядок оценки

В ходе тестирования нанесения КМ оцениваются следующие параметры:

Скорость нанесения (КМ/мин.); Количество пачек с качеством ниже D (шт., %брака от общего

количествава нанесенных КМ).

Оценка качества нанесения КМ проводится интегрированной системой верификации оборудования сериализации Эмитента. В случае отсутствия технической возможности оценки качества нанесения КМ оборудованием сериализации, допускается использовать Верификатор LVS-9510, с полем зрения 3" (76мм). Количество наносимых в ходе тестирования КМ определяется в зависимости от потребностей предприятия в каждом конкретном случае в соответствии с применяемыми на производстве технологическими процессами, но не может составлять менее 200 штук для оценки качества нанесения с погрешностью не выше 0,5%.

6.2. Тестирование процессов агрегации проводится путем определения возможности считывания КМ средствами, предусмотренными технологическими процессами предприятия Эмитента.

12


6. Тестирование процессов при маркировке товаровПользователь Оборудование агрегации АСУТП

6.2. А

грег

ация

Считывание КЗКМ вторичных упаковок,

поступающих с оборудования сериализации

Упаковка и нанесение SSCC на третичную упаковку

Сверка КМ, полученных из процесса 6.1. и

считанных при формировании

третичной упаковки

Получение нанесенных КМ из

процесса 6.1.

Формирование SSCC для третичной упаковки и описи вложения

Подготовка вторичных упаковок к упаковке в

третичную

Набор вторичных упаковок для упаковки в третичную упаковку

сформирован,перечень вошедших в нее КЗКМ


Просмотр описи вложения средствами

АСУТП

Проверка параметров считывания по

индикатору считывания оборудования агрегации


Описание процесса

КП считываются со вторичных упаковок, поступающих на установку агрегации, которая при готовности (комплектности) к формированию третичной упаковки сообщает в АСУТП о факте готовности и передает считанный набор КМ. Групповой код и опись вложения могут формироваться как на стороне системы агрегации, так и на стороне АСУТП – это зависит от используемого на объекте оборудования и не влияет на результаты тестирования.

Перед началом проведения тестирования нанесения КМ в проекте протокола тестирования фиксируются следующие параметры, характерные для конкретного объекта проведения тестирования:

Тип используемого на объекте оборудования, задействованного в тестируемых процессах (система агрегации, встроенная в

13

производственную линию; терминал сбора данных; техническое зрение; отдельно стоящий агрегационный стол и т.д.).

Оцениваемые параметры

В ходе тестирования систем агрегации, оцениваются следующие параметры:

Время считывания нанесенных КМ (КМ/мин.); Количество несчитанных КМ (шт., % от общего количества

переданных на агрегацию КМ).

7. Порядок тестирования процессов оптового оборота и дистрибуции

Тестирование для участников оптового оборота, дистрибуции проводится аналогично п. 6.2 с тем отличием, что пул КМ поступает не с оборудования сериализации, а из ранее зарегистрированной предыдущим участником оборота описи вложения.

8. Общие требования к настройке оборудования сериализации и

агрегации

№ НаименованиеТехнические характеристики

Требуемый параметр Требуемое значение

1 Система сериализации Электропитание

Резервное питание: ИБП для питания контроллера и рабочих станций с временем работы не менее 30 минут.

Технологии печати

Термоструйная (Разрешение не менее 300 dpi); Лазерная (размера лазерного пятна, не более 0,2 мм); Каплеструйная печать (Разрешение не менее 300 dpi).

Длина области печати

Не менее 60 мм (с учетом человекочитаемой информации).

Минимальный размер точечного символа

Не более 0,25 мм для струйной печати.

Уровень класса качества

В соответствии с ГОСТ Р ИСО/МЭК 15415-2012.

Метод коррекции ECC-200

14

ошибок(гарантированное восстановление при повреждении до 30% поверхности изображения). от 2

Кодирование ASCII в соответствии с ГОСТ Р ИСО/МЭК 16022-2008.

Виды маркировки

Текст, цифры, двумерные коды (DataMatrix) в соответствии с ГОСТ Р ИСО/МЭК 16022-2008, сквозная маркировка из базы данных.

Подача чернил при струйной печати

Сменный картридж, прямое нанесение.

Блок управления

Промышленный контроллер или панельный компьютер, выполняющие централизованное управление и синхронизацию работы конвейеров, систем сериализации, агрегации, складирования и переупаковки продукции, отбора продукции на складе, а также осуществление обмена данными с ИС «Маркировка».

Загрузка данных

Создание шаблонов со структурой, используемой в ассоциации автоматической идентификации «ЮНИСКАН/ГС1 РУС», генерация случайных чисел, загрузка из внешней базы данных.

Обработка данных

Состояние печати, сериализации, верификации, отбраковки, агрегации и текущее состояние системы в реальном масштабе времени.

Резервное копирование и востановление

Резервное копирование с последующим восстановлением системы с конфигурационными и архивными данными.

2 Система агрегации

Отображение информации

Состояние печати, верификация, отбраковка, текущее состояние системы в реальном масштабе времени.

15

Сеть передачи данных

Ethernet.

Сетевой протокол TCP/IP, Modbus.

Минимальный размер модуля при уверенном считывании

Не более 0,25 мм.

3 Сканеры штрих кода

Тип информации Одномерные штрих-коды, двумерные коды (DataMatrix).

ФункциональностьCчитывание, проверка, удаление и добавление КМ сериализованного или агрегированного продукта.

Подключение в зависимости от места использования

Ethernet, RS-485, USB

4 Упаковка Тип картона

Класс GC2/GT2 – (мелованный, с пропиткой оборота) либо более высокого класса*.*Возможно применение картонов других

классов при предварительном тестировании

Общие рекомендации по настройке ПО для управления оборудованием (выполняются при подготовке к тестированию, при тестировании не проверяются):

Настройки ПО в части длины и возможностей изменения полей должны соответствовать Стандарту GS1 General Specification, редакции 18, ратифицированной в январе 2018 года

o Открыты для редактирования и изменения поля 91-98o Максимальная длина каждого поля – 90 символов

Поля 91-92 в настройках ПО необходимо сделать динамическими (должны изменяться совместно с уникальным серийным номером)

В настройках ПО должна быть предусмотрена (не заблокирована) возможность включения режима пикселизации и/или возможность изменения разрешения для подбора оптимальных значений этих параметров в ходе тестирования.

Настройки графического и модульного размера кода должны быть принудительными (в большинстве случаев ПО изменяет размер кодов в автоматическом режиме) Должна быть предусмотрена возможность применения пользователем настроек размера

16

На сканирующих устройствах, применяемых при первичном считывании и агрегации, необходимо настроить максимально возможное разрешение сканирования, а ПО технического зрения настроить на распознавание минимального размера точки 0.255 мм.

Настройки верификации и требования к качеству нанесения кода должны быть выполнены в соответствии со стандартом ИСО 15415 (ГОСТ Р ИСО/МЭК 15415-2012)

Общие требования к установке оборудования.

Установка должна осуществляться строго в соответствии с требованиями нормативной документации на установку производственного оборудования и требованиям производителя оборудования.

Проверка правильности выставления оборудования по уровню должна осуществляться при приемке и валидации производственной линии в соответствии с действующими ГОСТами.

При эксплуатации необходимо ограничить воздействие на систему печати (печатающую головку) внешних факторов, таких как пыль и статическое электричество (в случае если это не предусмотрено конструктивными особенностями станции).

o Требования к пыле- влаго- защищенности IP50 по ГОСТ 14254-96 (частичная защита от пыли) или выше.

o Необходимо обеспечить качественное заземление оборудования согласно инструкции по монтажу оборудования.

Во избежание плохой считываемости при агрегации необходимо обеспечить достаточный уровень освещенности рабочей поверхности (в соответствии с требованиями к устройствам считывания).

Для обеспечения ровного освещения рабочей поверхности может потребоваться применить рассеиватели света.

9. Порядок подключения к тестовому стенду СЭ

9.1. Конфигурация тестового стендаТестовый стенд СУЗ на эмиссию и заданиями на нанесение КМ

развернут на сервере с IP-адресом 172.104.154.9, TCP-порт - 9999.

9.2. Общие замечания по использованию тестового стендаДля отправки запросов в соответствии с описанием REST-API,

приведенном ниже следует использовать следующие общие правила.

17

Аутентификацию клиентских подключений REST-контроллер

осуществляет на основе клиентского токена, передаваемого клиентом в

заголовке HTTP-запроса. Имя заголовка для передачи клиентского токена -

«clientToken». Тестовый token 1cecc8fb-fb47-4c8a-af3d-d34c1ead8c4f

Отправлять данные методом POST следует с использованием Content-

Type: application/json.

Для тестирования методов REST-контроллера можно использовать

стандартную утилиту ОС Linux – cURL.

Пример командной строки cURL для REST-запроса:

curl -H "Content-Type: application/json" -H "clientToken: 1cecc8fb-fb47-4c8a-af3d-d34c1ead8c4f" -X POST -d '{"participantName":"ООО Спортмастер","inn":"7728551528","contractNumber":"18-035","contractDate":"2018-08-01","cemName":"ЦЭМ Москвы №1","cemContractNum":"2018-012","cemContractDate":"2018-08-02","cemInn":"7728551777","contactPerson":"директор Иванов Иван Иванович","deliveryAddress":{"city":"г. Москва","street":"ул. Московская","building":"д.27","office":"606","note":"Постучать в дверь 2 коротких и 1 длинный"},"products":[{"gtin":"848839984","codeTnVed":"451202","releaseMethodType":"PRODUCTION","quantity":100,"identificationType":"PRINTED","serialNumberType":"OPERATOR","serialNumber":"","markingType":"PRODUCT","createMethodType":"CEM","receiveMethodType":"ELECTRONIC","productionLine":"1"},{"gtin":"848839333","codeTnVed":"451233","releaseMethodType":"PRODUCTION","quantity":10,"identificationType":"PRINTED","serialNumberType":"OPERATOR","serialNumber":"","markingType":"PRODUCT","createMethodType":"CEM","receiveMethodType":"ELECTRONIC","productionLine":"2"}],"productionOrderId": "1234567890"}' http://172.104.154.9:9999/api/orderCodes

9.3. Описание API и примеры запросов9.3.1. Формирование заявки на КМ

Данный метод в качестве параметра принимает структуру данных JSON и токен. Токен генерируется СУЗ при регистрации клиента СУЗ. Токен передается на сервер в заголовке HTTP-запроса с именем "clientToken". Клиентом СУЗ являются: учетная система или производственная линия.

Структура запроса на формирование заявки на КМ.

18

Параметры REST-запроса

URL: http://<server-name>[:server-port]/api/orderCodesMethod: POSTContent-Type: application/json

Формат JSON-объекта POST-запросаПоле Описание Тип Обязательност

ьparticipantName Наименование

участника оборотаСтрока Нет

inn ИНН участника оборота

Строка Нет

contractNumber Номер договора с Оператором ИС МП

Строка Нет

contractDate Дата договора с Оператором ИС МП

ДатаYYYY-MM-DD

Нет

cemName Наименование ЦЭМ

Строка Нет

cemContractNum Номер договора с ЦЭМ

Строка Нет

cemContractDate Дата договора с ЦЭМ

ДатаYYYY-MM-DD

Нет

cemInn ИНН ЦЭМ Строка НетcontactPerson Контактное лицо Строка НетdeliveryAddress Адрес доставки JSON Object

AddressНет

products Список товаров JSON Array of

OrderProduct

Да

productionOrderId

Идентификатор производственного заказа

Строка Да

Формат адреса доставки - AddressПоле Описание Тип Обязательность

сity Город Строка Нетstreet Улица Строка Нетbuilding Номер дома Строка НетOffice Офис/помещение Строка НетNote Примечание Строка Нет

19

Формат описания товара – OrderProductПоле Описание Тип Обязательнос

тьGtin GTIN товара Строка(14) ДаcodeTnVed Код ТН ВЭД Строка(10) ДаreleaseMethodType

Способ ввода товара в оборот

Справочник №1

Да

quantity Количество КМ/СИ

Целочисленный

Да

identificationType Вид СИ Справочник №2

Да

serialNumberType

Способ формирования индивидуального серийного номера


Да

serialNumber Индивидуальный серийный номер

Строка Нет

markingType Вид маркировки Справочник №4

Да

createMethodType

Способ изготовления


Да

receiveMethodType

Способ получения


Да

productionLine Идентификатор производственной линии

Строка Да

Справочник №1 – Способ ввода товаров в оборотКонстанта Описание Тип

PRODUCTION Производство в РФ СтрокаIMPORT Импорт Строка

Справочник №2 – Вид СИКонстанта Описание Тип

PRINTED Печатаемый СтрокаGLUED Клеевой СтрокаHINGED Навесной Строка

Справочник №3 – Способ формирования индивидуального серийного номера

Константа Описание ТипSELF_MADE Эмитентом Строка

20

OPERATOR Оператором Строка

Справочник №4 – Вид маркировкиКонстанта Описание Тип

PRODUCT_PACKAGE На потребительскую упаковку

Строка

PRODUCT На товар СтрокаPRODUCT_LABEL На товарный ярлык Строка

Справочник №5 – Способ изготовленияКонстанта Описание Тип

SELF_MADE Эмитентом СтрокаCEM ЦЭМ Строка

Справочник №6 – Способ полученияКонстанта Описание Тип

PHYSICAL На физическом носителе СтрокаELECTRONIC В электронном виде Строка

Пример URL REST-запроса

http://172.104.154.9:9999/api/orderCodes

Пример данных POST-запроса в формате JSON

{"participantName": "ООО Спортмастер","inn": "7728551528","contractNumber": "18-035","contractDate": "2018-08-01","cemName": "ЦЭМ Москвы №1","cemContractNum": "2018-012","cemContractDate": "2018-08-02","cemInn": "7728551777","contactPerson": "директор Иванов Иван Иванович","deliveryAddress": {

"city": "г. Пенза","street": "ул. Московская","building": "д.27","office": "606","note": "Постучать в дверь 2 коротких и 1 длинный"

},"products": [

{"gtin": "848839984","codeTnVed": "451202",

21

"releaseMethodType": "PRODUCTION","quantity": 100,"identificationType": "PRINTED","serialNumberType": "OPERATOR","serialNumber": "генератор эмиссий сделает","markingType": "PRODUCT","createMethodType": "CEM","receiveMethodType": "ELECTRONIC","productionLine": "1"

}, {

"gtin": "848839333","codeTnVed": "451233","releaseMethodType": "PRODUCTION","quantity": 10,"identificationType": "PRINTED","serialNumberType": "OPERATOR","serialNumber": "","markingType": "PRODUCT","createMethodType": "CEM","receiveMethodType": "ELECTRONIC","productionLine": "2"

}],"productionOrderId": "1234567890"

}

Структура JSON-ответа на запрос по формированию заявки на КМ

Метод возвращает UUID заявки на СУЗ и примерное время выполнения заявки в виде метки времени timestamp. UUID в дальнейшем используется для обращения к методу получения КМ из пула. Для заказов производств с прямым нанесением возвращаемое время выполнения заказа будет равно нулю. Взаимодействие будет в псевдо-асинхронном режиме.

Формат ответаПоле Описание Тип Обязательнос

тьuuid UUID заявки

на КМСтрока Нет

expectedCompleteTimestamp

Метка времени планируемого выполнения заявки


Нет

22

Пример JSON-ответа на запрос

{"uuid": "550e8400-e29b-41d4-a716-446655441234","expectedCompleteTimestamp": 1533673712

}

Пример JSON-ответа с ошибкой

{"error":["Invalid INN parameter length"]}

9.3.2. Получение пула КМ

Метод получения пула КМ в качестве параметров требует: токен, UUID заявки, GTIN, количество КМ, которые необходимо выдать и имя шаблона для печати КМ. Токен генерируется СУЗ при регистрации клиента СУЗ. Токен передается на сервер в заголовке HTTP-запроса с именем "clientToken". Если заказ еще выполняется и пул кодов не сформирован, метод вернет пустой массив.

Для производств с прямым нанесением заказ будет выполняться моментально, во всех других случаях метод получения заказа возвращает примерное время исполнения заказа, которое будет рассчитываться, исходя из статистики взаимодействия с РЭ и с небольшим запасом.

Структура запроса на получение КМ из заказа


URL: http://<server-name>[:server-port]/api/codes?uuid={uuid}& gtin={gtin}&quantity={quantity}&templateId={templateId}Method: GET

Формат параметров запроса

Параметр Описание Тип Обязательностьuuid UUID бизнес-

заказа на эмиссию КМ

UUID Да

gtin GTIN товара Строка Даquantity Количество

запрашиваемых кодов

Целочисленный Да

templateId Идентификатор Строка Да

23

шаблона КМ


http://172.104.154.9:9999/api/codes?uuid=550e8400-e29b-41d4-a716-446655441234&gtin=12345678901234&quantity=1000&templateId=vertical

Структура JSON-ответа на запрос по получению КМ из заказа

Формат ответа

Поле Описание Тип ОбязательностьmarkCodes Массив КМ JSON

Array of MarkCode

Да

Формат объекта - MarkCode

Поле Описание Тип Обязательностьgtin GTIN товара Строка Даkiz КИЗ Строка Даkpkiz КП КИЗ Строка Да

Пример JSON-ответа

{"markCodes": [

{"gtin": "12345678901234","kiz": "(01)12345678901234(21)j89TCnKkLPd5X(240)

1234(91)1129","kpkiz": "(92)AusibQLCfH2fbOoXL3yU77gR

BOsnhdkljRGjZvl7gy0Uu9E1l0x6S2RzaWbKSgI1RmYQnZyumM6ZWhx3ktKOCw=="

},{

"gtin": "01334567894321","kiz": "(01)01334567894321(21)j89TCnKkLPd5X(240)

1234(91)1129","kpkiz": "(92)AusibQLCfH2fbOoXL3yU77gR

BOsnhdkljRGjZvl7gy0Uu9E1l0x6S2RzaWbKSgI1RmYQnZyumM6ZWhx3ktKOCw=="

}]

24

}

9.3.3. Передача в СУЗ отчета об использовании КМ

Метод для передачи отчетов в СУЗ об использовании КМ. Метод принимает токен и структуру JSON для четыре разных вида отчета:

1. Агрегация – отчет об упакованных товарах с нанесенными СИ, включающий коды логистических единиц, в которые упакованы товары

a. Файл агрегации может иметь подтип: Update он отсылается при изъятии контрольных образцов и других операциях, которые изменяют состав агрегата

2. Выбытие КМ – отчет о выбывших КМa. Брак

3. Верификация КМ – отчет о верифицированных КМ4. Печать КМ – отчет о напечатанных КМ

КМ в файлах отчетов передаются без КП. Токен генерируется СУЗ при регистрации клиента СУЗ. Токен передается на сервер в заголовке HTTP-запроса с именем "clientToken".

Структура JSON-запроса на передачу в СУЗ отчета об использовании

КМ


URL: http://<server-name>[:server-port]/api/reportsMethod: POSTContent-Type: application/json

Формат запросаПоле Описание Тип Обязательност

ьparticipantName Наименование

участника оборота

Строка Да


Строка Да

productionOrderId


Строка Да

aggregationPack Информация об агрегации

JSON Array of AggregationPa

Нет

25

ckrejectedSntins Информация о

выбывших КМJSON Array of RejectedSntin

Нет

verifiedSntins Информация о проверенных КМ

JSON Array of String

Нет

printedSntins Информация о напечатанных КМ


Нет

Формат объекта - AggregationPackПоле Описание Тип Обязательность

packSerialNumber Серийный номер упаковки

Строка Да

aggregationType Тип агрегации

Справочник №1 Да

sntins Массив серийных номеров+ товарных номенклатур


Нет

aggregationPack Информация об агрегации

JSON Array of AggregationPack

Нет

Формат объекта - RejectedSntinПоле Описание Тип Обязательность

sntin Серийный номер + ТН

Строка Да

rejectionType Причина выбытия Справочник №2

Да

Справочник №1 "Тип агрегации" - AggregationTypeКонстанта Описание Тип

AGGREGATION Новая агрегация СтрокаUPDATE Обновление существующей

агрегацииСтрока

Справочник №2 "Причина выбытия" - RejectionTypeКонстанта Описание Тип

REJECTED Брак СтрокаDROPPED_OUT Другая причина выбытия Строка


26

http://172.104.154.9:9999/api/reports

Пример данных POST-запроса в формате JSON

{"participantName": "ООО Спортмастер","inn": "7728551528","productionOrderId": "20180801","aggregationPack": [

{"packSerialNumber": "123123123123","aggregationType": "AGGREGATION","sntins": [

"123456789012345678901","123456789012345678902","123456789012345678903","123456789012345678904","123456789012345678905"

]},{

"packSerialNumber": "123123123124","aggregationType": "UPDATE","aggregationPack": [

{"packSerialNumber": "456456456456","aggregationType": "AGGREGATION","sntins": [

"123456789012345678906","123456789012345678907","123456789012345678908","123456789012345678909","123456789012345678900"

]}

]}

],"rejectedSntins": [

{"sntin":"123456789012345678911","rejectionType":"REJECTED"

},{

"sntin":"123456789012345678912","rejectionType":"DROPPED_OUT"

27

}],"verifiedSntins": [

"123456789012345678921","123456789012345678922","123456789012345678923","123456789012345678924","123456789012345678925"

],"printedSntins": [

"123456789012345678931","123456789012345678932","123456789012345678933","123456789012345678934","123456789012345678935"

]}

Структура JSON-ответа на запрос по передаче в СУЗ отчета об

использовании КМ

Формат ответа

Поле Описание Тип Обязательностьsuccess Признак успешного

приема отчетаЛогический (true/false)

Да

errors Описание ошибок при success=false

JSON Array of Strings

Нет


{"success":true}

9.3.4. Получение из СУЗ отчета об использовании КМ

Метод предназначен для выгрузки в учетную систему отчета по сделанным заказам на эмиссию КМ и об утилизации КМ из заказов. Метод принимает токен, и параметры, содержащие дату и время начала выборки данных для отчета, дату и время окончания выборки (далее возможно расширения списка параметров запроса отчета), передача периода обязательна, если не указан производственный заказ, идентификатор производственного заказа – фильтр по производственному заказу. Токен генерируется СУЗ при регистрации клиента СУЗ. Токен передается на сервер в заголовке HTTP-запроса с именем "clientToken". Метод возвращает

28

структуру данных за выбранный период либо, если не указан период, то все заказы на КМ в рамках заданного производственного заказа.

Структура запроса на получение из СУЗ отчета об использовании КМ


URL: http://<server-name>[:server-port]/api/codeUsage?from={fromTimestamp}&to={toTimestamp}&productionOrderId={productionOrderId}Method: GET

Формат параметров запроса

Поле Описание Тип Обязательность

from Дата и время начала выборки


Нет

to Дата и время конца выборки


Нет

productionOrderId


Строка Да


http://172.104.154.9:9999/api/codeUsage?from=1533643712&to=1533673712&productionOrderId=12345

Структура JSON-ответа на запрос по получению из СУЗ отчета об

использовании КМ

Формат ответаПоле Описание Тип Обязательность

orderReports Массив данных об использовании КМ

JSON Array of

OrderReport

Да

Формат объекта - OrderReportПоле Описание Тип Обязательность

productionOrderId Идентификатор производственного заказа

Строка Да

29

uuid UUID бизнес-заказа

UUID Да

codeStatuses Статусы использования КМ

JSON Array of

SntinStatus

Да

Формат объекта - SntinStatusПоле Описание Тип Обязательность

sntin Серийный номер + номенклатура товара

Строка Да

codeStatus Статус использования КМ


Да

Справочник №1 "Статусы использования КМ" - CodeStatusКонстанта Описание Тип

GENERATED КМ эмитирован СтрокаUTILISED КМ нанесен СтрокаVERIFIED КМ верифицирован СтрокаREJECTED КМ выведен (брак) СтрокаDROPPED_OUT КМ выведен (другая

причина)Строка

PACKED КМ упакован СтрокаUNKNOWN Неизвестен Строка


{"orderReports": [

{"productionOrderId": "12345678901234","uuid": "550e8400-e29b-41d4-a716-446655441234","codeStatuses": [

{"sntin": "123456789012345678901234","codeStatus": "GENERATED"

},{

"sntin": "123456789012345678901235","codeStatus": "PACKED"

}]

},{

"productionOrderId": "12345678901236","uuid": "550e8400-e29b-41d4-a716-446655441236",

30

"codeStatuses": [{

"sntin": "123456789012345678901236","codeStatus": "UTILISED"

},{

"sntin": "123456789012345678901237","codeStatus": "REJECTED"

}]

}]

}

9.3.5. Передача документа в ИС МП

Метод предназначен для передачи в ИС МП любых документов. Метод принимает в качестве параметров токен и JSON. Токен генерируется СУЗ при регистрации клиента СУЗ. Токен передается на сервер в заголовке HTTP-запроса с именем "clientToken".

Структура запроса на передачу документа в ИС МП


URL: http://<server-name>[:server-port]/api/docsMethod: POSTContent-Type: application/json

Формат запросаПоле Описание Тип Обязательность

participantName Наименование участника оборота

Строка Да


Строка Да

receiverId Идентификатор подсистемы-получателя

Строка Да

documentType Тип документа Строка Даdocument Документ в формате

Base64Строка Да

31

Параметр идентификатор подсистемы-получателя необходим, так как может существовать более одной системы маркировки и нужно конкретизировать, кому предназначен документ.

Структура JSON-ответа на запрос по передаче документа в ИС МП

Формат ответаПоле Описание Тип Обязательность

uuid UUID присвоенный документу в СУЗ

UUID Нет

status Статус отправки документа


Да

UUID документу присваивается только в случае успешного приема в очередь на обработку.

Справочник №1 "Статус отправки документа" - DocStatus

Константа Описание ТипENQUEUED Документ принят в очередь на

обработкуСтрока

REJECTED Документ отклонен (ошибка формата)

Строка

Пример URL REST-запросаhttp://172.104.154.9:9999/api/docs

Пример данных POST-запроса в формате JSON{

"participantName": "ООО Спортмастер","inn": "7728551528","receiverId": "20180801","documentType": "1","document":

"SW1hZ2VuYXJpdW0gaXMgYSBQb3N0LURldk9wcyBlcmEgc29sdXRpb24h"}

32

Обязательная маркировка товаров -...

Documents

Transcript of Обязательная маркировка товаров -...