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

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

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

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

Method: GET

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

Параметр	Описание	Тип	Обязательность
uuid	UUID бизнес-заказа на эмиссию КМ	UUID	Да
gtin	GTIN товара	Строка	Да
quantity	Количество запрашиваемых кодов	Целочисленный	Да
templateId	Идентификатор шаблона КМ	Строка	Да

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

http://172.104.154.9:9999/api/codes?uuid=550e8400-e29b-41d4-a716-446655441234>in=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

BOsnhdkljRGjZvl7gy0Uu9E1l0x6S2RzaWbKSgI1

RmYQnZyumM6ZWhx3ktKOCw=="

},

{

                       "gtin": "01334567894321",

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

1234(91)1129",

                       "kpkiz": "(92)AusibQLCfH2fbOoXL3yU77gR

BOsnhdkljRGjZvl7gy0Uu9E1l0x6S2RzaWbKSgI1

RmYQnZyumM6ZWhx3ktKOCw=="

}

               ]

}

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

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

Агрегация – отчет об упакованных товарах с нанесенными СИ, включающий коды логистических единиц, в которые упакованы товары Файл агрегации может иметь подтип: Update он отсылается при изъятии контрольных образцов и других операциях, которые изменяют состав агрегата Выбытие КМ – отчет о выбывших КМ Брак Верификация КМ – отчет о верифицированных КМ Печать КМ – отчет о напечатанных КМ

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

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

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

URL: [:server-port]/api/reports">http://[:server-port]/api/reports

Method: POST

Content-Type: application/json

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

Поле	Описание	Тип	Обязательность
participantName	Наименование участника оборота	Строка	Да
inn	ИНН участника оборота	Строка	Да
productionOrderId	Идентификатор производственного заказа	Строка	Да
aggregationPack	Информация об агрегации	JSON Array of AggregationPack	Нет
rejectedSntins	Информация о выбывших КМ	JSON Array of RejectedSntin	Нет
verifiedSntins	Информация о проверенных КМ	JSON Array of String	Нет
printedSntins	Информация о напечатанных КМ	JSON Array of String	Нет

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

Поле	Описание	Тип	Обязательность
packSerialNumber	Серийный номер упаковки	Строка	Да
aggregationType	Тип агрегации	Справочник №1	Да
sntins	Массив серийных номеров+ товарных номенклатур	JSON Array of String	Нет
aggregationPack	Информация об агрегации	JSON Array of AggregationPack	Нет

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

Поле	Описание	Тип	Обязательность
sntin	Серийный номер + ТН	Строка	Да
rejectionType	Причина выбытия	Справочник №2	Да

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

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

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

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

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

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",