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 |