Comment lire et interpréter les journaux du channel manager

Ce guide contient des conseils pour lire et interpréter les journaux du channel manager, pour résoudre les différents problèmes qui pourraient survenir. Les journaux du channel manager peuvent inclure les mises à jour d’inventaire envoyées depuis Mews, et de nouvelles réservations effectuées via le channel manager. Les journaux peuvent être utilisés par l’équipe d’assistance du channel manager pour résoudre les requêtes. Pour savoir comment accéder aux journaux du channel manager, consultez Comment accéder aux journaux du channel manager.


Remarque : Les journaux sont stockés pendant un maximum de 30 jours. Vous ne pouvez pas accéder à des données datant de plus de 30 jours.
 

Intégrations de channel manager

Lorsque nous parlons de la file d’attente et des journaux de messages, nous nous référons à la file d’attente du channel manager et aux journaux de messages du channel manager. En effet, la majorité de ces intégrations sont des intégrations de channel managers, mais notez que ces intégrations peuvent inclure des canaux directs tels que des systèmes de réservation centraux ou des agences de voyages en ligne, qui ne passent pas par un channel manager. Ils fonctionnent cependant d’une manière similaire, en envoyant des mises à jour de tarifs, de disponibilités et d’inventaires depuis Mews vers le canal, et en recevant des réservations depuis le canal vers Mews.

 

Cas d’utilisation généraux

Les exemples suivants s’appliquent uniquement aux intégrations générales qui utilisent le Mews Open API et pas aux intégrations spéciales telles que SiteMinder et SynXis. Dans tous les cas d’utilisation généraux, les données sont au format JSON.
 

Sommaire

 

1. Mise à jour d’inventaire : vérifier le nombre de chambres

Cas d’utilisation : « Je veux vérifier le nombre de chambres disponibles pour une catégorie d’espace spécifique, par exemple, DBL, envoyée au channel manager dans le cadre d’une mise à jour d’inventaire. »


Le nombre d’espaces disponibles est affiché à côté de "availability", sous le "spaceTypeCode" correspondant. Dans l’exemple suivant, il y a 16 chambres 16 DBL disponibles :

{
  "availabilities": [
    {
      "spaceTypeCode": "DBL",
      "availability": 16,
      "from": "2021-07-22",
      "to": "2021-07-22"
    }
  ],
  "clientToken": "{ClientToken}",
  "connectionToken": "{Token}"
}

 

2. Mise à jour d’inventaire : vérifier le prix

Cas d’utilisation : « Je veux vérifier le prix d’un plan tarifaire spécifique envoyé au channel manager dans le cadre d’une mise à jour d’inventaire. »


