Messages de réponse d'indication

Lorsque nous envoyons un message Hint Request, vos serveurs doivent y répondre avec un message de réponse d'indication. Celui-ci doit spécifier les hôtels dont les prix ont changé depuis la dernière fois où nous avons reçu un message de réponse d'indication de la part de vos serveurs. En cas de changement de prix, nous envoyons un message de requête <Query> qui récupère les nouvelles données tarifaires des hôtels et séjours indiqués.

Pour en savoir plus sur le processus de modification des prix, consultez Mettre à jour des prix.

Dans les messages de réponse d'indication, vous pouvez utiliser l'une des méthodes suivantes pour nous spécifier les hôtels et les séjours dont nous devons modifier les prix :

La durée de séjour par défaut est de cinq jours lorsque vous utilisez ce mode d'envoi.

L'élément racine d'un message de réponse d'indication est <Hint>. Pour demander la mise à jour d'un hôtel ou d'un séjour, vous devez utiliser un ou plusieurs éléments <Item>. Un message de réponse d'indication peut définir plusieurs éléments <Item>.

Chaque message de réponse d'indication doit comporter au moins un élément <Property> pour chaque élément <Item>. L'élément <Property> identifie un hôtel en utilisant le même ID que celui défini dans la liste d'hôtels pour l'établissement concerné.

Par défaut, vous spécifiez un identifiant d'hôtel unique pour chaque bloc <Item>. Toutefois, vous pouvez nous indiquer plusieurs hôtels dans un bloc "<Item>" si vous utilisez des plages de dates d'arrivée ou des séjours inclus dans une période pour mettre à jour vos prix.

Flux des messages de requête et de réponse pour un séjour exact

Les messages d'indication peuvent être basés sur des séjours individuels (combinaison d'une date d'arrivée et d'une durée de séjour). Dans ce cas, vous spécifiez une date d'arrivée et une durée de séjour pour vos hôtels, et nous récupérons les nouvelles données tarifaires uniquement pour ce séjour.

Le message de réponse d'indication suivant définit un seul hôtel et un seul séjour :

<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2014-06-10</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
</Hint>

Nous répondons à votre message de réponse d'indication par un message de requête <Query> semblable à ce qui suit :

<Query>
  <Checkin>2014-06-10</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

Vous devez ensuite créer un message <Transaction> en mettant à jour les prix de l'hôtel pour le séjour suivant :

6/10/14 - 6/13/14

Flux des messages de requête et de réponse pour une plage de dates d'arrivée

Un message de réponse d'indication peut spécifier une plage de dates d'arrivée, allant de la plus proche à la plus éloignée. Lors nous récupérons de nouvelles données tarifaires, notre système extrait les séjours correspondant à chaque date d'arrivée à l'hôtel spécifiée et à la durée du séjour indiquée.

Dans l'exemple ci-dessous, le message de réponse d'indication définit un hôtel et une plage de dates d'arrivée :

<Hint>
  <Item>
    <Property>12345</Property>
    <FirstDate>2014-06-10</FirstDate>
    <LastDate>2014-06-13</LastDate>
  </Item>
</Hint>

Nous y répondons par un message de requête <Query> semblable à celui-ci :

<Query>
  <FirstDate>2014-06-10</FirstDate>
  <LastDate>2014-06-12</LastDate>
  <Nights>5</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

Vous devez ensuite créer un message <Transaction> en mettant à jour les prix de l'hôtel pour les séjours suivants :

6/10/14 - 6/11/14
6/10/14 - 6/12/14
6/10/14 - 6/13/14
6/10/14 - 6/14/14
6/10/14 - 6/15/14

6/11/14 - 6/12/14
6/11/14 - 6/13/14
6/11/14 - 6/14/14
6/11/14 - 6/15/14
6/11/14 - 6/16/14

6/12/14 - 6/13/14
6/12/14 - 6/14/14
6/12/14 - 6/15/14
6/12/14 - 6/16/14
6/12/14 - 6/17/14

Dans cet exemple, la durée de séjour par défaut (cinq nuits) est utilisée.

Flux des messages de requête et de réponse pour des itinéraires ou séjours inclus dans une période

Un message de réponse d'indication peut spécifier une plage de nuits pour un séjour. Nous devons alors récupérer tous les séjours qui contiennent au moins l'une de ces nuits. Le groupe de séjours récupéré combine à la fois les nuits avec les prix modifiés et la durée maximale du séjour indiquée.

Dans l'exemple ci-dessous, le message de réponse d'indication définit des séjours inclus dans une période :

<Hint>
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2014-06-10</FirstDate>
      <LastDate>2014-06-13</LastDate>
    </StaysIncludingRange>
  </Item>
</Hint>

Nous répondons à votre message de réponse d'indication par un message de requête <Query> semblable à celui-ci :

<Query>
  <FirstDate>2014-06-10</FirstDate>
  <LastDate>2014-06-13</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>12345</Property>
    <Property>67891</Property>
  </PropertyList>
</Query>

Vous devez ensuite créer un message <Transaction> en mettant à jour les prix de l'hôtel pour les séjours suivants :

6/07/14 - 6/10/14

6/08/14 - 6/10/14
6/08/14 - 6/11/14

6/09/14 - 6/10/14
6/09/14 - 6/11/14
6/09/14 - 6/12/14

6/10/14 - 6/11/14
6/10/14 - 6/12/14
6/10/14 - 6/13/14

6/11/14 - 6/12/14
6/11/14 - 6/13/14
6/11/14 - 6/14/14

6/12/14 - 6/13/14
6/12/14 - 6/14/14
6/12/14 - 6/15/14

6/13/14 - 6/14/14
6/13/14 - 6/15/14
6/13/14 - 6/16/14

Sachez qu'avec les séjours inclus dans une période, les prix de tous les séjours, y compris ceux qui commencent avant la première date, mais qui la chevauchent, doivent être mis à jour.