Restofy Docs

Aplicar descuento a la orden

POST /api/pos-discounts/process-order-discount

Descripción

Aplica un descuento global a la orden por monto fijo o porcentaje. Un valor en cero quita el descuento existente.

Detalles

Reemplaza el descuento global de la orden por el monto o porcentaje indicado, recalculando los totales al instante. La razón de descuento es obligatoria cuando el valor es mayor a cero. No se permite descuento del 100% (debe usarse cortesía) ni un descuento que deje la orden en sobrepago. Solo aplica mientras la orden esté abierta y sin haberse pagado por completo. Puede requerir PIN.

Permisos requeridos

auth-tenant

Request

Nombre Tipo Requerido Reglas
orderUuid string
min:36 max:36
discountType string
max:10
amountCents int No
min_value:0
percent int No
min_value:0 max_value:100
discountReasonId 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-discount \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "orderUuid": "string",
    "discountType": "string"
}'

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

Ejemplo de respuesta

Actualizado: 2026-07-15T13:20:48Z
HTTP 200

Request

{
    "orderUuid": "62604c19-9332-4f41-b407-45ea87b845b8",
    "discountType": "amount",
    "amountCents": 100,
    "discountReasonId": 1
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "orderUuid": "62604c19-9332-4f41-b407-45ea87b845b8",
        "discountCents": 100
    }
}