Aplicar descuento a un ítem
POST /api/pos-discounts/process-item-discount
Descripción
Aplica un descuento a un ítem puntual de la orden por monto fijo o porcentaje. Un valor en cero quita el descuento.
Detalles
Reemplaza el descuento aplicado a un ítem por el monto o porcentaje indicado, y recalcula los totales de la orden. La razón es obligatoria cuando el valor es mayor a cero. No se permite dejar el ítem en cero por descuento (debe usarse cortesía) ni un descuento que deje la orden en sobrepago. Solo aplica mientras la orden esté abierta. Puede requerir PIN.
Permisos requeridos
auth-tenant
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| itemUuid | string | Sí |
min:36
max:36
|
| discountType | string | Sí |
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-item-discount \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"itemUuid": "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
{
"itemUuid": "ce3b04b7-753e-4b94-ba0e-00b5cbfa11fd",
"discountType": "amount",
"amountCents": 50,
"discountReasonId": 1
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"itemUuid": "ce3b04b7-753e-4b94-ba0e-00b5cbfa11fd",
"orderUuid": "2e4a9a32-ae36-4f4b-8665-e39720318e2a",
"discountCents": 50
}
}