Ir al contenido

Cambiar el estado de un movimiento de caja de cliente

PUT/api/customer-cashbox-movement/{id}/change-status

Anula un movimiento de caja de cliente. El único estado admitido es anulado. En una transacción: guarda el comentario con el estado anterior, anula el movimiento de la caja de la empresa asociado y, si el movimiento forma parte de una transferencia, anula también la contraparte (para un ingreso, el egreso que lo originó; para un egreso, el ingreso de destino) junto con su movimiento de la empresa. El observador revierte el saldo de cada caja de cliente afectada: el ingreso anulado resta su monto y el egreso anulado lo suma.

idintegerobligatorio

Identificador del movimiento.

statusstringobligatorio

Nuevo estado. Solo se admite anulado.

status_update_commentstring

Motivo de la anulación. Se guarda seguido del estado anterior.

CustomerCashboxMovementPolicy::changeStatus exige que el token tenga la habilidad customer:delete. Si el movimiento ya tiene ese estado, rechaza con No se puede actualizar al mismo estado. Ver Permisos y políticas.

Ventana de terminal
curl -X PUT \
"https://servererp.allendostmen.app/api/customer-cashbox-movement/5/change-status" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"status": "anulado",
"status_update_comment": "PAGO DUPLICADO"
}'
Movimiento anulado200
{
"id": 30,
"customer_id": 12,
"customer_cashbox_id": 4,
"to_customer_cashbox_id": null,
"from_customer_cashbox_id": null,
"transfer_customer_cashbox_movement_id": null,
"cashbox_movement_id": 879,
"type": "ingreso",
"concept": "PAGO DEL CLIENTE",
"amount": 1500.0,
"untouchable": false,
"status": "anulado",
"previous_status": "activo",
"status_update_comment": "PAGO DUPLICADO (Anterior estado *activo*)",
"status_update_date": "2026-11-19T11:05:00.000000Z",
"create_user_id": 1,
"update_user_id": 1,
"delete_user_id": null,
"restore_user_id": null,
"status_update_user_id": 1,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
Registro no encontrado404
{
"message": "No query results for model [App\\Models\\CustomerCashboxMovement] 5"
}
Sin permiso403
{
"message": "No tienes permisos para cambiar el estado."
}
Mismo estado403
{
"message": "No se puede actualizar al mismo estado."
}
Datos no válidos422
{
"message": "El campo status es obligatorio.",
"errors": {
"status": [
"El campo status es obligatorio."
]
}
}