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

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

Формат описания товара – OrderProduct

Поле	Описание	Тип	Обязательность
Gtin	GTIN товара	Строка(14)	Да
codeTnVed	Код ТН ВЭД	Строка(10)	Да
releaseMethodType	Способ ввода товара в оборот	Справочник №1	Да
quantity	Количество КМ/СИ	Целочисленный	Да
identificationType	Вид СИ	Справочник №2	Да
serialNumberType	Способ формирования индивидуального серийного номера	Справочник №3	Да
serialNumber	Индивидуальный серийный номер	Строка	Нет
markingType	Вид маркировки	Справочник №4	Да
createMethodType	Способ изготовления	Справочник №5	Да
receiveMethodType	Способ получения	Справочник №6	Да
productionLine	Идентификатор производственной линии	Строка	Да

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

Константа	Описание	Тип
PRODUCTION	Производство в РФ	Строка
IMPORT	Импорт	Строка

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

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

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

Константа	Описание	Тип
SELF_MADE	Эмитентом	Строка
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",

                       "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	Метка времени планируемого выполнения заявки	Целочисленный	Нет

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

{

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

       "expectedCompleteTimestamp": 1533673712

}

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

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

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

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

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