Dieser Artikel bietet Hilfe dafür, wie Sie die Protokolle für Channel-Manager lesen und auslegen, um verschiedene Probleme lösen zu können, die unter Umständen auftreten. Protokolle für Channel-Manager können Updates zum Inventar, die von Mews versendet wurden, und neue Reservierungen enthalten, die über den Channel-Manager vorgenommen wurden. Die Protokolle könnten für das Supportteam bei Channel-Managern für die Lösung von Anfragen wichtig sein. Eine Erklärung dazu, wie Sie auf die Protokolle für Channel-Manager zugreifen, finden Sie in So greifen Sie auf Ihre Protokolle für Channel-Manager zu.

Hinweis: Protokolle werden für maximal 30 Tage gespeichert, sodass Sie nicht auf Daten zugreifen können, die älter als 30 Tage sind.
 

Integrationen für Channel-Manager Wir beziehen uns auf die Warteschleife und die Nachrichtenprotokolle mit Warteschleife für Channel-Manager und Nachrichtenprotokolle für Channel-Manager. Die Mehrheit an solchen Integrationen sind in der Tat Channel-Manager, beachten Sie jedoch, dass diese Integrationen ebenfalls direkte Kanäle wie etwa zentrale Reservierungssysteme oder Online-Reiseagenturen enthalten könnten, die nicht über den Channel-Manager kommen. Jedoch haben sie alle eine ähnliche Funktion: Das Senden von Updates zu Raten, zur Verfügbarkeit und zum Inventar von Mews zum Kanal und das Erhalten von Buchungen oder Reservierungen vom Kanal zu Mews.

 

Allgemeine Anwendungsfälle

Die folgenden Beispiele gelten nur für allgemeine Integrationen, die die Mews Open API benutzen, und nicht für spezielle Integrationen wie etwa SiteMinder und SynXis. In allen allgemeinen Anwendungsfällen sind die Daten im JSON-Format.

Inhaltsverzeichnis

• 1. Update zum Inventar: Prüfen Sie die Anzahl der Zimmer
• 2. Update zum Inventar: Prüfen Sie den Preis
• 3. Update zum Inventar: Welche Zimmer schließen wir?
• 4. Reservierungen: Fehlen Gästedetails?
• 5. Reservierungen: Problembehebung bei Zahlungskarten
• 6. Reservierungen: Wo kann ich den Preis pro Nacht sehen?
• 7. Reservierungen: Wo kann ich die Gästezahl sehen?
• 8. Reservierungen: Wo kann ich sehen, welche Produkte gebucht werden?
• 9. Reservierungen: Wo kann ich den Gesamtpreis sehen?
• 10. Reservierungen: Wurde ein Firmenprofil verknüpft?
• 11. Reservierungen: Welcher Kanal wurde benutzt?
• 12. Reservierungen: Problembehebung bei Reservierungsnummern

 

 

 1. Update zum Inventar: Prüfen Sie die Anzahl der Zimmer

Anwendungsfall: "Ich möchte die Anzahl an verfügbaren Zimmern für eine bestimmte Raumkategorie, zum Beispiel DBL (Doppelzimmer/DZ), prüfen, die an den Channel-Manager als Teil eines Updates zum Inventar gesendet werden."

Die Anzahl an verfügbaren Räumen wird im Vergleich zu "availability" (Verfügbarkeit) unter dem entsprechenden Raumtypcode "spaceTypeCode". Im folgenden Beispiel sind 16 DZ verfügbar:

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

 

2. Update zum Inventar: Prüfen Sie den Preis

Anwendungsfall: "Ich möchte den Preis für einen bestimmten Ratenplan prüfen, der als Teil eines Updates zum Inventar gesendet wird."

Der Preis wird für eine bestimmte Gästezahl und in einer bestimmten Währung gezeigt, alle im Vergleich mit einem gegebenen Ratenplancode und Raumtypcode. Im Beispiel unten ist der Preis €100 brutto oder €93,46 netto, im Vergleich zum Raumtyp "D1" und zum Ratenplan "FF":

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

 

