Crea una producción. Controlata calcula el consumo de materiales, productos usados y recursos a partir de los componentes del producto; no lo envías tú.
v1/production/add.php
Parámetros
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| products | array | Sí | Productos a fabricar, ver abajo |
| date | string | No | Fecha de producción, YYYY-MM-DD. Por defecto hoy |
| name | string | No | Nombre |
| notes | string | No | Notas |
| produce_subproducts | int | No | 1: producir los semielaborados junto con los productos, 0: descontarlos del almacén ya hechos. Por defecto según el ajuste de la empresa |
| materials_storage_id | int | No | Almacén del que se descuentan los materiales. 0: elegir automáticamente |
| subproducts_storage_id | int | No | Almacén del que se descuentan los productos usados. 0: elegir automáticamente |
| products_storage_id | int | No | Almacén al que entran los productos fabricados |
Línea products:
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | int | id o sku | ID del producto |
| sku | string | id o sku | SKU del producto |
| amount | float | Sí | Cantidad, mayor que 0 |
| notes | string | No | Comentario de la línea |
Un producto se indica por id o sku (también se busca por SKU alternativos). El mismo producto se puede indicar en varias líneas.
Una producción nueva se crea con el estado del ajuste Estado por defecto de las nuevas producciones.
Ejemplo de solicitud
{
"date": "2026-10-06",
"name": "Lote de mesas",
"products": [
{
"id": 512,
"amount": 10,
"notes": "Dos capas de aceite"
},
{
"sku": "P-CHAIR-01",
"amount": 40
}
],
"materials_storage_id": 3998,
"products_storage_id": 4001,
"produce_subproducts": 1
}
Ejemplo de respuesta
{
"success": true,
"production_id": 39978,
"num": 152,
"status": 0
}
La respuesta devuelve el ID, el número y el código de estado de la nueva producción.
Errores
| Error | Motivo |
|---|---|
| No products in input | products falta o es un array vacío |
| Products is not an array | products no es un array |
| Line 0 of products must be an object | Una línea de products no es un objeto (en lugar de 0, el número de línea) |
| SKU or id not set for product 0 | La línea no tiene ni id ni sku |
| Product with id 512 not found | Producto no encontrado o eliminado (para un SKU: Product with SKU "P-CHAIR-01" not found) |
| Amount must be greater than 0 for product with id 512 | La cantidad no es un número o no es mayor que 0 tras redondear |
| Invalid notes value for product with id 512. Must be a string | notes de la línea no es una cadena |
| Notes for product with id 512 are too long: maximum 10000 characters | El comentario de la línea supera los 10 000 caracteres |
| Storage ID is not set | Se envió products_storage_id igual a 0 |
| Storage ID not found | Almacén no encontrado o eliminado |
| Date is not a valid date in format YYYY-MM-DD | Formato de fecha no válido |