Requêtes
Syntaxe
Le message OTA_HotelInvCountNotifRQ
utilise la syntaxe suivante:
<?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>
Éléments et attributs
Le message OTA_HotelInvCountNotifRQ
contient les éléments et les attributs suivants:
Élément / @Attribut | Occurrences | Type | Description |
---|---|---|---|
OTA_HotelInvCountNotifRQ | 1 | Complex element | Élément racine d'un message qui définit la disponibilité des prix des chambres. |
OTA_HotelInvCountNotifRQ / @xmlns | 0..1 | string (URI) | Espace de noms XML. |
OTA_HotelInvCountNotifRQ / @EchoToken | 1 | string | Identifiant unique de ce message de requête. Cette valeur est renvoyée dans le message de réponse. Les caractères autorisés sont a-z, A-Z, 0-9, _ (trait de soulignement) et - (tiret). |
OTA_HotelInvCountNotifRQ / @TimeStamp | 1 | DateTime | Date et heure de création de ce message. |
OTA_HotelInvCountNotifRQ / @Version | 1 | decimal | Version du message OpenTravel. |
OTA_HotelInvCountNotifRQ / POS | 0..1 | POS | Conteneur permettant de spécifier le compte partenaire pour ce message (généralement utilisé si votre backend fournit des flux de prix pour plusieurs comptes partenaire). |
OTA_HotelInvCountNotifRQ / POS/ Source | 1 | Source | Obligatoire si <POS> est présent. Conteneur pour <RequestorID> . |
OTA_HotelInvCountNotifRQ / POS / RequestorID | 1 | RequestorID | Obligatoire si <POS> est présent. Définit le compte partenaire. |
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID | 1 | string | Compte partenaire pour ce message. Cette valeur de chaîne correspond à la valeur de la clé partenaire indiquée sur la page
Paramètres du compte dans Hotel Center.
Remarque:Si votre backend fournit des flux pour plusieurs comptes, cette valeur doit correspondre à la valeur de l'attribut |
OTA_HotelInvCountNotifRQ / Inventories | 1 | Inventories | Conteneur pour un ou plusieurs éléments <Inventory> . |
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode | 1 | string | Identifiant unique de l'établissement. Cette valeur doit correspondre à l'identifiant de l'hôtel spécifié à l'aide de <id> dans l'élément <listing> du flux Hotel List Feed. L'identifiant de l'hôtel est également listé dans Hotel Center. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory | 1..n | Inventory | Définit le nombre de chambres disponibles pour différentes périodes pour un même établissement. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl | 1 | StatusApplicationControl | Définit la plage de dates, ainsi que l'identifiant du type de chambre (InvTypeCode ). |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start | 1 | Date | Date de début (basée sur le fuseau horaire de l'établissement), incluse, de la plage de dates. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End | 1 | Date | Date de fin (basée sur le fuseau horaire de l'établissement), incluse, de la plage de dates. Doit être supérieur ou égal à la valeur start .
Si start et end sont égaux, la mise à jour s'applique à cette date. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon | 0..1 | boolean | Définissez cet attribut sur true ou 1 pour inclure explicitement les lundis.
Si la valeur est |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue | 0..1 | boolean | Définissez cet attribut sur true ou 1 pour inclure explicitement les mardis.
Si la valeur est |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds | 0..1 | boolean | Définissez cet attribut sur true ou 1 pour inclure explicitement les mercredis.
Si la valeur est |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur | 0..1 | boolean | Définissez cet attribut sur true ou 1 pour inclure explicitement les jeudis.
Si la valeur est |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri | 0..1 | boolean | Définissez cet attribut sur true ou 1 pour inclure explicitement les vendredis.
Si la valeur est |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat | 0..1 | boolean | Définissez cet attribut sur true ou 1 pour inclure explicitement les samedis.
Si la valeur est |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun | 0..1 | boolean | Définissez cet attribut sur true ou 1 pour inclure explicitement les dimanches.
Si la valeur est |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode | 1 | string | Identifiant unique de l'inventaire (type de chambre). Cette valeur correspond à <RoomID> dans un message Transactions (Données sur un établissement). |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts | 1 | InvCounts | Conteneur permettant de définir un nombre d'inventaire unique. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount | 1 | InvCount | Définit le nombre de chambres disponibles pouvant être réservées. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count | 1 | integer | Nombre de chambres disponibles pouvant être réservées pour le type de chambre. La valeur zéro indique que le type de chambre n'est plus disponible. Une valeur négative est traitée comme zéro. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType | 1 | enum | Type de décompte d'inventaire spécifié. La valeur valide est:
|
Exemples
Inventaire restant
Définit 5
rooms left for
RoomID_1` aux dates données.
<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>
Inventaire épuisé
Marquez RoomID_1
comme épuisé aux dates données.
<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>
Réponses
Syntaxe
Le message OTA_HotelInvCountNotifRS
utilise la syntaxe suivante:
<?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>
Éléments et attributs
Le message OTA_HotelInvCountNotifRS
contient les éléments et les attributs suivants:
Élément / @Attribut | Occurrences | Type | Description |
---|---|---|---|
1 | Complex element | Élément racine d'une réponse à un message de disponibilité. | |
OTA_HotelInvCountNotifRS / @TimeStamp | 1 | DateTime | Date et heure de création de ce message. |
OTA_HotelInvCountNotifRS / @EchoToken | 1 | string | Identifiant unique du message OTA_HotelInvCountNotifRQ associé. |
OTA_HotelInvCountNotifRS / Success | 0..1 | Success | Indique que le message OTA_HotelInvCountNotifRQ a bien été traité.
Chaque message contient soit |
OTA_HotelInvCountNotifRS / Errors | 0..1 | Errors | Conteneur pour un ou plusieurs problèmes rencontrés lors du traitement du message OTA_HotelInvCountNotifRQ .
Chaque message contient soit |
OTA_HotelInvCountNotifRS / Errors / Error | 1..n | Error | Description d'une erreur rencontrée lors du traitement du message OTA_HotelInvCountNotifRQ . Pour en savoir plus sur ces erreurs, consultez Messages d'erreur concernant l'état du flux. |
OTA_HotelInvCountNotifRS / Errors / Error / @Type | 1 | integer | Type d'avertissement d'erreur (EWT) OpenTravel Alliance associé à l'erreur. Seule la valeur 12 (Processing exception) est utilisée. |
OTA_HotelInvCountNotifRS / Errors / Error / @Code | 1 | integer | Code d'erreur (ERR) OpenTravel Alliance associé à l'erreur.
Seule la valeur 450 (Unable to process) est utilisée. |
OTA_HotelInvCountNotifRS / Errors / Error / @Code | 1 | enum | État de la demande d'origine. Seule la valeur NotProcessed est utilisée. |
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText | 1 | string | Identifiant Google du problème. Pour en savoir plus sur ces erreurs, consultez Messages d'erreur concernant l'état du flux. |
Exemples
Réussite
Voici une réponse à un message OTA_HotelInvCountNotifRQ
correctement traité.
<?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>
Erreurs
Voici une réponse à un message OTA_HotelInvCountNotifRQ
non traité en raison d'erreurs.
<?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>