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

Атрибутивный состав можно запросить по коду группы ТНВЭД (как правило, он известен и указан в соответствующей нормативной документации), или по идентификатору категории товара в Национальном каталоге.

На текущий момент, для всех товарных групп, кроме Табачной продукции, используется четырехзначный код группы ТНВЭД. Для Табачной продукции - 10 знаков.

Актуальная информация по маркируемым товарным группам и кодам ТНВЭД представлена на сайте честныйзнак.рф.

Пример запроса с использованием кода группы ТНВЭД:

GET  https://апи.национальный-каталог.рф/v3/attributes?apikey=XXX&tnved=3033&attr_type=m

Для того, чтобы определить категорию, к которой относится товар, необходимо воспользоваться методом categories. Данный метод позволяет до уточнить категорию товара. Определение основной категории будет происходить по атрибуту tnved при формировании запроса по методу feed.

Запрос вернет список категорий, из которой нужно будет выбрать ту, к которой Вы собираетесь отнести создаваемую карточку товара. И уже по ней запросить атрибутивный состав карточки.

Пример запроса с использованием категории классификатора товаров НК:

GET  https://апи.национальный-каталог.рф/v3/attributes?apikey=XXX&cat_id=30933&attr_type=m

При просмотре обязательных к заполнению атрибутов будут отображены атрибуты первого и второго слоя.

Атрибуты делятся на слои следующим образом:

  • Первый слой — минимальный набор атрибутов, необходимый для создания черновика карточки и возможности эмиссии кодов маркировки. К ним относятся: Код товара, ТНВЭД, наименование товара, товарный знак.
  • Второй слой — обязательные атрибуты, необходимые для полного описания товара и возможности ввода кодов маркировки в оборот. Второй слой атрибутов разный для разных товарных групп, в зависимости от того, что указано в Правилах маркировки для той или иной товарной группы. Без заполнения второго слоя карточка не может быть подписана и, соответственно, код маркировки, выпущенный для такого товара, не может быть введён в оборот.
  • Третий слой — условный, представляет из себя необязательные атрибуты, которые заполняются по желанию для более полного информирования потребителя о своём товаре.
Запрос основных атрибутов товара

Для получения информации по обязательным для заполнения атрибутам в запросе по методу attributes потребуется указать attr_type=m.

Запрос всех атрибутов товара

Для получения информации по полному перечню атрибутов в запросе по методу attributes потребуется указать attr_type=a или же не указывать параметр attr_type и его значение.


Как создать карточку товара
Перед созданием карточки товара необходимо ознакомиться с обязательным к заполнению атрибутивным составом c помощью метода attributes для данной товарной позиции, так как для направления карточки товара на модерацию он должен быть заполнен в полном объеме.
Если это новая карточка товара (ранее не описывалась в ГС1), то для нее потребуется сгенерировать код товара (GTIN) с помощью метода generate-gtins.
Для создания черновика карточки товара формируется запрос по методу feed, минимально в теле запроса требуется указать код товарной позиции, код ТНВЭД, товарный знак, полное наименование. При формировании карточки товара в каталоге Вам будут доступны для указания/выбора только те коды ТНВЭД, которые соответствуют выбранным Вами в ЕЛК товарным группам. (Если указанная в фиде карточка товара была описана ранее в ГС1 и поле код ТНВЭД не было заполнено, то добавить такую карточку товара в Каталог можно через личный кабинет. Добавление такой карточки товара через API на текущий момент невозможно, подобный фид будет отклонен.)
Если карточка товара является комплектом, то потребуется указать признак is_kit равный 1.
Если карточка товара является набором, то потребуется указать признак is_set равный 1.
Указание кода ТНВЭД (атрибуты tnved, 3959, 13933).
Если в Каталоге зарегистрирован четырехзначный код группы ТНВЭД, то он указывается в атрибуте tnved (атрибут 3959 при этом не заполняется), а в атрибуте 13933 указывается десятизначный код ТНВЭД.
Если в Каталоге зарегистрирован десятизначный код ТНВЭД для четырехзначного кода группы ТНВЭД, то он указывается в атрибуте tnved (атрибуты 3959 и 13933 при этом не заполняются).
Проверить зарегистрирован ли в Каталоге четырехзначный или десятизначный код ТНВЭД можно с помощью метода mark-check.
Создание карточки товара с техническим GTIN
Если требуется сформировать техническую карточку товара (описание остатков или описание карточки товара для перемаркировки), то вместо кода товара в теле запроса указывается признак is_tech_gtin равный 1 (технический GTIN будет сгенерирован системой).
Создание карточки товара с иностранным GTIN
Создание карточки товара с иностранным GTIN производится так же, как и с российским GTIN. Для ее создания потребуется сформировать запрос по методу feed.
Перед обработкой запроса система проверяет наличие карточки товара (с указанным в запросе по методу feed кодом товара) в системе ГС1.
Если карточка товара отсутствует в Каталоге и есть в ГС1, при этом в фиде и в ГС1 не совпадают значения атрибутов ТН ВЭД и Товарный знак, то фид будет отклонен.
Если карточка товара отсутствует в Каталоге и есть в ГС1, при этом в фиде и в ГС1 совпадают значения атрибутов ТН ВЭД и Товарный знак, то информация о карточке будет загружена из ГС1 и затем фид будет обработан.
Если карточка товара с таким кодом товара ранее не описывалась ни в Каталоге, ни в ГС1, то при успешной обработке фида будет сформирована карточка товара.
Создание черновика карточки товара на основе ранее опубликованной карточки
Если карточка товара была опубликована в каталоге ранее, то при создании черновика на основании такой карточки в теле фида потребуется указать good_id (вместо gtin), а для редактирования будут доступны только атрибуты третьего слоя.