Le prix est affiché pour un compte client spécifique et dans une devise spécifique, à côté du plan tarifaire et du code du type d’espace correspondant. Dans l’exemple ci-dessous, le prix est de 100,00 € brut ou 93,46 € net pour le type d’espace 'D1' et le plan tarifaire 'FF' :

   "ratePrices": [
        {
            "spaceTypeCode": "D1",
            "ratePlanCode": "FF",
            "prices": [
                {
                    "grossAmount": 100.00,
                    "netAmount": 93.46,
                    "currencyCode": "EUR",
                    "guestCount": 1
                },

 

3. Mise à jour d’inventaire : quelles sont les chambres qui ont été fermées ?

Cas d’utilisation : « Pour une mise à jour d’inventaire donnée, je veux savoir quelles chambres ont été fermées et quelles chambres ont des restrictions de durée de séjour. »


Les chambres ou les espaces fermés sont affichés avec des restrictions d’état (state) '2', comme dans l’exemple ci-dessous. Pour en savoir plus, vous pouvez consulter la documentation d’API.

"restrictions": [
   {
      "ratePlanCode": "BTR",
      "spaceTypeCode": "RCS",
      "state": [
        2,
        8
      ],
      "minLos": null,
      "maxLos": null,
      "from": "2022-07-20",
      "to": "2022-07-20"
    },


Dans le cas des espaces fermés, vous pourrez également voir un ou plusieurs états supplémentaires '6', '7' ou '8' pour indiquer si l’espace est fermé à l’arrivée, au départ, lors du séjour, ou plusieurs de ces états.
 

État de restriction

Code                Description               
1Ouvert
2Fermé
3- 
4-
5-
6Fermé à l’arrivée
7Fermé au départ
8Fermé lors du séjour
 

Pour plus d’exemples, consultez la documentation d’API.
 

4. Réservations : quelles sont les données client manquantes ?

Cas d’utilisation : « Je veux vérifier le journal des réservations pour savoir si un numéro de téléphone ou d’autres informations de client manquent pour une réservation spécifique. »


Dans ce cas, vous pouvez trouver la réservation et vérifier les données directement. Si le champ 'telephone' est vide ou absent, cela signifie qu’aucun numéro de téléphone n’a été envoyé par le channel manager. Nous vous recommandons alors de contacter l’assistance du channel manager.


Vous pouvez trouver la réservation spécifique en filtrant les données du journal des messages avec les paramètres appropriés, par exemple les heures de début et de fin. Si vous utilisez plusieurs channel managers, filtrez également les données avec le nom du channel manager.


Un enregistrement des données d’un client ressemble à ceci :

"customer": {
   "address": {
      "addressLine1": "Some street 123",
      "addressLine2": "Some other detail",
      "city": "Some city",
      "country": "US",
      "latitude": 30,
      "longitude": 20,
      "region": "Some region",
      "zip": "123 45"
      },
   "email": "[email protected]",
   "firstName": "John",
   "lastName": "Smith",
   "nationalityCode": "US",
   "languageCode": "en-US",
   "telephone": "1-3526-88918"
},

 

5. Réservations : résolution des problèmes des cartes de paiement

Cas d’utilisation : « Je veux voir les informations de la carte de paiement pour une réservation spécifique. »


Un enregistrement de carte de paiement peut être affiché au sein d’un enregistrement de réservation, comme dans l’exemple ci-dessous. Pour des raisons de sécurité, le numéro de carte ne sera jamais affiché dans les journaux. À la place, il sera remplacé par "XXXXXXXXXXXXXX" ou par du texte aléatoire. De même, le numéro de CVV sera un numéro non valide. Les seules données valides seront le nom du titulaire de la carte et la date d’expiration de la carte.

 "paymentCard": {
        "cvv": "666",
        "expireDate": "1222",
        "holderName": "John Smith",
        "number": "XXXXXXXXXXXXXX,
        "type": 1
    }

 

6. Réservations : où trouver le prix par nuit ?

Cas d’utilisation : « Je veux voir le prix pour chaque nuit du séjour, pour une réservation spécifique. »


Les prix par nuit sont indiqués en tant que "amounts" dans l’enregistrement de la réservation, avec un montant par nuit pour la durée totale du séjour.
Par exemple :

"reservations": [
	{
		"adultCount": 2,
		"code": "02",
		"from": "2020-05-06",
		"to": "2020-05-09",
		"amounts": [
			{
				"net": 81,
				"gross": 100
			},
			{
				"net": 97.2,
				"gross": 120
			},
			{
				"net": 97.2,
				"gross": 120
			}
		],
		"ratePlanCode": "NR",
		"spaceTypeCode": "DBL",
		"state": 2,
		"totalAmount": {
			"net": 275.4,
			"gross": 340
		}


Dans cet exemple, la réservation consiste en un séjour de trois nuits, avec des prix de 100.00, de 120.00 et de 120.00 respectivement pour chaque nuit. Le montant total du séjour de 340.00 est indiqué séparément.

 

7. Réservations : où trouver le nombre de clients ?

Cas d’utilisation : « Je veux connaître le nombre de clients pour une réservation spécifique. »


Pour voir le nombre d’adultes et d’enfants pour les réservations, cherchez 'adultCount' et 'childCount' dans l’enregistrement de la réservation.

Pour une intégration de channel manager avec l’option "Utiliser la catégorie d’âge dans les réservations" activée, vous pouvez rechercher 'GuestCounts' dans l’enregistrement de la réservation.

 

8. Réservations : où trouver les produits qui ont été réservés ?

Cas d’utilisation : « Je veux savoir quels produits supplémentaires ont été réservés pour une réservation spécifique. »


Pour voir quels produits supplémentaires ont été réservés dans le cadre du séjour, cherchez les 'extras' dans l’enregistrement de la réservation.
 

        "extras": [
                {
                    "code": "1",
                    "count": 1,                    
                    "amount": {
                        "net": 16.2,
                        "gross": 20
                    },
                    "from": "2021-05-06",
                    "to": "2021-05-07",
                    "pricing": 3
                }


Le produit est identifié par 'code', pour effectuer un mappage avec un produit spécifique dans les paramètres d’intégration de votre channel manager. 'pricing' correspond à un code qui identifie la règle de facturation, par exemple par personne et par nuit, ou par séjour. 'amount' correspond au prix par unité de produit.
 

Codes de tarification

CodeDescription
1Une fois pour la réservation
2Par personne
3Par nuit
4Par personne et par nuit


Pour la liste définitive des codes, référez-vous à la documentation API.

 

9. Réservations : où trouver le prix total ?

Cas d’utilisation : « Je veux voir le prix total d’une réservation spécifique. »


Le prix total de la réservation est indiqué sous 'totalAmount'. Cela inclut la somme des montants pour chaque nuit du séjour, ainsi que le total des produits supplémentaires. Cette valeur est reçue par Mews depuis le channel manager. La valeur ne sera modifiée que si le système est configuré avec des règles produit qui indiquent qu’un montant doit y être ajouté.
 

Comme avec tous les montants, si votre établissement est configuré pour des tarifs bruts, le montant brut sera utilisé, mais s’il est configuré pour des tarifs nets, alors c’est le montant net qui sera utilisé et les taxes seront calculées en fonction de votre environnement juridique.

 

10. Réservations : y a-t-il un profil de société associé ?

Cas d’utilisation : « Je veux savoir si un profil de société est associé à une réservation spécifique. »


Pour savoir si un profil d’entreprise est associé aux informations de la réservation, cherchez 'company'. Un enregistrement d’entreprise ressemble à ceci :
 

"company": {
        "id": "MEWS",
        "iata": "65893",
        "name": "Mews Systems, s.r.o.",
        "contact": {
            "email": "[email protected]",
            "phone": "+420 775 684 983",
            "address": {
                "zip": "110 00",
                "city": "Prague",
                "country": "Czech Republic",
                "addressLine1": "586 Ulice Test",
                "addressLine2": "Patro 2"
            }
        }
 

11. Réservations : quel était le canal utilisé ?

Cas d’utilisation : « Je veux savoir quel a été le canal utilisé pour effectuer la réservation. »


Pour savoir quel a été le canal utilisé pour effectuer la réservation, cherchez 'channel'.
Astuce : cela peut vous servir lorsque vous souhaitez savoir si un channel manager a envoyé le code de mappage de canal correct et si ça a affecté le mappage de l’agence de voyages.

    "channel": {
        "code": 1,
        "name": "Expedia"
    }


Vous pouvez trouver une liste complète des codes des canaux ici. Il n’est pas nécessaire de les copier lorsque vous mappez les profils d’agences de voyages, il suffit de les sélectionner à partir du menu déroulant lorsque vous configurez les agences de voyages, comme expliqué dans la Méthode 1 ici. Ils seront déjà connectés aux codes de canaux listés.

 

12. Réservations : résolution des problèmes liés aux numéros de réservation

Cas d’utilisation : « Je veux savoir quels sont les numéros de réservation qui ont été envoyés dans le cadre de la réservation. »


Mews reçoit deux nombres de réservation - l’un provient du canal d’origine ('channelId'), l’autre du channel manager ('channelManagerId'). Les chiffres peuvent varier.
 

{
	"clientToken": "[Channel manager client token]",
	"connectionToken": "[Token of a concrete connection]",
	"channelId": "EXP-123456",
	"channelManagerId": "123456",
 
Was this article helpful?
10



Feedback