items__createItem

post

https://mcp.alegra.com/tools/items__createItem

Crea un nuevo ítem en la aplicación. El campo type determina qué campos son requeridos:

type	Campos adicionales requeridos
`service`	`unit` (opcional)
`product`	`inventory` (unit, unitCost, warehouses)
`kit`	`subitems` + `kitWarehouse`
`variantParent`	`variantAttributes` (mín 1) + `itemVariants` (opcional)

⚠️
Límite de variantes: Para type=variantParent, el producto cartesiano de las opciones de variantAttributes no puede superar 100 combinaciones. Si se proveen itemVariants explícitos, no pueden superar 100 entradas. El servidor rechazará el request si se supera este límite.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

required

Nombre del ítem.

type

string

enum

required

Tipo de ítem. Determina qué campos adicionales aplican.

Allowed:

price

array of objects

required

Lista de precios. Se requiere al menos un precio.

price*

description

string

reference

string

status

string

enum

Allowed:

unit

string

itemCategory

object

Categoría del ítem (clasificación comercial).

category

object

Categoría contable del ítem (cuenta contable).

tax

array of objects

tax

customFields

array of objects

customFields

settingsOnShop

object

Configuración de visibilidad en tienda online.

accounting

object

Cuentas contables del ítem.

inventory

object

Inventario del ítem. Aplica a type=product y type=variantParent.

subitems

array of objects

Requerido para type=kit. Lista de ítems que componen el kit.

subitems

kitWarehouse

object

Requerido para type=kit. Bodega desde la cual se descuenta el kit.

variantAttributes

array of objects

Requerido para type=variantParent. Define los atributos y sus opciones. El producto cartesiano de opciones no puede superar 100 combinaciones (ej: 2 atributos × 5 opciones = 10, válido; 5 × 5 × 5 = 125, rechazado).

variantAttributes

itemVariants

array of objects

Opcional para type=variantParent. Lista explícita de variantes a crear (máx 100). Si no se provee, las variantes se generan automáticamente como producto cartesiano de variantAttributes.

itemVariants

Responses

400

Datos inválidos o límite de variantes superado.

401

No autorizado

Language

Credentials

Basic

base64

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Ítem creado exitosamente.