СУЗ: ИЗКМ - Описание LEGACY-API

Цель работы специального программного обеспечения "Станция управления заказами" (СУЗ)- выполнение производителями и импортерами ключевых операций при производстве маркированной продукции, включая:

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

ИЗКМ (ICOM) используется при маркировке следующих товарных групп:

* до указанной даты используется СУЗ (Облако 3.1).

В документации приведено описание программного интерфейса взаимодействия (API) cтанции управления заказами - СУЗ (ИЗКМ), в котором взаимодействие осуществляется по протоколу HTTP, используя формат JSON.

Базовая последовательность вызова методов СУЗ (ИЗКМ) при создании нового заказа на эмиссию кодов маркировки:

1. Проверка доступности сервисов СУЗ (ИЗКМ).
2. Создание заказа на эмиссию КМ.
3. Получение КМ из буфера заказа.
4. Закрытие заказа/подзаказа по заданному GTIN.
5. Создание отчета о нанесении КМ.
6. Создание отчета об агрегации КМ.
7. Создание отчета о списании (отбраковке) КМ.

API также предоставляет вспомогательные методы:

1. Получение отчета / статуса обработки отчета по идентификатору отчета.
2. Получение списка заказов УОТ/получение статуса заказов.
3. Получение списка идентификаторов пакетов КМ.
4. Повторное получение КМ из заказа.

Ключевые отличия СУЗ (ИЗКМ) от СУЗ (Облако 3.1):

1. Реализована возможность подачи "Отчета о нанесении (использовании) кодов маркировки" (api/v2/{extension}/utilisation):

• отчет о нанесении (использовании) кодов маркировки формируется участниками оборота самостоятельно (с учетом производственного цикла)
• отчет может содержать дату производства ("productionDate), номер производственной серии ("seriesNumber") и дату истечения срока годности ("expirationDate") маркированной продукции

2. Метод «Создание заказа на эмиссию КМ» (api/v2/{extension}/orders):

• исправлена ошибка, при которой для отдельных параметров ("quantity", "templateId"), которые являются числовыми (integer), допускалось передача строки (string);
• исправлена ошибка, при которой в запросе допускалось отсутствие отдельных параметров ("templateId"), которые являются обязательными;
• добавлено необязательное поле "Тариф" ("rateType"), необходимое для заказа кодов маркировки, услуга по которым предоставляется Оператором без взимания платы.

3. Метод «Получение КМ из подзаказа» (api/v2/{extension}/codes):

• исправлена ошибка, при которой некорректно обрабатывался параметр "lastBlockId" – в случае, если из заказа выгружается только часть заказанных кодов, то запрос на выгрузку оставшейся части кодов маркировки из того же заказа, должен содержать значение параметра "lastBlockId", равный идентификатору пакета кодов, полученных в предыдущем запросе ("BlockId"), в ином случае выгружаться будет первый полученный пакет кодов.

4. Метод «Получение статуса массива КМ из заказа» (api/v2/{extension}/ buffer/status):

• исправлена ошибка в описании параметра "poolInfos" в ответе – параметр "poolInfos" является необязательным и заполняется только после выгрузки первого пакета кодов маркировки ("BlockId"), по отклоненным заказам и по заказам, из которых коды маркировки не выгружались, параметр "poolInfos"не заполняется.

5. Метод «Получение списка заказов (api/v2/{extension}/orders):

• реализована возможность формирования списка заказов с учетом статуса заказа ("status") и даты создания (от "dateFrom" до "dateTo")

6. Метод «Создание отчета об агрегации КМ» (api/v2/{extension}/aggregation):

• исправлена ошибка, при которой в запросе для отдельных параметров ("aggregatedItemsCount", "aggregationUnitCapacity"), которые являются числовыми ("integer"), допускалось использование строки ("string").

7. Прекращена поддержка следующих методов:

• метод «Получить версию СУЗ и API» (api/v2/{extension}/version)
• метод «Получить маркер безопасности по имени пользователя и паролю» (api/v2/{extension}/token)
• метод «Получить информацию об агрегации» (api/v2/{extension}/aggregation/info)