OTA_HotelInvCountNotifRQ

Solicitudes

Sintaxis

El mensaje OTA_HotelInvCountNotifRQ usa la siguiente sintaxis:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="message_ID"
                          TimeStamp="timestamp"
                          Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean_value"
                                Tue="boolean_value"
                                Weds="boolean_value"
                                Thur="boolean_value"
                                Fri="boolean_value"
                                Sat="boolean_value"
                                Sun="boolean_value"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="integer" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Elementos y atributos

El mensaje OTA_HotelInvCountNotifRQ tiene los siguientes elementos y atributos:

Elemento / @Attribute Casos Tipo Descripción
OTA_HotelInvCountNotifRQ 1 Complex element Es el elemento raíz de un mensaje que define la disponibilidad de las tarifas de habitaciones.
OTA_HotelInvCountNotifRQ / @xmlns 0..1 string (URI) Es el espacio de nombres XML.
OTA_HotelInvCountNotifRQ / @EchoToken 1 string Es un identificador único para este mensaje de solicitud. Este valor se muestra en el mensaje de respuesta. Los caracteres permitidos son a-z, A-Z, 0-9, _ (guion bajo) y - (guion).
OTA_HotelInvCountNotifRQ / @TimeStamp 1 DateTime Fecha y hora de creación de este mensaje.
OTA_HotelInvCountNotifRQ / @Version 1 decimal Es la versión del mensaje de OpenTravel.
OTA_HotelInvCountNotifRQ / POS 0..1 POS Es un contenedor para especificar la cuenta de socio para este mensaje (por lo general, se usa si tu backend proporciona feeds de precios para varias cuentas de socios).
OTA_HotelInvCountNotifRQ / POS/ Source 1 Source Obligatorio si <POS> está presente. Es un contenedor para el objeto <RequestorID>.
OTA_HotelInvCountNotifRQ / POS / RequestorID 1 RequestorID Obligatorio si <POS> está presente. Define la cuenta del socio.
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID 1 string Es la cuenta de socio de este mensaje. Este valor de cadena es el valor de la clave de socio que se indica en la página Configuración de la cuenta de Hotel Center.

Nota: Si tienes un backend que proporciona feeds para varias cuentas, este valor debe coincidir con el valor del atributo partner de tu mensaje Transaction (Property Data) y el valor del atributo ID en el elemento <RequestorID> de tu mensaje <OTA_HotelRateAmountNotifRQ> para la misma cuenta.
OTA_HotelInvCountNotifRQ / Inventories 1 Inventories Es un contenedor para uno o más elementos <Inventory>.
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode 1 string Es el identificador único de la propiedad. Este valor debe coincidir con el ID de hotel especificado con <id> en el elemento <listing> del feed de lista de hoteles. El ID del hotel también se muestra en Hotel Center.
OTA_HotelInvCountNotifRQ / Inventories / Inventory 1..n Inventory Define los recuentos de habitaciones disponibles para diferentes períodos de una sola propiedad.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl 1 StatusApplicationControl Define el período, así como el identificador del tipo de habitación (InvTypeCode).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start 1 Date Es la fecha de inicio (según la zona horaria de la propiedad), inclusive, del período.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date Es la fecha de finalización (según la zona horaria de la propiedad), inclusive, del período. Debe ser igual o mayor que el valor de start. Si start y end son iguales, la actualización se aplica a esa fecha.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon 0..1 boolean Se establece en true o 1 para incluir los lunes de forma explícita.

