Anular un movimiento
PUT/api/cashbox-movement/{cashboxMovement}/anulate
Anula el movimiento y devuelve el movimiento anulado. Si está vinculado a una orden de pago, delega en el caso de uso AnnulPaymentUseCase, que también revierte el pago; en ese caso exige además el permiso de anular pagos de órdenes de compra (PaymentOrderAnnulPayment). Si es la devolución de un pago, no se puede anular por aquí. Falla si el movimiento ya está anulado o conciliado, o si su caja está cerrada. Al anular se revierte el gasto del centro de costo, si lo tenía.
Parámetros de la ruta
Sección titulada «Parámetros de la ruta»cashboxMovementintegerobligatorioIdentificador del movimiento.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»status_update_commentstringobligatorioMotivo de la anulación.
Permiso
Sección titulada «Permiso»cashbox.movement.anulate, validado en CashboxMovementPolicy::anulate, que además exige que el movimiento no esté ya anulado. Ver Permisos y políticas.
curl -X PUT \ "https://servererp.allendostmen.app/api/cashbox-movement/1520/anulate" \ -H "Authorization: Bearer $TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "status_update_comment": "Registrado por error"}'const response = await fetch( "https://servererp.allendostmen.app/api/cashbox-movement/1520/anulate", { method: "PUT", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "status_update_comment": "Registrado por error" }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->put('https://servererp.allendostmen.app/api/cashbox-movement/1520/anulate', [ 'status_update_comment' => 'Registrado por error', ]);Movimiento anulado200
{ "id": 1520, "type": "egreso", "account_id": 1, "payment_method_id": 2, "payment_date": "2026-11-19T10:30:00.000000Z", "subtotal_amount": 150.5, "total_amount": 150.5, "concept": "Pago de servicio", "third_party_type": "proveedor", "provider_id": 12, "status": "anulado", "create_user_id": 1, "status_update_comment": "Registrado por error", "update_user_id": 1}Sin permiso403
{ "message": "This action is unauthorized."}Ya anulado422
{ "message": "Este movimiento ya se anuló anteriormente, no se puede anular", "errors": { "cashbox_movement_id": [ "Este movimiento ya se anuló anteriormente, no se puede anular" ] }}