Cambiar el estado de la compra

Maxim

Maxim

Última actualización el Oct 8, 2026

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