Ir al contenido

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.

cashboxMovementintegerobligatorio

Identificador del movimiento.

status_update_commentstringobligatorio

Motivo de la anulación.

cashbox.movement.anulate, validado en CashboxMovementPolicy::anulate, que además exige que el movimiento no esté ya anulado. Ver Permisos y políticas.

Ventana de terminal
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"
}'
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"
]
}
}