Restofy Docs
Descuentos y cortesías POST

Marcar ítem como cortesía

POST /api/pos-discounts/process-order-item-comp

Descripción

Marca un ítem como cortesía, en su totalidad o solo en parte de la cantidad. La operación es irreversible.

Detalles

Marca un ítem como cortesía con la razón indicada y recalcula los totales de la orden. Si se indica una cantidad menor a la del ítem, solo esa porción queda como cortesía y el resto sigue activo. No se permite marcar como cortesía el último ítem activo de la orden: en ese caso debe usarse cortesía de la orden completa. Solo aplica mientras la orden no tenga pagos. La operación es irreversible. Puede requerir PIN.

Permisos requeridos

auth-tenant

Request

Nombre Tipo Requerido Reglas
itemUuid string
min:36 max:36
discountReasonId int
min_value:1
quantityToComp int No
min_value:1
pin string No
max:60

Ejemplo de request

curl -X POST https://restofy.pro/api/pos-discounts/process-order-item-comp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-Tenant-Key: <tenantKey>" \
  -d '{
    "itemUuid": "string",
    "discountReasonId": 1
}'

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-09-08T16:35:34Z
HTTP 200

Request

{
    "itemUuid": "393da6e9-8e5b-4bc3-a1ea-7b098a153c0b",
    "discountReasonId": 1
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "itemUuid": "393da6e9-8e5b-4bc3-a1ea-7b098a153c0b",
        "orderUuid": "86697fbc-cdc2-43d9-8610-ba53a7c1785e",
        "compedQuantity": "1.0000",
        "isPartial": false
    }
}