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

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

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

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

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

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

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

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

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

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

Метод возвращает справочный список всех кодов ТН ВЭД. Чтобы найти код по его фрагменту, укажите первые цифры кода в параметре search.

Метод возвращает список кодов ОКПД2 по ID предмета и фрагменту кода ОКПД2.

Метод возвращает справочный список всех кодов ОКПД2. Чтобы найти код по его фрагменту, укажите первые цифры кода через точку в параметре search.

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

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

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

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

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

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

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

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

Создание карточки товара происходит асинхронно. Синхронизация новой карточки с сервисами может занимать до 30 минут. В течение этого времени невозможно добавить остатки на склады и настроить цены.
В песочнице карточка товара создаётся сразу, без ожидания.

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

Чтобы прикрепить документы к карточке товара, передайте данные документов в объекте запроса documents.
Чтобы подтвердить, что для товара не требуются документы, передайте true в параметре excludeDocuments.

Проверка документов выполняется асинхронно и может занимать до 3 дней. При изменении карточки или документа проверка запускается повторно.
Результаты проверки отображаются в списке карточек товаров, объект documents:

• результат по каждому документу в полях verdict объекта items. Если verdict не возвращается в ответе — проверка документа ещё не завершена
• итоговый общий результат по карточке в поле overallVerdict. При общей проверке карточки учитываются не только результаты проверки документов, но и другие данные. Например, наличие обязательной маркировки и сведения из внешних реестров. Если overallVerdict не возвращается в ответе — проверка карточки ещё не завершена

Метод создаёт карточки товаров, присоединяя их к существующим отдельным карточкам и группам объединённых карточек. В одной группе объединённых карточек товаров может быть не более 30 карточек, соответственно, создать с присоединением можно не более 29 карточек товаров за один запрос.

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

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

Чтобы прикрепить документы к карточке товара, передайте данные документов в объекте запроса documents.
Чтобы подтвердить, что для товара не требуются документы, передайте true в параметре excludeDocuments.
Проверка документов выполняется асинхронно и может занимать до 3 дней. При изменении карточки или документа проверка запускается повторно.
Результаты проверки отображаются в списке карточек товаров, объект documents:

• результат по каждому документу в полях verdict объекта items. Если verdict не возвращается в ответе — проверка документа ещё не завершена
• итоговый общий результат по карточке в поле overallVerdict. При общей проверке карточки учитываются не только результаты проверки документов, но и другие данные. Например, наличие обязательной маркировки и сведения из внешних реестров. Если overallVerdict не возвращается в ответе — проверка карточки ещё не завершена

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

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

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

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

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

Чтобы получать только карточки товаров, которые были созданы или обновлены после предыдущей выгрузки данных:

1. Сохраните поля "cursor":{"updatedAt":"***","nmID":"***"} из последнего ответа предыдущей выгрузки. При выгрузке используйте сортировку по возрастанию: "sort":{"ascending":true}.
2. Укажите в первом запросе сохранённые поля "cursor":{"updatedAt":"***","nmID":"***"}. Продолжайте использовать сортировку по возрастанию.
3. Сохраните поля "cursor":{"updatedAt":"***","nmID":"***"} из последнего ответа текущей выгрузки.

В объекте documents метод возвращает:

• информацию о переданных документах — массив items
• результаты проверки по каждому документу — объект verdict в items. Если verdict не возвращается в ответе — проверка документа ещё не завершена
• результат проверки всей карточки — объект overallVerdict. Проверка всей карточки включает проверку не только документов, но и других данных. Например, наличия обязательной маркировки и сведений из внешних реестров. Если overallVerdict не возвращается в ответе — проверка карточки ещё не завершена

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

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

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

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

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

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

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

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

С помощью этого метода нельзя обновлять или удалять:

• баркоды размеров товара. Можно только добавить дополнительные баркоды
• параметры photos, video и tags
• цены товаров. Цену можно задать, только если вы добавляете новые размеры

При добавлении нового размера укажите его цену через параметр price. Если в запросе не указан price, цена размера будет 0 — в этом случае изменить её можно будет с помощью методов:

• Установить цены и скидки, если у товара "editablePriceSize":false
• Установить цены для размеров, если у товара "editablePriceSize":true

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

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

Чтобы прикрепить документы к карточке товара, передайте данные документов в объекте запроса documents.
Чтобы внести изменения в прикрепленный к карточке документ, передайте id документа и его данные в объекте запроса documents. Получить id документа вы можете в списке карточек товара. После изменения документа или добавления нового документа карточка повторно отправляется на проверку.

Проверка документов выполняется асинхронно и может занимать до 3 дней.
Вы можете изменить карточку снова до завершения текущей проверки. При этом проверка запустится повторно, а карточка сохранит текущий статус до завершения новой проверки.
Если карточка была доступна для продажи до обновления документа, она будет доступна и до получения нового результата проверки. Если карточка уже была заблокирована, то после обновления данных она останется заблокированной до получения положительного результата повторной проверки.

Результаты проверки отображаются в списке карточек товаров, объект documents:

• результат по каждому документу в полях verdict объекта items. Если verdict не возвращается в ответе — проверка документа ещё не завершена
• итоговый общий результат по карточке в поле overallVerdict. При общей проверке карточки учитываются не только результаты проверки документов, но и другие данные. Например, наличие обязательной маркировки и сведения из внешних реестров. Если overallVerdict не возвращается в ответе — проверка карточки ещё не завершена

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

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

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

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

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

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

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