Anular orden con pagos
POST /api/pos-cancellation/cancel-closed-order
Descripción
Anula una orden cerrada o con pagos parciales, revirtiendo su actividad financiera y dejándola cancelada.
Detalles
Anula una orden cerrada o una orden abierta que ya tiene pagos parciales, revirtiendo los movimientos financieros que había generado el pago. En el caso parcial también cancela los ítems activos y recalcula los totales. Si la orden ya tenía factura vigente, la anulación genera automáticamente el comprobante de anulación fiscal correspondiente. No se puede anular si los pagos pertenecen a una sesión de caja ya cerrada, ni una orden que ya fue cancelada. Puede requerir PIN y queda registrada en la auditoría del restaurante.
Permisos requeridos
auth-tenant
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| orderUuid | string | Sí |
min:36
max:36
|
| cancellationReasonId | int | Sí |
min_value:1
|
| cancellationReason | string | No |
max:500
|
| pin | string | No |
max:60
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/pos-cancellation/cancel-closed-order \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"orderUuid": "string",
"cancellationReasonId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"orderUuid": "4e017a27-529c-4b5d-a92a-1ffbf946276a",
"cancellationReasonId": 9,
"cancellationReason": "cancel closed test"
}Response
{
"success": true,
"message": "Orden cancelada",
"data": {
"orderUuid": "4e017a27-529c-4b5d-a92a-1ffbf946276a",
"documents": [
{
"invoiceUuid": "a5580158-7eb3-11f1-ac02-f2368af4d8ac",
"isElectronic": 0
}
]
}
}