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 |
