OTA_HotelInvCountNotifRQ

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 suivants sont autorisés : a-z, A-Z, 0-9, _ (trait de soulignement) et - (trait d'union).
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 <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 du 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 vous disposez d'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 à celle 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é dans l'élément <id> de l'élément <listing> du flux Hotel List Feed. L'ID de l'hôtel est également indiqué 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 et 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.

Si la valeur est true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont exclus des dates comprises entre 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.

Si la valeur est true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont exclus des dates comprises entre 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.

Si la valeur est true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont exclus des dates comprises entre 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.

Si la valeur est true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont exclus des dates comprises entre 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.

Si la valeur est true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont exclus des dates comprises entre 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.

Si la valeur est true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont exclus des dates comprises entre 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.

Si la valeur est true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En effet, ils sont exclus des dates comprises entre 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 un seul nombre d'inventaires.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount 1 InvCount Définit le nombre de salles 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 est complet. 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 la suivante:

  • 2: disponibilité définie.

Exemples

Inventaire restant

Définit 5 salles restantes pour RoomID_1 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="5" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Inventaire épuisé

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

Opération réussie

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

La réponse suivante 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>