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 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 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é à 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 true, les autres jours de la semaine qui ne sont pas explicitement définis sur true sont exclus. En réalité, ils sont filtrés 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 réalité, ils sont filtrés 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 réalité, ils sont filtrés 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 réalité, ils sont filtrés 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 réalité, ils sont filtrés 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 réalité, ils sont filtrés 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 réalité, ils sont filtrés 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 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:

  • 2: disponibilité définie.

Exemples

Inventaire restant

Définit 5rooms left forRoomID_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 <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

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>