Описание API Контента

Создание карточки товара происходит асинхронно, при отправке запроса на создание карточки ваш запрос становится в очередь на создание.

Внимание. Карточка считается созданной, если создалась хотя бы одна номенклатура в ней. Если во время обработки запроса в очереди выявляются ошибки, то номенклатура считается ошибочной.

Как создать карточку:

1. Получите список всех категорий с помощью метода Родительские категории товаров
2. Получите список доступных предметов (подкатегорий) с помощью метода Список предметов (подкатегорий)
3. Получите характеристики, которые можно задавать в этом предмете (подкатегории), с помощью метода Характеристики предмета (подкатегории). Для характеристик Цвет, Страна производства, Сезон, Ставка НДС, ТНВЭД используйте значения из раздела Конфигуратор.
4. Отправьте запрос. Если ответ Успешно (200), но какие-то карточки не создались, проверьте ошибки с помощью метода Список несозданных номенклатур (НМ) с ошибками.

В одном запросе можно создать максимум 100 карточек (imtID) и по 30 номенклатур (nmID) в каждой. Максимальный размер запроса 10 Мб.

Габариты товаров можно указать только в сантиметрах.

Обновляет карточку товара. Данные для обновления можно получить с помощью метода Список номенклатур (НМ)

Нельзя редактировать или удалить баркоды, но можно добавить баркод к существующему. Параметры photos, video и tags передавать не обязательно, их нельзя редактировать или удалять в этом методе.

Если ответ Успешно (200), но какие-то карточки не изменились, проверьте ошибки с помощью метода Список несозданных номенклатур (НМ) с ошибками.

В одном запросе можно отредактировать максимум 3000 номенклатур (nmID). Максимальный размер запроса 10 Мб.

Габариты товаров можно указать только в сантиметрах.

Метод позволяет добавить к карточке товара новую номенклатуру.
Добавление НМ к КТ происходит асинхронно, после отправки запрос становится в очередь на обработку.
Важно! Если после успешной отправки запроса номенклатура не создалась, то необходимо проверить раздел "Список несозданных НМ с ошибками".
Для того чтобы убрать НМ из ошибочных, необходимо повторно сделать запрос с исправленными ошибками.
Максимальный размер запроса 10 Мб.

Габариты товаров можно указать только в сантиметрах.

Метод позволяет объединять номенклатуры (nmID) под одним imtID и разъединять их.

Для объединения НМ необходимо отправить запрос со списком НМ с заполненным параметром targetIMT в теле запроса. При этом все НМ объединятся под imtID указанном в targetIMT.

Чтобы отсоединить НМ от карточки, необходимо передать эту НМ без параметра targetIMT в теле запроса.
При этом для передаваемой НМ создается новый imtID.
Если в запросе на разъединение передается несколько НМ, то все они автоматически объединятся под одним новым imtID.
Чтобы присвоить каждой НМ уникальный imtID необходимо передавать по одной НМ за запрос. Для НМ, не участвующих в запросе, никаких изменений не происходит.
Максимальный размер запроса 10 Мб.

ВАЖНО: Объединить можно только номенклатуры с одинаковыми предметами.
ВАЖНО: В одной КТ (под одним imtID) не может быть больше 30 номенклатур (nmID).

Метод позволяет сгенерировать массив уникальных баркодов для создания размера НМ в КТ.

Метод позволяет получить список созданных НМ с фильтрацией по разным параметрам, пагинацией и сортировкой.

Метод доступен по токену с опцией Продвижение

Важно. Карточки, находящиеся в корзине, в ответе метода не выдаются.
Получить такие карточки можно только методом "Список НМ, находящихся в корзине".

Порядок работы с get/cards/list:
Чтобы получить полный список номенклатур, если их больше 100, необходимо воспользоваться пагинацией.

1. Сделать первый запрос (все указанные ниже параметры обязательны):
   

           {
             "settings": {
               "cursor": {
                 "limit": 100
               },
               "filter": {
                 "withPhoto": -1
               }
             }
           }

   
   
2. Пройти в конец полученного списка номенклатур, скопировать из cursor две строки:
   • "updatedAt": "***",
   • "nmID": ***,
3. Вставить скопированные строки в cursor запроса, повторить вызов метода.
4. Повторять пункты 2 и 3, пока total в ответе не станет меньше чем limit в запросе.
   Это будет означать, что Вы получили все карточки.

