Hoe je de Channel Manager logboeken kunt lezen en interpreteren

Dit artikel begeleid je bij het lezen en interpreteren van channel manager logs, om te helpen met verschillende problemen die zouden kunnen optreden. Er kunnen in de channel Manager logs inventarisupdates die van Mews gestuurd zijn en nieuwe reserveringen die via de channel Manager zijn gemaakt inbegrepen zijn. De logboeken kunnen belangrijk zijn voor het support team van de channel manager om problemen op te kunnen lossen. Voor een uitleg over hoe je toegang kunt krijgen tot de channel Manager logboeken, lees Hoe je toegang kunt krijgen tot je inventarislogboeken.
 

Let op: logs worden maximaal 30 dagen bewaard, dus je kunt data ouder dan 30 dagen niet bekijken.
 

Channel Manager integraties

Wij noemen de wachtrij- en berichtlogboeken de channel manager wachtrij- en channel manager berichtlogboeken. De meeste van deze integraties zijn channel manager, echter kunnen er bij deze integraties ook directe kanalen zoals centrale reserveringssystemen of online travel agents inbegrepen zijn, die niet via een channel manager zijn. Ze hebben echter allemaal een vergelijkbare functie, ze sturen updates van tarieven, beschikbaarheid en inventaris vanuit Mews naar het kanaal, en ontvangen boekingen of reserveringen uit het kanaal in Mews.

 

Algemene use cases

De volgende voorbeelden zijn alleen toepasselijk op algemene integraties die de Mews Open API gebruiken en niet op speciale integraties zoals SiteMinder en SynXis. Bij alle Algemene use cases, is de data in JSON formaat.
 

Inhoud

1. Inventarisupdate - controleer het aantal kamers

2. Inventarisupdate - controleer de prijs

3. Inventarisupdate - welke kamers hebben wij gesloten?

4. Reserveringen - ontbreken er gastgegevens?

5. Reserveringen - betaalkaarten troubleshooten

6. Reserveringen - waar kan ik de prijs per nacht zien?

7. Reserveringen - waar kan ik het aantal gasten zien?

8. Reserveringen - waar kan ik zien welke producten geboekt zijn?

9. Reserveringen - waar kan ik de totale prijs zien?

10. Reserveringen - is er een bedrijfsprofiel aan verbonden?

11. Reserveringen - welk kanaal werd gebruikt?

12. Reserveringen - reserveringsnummers troubleshooten

 

1. Inventarisupdate - controleer het aantal kamers

Use case: "Ik wil het aantal beschikbare kamers van een specifieke ruimtecategorie (bijv. DBL) die naar de Channel Manager zijn gestuurd als deel van een inventarisupdate controleren."


Het aantal beschikbare ruimtes wordt weergegeven bij "availability" (beschikbaarheid) onder de bijbehorende "spaceTypeCode" (ruimtetypecode). In het volgende voorbeeld zijn er 16 DBL kamers beschikbaar:

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

 

2. Inventarisupdate - controleer de prijs

Use case: "Ik wil de prijs van een specifiek tariefplan dat als deel van een inventarisupdate naar de channel manager werd gestuurd controleren."


De prijs wordt voor een bepaald gastenaantal en valuta weergegeven, bij een gegeven tariefplancode en ruimtetypecode. In het voordbeeld hieronder, is de prijs €100.00 bruto of €93.46 netto, met ruimtetype 'D1' en tariefplan 'FF':

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

 

3. Inventarisupdate - welke kamers hebben wij gesloten?

Use case: "Ik wil bij een inventarisupdate zien welke kamers wij gesloten hebben en welke kamers lengte-van-verblijf restricties hebben."


Gesloten kamers of ruimtes zijn aangegeven met restrictiestatus '2', zoals in het voorbeeld hieronder. Dit staat ook in de API documentatie https://mews-systems.gitbook.io/channel-manager-api/channel-manager-api#update-restrictions.

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


In het geval van gesloten ruimtes, zie je ook een of meer extra status van '6', '7' of '8' dat aangeeft of de ruimte gesloten voor aankomst, vertrek, verblijf, of een combinatie daarvan is.
 

Restrictie Status

CodeBescrijving
1Open
2Gesloten
3-
4-
5-
6Gesloten voor Aankomst
7Gesloten voor Vertrek
8Gesloten voor Verblijf
 

Je kunt meer voorbeelden vinden in de API documentatie https://mews-systems.gitbook.io/channel-manager-api/channel-manager-api#update-restrictions.
 

4. Reserveringen - ontbreken er gastgegevens?

Use case: "Ik wil het reserveringslogboek controleren om te kijken of een gastentelefoonnummer of andere gastgegevens ontbreken bij een bepaalde reservering."


In dit geval kan je de reservering vinden en de data direct bekijken. Als het 'telefoon' of 'telephone' veld ontbreekt of leeg is, werd er geen telefoonnummer gestuurd door de channel manager, en moet je dit opvolgen bij channel manager support.


Je kunt de specifieke reservering vinden door de berichtlogdata te filteren op de bijpassende parameters, zoals start- en eindtijden. Als je meerder channel managers gebruikt filter dan ook op channel manager naam.


De data van een gast of klant zien er zo uit:

"customer": {
   "address": {
      "addressLine1": "Een of andere straat 123",
      "addressLine2": "Ander detail",
      "city": "Een stad",
      "country": "NL",
      "latitude": 30,
      "longitude": 20,
      "region": "Een regio",
      "zip": "123 45"
      },
   "email": "[email protected]",
   "firstName": "Jan",
   "lastName": "Jansen",
   "nationalityCode": "NL",
   "languageCode": "nl-NL",
   "telephone": "1-3526-88918"
},

 