Как отправить карточку товара на модерацию
Отправка карточек товаров на модерацию при создании
Карточку товара можно направить на модерацию сразу после ее создания в каталоге, если в теле запроса по методу feed указать признак moderation равный 1. Если в теле запроса по методу feed признак moderation был указан равным 0 или не был указан, то карточка товара будет сформирована и приобретет статус "Черновик".
Отправка карточек товаров на модерацию в статусе "Черновик"
Если карточка товара была сформирована в каталоге ранее, находится в статусе "Черновик" и не требует редактирования, то на модерацию ее можно направить принудительно используя метод feed-moderation.
Пример запроса с использованием кода товара и ИНН Вашей организации:
GET  https://апи.национальный-каталог.рф/v3/feed-moderation?apikey=XXX&gtin=04640002660886&inn=123455678
Пример запроса с использованием идентификатора данной карточки товара в каталоге:
GET  https://апи.национальный-каталог.рф/v3/feed-moderation?apikey=XXX&good_id=7126
Примечание: при использовании данного метода для направления карточек товаров на модерацию Вы сможете увидеть только факт отправления или не отправления карточки на модерацию. Указываемая модераторами информация при отклонении карточки будет доступна для просмотра только через личный кабинет. Для того чтобы получить информацию о причинах отклонения карточки с модерации по API отправление карточки на модерацию должно быть произведено с помощью запроса по методу feed.
Модерация в разных средах
В продуктивной среде каталога модерация карточек товаров производится в порядке очередности, в течении двух рабочих дней.
В тестовой среде каталога модерация производится по запросу в адрес службы технической поддержки (support@national-catalog.ru), который так же будет обработан в порядке очередности.

Как посмотреть текущий статус карточки товара
Получить информацию по статусу карточки товара можно с помощью метода feed-product, в ответе на запрос по данному методу будет отображен атрибут good_status со значением (draft, signed, archive) текущего технологического статуса и атрибут good_detailed_status с массивом текущих статусов выбранной карточки товара.
Пример запроса:
GET  https://апи.национальный-каталог.рф/v3/feed-product?apikey=XXX&gtin=6411300162475

