items__updateItem

Actualiza los datos de un ítem existente. Solo enviar los campos que cambiarán.

⚠️ Advertencia para type=variantParent:

Enviar variantAttributes reemplaza TODOS los atributos existentes del ítem padre.

Enviar itemVariants reemplaza TODAS las variantes existentes (operación destructiva).

Límite: El producto cartesiano de opciones en variantAttributes no puede superar 100 combinaciones. El servidor rechazará el request si se supera este límite.

Request body

idstring required

ID del ítem a actualizar.

namestring

descriptionstring

referencestring

status'active' | 'inactive'

unitstring

Example request

{
  "id": "10",
  "name": "Camiseta azul actualizada",
  "price": [
    {
      "price": 30,
      "idPriceList": 1
    }
  ],
  "description": "Algodón 100%, nueva colección",
  "reference": "SKU-001-V2",
  "status": "active",
  "unit": "unit",
  "itemCategory": {
    "id": "2"
  },
  "category": {
    "id": "5"
  },
  "tax": [
    {
      "id": "3"
    }
  ],
  "customFields": [
    {
      "id": "cf1",
      "key": "barcode",
      "value": "7701234567891"
    }
  ],
  "settingsOnShop": {
    "hide": true
  },
  "accounting": {
    "inventory": "14",
    "inventariablePurchase": "6"
  },
  "inventory": {
    "unit": "unit",
    "unitCost": 12,
    "warehouses": [
      {
        "id": "1",
        "initialQuantity": 200,
        "minQuantity": 10,
        "maxQuantity": 1000
      }
    ]
  },
  "subitems": [
    {
      "item": {
        "id": "10"
      },
      "quantity": 3,
      "price": 22
    }
  ],
  "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": 75
          }
        ]
      }
    }
  ]
}

Response

Ítem actualizado exitosamente.