Yield

A SABER ANTES DE COMENZAR

1. Las reglas automatizadas de Yield estarán definidas por el porcentaje de ocupación del establecimiento. 
   
2. La ocupación se calcula sobre el total del rack del alojamiento y no por categoría.
   
3. Las reglas se basan en horario español peninsular UTC +2 de 12.00h a 12.00h.
   
4. Solo está habilitado para planning por días. No compatible con planning por horas.
   
5. Las reglas solo pueden crearse desde la versión escritorio. No pueden crearse desde la versión web/app.
   
6. Solo está disponible para contratos Premium y Advanced. No estará disponible para Essential.
   
7. Contratos hasta 31/01/26 tienen Yield gratis. Para contratos a partir del 01/02/26 es de pago junto con todos los informes RMS.
   

Esta herramienta permite crear:

1. Reglas por horas: funcionan dentro de un intervalo horario para el día en curso.
   
2. Reglas por días: permiten configurar un rango dinámico entre 1 y 365 días.
   

Las reglas pueden:

1. editarse
   
2. eliminarse
   
3. desactivarse
   

Para desactivar una regla simplemente debe quitarse el check de activación.

Elementos sobre los que SÍ aplica Yield:

1. coste de alojamiento de la ocupación estándar
   
2. incremento de personas adicionales
   
3. precios especiales
   

Elementos sobre los que NO aplica Yield:

1. regímenes
   
2. tasas
   
3. extras
   
4. paquetes promocionales
   
5. camas adicionales

Si se necesita aplicar un descuento o incremento en una fecha concreta deberá configurarse mediante un precio especial.

Una vez aplicada Yield a la tarifa correspondiente, el sistema aplicará también los descuentos y códigos de descuentos generados para el motor de reservas.

