Instructie
Moeilijkheidsgraad:
Beheer > Integraties > GetYourGuide
GetYourGuide instellen: authenticatie, mapping en checklist
Technische inrichting van de GetYourGuide-koppeling in i-Reserve. Doe eerst de productopzet uit de vorige artikelen (deelnemers + spiegelobject).
1. Authenticatie-tab
| Veld | Wat in te vullen |
|---|---|
| Supplier ID | Je leverancier-id zoals toegekend door GetYourGuide. |
| Supplier naam | Weergavenaam (voor rapportage/herkenning). |
Onder water gebruikt i-Reserve voor de uitgaande calls (beschikbaarheid pushen) Basic-authenticatie, en worden de inkomende calls van GetYourGuide via een centrale gateway met een ondertekening (HMAC) geverifieerd. Deze sleutels worden automatisch geregeld bij het opzetten van de koppeling.
2. Details-tab
| Veld | Wat het doet |
|---|---|
| Reserverings-status | Status die een reservering krijgt wanneer GetYourGuide reserveert (standaard 10). |
| Boekings-status | Status bij bevestiging van de boeking (standaard 20). |
| Annulerings-status | Status bij annulering (standaard 70). |
| Cutoff (seconden) | Minimale aanlooptijd vóór de starttijd waarop nog geboekt mag worden. |
| Extern-id-veld | Reserveringsveld waarin de GetYourGuide-referentie wordt bewaard. |
| Openingstijden als standaard | Ja = beschikbaarheid standaard als tijdvak (openingstijden); Nee = vaste tijdsloten. Per object te overrulen. |
| Standaardduur (minuten) | Duur van een slot wanneer er geen objectduur is ingesteld. |
3. Mapping
- object → GetYourGuide-product — koppel het (spiegel)object aan het GetYourGuide-product-id.
- deelnemer → categorie — koppel elke i-Reserve-deelnemer aan een GetYourGuide-categorie; voeg een fallback
*toe voor de overige deelnemers. - extra → add-ontype — (optioneel) koppel extra’s aan een add-ontype.
- objectduur — (optioneel) de slot-duur in minuten per object.
- openingstijden ja/nee — (optioneel) per object kiezen tussen tijdvak of vaste sloten.
Klik na het mappen op Sync products om de objecten bij GetYourGuide te registreren en de externe product-id’s op te halen.
4. Checklist
Voorbereiding
- ☐ GetYourGuide-leveranciersaccount met connectiviteit; Supplier ID bekend.
- ☐ Producten/opties aangemaakt aan de GetYourGuide-kant (categorieën, prijzen, teksten).
- ☐ i-Reserve-object met deelnemers en prijzen ingericht.
- ☐ Spiegelobject (resource, zonder workflow) aangemaakt en via gedeelde resource gekoppeld.
Inrichten & testen
- ☐ Auth-tab: Supplier ID + naam ingevuld.
- ☐ Details-tab: statussen, cutoff, extern-id-veld, openingstijden-default en standaardduur ingesteld.
- ☐ Mapping: object→product, deelnemer→categorie (+ fallback
*), evt. extra’s/duur/openingstijden. - ☐ Sync products uitgevoerd; externe product-id’s opgehaald.
- ☐ Beschikbaarheid komt aan bij GetYourGuide (testpaneel: payload + verzenden).
- ☐ Testflow: reservering → boeking → annulering verlopen correct; statussen kloppen.
- ☐ E-tickets (QR) worden teruggegeven en zijn geldig in de i-Reserve-ticketcontrole.
- ☐ Geen i-Reserve-klant-e-mails voor GetYourGuide-boekingen (spiegelobject zonder workflow).
De GetYourGuide-koppeling is nog in beta/uitrol. Stem de eerste inrichting en de go-live af met i-Reserve.
Deelnemers zijn verplicht: zonder deelnemer-naar-categorie-mapping (en een fallback "*") biedt de koppeling het product niet aan. GetYourGuide verkoopt altijd per deelnemerscategorie.
