Anulación de órdenes
POST
Cancelar orden completa
POST /api/pos-cancellation/cancel-order
Descripción
Cancela una orden abierta sin pagos registrados, cancelando también todos sus ítems con la misma razón.
Detalles
Cancela una orden mientras no tenga pagos registrados, marca todos sus ítems activos como cancelados con la razón indicada y deja los totales en cero. No depende de la caja: una orden sin pagos no movió dinero. Puede requerir PIN. Falla si la orden ya está cerrada, cancelada o tiene pagos.
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
|
| restoreInventory | bool | No | — |
Ejemplo de request
curl -X POST https://restofy.pro/api/pos-cancellation/cancel-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-10-09T02:12:12Z
HTTP 200
Request
{
"orderUuid": "dddddddd-dddd-dddd-dddd-dddddddddd01",
"cancellationReasonId": 9,
"cancellationReason": "Cambio de modo en test"
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"orderUuid": "dddddddd-dddd-dddd-dddd-dddddddddd01"
}
}