Disponibilidad y restricciones

Disponibilidad y restricciones

IP-Connect enviará actualizaciones de disponibilidad y restricciones utilizando OTA_HotelAvailNotifRQ. El canal conectado debe procesar las actualizaciones y responder con OTA_HotelAvailNotifRS como exitosa o fallida al procesar la solicitud.

OTA_HotelAvailNotifRQ

Se enviará un mensaje OTA_HotelAvailNotifRQ al servicio web de un canal conectado después de que el valor cambie en IP-Connect. El mensaje se puede usar para actualizar la disponibilidad y las restricciones de un tipo de habitación para un solo hotel.

Específicamente:

  • Disponibilidad del inventario.
  • Actualización de tarifas.
  • Cerrado en llegada.

Cada mensaje OTA_HotelAvailNotifRQ contiene un único elemento AvailStatusMessages que indica el hotel a actualizar, utilizando el atributo AvailStatusMessages/@HotelCode. Los elementos AvailStatusMessages/AvailStatusMessage contendrán las actualizaciones para procesar en un rango de fechas. Puede haber varias actualizaciones de AvailStatusMessage por solicitud, sin embargo, cada solicitud estará limitada a un hotel y una habitación.

La estructura básica del mensaje es la siguiente:

Leyenda O = Opcional

O Número Elemento /@Atributo Tipo de dato Descripción
1 OTA_HotelAvailNotifRQ Nodo raíz.
1 @Version Decimal Versión.Actualmente 1.0.
1 @TimeStamp DateTime Tiempo de transacción.
1 @EchoToken String Identificador global único para la solicitud, esta debe ser reflejada como un EchoToken en la respuesta.
POS Nodo Información de origen de la petición.
Source Nodo Contiene información referente a la fuente de la petición.
RequestorID Nodo Contiene información del solicitante.
@Type Integer Tipo de solicitud.
@ID String Identificador de origen para petición.
AvailStatusMessages Nodo Contiene los mensajes de disponibilidad.
@HotelCode String Código de la propiedad a la que se actualiza la disponibilidad.
AvailStatusMessage Nodo Contiene los mensajes de disponibilidad.
@BookingLimit Integer Establece el numero de habitaciones disponibles para venta.
StatusApplicationControl Nodo Contiene la información para identificación de fecha y habitación.
@Start Date Fecha de inicio para disponibilidad. Esta es inclusiva.
@End Date Fecha de cierre para disponibilidad. Esta es inclusiva.
RestrictionStatus Nodo Contiene información del estado de venta de habitación.
1 @Status String Obligatorio si RestricionStatus esta presente. Puede ser Open: para venta de habitación o Close: para detener la venta de habitación. 
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" TimeStamp="2005-08-01T09:30:47+08:00" EchoToken="abc123">        
    <POS xmlns="http://www.opentravel.org/OTA/2003/05">
        <Source>
            <RequestorID Type="22" ID="PMS1" />
        </Source>
    </POS>
    <AvailStatusMessages HotelCode="6972" xmlns="http://www.opentravel.org/OTA/2003/05">
       <AvailStatusMessage BookingLimit="50">
            <StatusApplicationControl Start="20180901" End="20180930" RatePlanCode="BASE" InvTypeCode="D2D" />
            <RestrictionStatus Status="Open" />
        </AvailStatusMessage>
    </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

StatusApplicationControl

Este elemento debe aparecer una vez en cada elemento AvailStatusMessage. 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 disponibilidad

IP-Connect enviará actualizaciones de disponibilidad utilizando el atributo AvailStatusMessage/@BookingLimit. El valor de @BookingLimit será un valor entero positivo.

Leyenda O = Opcional

O Número Elemento / @Atributo Tipo de dato Descripción
1 OTA_HotelAvailNotifRQ Nodo raíz.
1 @Version Decimal Versión.Actualmente 1.0.
1 @TimeStamp DateTime Tiempo de transacción.
1 @EchoToken String Identificador global único para la solicitud, esta debe ser reflejada como un EchoToken en la respuesta.
AvailStatusMessages Nodo Contenedor para mensajes de disponibilidad.
@HotelCode String Código de la propiedad a la que se actualiza la disponibilidad.
AvailStatusMessage Nodo Contiene datos de mensaje referente al estado de disponibilidad.
@BookingLimit Integer Establece el numero de habitaciones disponibles para venta.
StatusApplicationControl Nodo Contiene datos de actualización de estado.
@Start Date Fecha de inicio para disponibilidad. Esta es inclusiva.
@End Date Fecha de cierre para disponibilidad. Esta es inclusiva.
@InvTypeCode String Identifica la habitación. InvTypeCode a usar en conjunto con RatePlanCode para identificar la habitación a actualizar.
@RatePlanCode String Identifica la tarifa. RatePlanCode a usar en conjunto con InvTypeCode para identificar la habitación a actualizar.
RestrictionStatus Nodo Opcional, usado para controlar la venta de habitaciones y cerrado en llegada.
@Status String Obligatorio si RestrictionStatus esta presente. Puede ser Open: para venta de habitación o Close: para detener la venta de habitación. 
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" TimeStamp="2005-08-01T09:30:47+08:00" EchoToken="abc123">
  <AvailStatusMessages HotelCode="HOTEL">
      <AvailStatusMessage BookingLimit="10">
         <StatusApplicationControl Start="20120101" End="20120102" InvTypeCode="D2D" RatePlanCode="BASE"/>
         <RestrictionStatus Status="Open" />
       </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Configuración de venta y cerrado en llegada.

