Работа с товарами (products)

Метод возвращает названия и ID всех родительских категорий для создания карточек товаров: например, Электроника, Бытовая химия, Рукоделие.

Метод возвращает список названий родительских категорий предметов и их предметов с ID. Например, у категории Игрушки будут предметы Калейдоскопы, Куклы, Мячики.

Метод возвращает параметры характеристик предмета: названия, типы данных, единицы измерения и так далее. В запросе необходимо указать ID предмета.

Метод возвращает возможные значения характеристики предмета Цвет.

Метод возвращает возможные значения характеристики предмета Пол.

Метод возвращает возможные значения характеристики предмета Страна производства.

Метод возвращает возможные значения характеристики предмета Сезон.

Метод возвращает возможные значения характеристики предмета Ставка НДС.

Метод возвращает список ТНВЭД-кодов по ID предмета и фрагменту ТНВЭД-кода.

Возвращает бесплатные и платные лимиты продавца на создание карточек товаров.

Формула для получения количества карточек, которые можно создать:

(freeLimits + paidLimits) - количество созданных карточек

Созданными считаются карточки, которые можно получить через методы список карточек товаров и список карточек товаров в корзине.

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

Метод создаёт карточки товаров c указанием описаний и характеристик товаров.

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

Создание карточки товара происходит асинхронно. После отправки запрос становится в очередь на обработку.
В одном запросе можно создать максимум 100 объединённых карточек товаров (imtID), по 30 карточек товаров в каждой. Максимальный размер запроса 10 Мб.
Если ответ Успешно (200), но какие-то карточки не создались, проверьте список несозданных карточек товаров.

Метод создаёт новые карточки товаров, присоединяя их к существующим карточкам.

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

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

Метод возвращает список созданных карточек товаров.

Чтобы получить больше 100 карточек товаров, используйте пагинацию:

1. Сделайте первый запрос:
   

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

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

Метод возвращает список карточек товаров (черновиков), при создании или редактировании которых произошли ошибки, с описанием этих ошибок.

Данные в ответе возвращаются пакетами batch. Один пакет содержит:

• все ошибки по одной объединённой карточке товара imtID одного запроса при создании карточек товаров
• все ошибки одного запроса при создании с присоединением или редактировании карточек товаров
  
  Чтобы получить более 100 пакетов, используйте пагинацию:

1. Сделайте первый запрос:
   

      {
        "cursor": {
          "limit": 100
        },
        "order": {
          "ascending": true
        }
      }

2. Скопируйте "updatedAt": "***","batchUUID": "***" из cursor ответа и вставьте в cursor запроса.
3. Повторите запрос.
4. Повторяйте пункты 2 и 3, пока не получите в ответе "next": false. Это будет означать, что вы получили все пакеты.

Метод обновляет карточки товаров. Данные для обновления можно получить через список карточек товаров и список карточек товаров в корзине.

Нельзя редактировать или удалять баркоды, но можно добавить дополнительный баркод к карточке товара. Параметры photos, video и tags редактировать или удалять через данный метод нельзя.
Габариты товаров можно указать только в сантиметрах, вес товара с упаковкой — в килограммах.

В одном запросе можно отредактировать максимум 3000 карточек товаров (nmID). Максимальный размер запроса 10 Мб.
Если ответ Успешно (200), но какие-то карточки не обновились, проверьте список несозданных карточек товаров.

Метод объединяет и разъединяет карточки товаров. Карточки товаров считаются объединёнными, если у них одинаковый imtID.

Для объединения карточек товаров сделайте запрос с указанием imtID. Можно объединять не более 30 карточек товаров.
Для разъединения карточек товаров сделайте запрос без указания imtID. Для разъединенных карточек будут сгенерированы новые imtID.

Если вы разъедините одновременно несколько карточек товаров, эти карточки объединятся в одну и получат новый imtID.
Чтобы присвоить каждой карточке товара уникальный imtID, необходимо передавать по одной карточке товара за запрос.

Максимальный размер запроса 10 Мб.

Метод переносит карточки товаров в корзину. При этом карточки товаров не удаляются, их можно восстановить.

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

Метод восстанавливает карточки товаров из корзины.

Метод возвращает список карточек товаров в корзине.

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

1. Сделайте первый запрос:
   

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

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

Метод загружает и добавляет один медиафайл к карточке товара.

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

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

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

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

Метод загружает набор медиафайлов в карточку товара через указание ссылок в запросе.

Требования к ссылкам:

• ссылка должна вести прямо на файл. Убедитесь, что ссылка не ведёт на страницу предпросмотра или авторизации, например. Если по ссылке открывается текстовая страница TXT или HTML, ссылка считается некорректной
• для доступа к файлу по ссылке не нужна авторизация

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

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

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

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

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

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

Метод добавляет один ярлык продавца. Можно создать максимум 15 ярлыков для одного продавца. Максимальная длина ярлыка — 15 символов.
Созданный ярлык можно получить в общем списке.

Метод заменяет данные ярлыка: имя и цвет.
Новые данные можно получить в общем списке.

Метод удаляет ярлык из списка ярлыков продавца.