Tripadvisor Rentals: Unterschied zwischen den Versionen
(46 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt) | |||
Zeile 2: | Zeile 2: | ||
[[Kategorie:Channelmanager einrichten]] | [[Kategorie:Channelmanager einrichten]] | ||
[[Kategorie:Fehlermeldungen]] | [[Kategorie:Fehlermeldungen]] | ||
+ | [[Kategorie:Troubleshooting]] | ||
+ | <div class="heading">Tripadvisor Rentals API</div> | ||
+ | Diese Seite ist über das Menue {{#fas:cog}} (KONFIGURATION) CHANNEL MANAGER > TRIPADVISOR RENTALS und erklärt, wie die Schnittstelle mit Tripadvisor Rentals funktioniert und wie sie eingerichtet wird. | ||
− | + | https://www.tripadvisor.com/Rentals | |
− | < | + | <div class="warning">{{#fas:exclamation-triangle}} TripAdvisor hat seinen Geschäftsbereich TripAdvisor Rentals ab Oktober 2024 eingestellt. |
+ | |||
+ | Nach dem 30. September 2024 können Gäste keine Unterkünfte mehr über eine der Marken der TripAdvisor-Gruppe, einschließlich Holiday Lettings, Flipkey und Niumba, buchen. | ||
+ | |||
+ | Am 30. September 2024 hat Tripadvisor die Funktionalität entfernt, die die direkte Buchung von Unterkünften über alle Marken der Tripadvisor-Gruppe, einschließlich Holiday Lettings, Flipkey und Niumba, ermöglicht. | ||
+ | </div> | ||
__TOC__ | __TOC__ | ||
==Allgemeine Informationen== | ==Allgemeine Informationen== | ||
− | *[[:category:Channelmanager|Klicken | + | *[[:category:Channelmanager|Klicken Sie hier]] für allgemeine Informationen zur Funktionsweise des Channelmanagers. |
*Erstellung von [[Preise_für_OTAs|Preisen für OTAs]]. | *Erstellung von [[Preise_für_OTAs|Preisen für OTAs]]. | ||
=== Leistungen=== | === Leistungen=== | ||
− | * | + | Senden von Inhalten ist optional. |
− | * | + | |
− | * | + | Über die Schnittstelle können Sie: |
+ | *Inserate erstellen | ||
+ | *Inserate aktualisieren | ||
+ | *Inhalte senden und aktualisieren | ||
+ | *Bilder senden und aktualisieren | ||
+ | *Inventar exportieren | ||
+ | *Preise exportieren | ||
+ | *Wechseltage exportieren, komplexe closed to arrival and closed to departure Regeln können nicht gesendet werden | ||
+ | *Buchungen und Anfragen importieren | ||
+ | *Modifikationen an Buchungen und Stornierungen importieren | ||
+ | |||
=== Einschränkungen=== | === Einschränkungen=== | ||
− | *Tripadvisor erlaubt die Nutzung der | + | *Tripadvisor erlaubt die Nutzung der API nur für Tripadvisor Accounts, welche bereits eine API Verbindung haben. |
− | * | + | *Alle anderen Unterkünfte können iCal verwenden. Gehen Sie zu {{#fas:cog}} (KONFIGURATION) CHANNEL MANAGER > TRIPADVISOR ICAL und klicken Sie dann oben rechts auf Hilfe <span style="color:#019cde;“ >{{#far:question-circle}} </span> , um Anweisungen zur Einrichtung zu erhalten. |
− | Tripadvisor kennt keine Zimmertypen. Die Einheiten in Beds24 sollten die Anzahl 1 haben. Bei Bedarf können | + | *Tripadvisor kennt keine Zimmertypen. Die Einheiten in Beds24 sollten die Anzahl 1 haben. Bei Bedarf können Sie [[Individuelle_Einheiten_und_Zimmertypen|virtuelle Einheiten einrichten]]. |
− | == Bevor | + | *Tripadvisor hat spezielle Regeln bezüglich Bilder, bitte sehen Sie die Details in der [[Tripadvisor_Rentals#Bilder|Bilder Sektion]] |
+ | |||
+ | == Bevor Sie die Verbindung einrichten == | ||
'''Preise''' | '''Preise''' | ||
*Ohne gültige Preise, die für diesen OTA aktiviert sind, kann keine Verfügbarkeit gesendet werden. Allgemeine Informationen zur Erstellung von [[Preise_für_OTAs|Preisen für OTAs]]. | *Ohne gültige Preise, die für diesen OTA aktiviert sind, kann keine Verfügbarkeit gesendet werden. Allgemeine Informationen zur Erstellung von [[Preise_für_OTAs|Preisen für OTAs]]. | ||
+ | |||
+ | '''Buchungen''' | ||
+ | |||
+ | Künftige Buchungen werden automatisch importiert. Wenn Sie bisher Buchungen über iCal importiert haben, werden diese storniert wenn Tripadvisor eine Modification sendet. Die modifizierte Buchung wird via XML importiert. | ||
'''Einzelne Einheiten und Zimmertypen''' | '''Einzelne Einheiten und Zimmertypen''' | ||
− | Wenn | + | Wenn Sie bei Tripadvisor Rental einzelne Einheiten anbieten und bei anderen Channels z.B bei Booking.com Zimmertypen mit einer Anzahl größer 1, können Sie [[Individuelle_Einheiten_und_Zimmertypen|virtuelle Einheiten einrichten]]. |
TripadvisorRentals unterstützt keine Zimmertypen mit einer Anzahl von mehr als eins. Ein TripadvisorRentals Listing entspricht einer Einheit in Beds24. | TripadvisorRentals unterstützt keine Zimmertypen mit einer Anzahl von mehr als eins. Ein TripadvisorRentals Listing entspricht einer Einheit in Beds24. | ||
+ | |||
== Verbindung mit TripadvisorRentals herstellen== | == Verbindung mit TripadvisorRentals herstellen== | ||
− | * | + | *Wenn Sie einen Tripadvisor Accont haben, für den Sie die API-Schnittstelle nutzen, kontaktieren Sie Tripadvisor über das Kontaktformular https://rentalsupport.tripadvisor.com/contact_form?l=de mit folgenden Informationen: |
+ | |||
+ | **Ihre TripAdvisor Account ID | ||
+ | **Ihre registrierte TripAdvisor Rentals Account Email Adresse | ||
+ | **Eine Notiz, dass Sie die TripadvisorRentals Content API über Beds24 Channel Manager nutzen wollen | ||
+ | **Ihre Beds24 Kundennummer (Owner id), die Sie unter KONFIGRUATION-BENUTZERKONTO finden | ||
+ | |||
+ | *Nutzen Sie dieses [https://www.tripadvisor.com/RentalInsights/get-started#list Formular], wenn Sie noch keinen Account mit Tripadvisor haben. | ||
+ | |||
+ | Die Aktivierung gilt pro Beds24 Account. Alle Unterkünfte, die diesem Account gehören, können verbunden werden. Wenn Sie Unterkünfte in einem Subaccount haben, die verbunden werden müssen, Klicken Sie auf das 'User Icon' oben rechts und dann auf 'Account Management' (im alten Control Panel gehen Sie zu SUB ACCOUNTS im Menu oben rechts) dann auf Account bearbeiten -> Unterkunft bearbeiten "Tripadvisor Rentals XML Connect via Account" . Mit dieser Einstellung können Sie auswählen, dass sich die Unterkunft über ein anderes Konto als das, in dem sie sich befindet, mit Tripadvisor Rentals verbindet. | ||
=== Bei Tripadvisor bereits vorhandene Listings mappen=== | === Bei Tripadvisor bereits vorhandene Listings mappen=== | ||
− | *Klicken | + | *Klicken Sie auf "Anzeige aller Listings im Account". Dort sehen Sie eine Liste aller Ihrer TripadvisorRentals Listings mit deren IDs. Tripadvisor sendet auch gelöschte Listings. Ignornieren Sie diese. |
− | *Wenn | + | *Wenn Sie auf "Daten vom OTA anzeigen" klicken, sehe Sie die Daten, die TripadvisorRentals für das Listing anzeigt. |
− | *Wählen | + | *Wählen Sie die korrespondierende Einheit in Beds24 und klicken "Verbinden". |
− | |||
===Neues Listings erstellen=== | ===Neues Listings erstellen=== | ||
− | Wählen | + | Wählen Sie die Informationen, die Sie senden wollen "Inventar", "Preise", Buchungen, "Content" (eine oder mehrere) und klicken dann SPEICHERN. Wenn Sie keine Fehler im Content haben, sehen Sie dann einen "Veröffentlichen" Button. Nachdem Sie "Veröffentlichen geklickt haben", sehen Sie Ihr Listing wenn Sie auf "Anzeige aller Listings im Account" klicken. |
+ | |||
+ | Durch die Prüfung von Tripadvisor kann etwas dauern, bis Sie das Listing tatsächlich bei Tripadvisor sehen. | ||
+ | |||
+ | Wenn Sie Fehler im Content haben, klicken Sie auf "Fehler beheben". Sie werden dann zu der Seite geleitet, auf der Sie Ihre Probleme sehen. | ||
+ | |||
+ | ==== Aktivierung==== | ||
+ | *Klicken Sie auf den "Inhalt anzeigen, der gesendet wird an Tripadvisor Rentals" Link und auf "Daten anzeigen" um zu überprüfen, dass die Informationen, die gesendet werden korrekt sind. | ||
+ | *Gehen Sie zu KONFIGURATION ->CHANNEL MANAGER->TRIPADVISOR RENTALS ->SPEZIELLE INHALTE und stellen sicher, dass "Veröffentlichen" = JA eingestellt ist. | ||
+ | *Dann wählen Sie die Informationen, die Sie senden wollen - "Inventar", "Preise" "Content" (eine oder mehrere) und klicken dann SPEICHERN um die Synchronisation zu starten. | ||
+ | |||
− | + | ==== Buchungen==== | |
+ | Wenn Sie keine Anfragen importieren wolllen gehen Sie zu KONFIGURATION->CHANNEL MANAGER->TRIPADVISOR RENTALS ->SPEZIELLE INHALTE und stellen "Anfragen importieren" = Nein. | ||
− | |||
== Preise == | == Preise == | ||
− | Gesendet wird ein Preis für die Einheit sowie falls angelegt ein Mindestaufenthalt. Wenn es verschiedene Preise mit verschiedenen Mindestaufenthalten gibt, die alle für | + | Gesendet wird ein Preis für die Einheit sowie falls angelegt ein Mindestaufenthalt. Wenn es verschiedene Preise mit verschiedenen Mindestaufenthalten gibt, die alle für Tripadvisor aktiviert sind, wird der Preis mit dem niedrigsten Mindestaufenthalt gesendet. |
+ | |||
+ | Unter KONFIGURATION ->CHANNEL MANAGER->TRIPADVISOR RENTALS ->SPEZIELLE INHALTE kann folgendes festgelegt werden: | ||
+ | *die Anzahl der Gäste, für die der Preis gilt | ||
+ | *ein Preis für zusätzliche Gäste | ||
+ | *ein Rabattfaktor für einen wöchentlichen oder monatlichen Aufenthalt | ||
− | + | Tripadvisor unterstützt keine Dezimalstellen bei den Preisen | |
− | + | ||
− | + | <span style="color: #f3e504; font-size: 250%;" >{{#fas:lightbulb}} </span> Klicken Sie auf den "Daten anzeigen" Button um zu überprüfen, was gesendet wird. | |
===Multiplikator=== | ===Multiplikator=== | ||
− | Wenn | + | Wenn Sie einen Multiplikator für Ihre Preise benötigen, fügen Sie '''*''' gefolgt vom Multiplikator * im Feld "Preismultiplikator" ein. |
− | Der Multiplikator | + | Der Multiplikator wirkt auf alle gesendeten Preise und Gebühren. |
Beispiel: *1.23 multipliziert die Preise mit Faktor 1,23 (also um 23% erhöht). Niedrigere Preise können mit einem Multiplikator der kleine als 1 ist gestendet werden. *0.85 sendet 85% des normalen Preise (der Preise wird um 15% reduziert). | Beispiel: *1.23 multipliziert die Preise mit Faktor 1,23 (also um 23% erhöht). Niedrigere Preise können mit einem Multiplikator der kleine als 1 ist gestendet werden. *0.85 sendet 85% des normalen Preise (der Preise wird um 15% reduziert). | ||
Zeile 66: | Zeile 114: | ||
Beispiel: *[CONVERT:IDR-EUR] konvertiert Indonesische Rupees zu Euros. | Beispiel: *[CONVERT:IDR-EUR] konvertiert Indonesische Rupees zu Euros. | ||
− | Um die Preise der importierten Buchungen zurück zu konvertieren fügen | + | Um die Preise der importierten Buchungen zurück zu konvertieren fügen Sie ein * hinter dem Multiplikator '''*1.23*''' teilt den Preis der Buchung durch 1,23. |
===Währung=== | ===Währung=== | ||
Zeile 77: | Zeile 125: | ||
eingeben. | eingeben. | ||
− | Unter KONFIGURATION ->CHANNEL MANAGER->TRIPADVISOR RENTALS ->SPEZIELLE INHALTE kann ein Prozentsatz für eine nicht im Übernachtungspreis enthaltende Steuer eingegeben werden. | + | Einige globale Einstellungen können mit individuellen Einstellungen überschrieben werden. |
+ | |||
+ | |||
+ | Unter KONFIGURATION ->CHANNEL MANAGER->TRIPADVISOR RENTALS ->SPEZIELLE INHALTE kann ein Prozentsatz für eine nicht im Übernachtungspreis enthaltende Steuer eingegeben werden. | ||
− | == | + | == Inhalt== |
− | Wenn | + | Wenn Sie auch Inhalte an Tripadvisor senden möchten, gehen sie zu KONFIGURATION->CHANNEL MANAGER->TRIPADVISOR RENTALS ->INHALT um die Daten anzuzeigen, die gesendet werden. |
− | Um Inhalte zu vervollständigen, ändern klicken | + | Um Inhalte zu vervollständigen, ändern klicken Sie auf die Links auf dieser Seite. |
Tripadvisor erlaubt in beschreibenden Texten keine Email Adressen oder sonstige Kontaktdaten. | Tripadvisor erlaubt in beschreibenden Texten keine Email Adressen oder sonstige Kontaktdaten. | ||
− | + | <div class="warning">{{#fas:exclamation-triangle}}'''Folgende Informationen können nicht verändert werden, nachdem Tripadvisor das Listing aktiviert hat:''' | |
− | + | *Adresse (alle Einstellungen) | |
− | + | *Breitengrad | |
− | + | *Längengrad | |
− | + | *Unterkunft Typ | |
− | + | *Betten | |
− | + | Stellen Sie sicher, dass diese in Beds24 korrekt sind bevor Sie Daten an Tripadvisor senden.</div> | |
− | + | ||
=== Badezimmer und Schlafzimmer definieren=== | === Badezimmer und Schlafzimmer definieren=== | ||
− | Badezimmer und Schlafzimmer werden über Feature Codes | + | Badezimmer und Schlafzimmer werden über Feature Codes in {{#fas:cog}} (KONFIGURATION) UNTERKÜNFTE > EINHEITEN > EINRICHTEN) definiert |
− | |||
− | |||
− | |||
− | |||
− | + | *Klicken Sie auf den "Schlafzimmer bearbeiten " oder "Badezimmer bearbeiten" Button. | |
+ | *Definieren Sie den Typ und nutzen die die Selektoren um Einrichtungsmerkmale hinzuzufügen. | ||
+ | *Wen Sie mehrere Schlafzimmer und/oder Badezimmer haben müssen alle angelegt werden. | ||
+ | *Wenn Sie fertig sind schließen Sie das Pop Up und klicken SPEICHERN. | ||
− | |||
− | + | Badezimmer und Schlafzimmer und Ausstattungsmerkmale können auch manuell hinzugefügt werden. Weitere Informationen finden Sie weiter unten unter "Alle Feature Codes". | |
− | + | <span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> TripadvisorRentals unterstützt nicht alle Ausstattungsmerkmale. Ein Liste der unterstützen Ausstattungsmerkmale finden Sie unter "Alle Feature Codes". | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== Ausstattungsmerkmale === | === Ausstattungsmerkmale === | ||
Ausstattungsmerkmale können entweder für die Unterkunft (KONFIGURATION->UNTERKÜNFTE->BESCHREIBUNG) oder für die Einheit (KONFIGURATION->UNTERKÜNFTE->EINHEITEN->EINRICHTEN) definiert werden. | Ausstattungsmerkmale können entweder für die Unterkunft (KONFIGURATION->UNTERKÜNFTE->BESCHREIBUNG) oder für die Einheit (KONFIGURATION->UNTERKÜNFTE->EINHEITEN->EINRICHTEN) definiert werden. | ||
− | Kriterien, die | + | Kriterien, die Sie für in der Unterkunft eintragen, werden Legen Sie nur die Kriterien, welche für alle Einheiten zutreffen in der Unterkunft an. Diese werden dann automatisch auf alle Einheiten angewendet. |
− | Kriterien, die nur für eine Einheit zutreffen legen | + | Kriterien, die nur für eine Einheit zutreffen legen Sie in der Einheit an. Achten sie darauf, dass Sie keine Dopplungen haben. |
− | Beispiel 1: Alle | + | Beispiel 1: Alle Ihre Einheiten haben Wifi. In diesem Fall können Sie Wifi unter KONFIGURATION->UNTERKÜNFTE->BESCHREIBUNG anlegen. Dies wird für alle Einheiten übernommen. |
− | Beispiel 2: Sie haben zwei Einheiten. Eine hat WIFI, die andere nicht. In diesem Fall legen | + | Beispiel 2: Sie haben zwei Einheiten. Eine hat WIFI, die andere nicht. In diesem Fall legen Sie WIFI KONFIGURATION->UNTERKÜNFTE->EINHEITEN->EINRICHTEN an. |
Ausstattungsmerkmale werden über Feature Codes definiert, die im Feld "Features" eingegeben werden. | Ausstattungsmerkmale werden über Feature Codes definiert, die im Feld "Features" eingegeben werden. | ||
− | *Klicken | + | *Klicken Sie auf den "Bearbeiten " Button neben dem "Feature" Feld. |
*Im Pop Up klicken sie auf "Ausstattung". | *Im Pop Up klicken sie auf "Ausstattung". | ||
− | *Ticken | + | *Ticken Sie alle Ausstattungsmerkmale. |
− | *Wenn | + | *Wenn Sie fertig sind schließen Sie das Pop Up und klicken SPEICHERN. |
− | TripadvisorRentals unterstützt nicht alle Ausstattungsmerkmale. Ein Liste der unterstützen Ausstattungsmerkmale finden | + | <span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> TripadvisorRentals unterstützt nicht alle Ausstattungsmerkmale. Ein Liste der unterstützen Ausstattungsmerkmale finden Sie unter "Alle Feature Codes". |
− | Badezimmer und Schlafzimmer und Ausstattungsmerkmale können auch manuell hinzugefügt werden. Weitere Informationen finden | + | Badezimmer und Schlafzimmer und Ausstattungsmerkmale können auch manuell hinzugefügt werden. Weitere Informationen finden Sie weiter unten unter "Alle Feature Codes". |
===Sprache=== | ===Sprache=== | ||
Zeile 144: | Zeile 183: | ||
===Bilder=== | ===Bilder=== | ||
− | Es werden die Bilder gesendet, die | + | Es werden die Bilder gesendet, die Sie in KONFIGURATION->BUCHUNGSSEITE ->BILDER als Bilder aktiviert haben. Das System nimmt zunächst Bilder die als Bilder für die Einheit aktiviert sind danach werden die Bilder für die "Offerte" überprüft. Wenn dort keine/nicht genügen Bilder hinterlegt sind, werden die Bilder für die Unterkunft herangezogen. |
+ | |||
+ | Das erste (Startbild) muss Querformat haben. | ||
+ | |||
+ | Tripadvisor ändert die Bilder nicht automatisch. Wenn Sie Ihre Bilder ändern möchten, tun Sie dies in Beds24 und bitten dann Tripadvisor, Ihre Bilder zu überprüfen und für Sie zu aktualisieren. | ||
− | + | <div class="warning">{{#fas:exclamation-triangle}} Jedes Bild darf nur einmal benutzt werden. Gehen Sie zu Konfiguration > Channel Manager > Tripadvisor Rentals XML > Spezieller Inhalt und stellen Bilder=Einheit. Dann gehen Sie zu Konfigruation > Buchungsseite > Bilder und stellen sicher, dass alle Bilder 'Einheit' nur einmal benutzt werden.</div> | |
=== Alle Feature Codes === | === Alle Feature Codes === | ||
Zeile 153: | Zeile 196: | ||
Nur diese Feature Codes werden von TripadvisorRentals unterstützt: | Nur diese Feature Codes werden von TripadvisorRentals unterstützt: | ||
+ | BEDROOM | ||
+ | |||
+ | BEDROOM_LIVING_SLEEPING_COMBO | ||
+ | |||
+ | BEDROOM_OTHER_SLEEPING_AREA | ||
+ | |||
+ | BED_BUNK | ||
+ | |||
+ | BED_CRIB | ||
+ | |||
+ | BED_DOUBLE | ||
+ | |||
+ | BED_SOFA | ||
+ | |||
+ | BED_SINGLE | ||
+ | |||
+ | BATHROOM | ||
+ | |||
+ | BATHROOM_FULL | ||
+ | |||
+ | BATHROOM_SHOWER | ||
+ | |||
+ | BATHROOM_HALF | ||
AIR_CONDITIONING | AIR_CONDITIONING | ||
Zeile 282: | Zeile 348: | ||
WIFI | WIFI | ||
+ | CHILDREN_NOT_ALLOWED | ||
+ | |||
+ | PETS_CONSIDERED | ||
+ | |||
+ | SMOKING_ALLOWED | ||
== Überprüfung == | == Überprüfung == | ||
− | Um zu prüfen welche Informationen an gesendet werden klicken | + | Um zu prüfen welche Informationen an gesendet werden klicken Sie auf den "Inhalt anzeigen, die gesendet werden an: Tripdvisor. Hier sehen Sie die gesendeten Rohdaten. Über "Daten Anzeigen" können Sie überprüfen, welche Preise gesendet werden. |
Wenn die Anzeige auf der Website des Channels korrekt ist, funktioniert die Verbindung. | Wenn die Anzeige auf der Website des Channels korrekt ist, funktioniert die Verbindung. | ||
+ | |||
+ | |||
+ | == Häufige Fehler == | ||
+ | '''Validation failures prevented publishing ACTIVATION / PASS_MANUAL_VERIFICATION Violation''' | ||
+ | Möglicherweise muss TripAdvisor Ihre Identität verifizieren. Sie sollen eine E-mail von Tripadvisor mir weiteren Instruktionen erhalten haben. Falls nicht kontaktieren Sie TripAdvisor. | ||
+ | |||
+ | '''ACTIVATION = FAILURE''' | ||
+ | Wahrscheinlch haben Sie in Ihrem Tripadvisor Account eingestellt, dass Inhalte von Beds24 gesendet wird aber Sie haben "Inhalt" in KONFIGURATION-CHANNEL MANAGER-TRIPADVISOR RENTALS nicht aktiviert so dass Beds24 nichts senden kann. Ändern Sie entweder die Einstellun in Beds24 oder in Tripadvisor. | ||
+ | |||
+ | '''domain":"CALENDAR","status":"NOT_CONTROLLED''' | ||
+ | Preferences the fields in the Tripadvisors owner's center, under Listings -> Preferences have been set to No. This section allows you to turn on or off specific sections you want to update via API. You will need to change these to "Yes". | ||
+ | |||
+ | '''Forbidden 403''' | ||
+ | Kontaktieren Sie Tripadvisor und bitten um Überprüfung, ob Sie mit über die TripadvisorRentals Content API mit Beds24 Channel Manager verbunden sind. | ||
+ | |||
+ | '''NOT_FOUND 404''' | ||
+ | Kontaktieren Sie Tripadvisor und bitten um Überprüfung, ob Sie mit über die TripadvisorRentals Content API mit Beds24 Channel Manager verbunden sind. | ||
+ | |||
+ | ==Hinweise== | ||
+ | *Tripadvisor zieht die volle Zahlung vom Kunden ein und überweist sie Ihnen nach der Ankunft. | ||
+ | *Nach der Abreise sendet Tripadvisor eine Bewertungsanfrage an die Gäste. | ||
+ | *Wenn Sie support benötigen kontaktieren Sie Tripadvisor. | ||
== Trennen== | == Trennen== |
Aktuelle Version vom 29. Oktober 2024, 17:31 Uhr
Diese Seite ist über das Menue (KONFIGURATION) CHANNEL MANAGER > TRIPADVISOR RENTALS und erklärt, wie die Schnittstelle mit Tripadvisor Rentals funktioniert und wie sie eingerichtet wird.
https://www.tripadvisor.com/Rentals
Nach dem 30. September 2024 können Gäste keine Unterkünfte mehr über eine der Marken der TripAdvisor-Gruppe, einschließlich Holiday Lettings, Flipkey und Niumba, buchen.
Am 30. September 2024 hat Tripadvisor die Funktionalität entfernt, die die direkte Buchung von Unterkünften über alle Marken der Tripadvisor-Gruppe, einschließlich Holiday Lettings, Flipkey und Niumba, ermöglicht.
Inhaltsverzeichnis
1 Allgemeine Informationen
- Klicken Sie hier für allgemeine Informationen zur Funktionsweise des Channelmanagers.
- Erstellung von Preisen für OTAs.
1.1 Leistungen
Senden von Inhalten ist optional.
Über die Schnittstelle können Sie:
- Inserate erstellen
- Inserate aktualisieren
- Inhalte senden und aktualisieren
- Bilder senden und aktualisieren
- Inventar exportieren
- Preise exportieren
- Wechseltage exportieren, komplexe closed to arrival and closed to departure Regeln können nicht gesendet werden
- Buchungen und Anfragen importieren
- Modifikationen an Buchungen und Stornierungen importieren
1.2 Einschränkungen
- Tripadvisor erlaubt die Nutzung der API nur für Tripadvisor Accounts, welche bereits eine API Verbindung haben.
- Alle anderen Unterkünfte können iCal verwenden. Gehen Sie zu (KONFIGURATION) CHANNEL MANAGER > TRIPADVISOR ICAL und klicken Sie dann oben rechts auf Hilfe , um Anweisungen zur Einrichtung zu erhalten.
- Tripadvisor kennt keine Zimmertypen. Die Einheiten in Beds24 sollten die Anzahl 1 haben. Bei Bedarf können Sie virtuelle Einheiten einrichten.
- Tripadvisor hat spezielle Regeln bezüglich Bilder, bitte sehen Sie die Details in der Bilder Sektion
2 Bevor Sie die Verbindung einrichten
Preise
- Ohne gültige Preise, die für diesen OTA aktiviert sind, kann keine Verfügbarkeit gesendet werden. Allgemeine Informationen zur Erstellung von Preisen für OTAs.
Buchungen
Künftige Buchungen werden automatisch importiert. Wenn Sie bisher Buchungen über iCal importiert haben, werden diese storniert wenn Tripadvisor eine Modification sendet. Die modifizierte Buchung wird via XML importiert.
Einzelne Einheiten und Zimmertypen
Wenn Sie bei Tripadvisor Rental einzelne Einheiten anbieten und bei anderen Channels z.B bei Booking.com Zimmertypen mit einer Anzahl größer 1, können Sie virtuelle Einheiten einrichten.
TripadvisorRentals unterstützt keine Zimmertypen mit einer Anzahl von mehr als eins. Ein TripadvisorRentals Listing entspricht einer Einheit in Beds24.
3 Verbindung mit TripadvisorRentals herstellen
- Wenn Sie einen Tripadvisor Accont haben, für den Sie die API-Schnittstelle nutzen, kontaktieren Sie Tripadvisor über das Kontaktformular https://rentalsupport.tripadvisor.com/contact_form?l=de mit folgenden Informationen:
- Ihre TripAdvisor Account ID
- Ihre registrierte TripAdvisor Rentals Account Email Adresse
- Eine Notiz, dass Sie die TripadvisorRentals Content API über Beds24 Channel Manager nutzen wollen
- Ihre Beds24 Kundennummer (Owner id), die Sie unter KONFIGRUATION-BENUTZERKONTO finden
- Nutzen Sie dieses Formular, wenn Sie noch keinen Account mit Tripadvisor haben.
Die Aktivierung gilt pro Beds24 Account. Alle Unterkünfte, die diesem Account gehören, können verbunden werden. Wenn Sie Unterkünfte in einem Subaccount haben, die verbunden werden müssen, Klicken Sie auf das 'User Icon' oben rechts und dann auf 'Account Management' (im alten Control Panel gehen Sie zu SUB ACCOUNTS im Menu oben rechts) dann auf Account bearbeiten -> Unterkunft bearbeiten "Tripadvisor Rentals XML Connect via Account" . Mit dieser Einstellung können Sie auswählen, dass sich die Unterkunft über ein anderes Konto als das, in dem sie sich befindet, mit Tripadvisor Rentals verbindet.
3.1 Bei Tripadvisor bereits vorhandene Listings mappen
- Klicken Sie auf "Anzeige aller Listings im Account". Dort sehen Sie eine Liste aller Ihrer TripadvisorRentals Listings mit deren IDs. Tripadvisor sendet auch gelöschte Listings. Ignornieren Sie diese.
- Wenn Sie auf "Daten vom OTA anzeigen" klicken, sehe Sie die Daten, die TripadvisorRentals für das Listing anzeigt.
- Wählen Sie die korrespondierende Einheit in Beds24 und klicken "Verbinden".
3.2 Neues Listings erstellen
Wählen Sie die Informationen, die Sie senden wollen "Inventar", "Preise", Buchungen, "Content" (eine oder mehrere) und klicken dann SPEICHERN. Wenn Sie keine Fehler im Content haben, sehen Sie dann einen "Veröffentlichen" Button. Nachdem Sie "Veröffentlichen geklickt haben", sehen Sie Ihr Listing wenn Sie auf "Anzeige aller Listings im Account" klicken.
Durch die Prüfung von Tripadvisor kann etwas dauern, bis Sie das Listing tatsächlich bei Tripadvisor sehen.
Wenn Sie Fehler im Content haben, klicken Sie auf "Fehler beheben". Sie werden dann zu der Seite geleitet, auf der Sie Ihre Probleme sehen.
3.2.1 Aktivierung
- Klicken Sie auf den "Inhalt anzeigen, der gesendet wird an Tripadvisor Rentals" Link und auf "Daten anzeigen" um zu überprüfen, dass die Informationen, die gesendet werden korrekt sind.
- Gehen Sie zu KONFIGURATION ->CHANNEL MANAGER->TRIPADVISOR RENTALS ->SPEZIELLE INHALTE und stellen sicher, dass "Veröffentlichen" = JA eingestellt ist.
- Dann wählen Sie die Informationen, die Sie senden wollen - "Inventar", "Preise" "Content" (eine oder mehrere) und klicken dann SPEICHERN um die Synchronisation zu starten.
3.2.2 Buchungen
Wenn Sie keine Anfragen importieren wolllen gehen Sie zu KONFIGURATION->CHANNEL MANAGER->TRIPADVISOR RENTALS ->SPEZIELLE INHALTE und stellen "Anfragen importieren" = Nein.
4 Preise
Gesendet wird ein Preis für die Einheit sowie falls angelegt ein Mindestaufenthalt. Wenn es verschiedene Preise mit verschiedenen Mindestaufenthalten gibt, die alle für Tripadvisor aktiviert sind, wird der Preis mit dem niedrigsten Mindestaufenthalt gesendet.
Unter KONFIGURATION ->CHANNEL MANAGER->TRIPADVISOR RENTALS ->SPEZIELLE INHALTE kann folgendes festgelegt werden:
- die Anzahl der Gäste, für die der Preis gilt
- ein Preis für zusätzliche Gäste
- ein Rabattfaktor für einen wöchentlichen oder monatlichen Aufenthalt
Tripadvisor unterstützt keine Dezimalstellen bei den Preisen
Klicken Sie auf den "Daten anzeigen" Button um zu überprüfen, was gesendet wird.
4.1 Multiplikator
Wenn Sie einen Multiplikator für Ihre Preise benötigen, fügen Sie * gefolgt vom Multiplikator * im Feld "Preismultiplikator" ein.
Der Multiplikator wirkt auf alle gesendeten Preise und Gebühren.
Beispiel: *1.23 multipliziert die Preise mit Faktor 1,23 (also um 23% erhöht). Niedrigere Preise können mit einem Multiplikator der kleine als 1 ist gestendet werden. *0.85 sendet 85% des normalen Preise (der Preise wird um 15% reduziert).
Sie können auch eine Template Variable zur Umrechnung benutzen. Diese funktioniert für alle Währungen, welche die Buchungsseite unterstützt.
Beispiel: *[CONVERT:IDR-EUR] konvertiert Indonesische Rupees zu Euros.
Um die Preise der importierten Buchungen zurück zu konvertieren fügen Sie ein * hinter dem Multiplikator *1.23* teilt den Preis der Buchung durch 1,23.
4.2 Währung
Unter KONFIGURATION ->CHANNEL MANAGER->TRIPADVISOR RENTALS ->SPEZIELLE INHALTE kann die gesendete Währung eingestellt werden. Falls dies eine andere Währung ist als in Beds24 angelegt, kann ein Multiplikator zur Umrechnung gesetzt werden.
4.3 Gebühren und Steuer
Unter KONFIGURATION ->CHANNEL MANAGER->INHALT UNTERKUNFT -> EINHEIT können die
- Reinigungsgebühr
- Kaution
eingeben.
Einige globale Einstellungen können mit individuellen Einstellungen überschrieben werden.
Unter KONFIGURATION ->CHANNEL MANAGER->TRIPADVISOR RENTALS ->SPEZIELLE INHALTE kann ein Prozentsatz für eine nicht im Übernachtungspreis enthaltende Steuer eingegeben werden.
5 Inhalt
Wenn Sie auch Inhalte an Tripadvisor senden möchten, gehen sie zu KONFIGURATION->CHANNEL MANAGER->TRIPADVISOR RENTALS ->INHALT um die Daten anzuzeigen, die gesendet werden.
Um Inhalte zu vervollständigen, ändern klicken Sie auf die Links auf dieser Seite.
Tripadvisor erlaubt in beschreibenden Texten keine Email Adressen oder sonstige Kontaktdaten.
- Adresse (alle Einstellungen)
- Breitengrad
- Längengrad
- Unterkunft Typ
- Betten
5.1 Badezimmer und Schlafzimmer definieren
Badezimmer und Schlafzimmer werden über Feature Codes in (KONFIGURATION) UNTERKÜNFTE > EINHEITEN > EINRICHTEN) definiert
- Klicken Sie auf den "Schlafzimmer bearbeiten " oder "Badezimmer bearbeiten" Button.
- Definieren Sie den Typ und nutzen die die Selektoren um Einrichtungsmerkmale hinzuzufügen.
- Wen Sie mehrere Schlafzimmer und/oder Badezimmer haben müssen alle angelegt werden.
- Wenn Sie fertig sind schließen Sie das Pop Up und klicken SPEICHERN.
Badezimmer und Schlafzimmer und Ausstattungsmerkmale können auch manuell hinzugefügt werden. Weitere Informationen finden Sie weiter unten unter "Alle Feature Codes".
TripadvisorRentals unterstützt nicht alle Ausstattungsmerkmale. Ein Liste der unterstützen Ausstattungsmerkmale finden Sie unter "Alle Feature Codes".
5.2 Ausstattungsmerkmale
Ausstattungsmerkmale können entweder für die Unterkunft (KONFIGURATION->UNTERKÜNFTE->BESCHREIBUNG) oder für die Einheit (KONFIGURATION->UNTERKÜNFTE->EINHEITEN->EINRICHTEN) definiert werden.
Kriterien, die Sie für in der Unterkunft eintragen, werden Legen Sie nur die Kriterien, welche für alle Einheiten zutreffen in der Unterkunft an. Diese werden dann automatisch auf alle Einheiten angewendet.
Kriterien, die nur für eine Einheit zutreffen legen Sie in der Einheit an. Achten sie darauf, dass Sie keine Dopplungen haben.
Beispiel 1: Alle Ihre Einheiten haben Wifi. In diesem Fall können Sie Wifi unter KONFIGURATION->UNTERKÜNFTE->BESCHREIBUNG anlegen. Dies wird für alle Einheiten übernommen.
Beispiel 2: Sie haben zwei Einheiten. Eine hat WIFI, die andere nicht. In diesem Fall legen Sie WIFI KONFIGURATION->UNTERKÜNFTE->EINHEITEN->EINRICHTEN an.
Ausstattungsmerkmale werden über Feature Codes definiert, die im Feld "Features" eingegeben werden.
- Klicken Sie auf den "Bearbeiten " Button neben dem "Feature" Feld.
- Im Pop Up klicken sie auf "Ausstattung".
- Ticken Sie alle Ausstattungsmerkmale.
- Wenn Sie fertig sind schließen Sie das Pop Up und klicken SPEICHERN.
TripadvisorRentals unterstützt nicht alle Ausstattungsmerkmale. Ein Liste der unterstützen Ausstattungsmerkmale finden Sie unter "Alle Feature Codes".
Badezimmer und Schlafzimmer und Ausstattungsmerkmale können auch manuell hinzugefügt werden. Weitere Informationen finden Sie weiter unten unter "Alle Feature Codes".
5.3 Sprache
Unter KONFIGURATION ->CHANNEL MANAGER->TRIPADVISOR RENTALS ->SPEZIELLE INHALTE kann die gesendete Sprache eingestellt werden.
5.4 Bilder
Es werden die Bilder gesendet, die Sie in KONFIGURATION->BUCHUNGSSEITE ->BILDER als Bilder aktiviert haben. Das System nimmt zunächst Bilder die als Bilder für die Einheit aktiviert sind danach werden die Bilder für die "Offerte" überprüft. Wenn dort keine/nicht genügen Bilder hinterlegt sind, werden die Bilder für die Unterkunft herangezogen.
Das erste (Startbild) muss Querformat haben.
Tripadvisor ändert die Bilder nicht automatisch. Wenn Sie Ihre Bilder ändern möchten, tun Sie dies in Beds24 und bitten dann Tripadvisor, Ihre Bilder zu überprüfen und für Sie zu aktualisieren.
5.5 Alle Feature Codes
Badezimmer und Schlafzimmer und Ausstattungsmerkmale können auch manuell hinzugefügt werden. Dazu müssen die Codes exakt wie unten aufgeführt eingegeben werden.
Nur diese Feature Codes werden von TripadvisorRentals unterstützt:
BEDROOM
BEDROOM_LIVING_SLEEPING_COMBO
BEDROOM_OTHER_SLEEPING_AREA
BED_BUNK
BED_CRIB
BED_DOUBLE
BED_SOFA
BED_SINGLE
BATHROOM
BATHROOM_FULL
BATHROOM_SHOWER
BATHROOM_HALF
AIR_CONDITIONING
BALCONY
BEACH_FRONT
BEACH
LAKE
BICYCLE
BOAT
CABLE
SATELLITE
CEILING_FAN
HEATING
POOL_CHILDREN
CITY
CYCLING
DISHWASHER
DRYER
DVD
ELEVATOR
FREEZER
FIREPLACE
FISHING
GAME_ROOM
GOLF
GRILL
GYM
POOL_HEATED
HIKING
HORSE_RIDING
CLEANING_INCLUDED
POOL_INDOOR
INTERNET
IRON_BOARD
HOT_TUB
KETTLE
LINENS
MICROWAVE
MOUNTAIN_VIEW
OCEAN_VIEW
DECK_PATIO_UNCOVERED
TABLE_TENNIS
POOL_TABLE
PRIVATE_YARD
PARKING_INCLUDED
REFRIGERATOR
RURAL
SAUNA
SKIING
STAFF
STEREO
SAFE
STOVE
ROOF_TERRACE
TENNIS
TOASTER
TOWELS
TRAMPOLINE
TV
POOL
POOL_PRIVATE
WASHER
WATERFRONT
WATER_SPORTS
WATER_VIEW
WIFI
CHILDREN_NOT_ALLOWED
PETS_CONSIDERED
SMOKING_ALLOWED
6 Überprüfung
Um zu prüfen welche Informationen an gesendet werden klicken Sie auf den "Inhalt anzeigen, die gesendet werden an: Tripdvisor. Hier sehen Sie die gesendeten Rohdaten. Über "Daten Anzeigen" können Sie überprüfen, welche Preise gesendet werden.
Wenn die Anzeige auf der Website des Channels korrekt ist, funktioniert die Verbindung.
7 Häufige Fehler
Validation failures prevented publishing ACTIVATION / PASS_MANUAL_VERIFICATION Violation Möglicherweise muss TripAdvisor Ihre Identität verifizieren. Sie sollen eine E-mail von Tripadvisor mir weiteren Instruktionen erhalten haben. Falls nicht kontaktieren Sie TripAdvisor.
ACTIVATION = FAILURE Wahrscheinlch haben Sie in Ihrem Tripadvisor Account eingestellt, dass Inhalte von Beds24 gesendet wird aber Sie haben "Inhalt" in KONFIGURATION-CHANNEL MANAGER-TRIPADVISOR RENTALS nicht aktiviert so dass Beds24 nichts senden kann. Ändern Sie entweder die Einstellun in Beds24 oder in Tripadvisor.
domain":"CALENDAR","status":"NOT_CONTROLLED Preferences the fields in the Tripadvisors owner's center, under Listings -> Preferences have been set to No. This section allows you to turn on or off specific sections you want to update via API. You will need to change these to "Yes".
Forbidden 403 Kontaktieren Sie Tripadvisor und bitten um Überprüfung, ob Sie mit über die TripadvisorRentals Content API mit Beds24 Channel Manager verbunden sind. NOT_FOUND 404 Kontaktieren Sie Tripadvisor und bitten um Überprüfung, ob Sie mit über die TripadvisorRentals Content API mit Beds24 Channel Manager verbunden sind.
8 Hinweise
- Tripadvisor zieht die volle Zahlung vom Kunden ein und überweist sie Ihnen nach der Ankunft.
- Nach der Abreise sendet Tripadvisor eine Bewertungsanfrage an die Gäste.
- Wenn Sie support benötigen kontaktieren Sie Tripadvisor.