PUT Upsert Batch Categories

PUT https://{environment}.neomode.com.br/management/catalog/categories

Upsert a list of categories.

❗️

UPSERT STATMENT

An upsert statement checks whether a product already exists with the code specified in the request body and either updates an existing product or creates a new one.

🚧

BATCH

This request is an array, so you can insert more than one category per query.

Request body example:

JSON

[
	{
		"code": "1",
		"name": "Level 1"
	},
	{
		"parentId": "{uuid}",
		"code": "11",
		"name": "Level 2"
	},
	{
		"parentId": "{uuid}",
		"code": "12",
		"name": "Another Level 2"
	},
	{
		"parentId": "{uuid}",
		"code": "121",
		"name": "Level 3"
	}
]

Category Entity

Field	Type	Required	Description
id	string (uuid)	Yes	Unique identifier of the category.
clientId	string	Yes	Identifier of the client submitting a category.
name	string	Yes	Category name.
description	string	Yes	Category description.
code	string	Yes	Internal category code. Can be used for mapping with the ERP.
order	number	Yes	Category position in the display ranking.
imageUrl	string	No	URL of the category's main image.
iconUrl	string	No	Category icon URL (optional).
isActive	boolean	Yes	Set whether the category is active.
parentId	string (uuid)	No	ID of the parent category. If not specified, the category will be considered top-level.