Назначение специального программного обеспечения "Станция управления заказами" (СУЗ) - выполнение производителями и импортерами ключевых операций при производстве маркированной продукции:
-
формирование заказов на эмиссию кодов маркировки;
-
получение (выгрузка) заказанных кодов маркировки;
-
формирование отчетов о нанесении (использовании) кодов маркировки;
-
формирование отчетов об агрегации маркированной продукции в групповую и (или) транспортную упаковку;
-
формирование отчетов об отбраковке (списание) маркированной продукции.
СУЗ (ИЗКМ) используется при маркировке следующих товарных групп:
|
Товарная группа |
Дата перехода на СУЗ (ИЗКМ)* |
API документация |
API документация |
|
Бытовая и прочая техника |
1 февраля 2023 |
Да |
Да |
|
Лекарственные средства |
1 февраля 2023 |
Да |
Да |
|
Вода и прохладительные напитки |
1 июля 2023 |
Да |
Да |
|
Алкогольная продукция |
1 августа 2023 |
Да |
Да |
|
Пиво и пивная продукция |
1 августа 2023 |
Да |
Да |
|
Табачная продукция |
1 августа 2023 |
Да |
Да |
|
Изделия медицинского назначения |
1 февраля 2025 |
Нет |
Да |
* до указанной даты используется СУЗ (Облако 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)
Ограничения при создании заказов и отчетов:
Заказ на эмиссию кодов маркировки:
-
не более 150 тыс. кодов на каждый товар (GTIN) в заказе
-
не более 10 товаров (GTIN) в одном заказе
-
не более 100 активных заказов (после выполнения заказа и получения кодов маркировки заказ необходимо закрыть, тем самым подтвердив выполнение заказа и получение кодов маркировки)
Отчет о нанесении кодов маркировки:
-
не более 30 тыс. кодов в одном отчете
Отчет об агрегации кодов маркировки:
-
не более 30 тыс. кодов в одном отчете (учитывается совокупное количество агрегируемых кодов и формируемых агрегатов)
Отчет о списании кодов маркировки:
-
не более 30 тыс. кодов в одном отчете
Прикрепленные файлы:
Комментарии
What is the difference between API - SUZ: IZKM and API - NIS ASL BELGISI
Good day. Raj Panchal
IZKM API is necessary for performing actions such as:
Ordering codes, aggregation, application report, write-offs, etc.
NIS MPT API is necessary for performing actions such as:
Checking a code, checking a document, receiving a history of codes
submitting documents to make changes to codes, etc.
A brief description of the differences:
-Authorization method
-In one, authorization is static and in the other, it is dynamic
-There are more methods in NIS MPT API than in IZKM
-IZKM API is used only by those participants who have the legal right to receive codes. while NIS MPT API can be used by all participants registered in Asl Belgisi.
-for some methods, an EDS key will be required for confirmation.
Both of these APIs are useful for specific tasks. Based on your task, you can use these documentation.
Also can you confirm the security, that there is no way to order codes without providing GTIN in the request.
Unfortunately, both documentations are available only in Russian, if you have any questions about the operating principle of the methods, you can send a request to support@crpt-turon.uz technical support service.
We recommend sending such questions to the technical support service, the email is indicated above.
Specifying the GTIN code when ordering codes is a mandatory parameter, without it the order is not possible.
If I am using the IZKM api for pharmaceutical products,
http://<server-name>[:server-port]/api/v2/{extension}/ping
what would be the values of - <server-name> [:server-port] and the {extension}
Войдите в службу, чтобы оставить комментарий.