Crea una baja de materiales y productos del almacén.

```
v1/writeoffs/add.php
```

## Parámetros

| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| num | string | Sí | Número |
| materials | array | materials o products | Materiales a dar de baja: id o sku y amount |
| products | array | materials o products | Productos a dar de baja: id o sku y amount |
| date | string | No | Fecha de la baja, YYYY-MM-DD. Por defecto hoy |
| materials_storage_id | int | No | Almacén del que se dan de baja los materiales. Por defecto el almacén de bajas de los ajustes de la empresa |
| products_storage_id | int | No | Almacén del que se dan de baja los productos. Por defecto el almacén de bajas de los ajustes de la empresa |
| notes | string | No | Notas |

Línea materials y products:

| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | int | id o sku | ID del material o del producto |
| sku | string | id o sku | SKU |
| amount | float | Sí | Cantidad, mayor que 0 |
| notes | string | No | Comentario de la línea |

Un material o producto se indica por id o sku. Hace falta al menos una línea en uno de los array.

Una baja nueva se crea con el estado del ajuste **Estado por defecto de las nuevas bajas**.

## Ejemplo de solicitud

```
{
    "num": "48",
    "date": "2026-10-06",
    "materials": [
        {
            "id": 2051,
            "amount": 0.15,
            "notes": "Defecto: grieta"
        }
    ],
    "products": [
        {
            "sku": "P-TABLE-01",
            "amount": 1
        }
    ],
    "materials_storage_id": 3998,
    "products_storage_id": 4001,
    "notes": "Defecto al cortar"
}
```

## Ejemplo de respuesta

```
{
    "success": true,
    "writeoff_id": 19291,
    "num": "48",
    "status": 1
}
```

La respuesta devuelve el ID, el número y el código de estado de la nueva baja.

## Errores

| Error | Motivo |
|---|---|
| No num in input | num falta o está vacío |
| No products or materials in input | No se envió ninguna línea |
| Materials is not an array | materials no es un array (igual para products) |
| Line 0 of materials must be an object | La línea no es un objeto (en lugar de 0, el número de línea) |
| SKU or id not set for material 0 | La línea no tiene ni id ni sku |
| Material with id 2051 not found | Material no encontrado o eliminado (para un producto: Product with SKU "P-TABLE-01" not found) |
| Amount must be greater than 0 for material with id 2051 | La cantidad no es un número o no es mayor que 0 tras redondear |
| Invalid notes value for material with id 2051. Must be a string | notes de la línea no es una cadena |
| Notes for material with id 2051 are too long: maximum 10000 characters | El comentario de la línea supera los 10 000 caracteres |
| 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 |
