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>" \
-H "X-Tenant-Key: <tenantKey>" \
-d '{
"orderUuid": "string",
"cancellationReasonId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
{
"orderUuid": "32d85395-f202-4138-a28c-3403d7c66dd9",
"cancellationReasonId": 9,
"cancellationReason": "anular venta facturada"
}Response
{
"success": true,
"message": "Orden cancelada",
"data": {
"orderUuid": "32d85395-f202-4138-a28c-3403d7c66dd9",
"documents": [
{
"invoiceUuid": "63ac0e97-ab4a-11f1-b72d-f2569efa6eee",
"isElectronic": 0
}
]
}
}