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
|
Ejemplo de request
curl -X POST https://app.restofy.co/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-07-15T13:20:48Z
HTTP 200
Request
{
"itemUuid": "2c007d2b-52b6-489d-bf60-1f04807c3597",
"cancellationReasonId": 9,
"cancellationReason": "razon visible"
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"itemUuid": "2c007d2b-52b6-489d-bf60-1f04807c3597",
"orderUuid": "069b2d28-b542-42f3-90ed-39cdeebbe184",
"cancelledQuantity": "1.0000",
"isPartial": false
}
}