Instructie
difficulty level:
Beheer > Integraties > GetYourGuide
GetYourGuide einrichten: Authentifizierung, Mapping und Checkliste
Technische Einrichtung der GetYourGuide-Verbindung in i-Reserve. Führen Sie zuerst den Produktaufbau aus den vorherigen Artikeln durch (Teilnehmer + Spiegelobjekt).
1. Reiter Authentifizierung
| Feld | Was einzutragen ist |
|---|---|
| Supplier ID | Ihre Lieferanten-ID, wie von GetYourGuide zugewiesen. |
| Supplier-Name | Anzeigename (für Berichterstattung/Erkennung). |
Im Hintergrund verwendet i-Reserve für die ausgehenden Aufrufe (Verfügbarkeit pushen) Basic-Authentifizierung, und die eingehenden Aufrufe von GetYourGuide werden über ein zentrales Gateway mit einer Signatur (HMAC) verifiziert. Diese Schlüssel werden beim Aufbau der Verbindung automatisch geregelt.
2. Reiter Details
| Feld | Was es bewirkt |
|---|---|
| Reservierungs-Status | Status, den eine Reservierung erhält, wenn GetYourGuide reserviert (Standard 10). |
| Buchungs-Status | Status bei Bestätigung der Buchung (Standard 20). |
| Stornierungs-Status | Status bei Stornierung (Standard 70). |
| Cutoff (Sekunden) | Minimale Vorlaufzeit vor der Startzeit, bis zu der noch gebucht werden darf. |
| Extern-ID-Feld | Reservierungsfeld, in dem die GetYourGuide-Referenz gespeichert wird. |
| Öffnungszeiten als Standard | Ja = Verfügbarkeit standardmäßig als Zeitraum (Öffnungszeiten); Nein = feste Zeitfenster. Pro Objekt übersteuerbar. |
| Standarddauer (Minuten) | Dauer eines Slots, wenn keine Objektdauer eingestellt ist. |
3. Mapping
- Objekt → GetYourGuide-Produkt — verbinden Sie das (Spiegel-)Objekt mit der GetYourGuide-Produkt-ID.
- Teilnehmer → Kategorie — verbinden Sie jeden i-Reserve-Teilnehmer mit einer GetYourGuide-Kategorie; fügen Sie einen Fallback
*für die übrigen Teilnehmer hinzu. - Extra → Add-on-Typ — (optional) verbinden Sie Extras mit einem Add-on-Typ.
- Objektdauer — (optional) die Slot-Dauer in Minuten pro Objekt.
- Öffnungszeiten ja/nein — (optional) pro Objekt zwischen Zeitraum oder festen Slots wählen.
Klicken Sie nach dem Mapping auf Sync products, um die Objekte bei GetYourGuide zu registrieren und die externen Produkt-IDs abzurufen.
4. Checkliste
Vorbereitung
- ☐ GetYourGuide-Lieferantenkonto mit Konnektivität; Supplier ID bekannt.
- ☐ Produkte/Optionen auf der GetYourGuide-Seite erstellt (Kategorien, Preise, Texte).
- ☐ i-Reserve-Objekt mit Teilnehmern und Preisen eingerichtet.
- ☐ Spiegelobjekt (Ressource, ohne Workflow) erstellt und über geteilte Ressource verbunden.
Einrichten & testen
- ☐ Reiter Authentifizierung: Supplier ID + Name ausgefüllt.
- ☐ Reiter Details: Status, Cutoff, Extern-ID-Feld, Öffnungszeiten-Default und Standarddauer eingestellt.
- ☐ Mapping: Objekt→Produkt, Teilnehmer→Kategorie (+ Fallback
*), ggf. Extras/Dauer/Öffnungszeiten. - ☐ Sync products ausgeführt; externe Produkt-IDs abgerufen.
- ☐ Verfügbarkeit kommt bei GetYourGuide an (Testpanel: Payload + senden).
- ☐ Testflow: Reservierung → Buchung → Stornierung laufen korrekt; Status stimmen.
- ☐ E-Tickets (QR) werden zurückgegeben und sind in der i-Reserve-Ticketkontrolle gültig.
- ☐ Keine i-Reserve-Kunden-E-Mails für GetYourGuide-Buchungen (Spiegelobjekt ohne Workflow).
Die GetYourGuide-Verbindung befindet sich noch in der Beta-/Einführungsphase. Stimmen Sie die erste Einrichtung und den Go-live mit i-Reserve ab.
Teilnehmer sind verpflichtend: Ohne Teilnehmer-zu-Kategorie-Mapping (und einen Fallback "*") bietet die Verbindung das Produkt nicht an. GetYourGuide verkauft immer pro Teilnehmerkategorie.
