Goods

Создать товар/категорию

Создание товара или категории в UDS. После успешного создания, товар отобразится в UDS, а идентификатор созданной категории можно будет использовать для указания nodeId при создании других товаров, а также для получения списка товаров.

Основные моменты

  • Тип создаваемого объекта указывается в поле data.type. Допустимо 3 значения:
    • CATEGORY - для создания категории товаров
    • ITEM - для создания товара
    • VARYING_ITEM - для создания товара с вариантами
  • Можно создать подкатегорию в категории (допускается три уровня вложенности).
  • Можно создать 20 категорий в основном списке, по 20 подкатегорий для каждой категории и по 20 подкатегорий для каждой подкатегории.
  • Для создания товара без категории следует указать значение null в поле nodeId
  • Для создания товара без ограничения по количеству следует указать значение null в поле inStock.
СтатусКод ошибкиОписание
400badRequestВозникли ошибки при валидации. Для получения подробной информации об ошибке обратитесь к полю errors.
400goods.nodeIndex.invalidДля создания категории указание идентификатора nodeId недопустимо
400goods.limitIsReachedПревышен лимит количества товаров
401unauthorizedНеверно указан ID компании или API Key
post/goods

Request body

idinteger

ID товара.

namestring required

Название товара / категории.

nodeIdinteger nullable

ID категории, в которой находится товар / категория.

externalIdstring nullable

Внешний идентификатор товара / категории.

dateCreatedstring date-time

Дата создания товара / категории.

hiddenboolean nullable

Скрыт ли товар / категория.

blockedboolean nullable

Заблокирован ли товар / категория.

imageUrlsstring[]

Список ссылок на изображение товара.

Response

Созданный товар или категория.

idinteger

ID товара.

namestring required

Название товара / категории.

nodeIdinteger nullable

ID категории, в которой находится товар / категория.

externalIdstring nullable

Внешний идентификатор товара / категории.

dateCreatedstring date-time

Дата создания товара / категории.

hiddenboolean nullable

Скрыт ли товар / категория.

blockedboolean nullable

Заблокирован ли товар / категория.

imageUrlsstring[]

Список ссылок на изображение товара.

Changes