Restofy Docs

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://app.restofy.co/api/pos-discounts/process-order-item-comp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "itemUuid": "string",
    "discountReasonId": 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": "3e767c72-b2fa-4772-87c9-caa42d88c02a",
    "discountReasonId": 1
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "itemUuid": "3e767c72-b2fa-4772-87c9-caa42d88c02a",
        "orderUuid": "d18ebed5-86c6-47c0-89fc-b06e8a3de446",
        "compedQuantity": "1.0000",
        "isPartial": false
    }
}