Anulación de órdenes
POST
Cancelar ítem de la orden
POST /api/pos-cancellation/cancel-order-item
Descripción
Cancela un ítem antes del pago, ya sea en su totalidad o solo parte de la cantidad pedida.
Detalles
Cancela un ítem de una orden que todavía no tiene pagos. Si se indica una cantidad menor a la del ítem se cancela solo esa porción dejando el resto activo; si no, se cancela el ítem completo. No se permite cancelar el último ítem activo de la orden: en ese caso debe cancelarse la orden completa. Puede requerir PIN.
Permisos requeridos
auth-tenant
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| itemUuid | string | Sí |
min:36
max:36
|
| cancellationReasonId | int | Sí |
min_value:1
|
| cancellationReason | string | No |
max:500
|
| pin | string | No |
max:60
|
| quantityToCancel | int | No |
min_value:1
|
| restoreInventory | bool | No | — |
Ejemplo de request
curl -X POST https://restofy.pro/api/pos-cancellation/cancel-order-item \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"itemUuid": "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
{
"itemUuid": "9d9d43d8-0f6a-4596-8cf5-e4c864b151cc",
"cancellationReasonId": 9,
"cancellationReason": "plato frio 8e1c08"
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"itemUuid": "9d9d43d8-0f6a-4596-8cf5-e4c864b151cc",
"orderUuid": "a9654629-3421-4d7e-a7dc-e00f47254be8",
"cancelledQuantity": "1.0000",
"isPartial": false
}
}