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 |