Anulación de órdenes
POST
Anular orden cerrada
POST /api/pos-cancellation/cancel-closed-order
Descripción
Anula una orden ya cerrada, revirtiendo su actividad financiera y dejándola cancelada.
Detalles
Anula una orden que ya fue cerrada (cobrada y facturada), revirtiendo los movimientos financieros que había generado el pago. Si la orden ya tenía factura vigente, la anulación genera automáticamente el comprobante de anulación fiscal correspondiente. Si el pedido es a domicilio, permite decidir si al repartidor se le paga igual el viaje; sin esa indicación se resuelve según si el pedido ya había salido. No se puede anular si los pagos pertenecen a una sesión de caja ya cerrada, si la orden ya fue cancelada, ni mientras una factura electrónica siga esperando el veredicto de la entidad fiscal. 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
|
| payCourier | bool | No | — |
| pin | string | No |
max:60
|
Ejemplo de request
curl -X POST https://restofy.pro/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-11-02T19:00:57Z
HTTP 200
Request
{
"orderUuid": "c2749612-cd03-4428-a46e-023b325bb5df",
"cancellationReasonId": 9,
"cancellationReason": "anular venta de otra secuencia"
}Response
{
"success": true,
"message": "Orden cancelada",
"data": {
"orderUuid": "c2749612-cd03-4428-a46e-023b325bb5df",
"documents": [
{
"invoiceUuid": "da19a84e-d115-11f1-8bb6-de64ef616b7c",
"isElectronic": 0
}
]
}
}