Las actualizaciones para detener ventas o cerrado en llegada se enviarán utilizando el nodo RestrictionStatus. A continuación se muestra un conjunto de escenarios a través de los cuales IP-Connect enviará una actualización.

Tenga en cuenta que las paradas de venta, cerradas a la llegada y cerradas a la salida pueden ser enviadas por separado por IP-Connect, por lo que su estado debe asumirse como separado. Por ejemplo, un mensaje que tiene un estado 'Open' sin una 'Restriction ='Arrival'' no debe cambiar el estado de cerrado a la llegada.

Tipo de restricción Como debe ser enviada
Habitación vendida. RestrictionStatus Status="Close"
Habitacion en venta. RestrictionStatus Status="Open"
Habitación configurada como cerrada en llegada. RestrictionStatus Status="Close" Restriction="Arrival"
La habitación está abierta en llegada. RestrictionStatus Status="Open" Restriction="Arrival"

Especificaciones de OTA_HotelAvailNotifRQ

Leyenda O = Opcional

O Número Elemento / @Atributo Tipo de dato Descripción
1 OTAHotelAvailNotifRQ Nodo raíz.
1 @TimeStamp DateTime Tiempo de transacción.
1 @Version Decimal Versión.Actualmente 1.0.
1 @EchoToken String Identificador global único para la solicitud, esta debe ser reflejada como un EchoToken en la respuesta.
1 OTAHotelAvailNotifRQ /AvailStatusMessages Nodo Contiene los mensajes de disponibilidad.
1 @HotelCode String Código de la propiedad a la que se actualiza la disponibilidad.
1:n AvailStatusMessages /AvailStatusMessage Nodo Contiene los mensajes de disponibilidad. Puede haber varios de estos nodos por solicitud.
0:1 @BookingLimit Integer Establece el numero de habitaciones disponibles para venta.
1 AvailStatusMessage /StatusApplicationControl Nodo Contiene la información para identificación de fecha y habitación.
1 @Start Date Fecha de inicio para disponibilidad. Esta es inclusiva.
1 @End Date Fecha de cierre para disponibilidad. Esta es inclusiva.
0:1 @RatePlanCode String Identifica la tarifa. RatePlanCode a usar en conjunto con InvTypeCode para identificar la habitación a actualizar.
1 @InvTypeCode String Identifica la habitación. InvTypeCode a usar en conjunto con RatePlanCode para identificar la habitación a actualizar.
0:1 StatusApplicationControl /LengthOfStay Nodo Opcional, usado para la duración mínima y máxima de estadía.
1 @MinMaxMessageType String Obligatoria si LengthsOfStay esta presente. Puede ser una de las siguientes.SetMinLOS: Establece el mínimo de estadía. SetMaxLOS: Establece el máximo de estadía (no soportado actualmente).
1 @Time Integer Obligatoria si LengthsOfStay esta presente. Establece los días mínimos para estadía.
0:1 AvailStatusMessage /RestrictionStatus. Nodo Opcional, usado para controlar la venta de habitaciones y cerrado en llegada.
1 @status String Obligatorio si RestrictionStatus esta presente. Puede ser Open: para venta de habitación o Close: para detener la venta de habitación.
0:1 @Restriction String Arrival: establece el valor de cerrado en llegada.

Ejemplo XML de respuesta exitosa.

Leyenda O = Opcional

O Número Elemento / @Atributo Tipo de dato Descripción
1 OTA_HotelAvailNotifRS Nodo raíz
1 @Version Decimal Versión. Actualmente 1.0.
Success Nodo Indicador del estado de la respuesta. 
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <OTA_HotelAvailNotifRS Version="0" xmlns="http://tempuri.org/">
            <Success xmlns="http://www.opentravel.org/OTA/2003/05"/>
        </OTA_HotelAvailNotifRS>
    </s:Body>
</s:Envelope>

Ejemplo XML de respuesta error.

Leyenda O = Opcional

O Número Elemento / @Atributo Tipo de dato Descripción
1 OTA_HotelAvailRS Nodo raíz
1 @Version Decimal Versión. Actualmente 1.0.
Errors /Error Nodos Contenedor /respuestas de error.
@Type Integer Código para tipo de error.
@Code Integer Código de error. 
<?xml version="1.0" encoding="utf-16"?>
<OTA_HotelAvailRS xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Version="0">
    <Errors xmlns="http://www.opentravel.org/OTA/2003/05">
        <Error Type="3" Code="392">Invalid Hotel Code</Error>
    </Errors>
</OTA_HotelAvailRS>
← Confirmación y reservaciónDescarga de reservas →