Restofy Docs
Toma de pedidos POST

Contexto de propina de la orden

POST /api/pos-order/get-order-tip-context

Descripción

Devuelve la configuración de propina vigente y el valor actualmente aplicado a la orden.

Detalles

Retorna el estado actual de la propina de la orden y la configuración aplicable según el canal de entrega: monto vigente, porcentaje, modo, base de cálculo, redondeo configurado, porcentaje sugerido por defecto y monto mínimo de orden a partir del cual se cobra propina. Indica también si la propina actual fue ajustada manualmente y si ajustarla requiere PIN de autorización según la configuración de seguridad activa.

Permisos requeridos

orders.module

Request

Nombre Tipo Requerido Reglas
orderUuid string
min:36 max:36

Ejemplo de request

curl -X POST https://restofy.pro/api/pos-order/get-order-tip-context \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-Tenant-Key: <tenantKey>" \
  -d '{
    "orderUuid": "string"
}'

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

Ejemplo de respuesta

Actualizado: 2026-09-08T16:35:34Z
HTTP 200

Request

{
    "orderUuid": "0d4fc797-e378-4265-9d06-8deb14f7f770"
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "orderUuid": "0d4fc797-e378-4265-9d06-8deb14f7f770",
        "tipAmountCents": 1500,
        "tipRateBasisPoints": 0,
        "tipModeApplied": "disabled",
        "tipConfigMode": "disabled",
        "tipRoundingOption": "none",
        "tipValueType": null,
        "tipDefaultRateBasisPoints": 0,
        "tipMinOrderCentsForTip": 0,
        "isTipOverridden": true,
        "baseCents": "4600000",
        "calculationBase": "price",
        "requiresPin": false
    }
}