Это старая версия документа.

Станция управления заказами v2.0

Содержание

1Введение (Introduction)
1.1Сокращения, определения (Terminology)
1.2Общее описание (General description)
1.3Описание процесса (General description process)
1.3.101.01.00.00 Создать заказ на эмиссию КМ (Create order for emission IC)
1.3.201.02.00.00 Получить статус массива КМ из бизнес-заказа (Get IC buffer status)
1.3.301.03.00.00 Получить КМ из бизнес-заказа (Get ICs from the order)
1.3.401.04.00.00 Отправить отчёт об использовании КМ (Send IC utilisation report to OMS)
1.4Буфер хранения КМ в СУЗ (ICs storage buffer in the OMS)
2Описание
2.1Требования к API
2.1.1Цифровая подпись сообщений (Digitally Signing Messages)
2.1.2Формирование GS1 DataMatrix (Constructing a GS1 DataMatrix)
2.1.3Обработка JSON (JSON Processing)
2.2Описание API (API description)
2.2.1Создать бизнес-заказ на эмиссию кодов маркировки (Create order for emission IC)
2.2.1.1Запрос (Request)
2.2.1.1.1Расширения для табачной промышленности (Extensions for the tobacco industry)
2.2.1.1.2Расширения для лёгкой промышленности – категория товарной группы «Предметы одежды, белье постельное, столовое, туалетное и кухонное» (Extensions for the light industry - category «Articles of apparel, bed linen, dining room, toilet and kitchen»)
2.2.1.1.3Расширения для лёгкой промышленности – категория товарной группы «Обувные товары» (Extensions for the light industry - category «Shoe products»)
2.2.1.1.4Расширения для производителей шин – категория товарной группы «Шины и покрышки пневматические резиновые новые» (Extensions for tire manufacturers - category of the product group «New pneumatic rubber tires and tires»)
2.2.1.1.5Расширения для производителей парфюмерной продукции – категория товарной группы «Духи и туалетная вода» (Extensions for manufacturers of perfumes - category of the product group «Perfume and toilet water»)
2.2.1.1.6Расширения для производителей фототоваров – категория товарной группы «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки» (Extensionsfor photo goods manufacturers- category of the product group «Cameras (except movie cameras), flash and flash lamps»)
2.2.1.1.7Расширения для фармацевтической промышленности (Extensions for the pharmacy industry)
2.2.1.1.8Расширения для производителей молока (Extensions for the milk producers)
2.2.1.1.9Расширения для производителей велосипедов и велосипедных рам (Extensions for the bicycle producers)
2.2.1.1.10Расширения для производителей кресел-колясок (Extensions for the wheelchairs producers)
2.2.1.2Ответ на запрос (Response to request)
2.2.2Отправить отчёт о выбытии/отбраковке КМ (Send report of dropout IC to OMS)
2.2.2.1Запрос (Request)
2.2.2.1.1

Расширения для табачной промышленности (Extensions for the tobacco industry)|

2.2.2.2
2.2.3
2.2.3.1Запрос (Request)