Метод позволяет получить список НМ и список ошибок которые произошли во время создания КТ.
ВАЖНО: Для того чтобы убрать НМ из ошибочных, надо повторно сделать запрос с исправленными ошибками на создание КТ.

Метод позволяет получить отдельно бесплатные и платные лимиты продавца на создание карточек товаров.
Формула для получения количества карточек, которые можно создать: (freeLimits + paidLimits) - Количество созданных карточек.
Созданными считаются все карточки, которые можно получить методами "Список НМ" и "Список НМ, находящихся в корзине".

С помощью данного метода можно получить список всех родительских категорий товаров.

С помощью данного метода можно получить список всех доступных предметов, родительских категорий предметов, и их идентификаторов.

Получение списка характеристик предмета по его ID.

Получение значения характеристики цвет.

Получение значения характеристики пол.

Получение значения характеристики Страна Производства.

Получение значения характеристики Сезон.

С помощью данного метода можно получить список ТНВЭД кодов по ID предмета и фильтру по ТНВЭД коду.

С помощью данного метода можно получить список значений для характеристики Ставка НДС.

Изменяет набор медиафайлов для товара (номенклатуры).

Внимание. Новые медиафайлы (data) полностью заменяют старые (mediaFiles). Чтобы добавить новые медиафайлы, укажите ссылки не только на них, но и на старые файлы.

Требования к изображениям:

• максимум изображений для одного товара (номенклатуры) — 30;
• минимальное разрешение – 700 × 900 пикселей;
• максимальный размер — 32 Мб;
• минимальное качество — 65%;
• форматы — JPG, PNG, BMP, GIF (статичные), WebP.

Требования к видео:

• максимум 1 видео для одного товара (номенклатуры).
• максимальный размер — 50 Мб;
• форматы — MOV, MP4.

Если хотя бы одно изображение в запросе не соответствует требованиям, то даже при успешном ответе (200) ни одно изображение не загрузится

Добавляет один медиафайл для товара (номенклатуры).

Требования к изображениям:

• максимум изображений для одного товара (номенклатуры) — 30;
• минимальное разрешение – 700 × 900 пикселей;
• максимальный размер — 32 Мб;
• минимальное качество — 65%;
• форматы — JPG, PNG, BMP, GIF (статичные), WebP.

Требования к видео:

• максимум 1 видео для одного товара (номенклатуры);
• максимальный размер — 50 Мб;
• форматы — MOV, MP4.

Метод позволяет получить список существующих тегов продавца.

Метод позволяет создать тег.
Завести можно 15 тегов.
Максимальная длина тега 15 символов.

Метод позволяет изменять информацию о теге (имя и цвет).

Метод позволяет удалить тег   

Метод позволяет добавить теги к КТ и снять их с КТ.
При снятии тега с КТ сам тег не удаляется.
К карточке можно добавить 15 тегов.

Метод позволяет перенести НМ в корзину. Перенос карточки в корзину не является удалением карточки.
ВАЖНО: При переносе НМ в корзину, данная НМ выходит из КТ, то есть ей присваивается новый imtID.
Карточка товара удаляется автоматически, если лежит в корзине больше 30 дней.
Корзина зачищается от карточек, лежащих в ней более 30 дней, каждую ночь по Московскому времени.

Метод позволяет восстановить НМ из корзины.
ВАЖНО: При восстановлении НМ из корзины она не возвращается в КТ в которой была до переноса в корзину, то есть imtID остается тот же, что и был у НМ в корзине.

Метод позволяет получить список НМ, находящихся в корзине.

Метод доступен по токену с опцией Продвижение


Порядок работы.
Чтобы получить полный список номенклатур, если их больше 100, необходимо воспользоваться пагинацией.

1. Сделать первый запрос (все указанные ниже параметры обязательны):
   

           {
             "settings": {
               "cursor": {
                 "limit": 100
               }
             }
           }

   
   
2. Пройти в конец полученного списка номенклатур, скопировать из cursor две строки:
   • "trashedAt": "***",
   • "nmID": ***,
3. Вставить скопированные строки в cursor запроса, повторить вызов метода.
4. Повторять пункты 2 и 3, пока total в ответе не станет меньше чем limit в запросе.
   Это будет означать, что Вы получили все карточки.