OTA_HotelInvCountNotifRQ

Demandes

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 inclut 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 pour ce message de demande. Cette valeur est renvoyée dans le message de réponse. Les caractères suivants sont autorisés : 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 partenaires).
OTA_HotelInvCountNotifRQ / POS/ Source 1 Source Obligatoire si <POS> est présent. Conteneur pour l'élément <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 Clé partenaire indiquée sur la page Paramètres du compte dans Hotel Center.

Remarque:Si vous avez un backend qui fournit des flux pour plusieurs comptes, cette valeur doit correspondre à la valeur de l'attribut partner de votre message Transaction (Données sur un établissement) et à la valeur de l'attribut ID dans l'élément <RequestorID> de votre message <OTA_HotelRateAmountNotifRQ> pour le même compte.
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 répertorié dans Hotel Center.
OTA_HotelInvCountNotifRQ / Inventories / Inventory 1..n Inventory Définit le nombre de chambres disponibles sur 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 (en fonction du fuseau horaire de l'établissement), incluse, de la plage de dates.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date Date de fin (en fonction du fuseau horaire de l'établissement), incluse, de la plage de dates. Doit être supérieure ou égale à la valeur start. Si les valeurs start et end sont égales, 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.

S'il est défini sur true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont éliminés des dates comprises entre les valeurs Start et End.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue 0..1 boolean Définissez cet attribut sur true ou 1 pour inclure explicitement les mardis.

S'il est défini sur true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont éliminés des dates comprises entre les valeurs Start et End.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds 0..1 boolean Définissez cet attribut sur true ou 1 pour inclure explicitement les mercredis.

S'il est défini sur true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont éliminés des dates comprises entre les valeurs Start et End.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur 0..1 boolean Définissez cet attribut sur true ou 1 pour inclure explicitement les jeudis.

S'il est défini sur true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont éliminés des dates comprises entre les valeurs Start et End.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri 0..1 boolean Définissez cet attribut sur true ou 1 pour inclure explicitement les vendredis.

S'il est défini sur true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont éliminés des dates comprises entre les valeurs Start et End.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat 0..1 boolean Définissez cet attribut sur true ou 1 pour inclure explicitement les samedis.

S'il est défini sur true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont éliminés des dates comprises entre les valeurs Start et End.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun 0..1 boolean Définissez cet attribut sur true ou 1 pour inclure explicitement les dimanches.

S'il est défini sur true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont éliminés des dates comprises entre les valeurs Start et End.
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 le nombre d'inventaires uniques.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount 1 InvCount Définit le nombre de chambres disponibles à la réservation.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count 1 integer Nombre de chambres disponibles à la réservation pour le type de chambre. La valeur zéro indique que le type de chambre est épuisé. Une valeur négative est considérée comme nulle.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType 1 enum

Type de décompte d'inventaire spécifié. La valeur valide est:

  • 2: disponibilité définie.

Exemples

Inventaire restant

Définit cinq chambres restantes pour 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é

Marque RoomID_1 comme épuisé aux dates indiqué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 inclut 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 <Success>, soit <Errors>.
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 <Success>, soit <Errors>.
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 requête 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

Opération réussie

Vous trouverez ci-dessous une réponse à un message OTA_HotelInvCountNotifRQ traité avec succès.

<?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

La réponse ci-dessous est 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>