Как посмотреть текущий статус фида
Изменение статуса пакета обновлений (фида) доступно для просмотра с помощью метода feed-status.
Пример запроса:
GET  https://апи.национальный-каталог.рф/v3/feed-status?apikey=XXX&feed_id=7126&verbose=true
При создании/редактировании карточки товара по методу feed (формирование фида), если запрос прошёл форматно-логический контроль, то вернется feed_id (идентификатор пакета обновлений) по которому можно просматривать информацию об изменении статуса отправленного пакета обновлений.
При просмотре информации о статусе обработки данного пакета обновлений методом feed-status можем получить статус PROCESSING из которого следует, что запрос принят системой и находится в очереди на обработку. При этом в самом запросе могут быть ошибки, которые после обработки пакета обновлений будут отображены (при наличии) в ответе на запрос по методу feed-status.
Статус Rejected вернется в том случае, если сам запрос был составлен неправильно.
Так же, при создании/редактировании карточки товара по методу feed можно указать признак moderation равным единице и тогда карточка товара после успешной обработки фида будет сразу направлена на модерацию, а информацию по изменению ее статуса можно будет просмотреть с помощью метода feed-status. То есть в данном случае Вы увидите статус "Received", а после того как модерация будет завершена отобразится статус "Moderated". После подписания методом feed-product-sign (если хотя бы одна карточка была успешно подписана), статус фида изменится на Signed.
Если указать признак moderation равным нулю или не указать его, то карточка товара будет обновлена и не направлена на модерацию. В таком случае ее можно будет направить на модерацию либо с помощью формирования еще одного запроса по методу feed, либо через ЛК или с помощью метода feed-moderation (при этом статус карточки в запросе по методу feed-status меняться не будет, а будет сохраняться статус полученный по итогу обработки запроса feed).

Как отредактировать карточку товара
Для редактирования карточки товара (в статусе "Черновик" или "Требует изменений") формируется запрос по методу feed, в теле запроса указывается идентификатор карточки товара в каталоге (good_id), код товара при этом не указывается, а так же необходимый для заполнения или перезаполнения атрибутивный состав.
При этом необходимо учитывать, что атрибуты первого слоя (за исключением полного наименования) будут не доступны для редактирования после создания карточки товара, а атрибуты второго слоя будут доступны для редактирования до направления карточки на модерацию и в том случае если они были отклонены с модерации, после публикации карточки товара в каталоге атрибуты первого и второго слоя будут недоступны для редактирования.
Получение good_id карточки товара
Получить идентификатор карточки товара можно с помощью метода feed-product.
Пример запроса:
GET  https://апи.национальный-каталог.рф/v3/feed-product?apikey=XXX&gtin=6411300162475

Как подписать карточку товара
Подпись карточки товара можно произвести с помощью метода feed-product-sign или feed-product-sign-pkcs.
При подписании карточек через API в тестовой среде передаваемая в запросе подпись не проверяется системой. В будущих релизах данную проверку планируется включить.
Для того чтобы подписать карточку товара потребуется запросить ее XML с помощью метода feed-product-document, при вызове данного метода в теле запроса указывается массив идентификаторов товаров (goodIds) или кодов товаров (gtins) и Ваше согласие/не согласие на публикацию (publicationAgreement).
Подпись карточки товара методом feed-product-sign
При использовании метода feed-product-sign полученный ранее XML карточки товара подписываете в наиболее удобной для Вас программе (XML самой карточки товара не изменяется, к нему добавляется тег Signature, который содержит в себе информацию о Вашем УКЭП), затем при формировании тела запроса указывается идентификатор товара в каталоге (goodId) и его подписанный XML (xml). В ответе на данный запрос Вы получаете массив успешно подписанных товарных позиций (signed) с указанием их идентификаторов в каталоге (goodId) и массив содержащий идентификаторы товара и текст ошибки, возникшей при обработке переданных XML (errors).
Подпись карточки товара методом feed-product-sign-pkcs
При использовании метода feed-product-sign-pkcs полученный ранее XML карточки товара требуется закодировать в base64, затем при формировании тела запроса указывается идентификатор товара в каталоге (goodId), закодированный в base64 XML карточки товара (base64Xml) и открепленная подпись, закодированная в base64 соответствующая типу CAdES в формате pkcs7 (signature). В ответе на данный запрос Вы получаете массив успешно подписанных товарных позиций (signed) с указанием их идентификаторов в каталоге (goodId) и массив содержащий идентификаторы товара и текст ошибки, возникшей при обработке переданных закодированных в base64 XML (errors).
Подписаться на новые отзывы
Дальнейшие инструкции отправлены на указанный Email
Подписаться на рассылку
Введите количество товара