Каталог бренда: модели своих брендов

Кому

Организации — подтверждённому владельцу бренда: заявка на владение подаётся во вкладке «Бренды» организации. Модели своих брендов организация ведёт бесплатно, её значения старше импорта открытых источников. Ключу нужно разрешение «Ведение моделей брендов», вызывающему — право управлять объявлениями организации.

Пакет

Модели передаются пакетом на POST /rest/v1/catalog/seller/model-nodes/sync с заголовком Idempotency-Key — повтор и занятый ключ ведут себя так же, как у синхронизации каталога. Поля пакета: organizationId — организация-владелец, defaultCategoryId — категория строк без своей, publish — публиковать модели после записи, items — строки.

{
  "organizationId": "0192f0c0-0000-7000-8000-00000000000a",
  "defaultCategoryId": "0192f0c0-0000-7000-8000-000000000001",
  "publish": true,
  "items": [
    {
      "brand": "Atlas",
      "name": "GA 30",
      "barcode": "4006381333931",
      "manufacturerCode": "GA30-VSD",
      "attributes": { "Мощность": "30", "Привод": "прямой, ремённый" },
      "imageUrls": ["https://example.org/img/ga30.jpg"]
    }
  ]
}

Строка

brand — бренд подписью либо ключом; у организации с одним брендом его можно не указывать. name — имя модели, бренд в начале имени снимается. categoryId либо categorySlug — категория идентификатором либо адресным сегментом её страницы. attributes — характеристики категории подписью либо ключом со значением текстом, несколько значений — через запятую; характеристика вне категории пропускается. imageUrls — фото, площадка забирает их сама и ставит модели присланный набор целиком.

Сопоставление

Строка находит модель штрихкодом, затем кодом производителя в бренде, затем именем модели в бренде и категории; не нашла — заводит модель черновиком. Строки одного пакета об одной модели её не задваивают. Значения, поправленные редактором платформы, строка не перетирает.

Публикация

С признаком publish модель публикуется сразу после записи. Характеристику без значения модели продавец заполняет в своём объявлении.

Ответ

Строки в порядке запроса: modelNodeId, признак created, при отказе — error и errorDetails; итоги — accepted, created, updated, failed. Отказ строки остальные не отменяет. Причины отказа: BRAND_NOT_OWNED — бренд не принадлежит организации, ATTRIBUTE_INVALID_TYPE — значение не приводится к характеристике, MODEL_CODE_TAKEN — код занят другой моделью, MODEL_CODE_INVALID — штрихкод вне GTIN. Пакет сверх потолка строк либо фото строки отклоняется целиком кодом SELLER_SYNC_BATCH_TOO_LARGE либо SELLER_SYNC_IMAGES_TOO_MANY, потолок назван в справочнике операций и в деталях ошибки.