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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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:
|
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.
|
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 .
|
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>