Tripadvisor Rentals

TRIPADVISOR API

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

Tripadvisor akzeptiert keine neuen Verbindungen. Nur Tripadvisor-Konten mit einer bestehenden Channel Manager-Verbindung können deren API nutzen.

• Tripadvisor-Konten mit einer bereits bestehenden Verbindung zu Beds24 können die Verbindung weiterhin nutzen.
• Tripadvisor-Konten, die von einem anderen Channel Manager wechseln, bei dem sie eine API-Verbindung haben, können ihre bestehende Verbindung zu Beds24 wechseln, sofern ihr Konto nicht Itrip ist.
• 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.

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.

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.

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.

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.

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.