Cambia el estado de la compra. El estado determina si los materiales y productos de la compra entran en las existencias.

```
v1/purchases/update_status.php
```

## Parámetros

| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| purchase_id | int | Sí | ID de la compra |
| status | int | Sí | Nuevo estado: **0** — Plan, **1** — Pedida, **3** — Recibida |
| date_received | string | No | Fecha de recepción. Se tiene en cuenta al pasar al estado Recibida |

El estado **Parcialmente recibida** (2) no se puede establecer por la API: aparece cuando parte de la compra se recibe como entregas en la interfaz de Controlata.

date_received se tiene en cuenta al pasar a **Recibida**: se escribe en la compra y la entrada en existencias se fecha con ella. En otros estados date_received se ignora.

## Ejemplo de solicitud

```
{
    "purchase_id": 29645,
    "status": 3,
    "date_received": "2026-10-09"
}
```

## Ejemplo de respuesta

```
{
    "success": true
}
```

## Errores

| Error | Motivo |
|---|---|
| No purchase_id in input | Falta un campo obligatorio (en lugar de purchase_id, el nombre del campo) |
| Invalid status value. Must be one of: 0, 1, 3 | Estado no válido, incluido el 2 |
| Purchase not found or access denied | Compra no encontrada o eliminada |
| Date is not a valid date in format YYYY-MM-DD | date_received no válida |
