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.

Request body

namestring required

Nombre del ítem.

type'service' | 'product' | 'kit' | 'variantParent' required

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

descriptionstring

referencestring

status'active' | 'inactive'

unitstring

Example request

{
  "name": "Camiseta azul",
  "type": "product",
  "price": [
    {
      "price": 25,
      "idPriceList": 1
    }
  ],
  "description": "Algodón 100%",
  "reference": "SKU-001",
  "status": "active",
  "unit": "unit",
  "itemCategory": {
    "id": "1"
  },
  "category": {
    "id": "5"
  },
  "tax": [
    {
      "id": "3"
    }
  ],
  "customFields": [
    {
      "id": "cf1",
      "key": "barcode",
      "value": "7701234567890"
    }
  ],
  "accounting": {
    "inventory": "14",
    "inventariablePurchase": "6"
  },
  "inventory": {
    "unit": "unit",
    "unitCost": 10,
    "warehouses": [
      {
        "id": "1",
        "initialQuantity": 100,
        "minQuantity": 5,
        "maxQuantity": 500
      }
    ]
  },
  "subitems": [
    {
      "item": {
        "id": "10"
      },
      "quantity": 2,
      "price": 20
    }
  ],
  "kitWarehouse": {
    "id": "1"
  },
  "variantAttributes": [
    {
      "id": "1",
      "options": [
        {
          "id": "10"
        }
      ]
    }
  ],
  "itemVariants": [
    {
      "id": "v1",
      "status": "active",
      "variantAttributes": [
        {
          "id": "1",
          "options": [
            {
              "id": "10"
            }
          ]
        }
      ],
      "inventory": {
        "warehouses": [
          {
            "id": "1",
            "initialQuantity": 50,
            "maxQuantity": 200
          }
        ]
      }
    }
  ]
}

Response

Ítem creado exitosamente.