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-10-09T02:12:12Z
HTTP 200
Request
{
"itemUuid": "00d46ed4-c744-4d64-b1cb-677d3c1d05b7",
"cancellationReasonId": 12,
"restoreInventory": true
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"itemUuid": "00d46ed4-c744-4d64-b1cb-677d3c1d05b7",
"orderUuid": "6b1c8579-e0b4-44e6-af63-b17d8a6a4880",
"cancelledQuantity": "1.0000",
"isPartial": false
}
}