3. Update zum Inventar: Welche Zimmer schließen wir?

Anwendungsfall: "Bei einem Update zum Inventar möchte ich sehen, welche Zimmer wir geschlossen haben und welche Zimmer Einschränkungen für Langzeitaufenthalte aufweisen."

Geschlossene Zimmer oder Räume sind diejenigen, die mit dem Einschränkungsstatus "2" angezeigt werden, wie im Beispiel unten angezeigt. Dies wird in der API-Dokumentation beschrieben, die nur auf Englisch verfügbar ist.

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

Im Fall von geschlossenen Räumen können Sie ebenfalls eine oder mehr zusätzliche Statusangaben mit den Nummern "6", "7" oder "8" sehen, um anzuzeigen, ob der Raum für Anreisen, Abreisen, Aufenthalte oder eine Kombination dieser geschlossen ist.
 

Einschränkungsstatus

Code	Beschreibung
1	Offen
2	Geschlossen
3	-
4	-
5	-
6	Bei Anreise geschlossen
7	Bei Abreise geschlossen
8	Bei Aufenthalt geschlossen

 

Mehr Beispiele können in der API-Dokumentation gefunden werden.
 

4. Reservierungen: Fehlen Gästedetails?

Anwendungsfall: "Ich möchte die Reservierungsprotokolle prüfen, um zu sehen, ob eine Gästetelefonnummer oder sonstige Gästedetails bei einer bestimmten Reservierung fehlen."

In diesem Fall können Sie die Reservierung finden und Daten direkt prüfen. Wenn das Feld "Telefon" fehlt oder leer ist, dann wurde keine Telefonnummer an den Channel-Manager gesendet und Sie sollten sich an den Support für Channel-Manager wenden.

Sie können die bestimmte Reservierung finden, indem Sie die Nachrichtenprotokolldaten nach passenden Parametern filtern, wie etwa Beginn- und Endzeiten. Wenn Sie mehrere Channel-Manager benutzen, filtern Sie auch nach dem Namen für Channel-Manager. 

Ein Datensatz für Gäste oder Kunden sieht folgendermaßen aus:

"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. Reservierungen: Problembehebung bei Zahlungskarten

Anwendungsfall: "Ich möchte Zahlungskartendaten für eine bestimmte Reservierung sehen."

Ein Datensatz für Zahlungskarten wird unter Umständen als Teil eines Reservierungsdatensatzes gezeigt, wie im Beispiel unten. Aus Sicherheitsgründen wird die Kartennummer nie in den Protokollen angezeigt, stattdessen wird sie mit "XXXXXXXXXXXXXX" oder zufällig ausgewähltem Text ersetzt. Genauso ist die Kartenprüfnummer eine Scheinnummer. Die einzig gültigen Daten sind der Karteninhabername und das Ablaufdatum der Karte.

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

 

6. Reservierungen: Wo kann ich den Preis pro Nacht sehen?

Anwendungsfall: "Ich möchte den Preis für jede einzelne Nacht des Aufenthalts für eine bestimmte Reservierung sehen."

Preise werden pro Übernachtungsaufenthalt als "Beträge" im Reservierungsdatensatz mit einem Betrag pro Nacht des gesamten Aufenthaltszeitraums gezeigt. Zum Beispiel:

"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 diesem Beispiel besteht die Reservierung aus einem Aufenthalt von drei Übernachtungen mit Preisen von 100, 120 und 120 für eine jeweilige Nacht. Der Gesamtbetrag für den Aufenthalt wird separat mit 340 angezeigt. 

 

7. Reservierungen: Wo kann ich die Gästezahl sehen?

Anwendungsfall: "Ich möchte die Nummer an Gästen im Vergleich mit einer bestimmten Reservierung sehen."

Um zu sehen, wie viele Erwachsene und Kinder gebucht haben, suchen Sie nach "adultCount" und "childCount" im Reservierungsdatensatz.

Bei einer Integration für Channel-Manager mit der aktivierten Option "Alterskategorie in Reservierungen benutzen" können Sie nach "GuestCounts" im Reservierungsdatensatz suchen.

 