Si se configura como true, se excluyen otros días de la semana que no se hayan configurado explícitamente como true (en efecto, se filtran de las fechas dentro de Start y End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue 0..1 boolean Se establece en true o 1 para incluir los martes de forma explícita.

Si se configura como true, se excluyen otros días de la semana que no se hayan configurado explícitamente como true (en efecto, se filtran de las fechas dentro de Start y End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds 0..1 boolean Se establece en true o 1 para incluir los miércoles de forma explícita.

Si se configura como true, se excluyen otros días de la semana que no se hayan configurado explícitamente como true (en efecto, se filtran de las fechas dentro de Start y End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur 0..1 boolean Se establece en true o 1 para incluir los jueves de forma explícita.

Si se configura como true, se excluyen otros días de la semana que no se hayan configurado explícitamente como true (en efecto, se filtran de las fechas dentro de Start y End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri 0..1 boolean Se establece en true o 1 para incluir los viernes de forma explícita.

Si se configura como true, se excluyen otros días de la semana que no se hayan configurado explícitamente como true (en efecto, se filtran de las fechas dentro de Start y End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat 0..1 boolean Se puede establecer en true o 1 para incluir los sábados de forma explícita.

Si se configura como true, se excluyen otros días de la semana que no se hayan configurado explícitamente como true (en efecto, se filtran de las fechas dentro de Start y End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun 0..1 boolean Se establece en true o 1 para incluir los domingos de forma explícita.

Si se configura como true, se excluyen otros días de la semana que no se hayan configurado explícitamente como true (en efecto, se filtran de las fechas dentro de Start y End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode 1 string Es el identificador único del inventario (tipo de habitación). Este valor se asigna a <RoomID> en un mensaje de Transacciones (datos de propiedad).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts 1 InvCounts Es un contenedor para definir un solo recuento de inventario.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount 1 InvCount Define la cantidad de habitaciones disponibles que se pueden reservar.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count 1 integer Es la cantidad de habitaciones disponibles que se pueden reservar para el tipo de habitación. Un valor de cero indica que el tipo de habitación está agotado. Un valor negativo se considera cero.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType 1 enum

Es el tipo de recuento de inventario que se especifica. El valor válido es el siguiente:

  • 2: Disponibilidad definitiva.

Ejemplos

Inventario restante

Establece que quedan 5 habitaciones para RoomID_1 en las fechas indicadas.

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="5" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Inventario agotado

Marcar RoomID_1 como agotado en las fechas indicadas

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Respuestas

Sintaxis

El mensaje OTA_HotelInvCountNotifRS usa la siguiente sintaxis:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="timestamp"
                          EchoToken="echo_token"
                          Version="3.0">
  <!-- Either Success or Errors will be populated. -->
  <Success/>
  <Errors>
    <Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
  </Errors>
</OTA_HotelInvCountNotifRS>

Elementos y atributos

El mensaje OTA_HotelInvCountNotifRS tiene los siguientes elementos y atributos:

Elemento / @Attribute Casos Tipo Descripción
1 Complex element Es el elemento raíz de una respuesta a un mensaje de disponibilidad.
OTA_HotelInvCountNotifRS / @TimeStamp 1 DateTime Fecha y hora de creación de este mensaje.
OTA_HotelInvCountNotifRS / @EchoToken 1 string Es el identificador único del mensaje OTA_HotelInvCountNotifRQ asociado.
OTA_HotelInvCountNotifRS / Success 0..1 Success Indica que el mensaje OTA_HotelInvCountNotifRQ se procesó correctamente.

<Success> o <Errors> están presentes en cada mensaje.
OTA_HotelInvCountNotifRS / Errors 0..1 Errors Es un contenedor para uno o más problemas que se encontraron durante el procesamiento del mensaje OTA_HotelInvCountNotifRQ.

<Success> o <Errors> están presentes en cada mensaje.
OTA_HotelInvCountNotifRS / Errors / Error 1..n Error Es la descripción de un error que se produjo durante el procesamiento del mensaje de OTA_HotelInvCountNotifRQ. Puedes encontrar detalles sobre estos errores en Mensajes de error sobre el estado del feed.
OTA_HotelInvCountNotifRS / Errors / Error / @Type 1 integer Es el EWT (Error Warning Type) de OpenTravel Alliance asociado al error. Solo se usa el valor 12 (Processing exception).
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 integer Es el código de error de la OpenTravel Alliance (ERR) asociado al error. Solo se usa el valor 450 (Unable to process).
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 enum Es el estado de la solicitud original. Solo se usa el valor NotProcessed.
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText 1 string Es el identificador de Google para el problema. Puedes encontrar detalles sobre estos errores en Mensajes de error sobre el estado del feed.

Ejemplos

Listo

A continuación, se muestra una respuesta a un mensaje OTA_HotelInvCountNotifRQ procesado correctamente.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2023-07-23T20:50:37-05:00"
                          Version="3.0">
  <Success/>
</OTA_HotelInvCountNotifRS>

Errores

A continuación, se muestra una respuesta a un mensaje OTA_HotelInvCountNotifRQ que no se procesó debido a errores.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2023-07-23T20:50:37-05:00"
                          Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelInvCountNotifRS>