Rates
OTA_HotelRateAmountNotifRQ
Se enviará un mensaje OTA_HotelRateAmountNotifRQ al servicio web de un canal conectado después de que el valor cambie en IP-Connect. El mensaje se puede usar para actualizar las tarifas de uno o más tipos de habitación para un solo hotel. Específicamente:
- Tarifas de habitación
- Inclusiones de habitación
Cada mensaje OTA_HotelRateAmountNotifRQ contiene un único elemento RateAmountMessages que indica el hotel para actualizar utilizando el atributo RateAmountMessages / @HotelCode. Los elementos RateAmountMessages / RateAmountMessage contendrán las actualizaciones para procesar en un rango de fechas. Puede haber varias actualizaciones de RateAmountMessage por solicitud, sin embargo, cada solicitud estará limitada a un hotel y una habitación.
Estructura básica del mensaje:
Leyenda O = Opcional
| O | Número | Elemento / @Atributo | Tipo de dato | Descripción |
|---|---|---|---|---|
| 1 | OTA_HotelRateAmountNotifRQ | Nodo raíz | ||
| 1 | @EchoToken | String | Identificador global único para la solicitud, esta debe ser reflejada como un EchoToken en la respuesta. | |
| 1 | @Version | Decimal | Versión.Actualmente 1.0. | |
| POS | Nodo | Información de origen de la petición. | ||
| Source | Nodo | Contenedor de fuente. | ||
| RequestorID | Nodo | Datos de origen. | ||
| @Type | Integer | Tipo de solicitud. | ||
| @ID | String | Identificador de origen para petición. | ||
| RateAmountMessages | Nodo | Contenedor de datos para tarifas. | ||
| @HotelCode | String | Código de la propiedad a la que se actualiza la disponibilidad. | ||
| RateAmountMessage | Nodo | Mensajes referentes a tarifas. | ||
| StatusApplicationControl | Nodo | Datos de estado por ratePlan. | ||
| @RatePlanCode | String | Identifica la tarifa. RatePlanCode a usar en conjunto con InvTypeCode para identificar la habitación a actualizar. | ||
| @InvTypeCode | String | Identifica la habitación. InvTypeCode a usar en conjunto con RatePlanCode para identificar la habitación a actualizar. | ||
| Rates /Rate | Nodo | Datos de tarifas. | ||
| @Start | Date | Fecha de inicio para disponibilidad. Esta es inclusiva. | ||
| @End | Date | Fecha de cierre para disponibilidad. Esta es inclusiva. | ||
| @Mon | Bool | Validación para aplicación de tarifa para el día Lunes. | ||
| @Tue | Bool | Validación para aplicación de tarifa para el día Martes. | ||
| @Weds | Bool | Validación para aplicación de tarifa para el día Miércoles. | ||
| @Thur | Bool | Validación para aplicación de tarifa para el día Jueves. | ||
| @Fri | Bool | Validación para aplicación de tarifa para el día Viernes. | ||
| @Sat | Bool | Validación para aplicación de tarifa para el día Sábado. | ||
| @Sun | Bool | Validación para aplicación de tarifa para el día Domingo. | ||
| @CurrencyCode | String | Moneda del cargo para huésped extra. | ||
| BaseByGuestAmts /BaseByGuestAmt | Nodo | Datos de tarifa por huésped. | ||
| @AmountBeforeTax | Double | Tarifa con impuestos. | ||
| @AgenQualifyingCode | Integer | Identificador de huésped, 8: Niños, 10: Adultos. |
<**OTA_HotelRateAmountNotifRQ** EchoToken="123sd" Version="1" xmlns="http://tempuri.org/">
<POS xmlns="http://www.opentravel.org/OTA/2003/05">
<Source>
<RequestorID Type="22" ID="PMS1" />
</Source>
</POS>
<RateAmountMessages HotelCode="6972" xmlns="http://www.opentravel.org/OTA/2003/05">
<RateAmountMessage>
<StatusApplicationControl RatePlanCode="BASE" InvTypeCode="D2D" />
<Rates>
<Rate Start="20170901" End="20170930" Mon="true" Tue="true" Weds="true" Thur="true" Fri="false" Sat="false" Sun="false" CurrencyCode="MXN">
<BaseByGuestAmts>
<BaseByGuestAmt AmountBeforeTax="500" AgeQualifyingCode="10" />
<BaseByGuestAmt AmountBeforeTax="250" AgeQualifyingCode="8" />
</BaseByGuestAmts>
</Rate>
</Rates>
</RateAmountMessage>
</RateAmountMessages>
</**OTA_HotelRateAmountNotifRQ**>
</soap:Body>
</soap:Envelope>
StatusApplicationControl
Este elemento debe aparecer una vez en cada elemento RateAmountMessage. El elemento StatusApplicationControl se usa para especificar el tipo de habitación, el código de tasa y las fechas para las cuales se aplica la actualización. Las fechas afectadas por la actualización están controladas por los atributos obligatorios @Start y @End.
Establecer tarifas
IP-Connect enviará actualizaciones de tarifas utilizando el elemento BaseByGuestAmount. El valor de @AmountAfterTax será un valor decimal positivo.
XML Configuración de tarifas
NOTA: Esta es la tasa de cambio XML predeterminada que recibirá si no se utilizan funciones de velocidad adicionales para su integración en IP-Connect.
Leyenda O = Opcional
| O | Numero | Elemento /@Atributo | Tipo de dato | Descripción |
|---|---|---|---|---|
| 1 | OTAHotelRateAmountNotifRQ | Nodo Raíz | ||
| 1 | @TimeStamp | DateTime | Tiempo de la transacción. | |
| 1 | @Version | Decimal | Versión actual 1.0 | |
| 1 | @EchoToken | String | Identificador global único para la solicitud, este debe ser reflejado como un EchoToken en respuesta. | |
| 1 | RateAmountMessages | Nodo | Mensajes referentes a tarifas. | |
| 1 | @HotelCode | String | Código de hotel de la propiedad a la que se actualizan tarifas. | |
| 1:n | RateAmountMessages /RateAmountMessage | Nodo | Mensajes referentes a tarifas. | |
| 1 | @HotelCode | String | Código de hotel de la propiedad a la que se actualizan tarifas. | |
| 1:n | RateAmountMessages /RateAmountMessage | Nodo | Mensajes referentes a tarifas. | |
| 1 | RateAmountMessage / StatusApplicationControl | Nodo | Información de estado para la tarifa. | |
| 1 | @InvTypeCode | String | Identifica la habitación. | |
| 0:1 | @RatePlanCode | String | Identifica la tarifa. | |
| 1 | @Start | Date | La fecha de inicio para la que se establece la tarifa. Esta fecha es inclusiva. | |
| 1 | @End | Date | La fecha de inicio para la que se establece la tarifa. Esta fecha es inclusiva. | |
| 1 | RateAmountMessage /Rates | Nodo | Datos de tarifa. | |
| 1 | Rates /Rate | Nodo | Datos de tarifa. | |
| 1 | Rate /BaseByGuestAmts | Nodo | Contenedor de datos para tarifas por huésped. | |
| BaseByGuestAmts / BaseByGuestAmt | Nodo | Datos de tarifa por huésped. | ||
| 1 | @AmountAfterTax | Decimal | Costo de tarifa después de aplicar impuesto. Valor decimal positivo. | |
| 0:1 | @NumberOfGuests | Integer | Numero de huéspedes en habitación. | |
| 0:1 | @AgeQualifyingCode | Integer | IP-Connect utiliza el valor de: 10 = Adulto. | |
| 0:1 | @CurrencyCode | String | Moneda de tarifa. | |
| 0:1 | Rate /AdditionalGuestAmounts | Nodo | Cargos adicionales para huéspedes extra para un código de edad establecido. | |
| 1:2 | AdditionalGuestAmounts /AdditionalGuestAmount | Nodo | Obligatorio si AdditionalGuestAmounts esta presente. | |
| 1 | @AgeQualifyingCode | Integer | IP-Connect utiliza los valores: 10 = Adult 8 = Child. | |
| 1 | @Amount | Decimal | Cargo extra. | |
| 0:1 | @CurrencyCode | String | Moneda del cargo para huésped extra. | |
| 0:1 | Rate /RateDescription | Nodo | Descripción de lo que incluye la tarifa. | |
| 1 | RateDescription /Text | String | Descripción de inclusiones. Máximo 255 caracteres. |
