Devuelve las bajas de la empresa, de las nuevas a las antiguas: por fecha y, dentro de una misma fecha, por ID. Las líneas no se incluyen en la lista; las devuelve [v1/writeoffs/get_entry](https://developers.controlata.com/hc/api-docs/articles/api-writeoffs-get-entry-es).

```
v1/writeoffs/get_list.php
```

## Parámetros

| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| date_from | string | No | Bajas desde esta fecha inclusive, YYYY-MM-DD |
| date_to | string | No | Bajas hasta esta fecha inclusive, YYYY-MM-DD |
| status | int | No | Estado: 0 Plan, 1 Dada de baja |
| limit | int | No | Tamaño de página, de 1 a 1000 |
| offset | int | No | Cuántos registros omitir |

Sin limit se devuelve toda la lista. Consulta la paginación en [Reglas generales](https://developers.controlata.com/hc/api-docs/articles/api-rules-es).

## Respuesta

Un array writeoffs con los campos de la baja:

| Campo | Tipo | Descripción |
|---|---|---|
| id | int | ID de la baja |
| num | string | Número |
| date | string | Fecha de la baja, YYYY-MM-DD |
| status | int | Estado: 0 Plan, 1 Dada de baja |
| materials_storage_id | int | Almacén del que se dan de baja los materiales |
| materials_storage_name | string | Nombre del almacén de materiales |
| products_storage_id | int | Almacén del que se dan de baja los productos |
| products_storage_name | string | Nombre del almacén de productos |
| cost | float | Coste de lo dado de baja |
| amount | float | Cantidad total. null si los elementos tienen unidades distintas |
| lines | int | Número de líneas |
| notes | string | Notas |

El campo total contiene el número total de bajas que cumplen los filtros.

## Ejemplo de solicitud

```
{
    "date_from": "2026-10-01",
    "date_to": "2026-10-31",
    "limit": 100,
    "offset": 0
}
```

## Ejemplo de respuesta

```
{
    "success": true,
    "writeoffs": [
        {
            "id": 19291,
            "num": "48",
            "date": "2026-10-06",
            "status": 1,
            "materials_storage_id": 3998,
            "materials_storage_name": "Principal",
            "products_storage_id": 4001,
            "products_storage_name": "Productos terminados",
            "cost": 26350,
            "amount": null,
            "lines": 2,
            "notes": "Defecto al cortar"
        }
    ],
    "total": 1
}
```

## Errores

| Error | Motivo |
|---|---|
| Date is not a valid date in format YYYY-MM-DD | date_from o date_to no válida |
| Invalid status value. Must be a number | status no es un número |
| Invalid limit value. Must be between 1 and 1000 | limit no válido |
| Offset requires limit | se envió offset sin limit |
