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 Sí
min:36 max:36
discountReasonId int Sí
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>" \
  -d '{
    "itemUuid": "string",
    "discountReasonId": 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": "35ad5ece-0db6-4353-b722-e96d7435b440",
    "discountReasonId": 1,
    "quantityToComp": 1
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "itemUuid": "35ad5ece-0db6-4353-b722-e96d7435b440",
        "orderUuid": "89bbae1a-be33-480b-8106-cd59ccf883a3",
        "compedQuantity": 1,
        "isPartial": true
    }
}