8. Reservierungen: Wo kann ich sehen, welche Produkte gebucht werden?

Anwendungsfall: "Ich möchte sehen, welche Produkte im Vergleich mit einer bestimmten Reservierung gebucht worden waren."

Um zu sehen, welche Zusatzprodukte als Teil des Aufenthalts gebucht wurden, suchen Sie innerhalb des Reservierungsdatensatzes nach "extras".

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

 

Das Produkt wird mit "code" identifiziert, dieser Code wird einem festgelegten Produkt in Ihren Integrationseinstellungen für Channel-Manager zugeordnet. "pricing" ist ein Code, der die Abbuchungsregel erkenntlich macht, zum Beispiel pro Person pro Nacht oder pro Aufenthalt. Der Code "amount" steht für den Preis pro Produkteinheit.
 

Preisgestaltungscodes

Code	Beschreibung
1	Einmal für die Reservierung
2	Pro Person
3	Pro Nacht
4	Pro Person pro Nacht

Eine festgelegte Liste an Codes finden Sie in der API-Dokumentation.

 

9. Reservierungen: Wo kann ich den Gesamtpreis sehen?

Anwendungsfall: "Ich möchte den Gesamtpreis für eine bestimmte Reservierung sehen."

Der Gesamtpreis für die Buchung liegt unter "totalAmount". Darin ist die Summe an Beträgen für jede einzelne Nacht des Aufenthalts plus dem Gesamtbetrag der zusätzlichen Produkte enthalten. Diesen Wert erhält Mews vom Channel-Manager, der Wert wird nur abgeändert, wenn das System mit Produktregeln konfiguriert wird, die festlegen, dass ein Betrag oben hinzugefügt werden sollte.  

Wenn Ihre Unterkunft auf die Bruttopreisgestaltung konfiguriert wird, dann wird wie bei allen Beträgen der Bruttobetrag verwendet. Wenn die Unterkunft jedoch auf die Nettopreisgestaltung konfiguriert wird, dann werden Nettobeträge genommen und Steuern werden gemäß Ihrem rechtlichen Umfeld berechnet.

 

10. Reservierungen: Wurde ein Firmenprofil verknüpft?

Anwendungsfall: "Ich möchte sehen, ob ein Firmenprofil mit einer bestimmten Reservierung verknüpft wurde."

Um zu sehen, ob ein geschäftliches Firmenprofil zusammen mit den Reservierungsdetails gesendet wurde, suchen Sie nach "Firma". Ein Firmendatensatz sieht wie folgt aus:

"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. Reservierungen: Welcher Kanal wurde benutzt?

Anwendungsfall: "Ich möchte sehen, über welchen Kanal die Reservierung vorgenommen wurde."

Um zu sehen, über welchen Kanal die Reservierung vorgenommen wurde, suchen Sie nach "Kanal". Tipp: Dies kann nützlich sein, wenn Sie nicht sicher sind, ob ein Channel-Manager den korrekten Zuordnungscode für Kanäle gesendet hat und dies Ihre Zuordnung für Reiseagenturen beeinflusst hat.

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

Eine vollständige Liste an Kanalcodes finden Sie hier. Es ist nicht nötig, diese zu kopieren, wenn Sie Reiseagenturprofile zuordnen. Wählen Sie diese einfach aus dem ausklappbaren Menü aus, wenn Sie Reiseagenturen einrichten, so wie unter Methode 1 hier erklärt. Diese sind bereits mit den aufgelisteten Kanalcodes verknüpft. 

 

12. Reservierungen: Problembehebung bei Reservierungsnummern

Anwendungsfall: "Ich möchte sehen, welche Reservierungsnummern als Teil der Reservierung über das System hinweg gesendet wurden."

Mews erhält zwei Reservierungsnummern: Eine kommt vom Ursprungskanal ("channelId") und eine vom Channel-Manager ("channelManagerId"). Die Anzahlen können sich unterscheiden.

{
	"clientToken": "[Channel manager client token]",
	"connectionToken": "[Token of a concrete connection]",
	"channelId": "EXP-123456",
	"channelManagerId": "123456",