Цель работы специального программного обеспечения "Станция управления заказами" (СУЗ)- выполнение производителями и импортерами ключевых операций при производстве маркированной продукции, включая:
- формирование заказов на эмиссию кодов маркировки;
- получение (выгрузка) заказанных кодов маркировки;
- формирование отчетов о нанесении (использовании) кодов маркировки;
- формирование отчетов об агрегации готовой, упакованной продукции с нанесёнными средствами цифровой идентификации;
- формирование отчетов об отбраковке (списание) бракованной продукции с нанесёнными средствами цифровой идентификации;.
ИЗКМ (ICOM) используется при маркировке следующих товарных групп:
Товарная группа | Дата перехода на СУЗ (ИЗКМ)* |
Бытовая техника | 1 февраля 2023 |
Лекарственные средства | 1 февраля 2023 |
Вода и прохладительные напитки | 1 июля 2023 |
Алкогольная продукция | 1 августа 2023 |
Пиво и пивная продукция | 1 августа 2023 |
Табачная продукция | 1 августа 2023 |
* до указанной даты используется СУЗ (Облако 3.1).
В документации приведено описание программного интерфейса взаимодействия (API) cтанции управления заказами - СУЗ (ИЗКМ), в котором взаимодействие осуществляется по протоколу HTTP, используя формат JSON.
Базовая последовательность вызова методов СУЗ (ИЗКМ) при создании нового заказа на эмиссию кодов маркировки:
- Проверка доступности сервисов СУЗ (ИЗКМ).
- Создание заказа на эмиссию КМ.
- Получение КМ из буфера заказа.
- Закрытие заказа/подзаказа по заданному GTIN.
- Создание отчета о нанесении КМ.
- Создание отчета об агрегации КМ.
- Создание отчета о списании (отбраковке) КМ.
API также предоставляет вспомогательные методы:
- Получение отчета / статуса обработки отчета по идентификатору отчета.
- Получение списка заказов УОТ/получение статуса заказов.
- Получение списка идентификаторов пакетов КМ.
- Повторное получение КМ из заказа.
Ключевые отличия СУЗ (ИЗКМ) от СУЗ (Облако 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)
Комментарии 0
Войдите в службу, чтобы оставить комментарий.