5. Reserveringen - betaalkaarten troubleshooten

Use case: "Ik wil de betaalkaartgegevens van een bepaalde reservering zien."


De geregistreerde betaalkaartgegevens kunnen worden weergegeven als deel van de reserveringsgegevens, zoals in het voorbeeld hieronder. Om veiligheidsredenen wordt het kaartnummer nooit weergegeven in de logs, in plaats daarvan wordt het vervangen met "XXXXXXXXXXXXXX" of willekeurige tekst. Eveneens is het CVV-nummer een dummynummer. De enige geldige data zijn de kaarthoudernaam (holderName) en de kaartvervaldatum (expireDate).

  "paymentCard": {
        "cvv": "666",
        "expireDate": "1222",
        "holderName": "Jan Jansen",
        "number": "XXXXXXXXXXXXXX,
        "type": 1
    }

 

6. Reserveringen - waar kan ik de prijs per nacht zien?

Use case: "Ik wil de prijs voor elke nacht van verblijf van een bepaalde reservering zien."


De prijzen per overnachting worden als "bedragen" (amounts) weergegeven in de reserveringsgegevens, met een bedrag per nacht van de totale verblijfsperiode. Bijvoorbeeld:

"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
		}


In dit voorbeeld bestaat de reservering uit een verblijf van drie nachten, met prijzen 100.00, 120.00 en 120.00 respectievelijk voor elke nacht. Het totale bedrag voor het verblijf is apart weergegeven als 340.00.

 

7. Reserveringen - waar kan ik het aantal gasten zien?

Use case: "Ik wil het aantal gasten bij een bepaalde reservering bekijken."


Om te zien hoeveel volwassenen en kinderen geboekt hebben, zoek 'adultCount' (aantal volwassenen) en 'childCount' (aantal kinderen) op in de reserveringsgegevens.

Voor een channel manager integratie met de optie "Gebruik leeftijdscategorie in reservering" ingeschakeld, kun je 'GuestCounts' zoeken in de reserveringsgegevens.

8. Reserveringen - waar kan ik zien welke producten geboekt zijn?

Use case: "Ik wil zien welke extra producten bij een bepaalde reservering zijn geboekt."


Om te zien welke add-on producten geboekt waren als deel van het verblijf, zoek op 'extras' in de reserveringsgegevens.

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

 

Het product wordt met 'code' geïdentificeerd, dit mapt naar een specifiek product in je channel manager integratie instellingen. De 'pricing' of prijsstelling is een code die de belastingregel identificeert bijv. per persoon per nacht, of per verblijf. Het bedrag of 'amount' is de prijs per eenheid van het product.
 

Prijsstellingscodes

CodeBeschrijving
1Een keer voor de reservering
2Per persoon
3Per nacht
4Per persoon per nacht


Voor de definitieve lijst met codes, raadpleeg de API documentatie https://mews-systems.gitbook.io/channel-manager-api/mews-api#process-group.

 

9. Reserveringen - waar kan ik de totale prijs zien?

Use case: "Ik wil de totale prijs van een bepaalde reservering zien."


De totale prijs van de boeking staat onder 'totalAmount' (totaal bedrag). Hierin is de som van bedragen voor elke nacht van verblijf inbegrepen, en ook het totaal van extra producten. Deze waarde is ontvangen door Mews van de channel manager, de waarde wordt alleen aangepast als het systeem met Productregels die het bedrag dat er bovenop moet worden toegevoegd aangeven is ingesteld.
 

Zoals met alle bedragen, als je property ingesteld is op brutoprijsstelling, wordt het brutobedrag gebruikt, als het echter op nettoprijsstelling is ingesteld, wordt het nettobedrag gebruikt en wordt belasting berekent volgens je juridische omgeving.

 

10. Reserveringen - is er een bedrijfsprofiel aan verbonden?

Use case: "Ik wil zien of er een bedrijfsprofiel aan een bepaalde reservering is verbonden."


Om te zien of een zakelijk bedrijfsprofiel samen met de reserveringsgegevens werd verstuurd, zoek op bedrijf of 'company'. De bedrijfsgegevens zien er zo uit:

"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": "Praag",
                "country": "Tsjechië",
                "addressLine1": "586 Ulice Test",
                "addressLine2": "Patro 2"
            }
        }

 

11. Reserveringen - welk kanaal werd gebruikt?

Use case: "Ik wil zien via welk kanaal de reservering werd gemaakt."


Om te zien via welk kanaal de reservering werd gemaakt, zoek 'channel' of kanaal. Tip: dit kan handig zijn wanneer je niet zeker weet of een channel manager de juiste kanaalmappingcode heeft gestuurd en het je reisbureau mapping heeft beïnvloed.

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


Je kunt een volledige lijst met kanaalcodes hier vinden. Je hoeft deze niet te kopiëren wanneer je reisbureauprofielen mapt, kies ze gewoon vanuit het drop-down menu wanneer je reisbureaus instelt (zoals hier wordt uitgelegd onder Methode 1). Ze zijn al verbonden aan de vermelde kanaalcodes.

 

12. Reservering - reserveringsnummers troubleshooten

Use case: "Ik wil zien welke reserveringsnummers verstuurd waren als de deel van de reservering."


Mews ontvangt twee reserveringsnummers - een komt van het oorspronkelijke kanaal ('channelId') en een komt van de channel manager ('channelManagerId'). Deze nummers kunnen verschillend zijn.
 

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



Feedback