Goods

Create goods or category

Creating an item/category in UDS. The ID of a successfully created item can be used as a nodeId to create an item/category in this category and get a list of internal items.

Key points

  • The type of the object being created is specified in the data.type field. Three values are supported:
    • CATEGORY — to create a product category
    • ITEM — to create a product item
    • VARYING_ITEM — to create a product with variants
  • You can create subcategories within categories (up to three levels of nesting).
  • You can create up to 20 categories in the main list, 20 subcategories per category, and 20 subcategories per subcategory.
  • To create an item without a category, set nodeId to null.
  • To create an item with unlimited stock, set inStock to null.

Errors

StatusError CodeDescription
400badRequestValidation errors occurred. See the errors field for details.
400goods.nodeIndex.invalidSpecifying a nodeId is not allowed when creating a category.
400goods.limitIsReachedThe product limit has been exceeded.
401unauthorizedInvalid company ID or API Key.
post/goods

Request body

idinteger

Goods ID.

namestring required

Goods name.

nodeIdinteger nullable

ID of the category in which the item is included.

externalIdstring nullable

External goods identifier.

dateCreatedstring date-time

Date item created.

hiddenboolean nullable

Is the goods hidden.

blockedboolean nullable

Is the goods blocked.

imageUrlsstring[]

Array of imageId from presigned url response

Response

Created goods item or category

idinteger

Goods ID.

namestring required

Goods name.

nodeIdinteger nullable

ID of the category in which the item is included.

externalIdstring nullable

External goods identifier.

dateCreatedstring date-time

Date item created.

hiddenboolean nullable

Is the goods hidden.

blockedboolean nullable

Is the goods blocked.

imageUrlsstring[]

Array of imageId from presigned url response

Changes

No recorded changes to this endpoint across all 1 revision of this API.