(Más información sobre cómo generar ventajas competitivas: https://ayuda.avirato.com/docs/manual-de-usuario/canales-de-venta/motor-de-reservas/configuracion/)

INFORMACIÓN IMPORTANTE

Antes de empezar, lo primero vamos a aclarar el funcionamiento general y horario de las reglas:

1. Las reglas se basan en horario español peninsular UTC +2.
   
2. El cálculo se realiza de 12.00h a 12.00h, lo que significa que el cálculo de los días se realiza en formato reserva:
   
   1. desde las 12.00h
      
   2. hasta las 11.59h del día siguiente
      

                  (es decir, no nos regimos por las 24 horas del día natural que comienza a las 00.00h y termina a las 23.59h)

1. Si el establecimiento tiene configurado un check out después de las 12.00h:
   
   1. las reglas por horas no podrán aplicarse dentro de esa franja
      
   2. las reglas por días sí tendrán en cuenta ese horario
      
2. Las reglas abarcan siempre la hora completa.
   

            Ejemplo:

            Si una regla está configurada desde las 00.00h hasta las 09.00h, se aplicará hasta las 09.59h, y dejará de aplicarse a partir de las 10.00h.

1. Renovación automática: hasta que una regla no sea desactivada se renovará automáticamente día tras día.
   
2. Compatibilidad entre reglas: no pueden coexistir dos reglas el mismo tiempo si comparten campos.
   

REGLA POR DÍAS

CONFIGURACIÓN REGLA POR DÍAS

Las reglas por días permiten configurar un rango dinámico entre 1 y 365 días.

1. Nombre de la regla: debe especificarse el nombre de la regla.
   
2. Dónde aplica la regla:
   
   1. Selección de canales: aparecerán los canales sincronizados del channel manager, PMS (reservas manuales) y el motor de reservas. Deben seleccionarse aquellos donde queramos aplicar la regla.
      
   2. Selección de categorías: deben seleccionarse las categorías en las que queramos que aplique la regla.
      
   3. Selección de temporadas: deben seleccionarse las temporadas creadas en las que queramos que aplique la regla.
      
3. Configuración del rango de días: debe seleccionar el rango de días entre 1 y 365 días vista sobre el que se aplicará la regla. Este rango se moverá automáticamente en el calendario mientras la regla siga activa.
   
4. Activar regla los días: deben seleccionarse los días de la semana en los que aplicar la regla.
   
5. Configuración de ocupación: debe seleccionarse el rango de ocupación en el que aplicará la regla
   
6. Configuración de descuento/incremento: debe seleccionarse el descuento o incremento que se aplicará

El release sí se aplica.

La regla se desplazará automáticamente día tras días mientras sigua activa.

CÓMO UTILIZAR EL RANGO DE DÍAS

Configure el rango dinámico entre 1 y 365 días. 

No pueden establecerse fechas concretas.

El rango se desplazará automáticamente día tras días mientras la regla sigua activa.

Ejemplo práctico

Si hoy es lunes y configura un rango entre 2 y 4 días:

1. Hoy antes de las 12.00h: la regla se aplicará desde la noche del martes hasta la noche del jueves
   
2. Hoy después de las 12.00h: la regla se aplicará desde la noche del miércoles hasta la noche del viernes

Las reglas se aplicarán únicamente en los días que estén activos y cumplan los requisitos.

Ejemplo: En una reserva de lunes a jueves, si martes y miércoles cumplen las condiciones la regla solo se aplicará esos días, y lunes y jueves mantendrán su precio normal.

REGLA POR HORAS

CONFIGURACIÓN DE LA REGLA POR HORAS

Las reglas por horas funcionan dentro de un intervalo horario para el día en curso.

1. Nombre de la regla: debe especificarse el nombre de la regla.
   
2. Dónde aplica la regla:
   
   1. Selección de canales: aparecerán los canales sincronizados del channel manager, PMS (reservas manuales) y el motor de reservas. Deben seleccionarse aquellos donde queramos aplicar la regla.
      
   2. Selección de categorías: deben seleccionarse las categorías en las que queramos que aplique la regla.
      
   3. Selección de temporadas: deben seleccionarse las temporadas creadas en las que queramos que aplique la regla.
      
3. Configuración del rango horario: debe seleccionar el rango horario del día actual en el que se aplicará la regla. La aplicación dependerá del momento en el que el huésped realice la reserva.
   
4. Check Desactivar filtro de estancia mínima para el día de hoy: si el establecimiento tiene configurada una estancia mínima podrá desactivarse para el horario específico de la regla.
   
5. Activar regla los días: deben seleccionarse los días de la semana en los que aplicar la regla.
   
6. Configuración de ocupación: debe seleccionarse el rango de ocupación en el que aplicará la regla
   
7. Configuración de descuento/incremento: debe seleccionarse el descuento o incremento que se aplicará
   

El release sí se aplica.

La regla se desplazará automáticamente día tras días mientras sigua activa.

Reservas de última hora

El motor de reservas solo permitirá reservas de ayer para hoy hasta una hora antes del check out configurado en la categoría.

Reservas de varios días

Si una reserva se realiza hoy a partir de las 12.00h para alojarse durante 3 días:

1. la regla por horas solo aplicará sobre la primera noche
   
2. las siguientes noches mantendrán precio normal, salvo que exista una regla por días que también pueda aplicarse.
   

FUNCIONAMIENTO SEGÚN LA HORA DE CREACIÓN

INFO INTERNA PARA AVIRATERS

Coloquialmente hablando: ¿Cómo saber si hoy es hoy o ayer?

>todo lo que se haga entre las 00.00h y las 12.00h corresponde al día anterior, es decir hoy es ayer

>todo lo que se haga después de las 12.00h hasta las 23.59h corresponde al día actual, es decir hoy es hoy

Ejemplo:

Voy a reservar hoy 28/05 para alojarme la noche de hoy 28/05 y la reserva la hago antes de las 23.59h: 

      -mi check in es el 28/05 y el check out es el 29/05 

      -la reserva la doy de alta hoy 28/05

      -por lo tanto hoy es hoy

      

Mismo escenario pero la reserva la hago después de las 00.00h y hasta las 11.59h:

      -la reserva es para el 28/05 pero la doy de alta siendo ya 29/05

      -mi check in es el 28/05 y el check out es el 29/05

      -por lo tanto hoy es ayer

CÁLCULO DE LA OCUPACIÓN

La ocupación se calcula sobre el total del alojamiento.

Aunque la regla se configure únicamente para una categoría, el sistema tendrá en cuenta la ocupación global de todas las categorías.

Elementos que SÍ se tienen en cuenta para la ocupación:

1. bloqueos de habitaciones
2. reservas en estado bloqueo

Elementos que NO se tienen en cuenta para la ocupación:

1. bloqueos por rack
2. bloqueos de channel manager
   
3. bloqueos después del check out
   

Es posible consultar el porcentaje de ocupación del establecimiento copiando y pegando la siguiente URL en cualquier navegador o en Postman:

https://yield.avirato.com/OccupationAll?&startDate=AAAA-MM-DD&endDate=AAAA-MM-DD&webCode=WEBCODE

Para soporte técnico se recomienda utilizar Postman porque la información se visualiza de forma más clara.

Si la consulta se realiza desde Postman siempre deberá utilizarse el método GET.

Vista desde el navegador

ENLACE PARA FORZAR EL CÁLCULO DE YIELD EN PMS

FÓRMULA PARA CALCULAR LA OCUPACIÓN REAL PARA YIELD

EJECUCIÓN DEL CRON DE YIELD

FRANJA HORARIA

Cuando el establecimiento se encuentre en otro país diferente a España debe configurar la zona horaria correcta.

Si el cliente trabaja desde España pero el alojamiento está en otro país, la zona horaria debe configurarse según la ubicación del establecimiento y no según la ubicación del usuario.

Modificar la zona horaria no desconfigura el PMS, únicamente ajusta la franja horaria.

Actualmente, la configuración de la zona horaria afecta a:

1. disponibilidad
   
2. channel manager
   
3. motor de reservas
4. domótica
   

La parte de Yield y mailing aún debe implementarse (Alí está trabajando en ello)

Ejemplo práctico de diferencia horaria:

-Hora en España: 17.00h

-Hora en otro país: 11.00h

Si el establecimiento está configurado en ese país, el sistema calculará automáticamente la diferencia horaria, en este caso, -6 horas respecto a España.

RECOMENDACIONES GENERALES

HISTÓRICO Y TRAZABILIDAD

1. Desde el 27/06/25 ya se deja huella de las reglas de Yield en el histórico del PMS
   
2. Desde el 17/09/25 la huella de Yield incorpora el nombre de la regla aplicada
3. Actualmente la creación, modificación o eliminación de la regla:
   
   1. no se refleja en el historial de la reserva
      
   2. no aparece en el informe histórico
      
   3. no queda registrado en la propia regla
      

CÓMO INTERPRETAR EL HISTÓRICO

1. Rule (día): indica una regla de día
   
2. Rule (hora): indica una regla de hora
   
3. Regla ID: corresponde al identificador de la regla. Puede consultarse mediante el endpoint https://yield.avirato.com/OccupationAll?webCode=WEBCODE
4. Procesamiento Automático Cron: 
   
   1. Reglas por horas:
      
      1. Nodo 1: horas impares
         
      2. Nodo 2: horas pares
         
      3. Nodo 3 medias horas
         
   2. Reglas por días:
      
      1. Hasta 30 días (Días <30) : se ejecuta cada 3 horas
         
      2. Superiores a 30 días (Días longer 30): se ejecuta una vez al día, normalmente de madrugada
         
5. Procesamiento PMS: se ejecuta cuando cualquier acción del PMS modifica el porcentaje de ocupación
   
   1. Procesamiento Días: cuando la regla es de 1 a 30 días
      
   2. Procesamiento Días >30: cuando la regla tiene configurados más de 30 días
      
   3. Procesamiento Horas: cuando la regla es por horas
      
6. Regla aplicada por petición HTTP PMS: cuando forzamos la aplicación de la regla a través de la URL
   
7. Regla aplicada  por Yield
   

Aunque no deja huella directa sobre la reserva, sí permite comprobar si existió una regla activa ese día.

Consultando la fecha de la reserva podrá revisarse el histórico.

GESTIÓN DE INCIDENCIAS