Запрос (Request) 2.2.3.1.1 Расширения для табачной промышленности (Extensions for the tobacco industry)51 2.2.3.1.2 Спецификации для производителей молока (Specifications for the milk producers) 52 2.2.3.2 Ответ на запрос (Response to request) …………………………………………………………………….53 2.2.4 Отправить отчёт об использовании (нанесении) КМ (Send IC utilisation report to OMS)54 2.2.4.1 Запрос (Request)……………………………………………………………………………………………………55 2.2.4.1.1 Расширения для табачной промышленности (Extensions for the tobacco industry)56 2.2.4.1.2 Расширения для фармацевтической промышленности (Extensions for the pharmacy industry) …………………………………………………………………………………………………………..57 2.2.4.1.3 Расширения для производителей молока (Extensions for the milk producers)……..61 2.2.4.2 Ответ на запрос (Response to request) …………………………………………………………………….62 2.2.5 Закрыть подзаказ по заданному GTIN (Close IC array for the specified product GTIN) ….63 2.2.5.1 Запрос (Request)……………………………………………………………………………………………………64 2.2.5.2 Ответ на запрос (Response to request) …………………………………………………………………….65 2.2.6 Получить КМ из бизнес-заказа (Get ICs from the order) ……………………………………………..65 2.2.6.1 Запрос (Request)……………………………………………………………………………………………………66 2.2.6.2 Ответ на запрос (Response to request) …………………………………………………………………….68 2.2.7 Получить статус массива КМ из бизнес-заказа (Get IC buffer status)…………………………..68 2.2.7.1 Запрос (Request)……………………………………………………………………………………………………69 2.2.7.2 Ответ на запрос (Response to request) …………………………………………………………………….69 2.2.8 Получить статус бизнес-заказов (Get status orders)……………………………………………………72 2.2.8.1 Запрос (Request)……………………………………………………………………………………………………73 2.2.8.2 Ответ на запрос (Response to request) …………………………………………………………………….73 2.2.9 Получить информацию об агрегации (Get aggregation)………………………………………………75 4 2.2.9.1 Запрос (Request)……………………………………………………………………………………………………75 2.2.9.2 Ответ на запрос (Response to request) …………………………………………………………………….76 2.2.9.2.1 Расширение для табачной промышленности……………………………………………………77 2.2.10 Получить статус обработки отчёта (Get status processing report)…………………………………78 2.2.10.1 Запрос (Request)………………………………………………………………………………………………..79 2.2.10.2 Ответ на запрос (Response to request) …………………………………………………………………79 2.2.11 Отправить лог файлы АСУТП (Send Automated process control system logs files) ………..80 2.2.11.1 Запрос (Request)………………………………………………………………………………………………..80 2.2.11.2 Ответ на запрос (Response to request) …………………………………………………………………81 2.2.12 Проверить доступность СУЗ (Ping OMS)…………………………………………………………………..82 2.2.12.1 Запрос (Request)………………………………………………………………………………………………..82 2.2.12.2 Ответ на запрос (Response to request) …………………………………………………………………83 2.2.13 Получить маркер безопасности по имени пользователя и паролю (Get a security token by username and password) …………………………………………………………………………………………………………..84 2.2.13.1 Запрос (Request)………………………………………………………………………………………………..84 2.2.13.2 Ответ на запрос (Response to request) …………………………………………………………………85 2.2.14 Получить версию СУЗ и API (Get OMS and API versions) ………………………………………….86 2.2.14.1 Запрос (Request)………………………………………………………………………………………………..86 2.2.14.2 Ответ на запрос (Response to request) …………………………………………………………………86 2.2.15 Получить список идентификаторов пакетов кодов маркировки (Get identifiers of blocks of ICs) 87 2.2.15.1 Ограничения (Restrictions)…………………………………………………………………………………87 2.2.15.2 Запрос (Request)………………………………………………………………………………………………..87 2.2.15.3 Ответ на запрос (Response to request) …………………………………………………………………88 2.2.16 Получить повторно коды маркировки из заказа кодов маркировки (Get ICs from the order repeatedly)………………………………………………………………………………………………………………………………90 2.2.16.1 Ограничения (Restrictions)…………………………………………………………………………………90 2.2.16.2 Запрос (Request)………………………………………………………………………………………………..91 2.2.16.3 Ответ на запрос (Response to request) …………………………………………………………………92 2.2.17 Отправить отчет об использовании и об автоматическом вводе в оборот (Send a report on the use and automatic commissioning)………………………………………………………………………………………..93 2.2.17.1 Ограничения (Restrictions)…………………………………………………………………………………93 2.2.17.2 Запрос (Request)………………………………………………………………………………………………..93 2.2.17.2.1 Расширения для производителей молока (Extensions for the milk producers) …..96 5 2.2.17.3 Ответ на запрос (Response to request) …………………………………………………………………98 2.2.18 Запрос номера документа отчета о вводе в оборот (Request for the document number of the report on the use and automatic commissioning)………………………………………………………………………….99 2.2.18.1 Ограничения (Restrictions)…………………………………………………………………………………99 2.2.18.2 Запрос (Request)………………………………………………………………………………………………..99 2.2.18.3 Ответ (Response to request) ………………………………………………………………………………100 2.3 Справочники (Dictionary) ………………………………………………………………………………………………102 2.3.1 Справочник №1 «Способ выпуска товаров в оборот» (Voc. №1 «Method of release of goods into circulation») ……………………………………………………………………………………………………………………102 2.3.2 Справочник №2 «Вид СИ» (Voc. №2 «Identification Type») ……………………………………..102 2.3.3 Справочник №3 «Способ формирования индивидуального серийного номера» (Voc. №3 «Method of generation of individual serial number»)………………………………………………………………….103 2.3.4 Справочник №4 «Вид маркировки» (Voc. №4 «Type of marking»)…………………………….103 2.3.5 Справочник №5 «Способ изготовления» (Voc №5 «Manufacturing Method»)…………….103 2.3.6 Справочник №6 «Способ получения» (Voc №6 «Method of receiving») …………………….104 2.3.7 Справочник №7 «Шаблоны КМ» (Voc №7 «Template IC»)……………………………………….104 2.3.8 Справочник №8 «Статус массива КМ» (Voc №8 «IC array status»)……………………………105 2.3.9 Справочник №9 «Тип агрегации» (Voc №9 «Aggregation Type»)………………………………106 2.3.10 Справочник №10 «Статус буфера КМ» (Voc №10 «IC buffer status»)………………………..106 2.3.11 Справочник №11 «Статус обработки отчёта» (Voc №11 «Report Processing Status») …107 2.3.12 Справочник №12 «Тип использования» (Voc №12 «Usage Type») ……………………………109 2.3.13 Справочник №13 «Статус бизнес заказа» (Voc №13 «Order status»)………………………….110 2.3.14 Справочник №14 «Причина выбытия» (Voc №14 «Dropout reason»)…………………………111 2.3.15 Справочник №15 «Тип кода маркировки» (Voc №15 «IC type»)……………………………….112 2.4 Формат и коды ошибок (Format and error codes)……………………………………………………………..113 2.4.1 Формат ошибки (Error format)…………………………………………………………………………………113 2.4.2 Описание ошибок (Error description) ……………………………………………………………………….114 3 Матрица предоставления сервисов API СУЗ 2.0 компонентами программного комплекса СУЗ (Matrix of providing services of API OMS 2.0 by components of the OMS software complex)………………115