Cambia el estado de la venta. El estado determina si los productos y materiales de la venta se descuentan de las existencias.
v1/orders/update_status.php
Parámetros
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| order_id | int | Sí | ID de la venta |
| status | int | Sí | Nuevo estado: 0 — Nuevo, 1 — Empaquetado, 3 — Enviado, 4 — Cancelado |
| date_shipped | string | No | Fecha de envío. Se tiene en cuenta al pasar al estado Enviado |
El estado Parcialmente enviado (2) no se puede establecer por la API: aparece cuando parte de la venta se envía en la interfaz de Controlata.
date_shipped se tiene en cuenta al pasar a Enviado: se escribe en la venta y el descuento se fecha con ella. En otros estados date_shipped se ignora.
Ejemplo de solicitud
{
"order_id": 43727,
"status": 3,
"date_shipped": "2026-10-08"
}
Ejemplo de respuesta
{
"success": true
}
Errores
| Error | Motivo |
|---|---|
| No order_id in input | Falta un campo obligatorio (en lugar de order_id, el nombre del campo) |
| Invalid status value. Must be one of: 0, 1, 3, 4 | Estado no válido, incluido el 2 |
| Order not found or access denied | Venta no encontrada o eliminada |
| Date is not a valid date in format YYYY-MM-DD | date_shipped no válida |