Restofy Docs
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
min:36 max:36
cancellationReasonId int
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-09-13T21:05:19Z
HTTP 200

Request

{
    "orderUuid": "1336c439-8d18-48d0-8798-83d4df359d1a",
    "cancellationReasonId": 9,
    "cancellationReason": "cancel closed test"
}

Response

{
    "success": true,
    "message": "Orden cancelada",
    "data": {
        "orderUuid": "1336c439-8d18-48d0-8798-83d4df359d1a",
        "documents": [
            {
                "invoiceUuid": "40bb7e57-acb4-11f1-b72d-f2569efa6eee",
                "isElectronic": 0
            }
        ]
    }
}