Órdenes
POST
Ajustar manualmente la propina
POST /api/pos-order/update-order-tip
Descripción
Sobrescribe la propina de la orden con un monto fijo o un porcentaje y recalcula los totales.
Detalles
Ajusta manualmente la propina de la orden indicando un monto fijo o un porcentaje sobre la base de cálculo configurada. La propina queda marcada como ajustada manualmente y se recalculan los totales. No se permite ajustar la propina cuando está configurada como obligatoria. Puede requerir PIN de autorización según la configuración de seguridad activa. Solo se permite mientras la orden siga abierta.
Permisos requeridos
auth-tenant
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| orderUuid | string | Sí |
min:36
max:36
|
| tipType | string | Sí |
max:10
|
| amountCents | int | No |
min_value:0
|
| percent | int | No |
min_value:0
max_value:100
|
| pin | string | No |
max:60
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/pos-order/update-order-tip \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"orderUuid": "string",
"tipType": "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": "4a89579a-217d-4918-adb4-ce54548818fe",
"tipType": "amount",
"amountCents": 1500
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"orderUuid": "4a89579a-217d-4918-adb4-ce54548818fe",
"tipAmountCents": 1500,
"tipRateBasisPoints": 0,
"tipModeApplied": "disabled",
"tipRoundingOption": "none",
"tipValueType": null,
"tipDefaultRateBasisPoints": 0,
"tipMinOrderCentsForTip": 0,
"isTipOverridden": true,
"baseCents": "6900000",
"calculationBase": "price",
"requiresPin": false
}
}