Добавить/изменить карточку (физический товар) (асинхронный, batch)

POST /v1/product-cards/physical/set

POST/v1/product-cards/physical/set

Асинхронное batch-создание/обновление карточек. Возвращает request_id.

Тело запроса

request_key
[ "string", "null" ]
Ключ идемпотентности (опц.)
cards
array
required
Массив карточек
Одна карточка товара для создания/обновления.
Показать свойства
seller_sku_id
string
required
SKU продавца (обязательный, уникальный)
seller_spu_id
[ "string", "null" ]
SPU продавца (опц.)
seller_default_offer_id
[ "string", "null" ]
Default offer ID (опц.; если не указан - seller_sku_id)
category_id
string
required
ID категории (листовой)
brand_id
string
required
ID бренда (обязательный)
name
string
required
Название товара (основной язык)
slug
[ "string", "null" ]
URL-слаг (опц.)
description
[ "string", "null" ]
Описание (опц.)
tags
[ "array", "null" ]
Теги (опц.)
media
[ "array", "null" ]
Медиа (изображения и видео, URL-импорт)
Показать свойства
Свойства не описаны
attributes
[ "array", "null" ]
Атрибуты
Показать свойства
Свойства не описаны
seller_recomendation
[ "array", "null" ]
Рекомендации продавца (сопутствующие товары, например щётки для пылесоса). Можно указать seller_sku_id и опционально spu_id для ссылки на SPU.
Показать свойства
Свойства не описаны
ru
Секция RU
wh
Секция WH
dimensions
Весогабариты брутто (в упаковке). Используются для логистики и складского учёта. Витрина может отобразить эти данные в карточке товара.
locales
[ "array", "null" ]
Локализация
Показать свойства
Свойства не описаны
is_in_bundle_only
boolean
Только в составе комплекта
model
[ "string", "null" ]
Наименование модели товара (опц.)
vendor_code
[ "string", "null" ]
Артикул производителя (опц.)
warranty
Срок гарантии (опц.)
certificates
[ "array", "null" ]
URL на файлы сертификатов (опц.)
manuals
[ "array", "null" ]
URL на файлы инструкций (опц.)
sample
Параметры уценённого товара (опц.; если указан — товар считается уценённым)

Успешный ответ

200Принят
application/json
object
request_id
string
required
ID запроса для получения результата через /v1/product-cards/set/results
request_key
[ "string", "null" ]
Эхо ключа идемпотентности
cards_count
integer
required
Количество принятых карточек
created_at
string
required
idempotent
[ "boolean", "null" ]
POST/v1/product-cards/physical/set
1curl https://api.omninet.ru/v1/product-cards/physical/set \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "cards": [6    {7      "seller_sku_id": "sku_red_sneakers_42",8      "category_id": "cat_sneakers",9      "brand_id": "brand_nike",10      "name": "Кроссовки Nike Air Max красные",11      "attributes": [12        {13          "attribute_id": "attr_color",14          "values": [15            {16              "value_id": "val_red"17            }18          ]19        },20        {21          "attribute_id": "attr_shoe_size",22          "values": [23            {24              "number": 42,25              "unit_code": "eu"26            }27          ]28        }29      ]30    }31  ]32}'
{
  "request_id": "string",
  "request_key": null,
  "cards_count": 0,
  "created_at": "string",
  "idempotent": null
}

Принят