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 o @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 las habitaciones.
OTA_HotelInvCountNotifRQ / @xmlns 0..1 string (URI) 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 La 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 de 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 elemento <RequestorID>.
OTA_HotelInvCountNotifRQ / POS / RequestorID 1 RequestorID Obligatorio si <POS> está presente. Define la cuenta de socio.
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID 1 string La cuenta de socio de este mensaje. Este valor de cadena es el valor de la 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 transacción (datos de propiedad) 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 la cantidad 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 Establece en true o 1 para incluir los lunes de forma explícita.

Si se establece en true, se excluyen los otros días de la semana que no se configuran 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 Establece true o 1 para incluir los martes de forma explícita.

Si se establece en true, se excluyen los otros días de la semana que no se configuran 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 Establece true o 1 para incluir los miércoles de forma explícita.

Si se establece en true, se excluyen los otros días de la semana que no se configuran 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 Establece true o 1 para incluir los jueves de forma explícita.

Si se establece en true, se excluyen los otros días de la semana que no se configuran 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 Establece true o 1 para incluir los viernes de forma explícita.

Si se establece en true, se excluyen los otros días de la semana que no se configuran 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 Establece en true o 1 para incluir explícitamente los sábados.

Si se establece en true, se excluyen los otros días de la semana que no se configuran 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 Establece en true o 1 para incluir los domingos de forma explícita.

Si se establece en true, se excluyen los otros días de la semana que no se configuran 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 mensaje Transactions (Property Data).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts 1 InvCounts 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:

  • 2: Disponibilidad definida.

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 o @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 La 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 mientras se procesaba el 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 encontró durante el procesamiento del mensaje OTA_HotelInvCountNotifRQ. Puedes encontrar detalles sobre estos errores en Mensajes de error sobre el estado del feed.
OTA_HotelInvCountNotifRS / Errors / Error / @Type 1 integer El EWT (tipo de advertencia de error) de OpenTravel Alliance asociado con el error Solo se usa el valor 12 (Processing exception).
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 integer El código de error (ERR) 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 El identificador de Google del problema. Puedes encontrar detalles sobre estos errores en Mensajes de error sobre el 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>