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. Requiere una sesión de caja abierta del usuario para vincular la operación. 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
|
| cashRegisterSessionId | 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-order \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"orderUuid": "string",
"cancellationReasonId": 1,
"cashRegisterSessionId": 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": "6b528f83-6174-4cd5-aee6-e7859e05367b",
"cancellationReasonId": 9,
"cashRegisterSessionId": 2,
"cancellationReason": "cliente arrepentido a las 19:42"
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"orderUuid": "6b528f83-6174-4cd5-aee6-e7859e05367b"
}
}