Maxim

Maxim

Última actualización el Oct 8, 2026

Modifica un producto y sus componentes. Solo se cambian los campos que envías, el resto se queda como estaba.

v1/products/edit.php

Parámetros

Campo Tipo Obligatorio Descripción
product_id int Sí ID del producto
name string No Nombre
sku string No SKU
unit string No Unidad de medida
price float No Precio de venta por unidad
batch_size float No Tamaño del lote
notes string No Notas
minimum float No Existencias mínimas en el almacén storage_id
storage_id int Con minimum Almacén donde se cambian las existencias mínimas
categories array No Categorías: objetos con id o name. Reemplazan las actuales por completo
suppliers array No Proveedores: objetos con id. Reemplazan los actuales por completo
alternative_sku array No SKU alternativos: objetos con sku y label. Reemplazan los actuales por completo
materials array No Materiales en los componentes
products array No Semielaborados en los componentes
resources array No Recursos en los componentes. Reemplazan los actuales por completo

Componentes del producto

Los componentes se definen por lote (batch_size unidades) y se envían en los array materials (materiales), products (semielaborados) y resources (recursos).

Líneas materials y products

Campo Tipo Obligatorio Descripción
id int Sí ID del material o del producto
amount_per_batch float Sí Cantidad por lote
unit string Sí Unidad de la línea. Del mismo grupo que la unidad del material o del producto: para un material en «kg» valen «kg» o «g»
loss_percent float No Pérdidas, en porcentaje. Por defecto 0. Se aceptan solo si en los ajustes de la empresa está activada la visualización de pérdidas en los componentes
position int No Posición de la línea en los componentes

Si se envía al menos uno de los array materials y products, los materiales y los semielaborados se reemplazan por completo, y el array que no se envía se considera vacío. Por ejemplo, si envías solo materials, los semielaborados se eliminan de los componentes.

position fija el orden de las líneas de componentes en la interfaz de Controlata, común para materials y products. Las líneas sin este campo van al final, en el orden enviado. Controlata renumera las posiciones desde 0, por lo que en Obtener los datos de un producto pueden diferir de las enviadas.

Líneas resources

Cada línea de recurso contiene el id del recurso. Si hacen falta amount_per_batch y unit depende del tipo de recurso (consulta Crear un recurso):

Tipo de recurso amount_per_batch unit
Tarifa fija Cantidad por lote, p. ej. horas de trabajo Necesario
Tarifa fija, el precio se indica en los componentes del producto Un importe por lote No necesario
Porcentaje No se envía: se toma del recurso No necesario
Porcentaje, se indica en los componentes del producto El porcentaje No necesario
Amortización Cantidad por lote, p. ej. horas de uso del equipo Necesario

Ejemplo de solicitud

Un nuevo precio de venta y los componentes de materiales. No se envían semielaborados, así que se eliminan de los componentes; los recursos se quedan igual.

{
    "product_id": 3120,
    "price": 47000,
    "materials": [
        {
            "id": 2051,
            "amount_per_batch": 0.6,
            "unit": "m3",
            "loss_percent": 5
        },
        {
            "id": 2060,
            "amount_per_batch": 400,
            "unit": "ud"
        }
    ]
}

Cambiar solo las existencias mínimas:

{
    "product_id": 3120,
    "minimum": 3,
    "storage_id": 3999
}

Ejemplo de respuesta

{
    "success": true
}

Errores

Error Motivo
No product_id in input Falta product_id
Product not found or access denied Producto no encontrado o eliminado
Name must not be empty Se envió un nombre vacío
Name must be a string El nombre no se envió como cadena, p. ej. como array
Unit not set Se envió una unidad de medida vacía
Unit not found Unidad de medida desconocida
Unit cannot be changed to another unit group: the product is used in components of other products Cambio del grupo de unidad de un producto que entra en los componentes de otros productos
Batch size must be greater than 0 El tamaño del lote es 0 o menor
No storage_id in input Se envió minimum sin storage_id
Storage ID not found Almacén no encontrado o eliminado
Product is not stored in storage location 3999, so its minimum cannot be set there El producto no figura en el almacén
Invalid price value. Must be a number El valor no es un número (igual para batch_size y minimum)
Category 12 not found Categoría no encontrada
Supplier not found or access denied Proveedor no encontrado o eliminado
SKU must be from 1 to 50 characters for alternative_sku 0 El SKU alternativo está vacío o supera los 50 caracteres
Label must not exceed 100 characters for alternative_sku 0 La etiqueta del SKU alternativo supera los 100 caracteres

Errores en las líneas de componentes

En el texto del error, en lugar de 2051 aparece el ID del elemento, y en lugar de 0 el número de línea en el array (desde 0).

Error Motivo
Materials is not an array materials no se envió como array (igual para products y resources)
Line 0 of materials must be an object La línea no es un objeto (igual para products y resources)
No id for material 0 Falta el id del material o no es un número (igual para product)
Material 2051 not found Material no encontrado o eliminado
Product 2051 not found Producto no encontrado o eliminado
Product cannot be a component of itself El producto se añadió a sus propios componentes
Amount per batch must be greater than 0 for material 2051 La cantidad falta, no es un número, o es 0 tras redondear a 3 decimales (igual para product y resource)
Unit not found for material 2051. Use a unit of the same group as the material unit La unidad falta, es desconocida o de otro grupo (igual para product)
Loss percent must be from 0 to 100 for material 2051 Las pérdidas son menores que 0, mayores que 100 o no son un número (igual para product)
Loss percent is disabled in company settings for material 2051 Se enviaron pérdidas, pero en los ajustes de la empresa está desactivada su visualización en los componentes (igual para product)
Resource for line 0 not found Recurso no encontrado o eliminado
Percent must not exceed 100 for resource 2051 El porcentaje en los componentes supera 100
Unit not found for resource 2051. Use a unit of the same group as the resource unit La unidad del recurso falta, es desconocida o de otro grupo