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 / @Atributo Casos Tipo Descripción
OTA_HotelInvCountNotifRQ 1 Complex element Es el elemento raíz de un mensaje que define la disponibilidad de la tarifa de la habitación.
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 Es la fecha y la 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 de este mensaje (por lo general, se usa si tu backend proporciona feeds de precios para varias cuentas de socio).
OTA_HotelInvCountNotifRQ / POS/ Source 1 Source Es obligatorio si <POS> está presente. Es un contenedor para el <RequestorID>.
OTA_HotelInvCountNotifRQ / POS / RequestorID 1 RequestorID Es obligatorio si <POS> está presente. Define la cuenta de socio.
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID 1 string Es la cuenta de socio de este mensaje. Este valor de cadena es el el valor de Clave de socio que aparece 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 de 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 <Inventory> elementos.
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 de hotel también aparece 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, de el 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 start. Si start y end son iguales, la actualización se aplica a esa fecha.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon 0..1 boolean Establécelo en true o 1 para incluir los lunes de forma explícita.

Si se establece en true, se excluyen los demás días de la semana que no se establezcan de forma explícita en true (en efecto, se filtran de las fechas dentro de Start y End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue 0..1 boolean Establécelo en true o 1 para incluir los martes de forma explícita.

Si se establece en true, se excluyen los demás días de la semana que no se establezcan de forma explícita en true (en efecto, se filtran de las fechas dentro de Start y End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds 0..1 boolean Establécelo en true o 1 para incluir los miércoles de forma explícita.

Si se establece en true, se excluyen los demás días de la semana que no se establezcan de forma explícita en true (en efecto, se filtran de las fechas dentro de Start y End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur 0..1 boolean Establécelo en true o 1 para incluir los jueves de forma explícita.

Si se establece en true, se excluyen los demás días de la semana que no se establezcan de forma explícita en true (en efecto, se filtran de las fechas dentro de Start y End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri 0..1 boolean Establécelo en true o 1 para incluir los viernes de forma explícita.

Si se establece en true, se excluyen los demás días de la semana que no se establezcan de forma explícita en true (en efecto, se filtran de las fechas dentro de Start y End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat 0..1 boolean Establécelo en true o 1 para incluir los sábados de forma explícita.

Si se establece en true, se excluyen los demás días de la semana que no se establezcan de forma explícita en true (en efecto, se filtran de las fechas dentro de Start y End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun 0..1 boolean Establécelo en true o 1 para incluir los domingos de forma explícita.

Si se establece en true, se excluyen los demás días de la semana que no se establezcan de forma explícita en 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 Transactions (Property Data) mensaje.
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 trata como 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 5 habitaciones restantes 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

Marca 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 / @Atributo 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 Es la fecha y la hora de creación de este mensaje.
OTA_HotelInvCountNotifRS / @EchoToken 1 string Es el identificador único del mensaje asociado OTA_HotelInvCountNotifRQ.
OTA_HotelInvCountNotifRS / Success 0..1 Success Indica que el mensaje OTA_HotelInvCountNotifRQ se procesó correctamente.

Either <Success> or <Errors> is present in each message.
OTA_HotelInvCountNotifRS / Errors 0..1 Errors Es un contenedor para uno o más problemas que se encontraron durante el procesamiento del OTA_HotelInvCountNotifRQ mensaje.

Either <Success> or <Errors> is present in each message.
OTA_HotelInvCountNotifRS / Errors / Error 1..n Error Es la descripción de un error que se encontró durante el procesamiento del OTA_HotelInvCountNotifRQ mensaje. Puedes encontrar detalles sobre estos errores en Mensajes de error de estado del feed.
OTA_HotelInvCountNotifRS / Errors / Error / @Type 1 integer Es el EWT (Error Warning Type) de OpenTravel Alliance asociado con el error. Solo se usa el valor 12 (Processing exception).
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 integer Es el ERR (Error Code) de OpenTravel Alliance asociado con el 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 de estado del feed.

Ejemplos

Listo

La siguiente es 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

La siguiente es 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>