> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.booqi.me/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Connect Get Your Guide to your shop

# GetYourGuide koppelen met Booqi
De GetYourGuide-integratie van Booqi houdt beschikbaarheid en boekingen gesynchroniseerd tussen je Booqi-account en GetYourGuide. Na het koppelen kan GetYourGuide rechtstreeks beschikbaarheid controleren, reserveringen aanmaken, boekingen bevestigen en annuleringen naar Booqi sturen.
## Voordat je begint
Je hebt nodig:
* Een actief Booqi-account met de producten die je wilt verkopen al ingesteld.
* Een GetYourGuide-leveranciersaccount.
* Toegang tot **Add-ons** in Booqi.
* Een gebruikersnaam en sterk wachtwoord voor de API-koppeling.
## Stap 1: GetYourGuide instellen in Booqi
1. Log in bij Booqi en ga naar **Add-ons**.
2. Open **GetYourGuide** en schakel de add-on in.
3. Vul een gebruikersnaam en wachtwoord in voor **Basic Authentication**. Je gebruikt dezelfde gegevens in GetYourGuide.
4. Kies welke Booqi-producten GetYourGuide mag verkopen:
   * **Alle producten**
   * **Alleen geselecteerde producten**
   * **Alle behalve geselecteerde producten**
5. Als je producten ticketcategorieën gebruiken, zoals Volwassene, Kind of Senior, koppel dan elke GetYourGuide-categorie aan de overeenkomende Booqi-doelgroepcategorie.
6. Sla je instellingen op.
Optioneel: schakel beschikbaarheidsmeldingen in als Booqi GetYourGuide moet informeren wanneer de beschikbaarheid verandert.
## Stap 2: Booqi koppelen in GetYourGuide
Configureer Booqi in je GetYourGuide Connectivity-instellingen met deze API-basis-URL:
```
https://your-subdomain.booqi.me/api/gyg/1
```
Vervang `your-subdomain` door je Booqi-subdomein.
Gebruik de gebruikersnaam en het wachtwoord voor Basic Authentication die je in Booqi hebt aangemaakt.
GetYourGuide moet de volgende endpoints gebruiken:
| Doel | Endpoint |
| ---- | ---- |
| Beschikbaarheid controleren | `GET /get-availabilities` |
| Reservering aanmaken | `POST /reserve` |
| Reservering annuleren | `POST /cancel-reservation` |
| Boeking bevestigen | `POST /book` |
| Boeking annuleren | `POST /cancel-booking` |
Gebruik voor productkoppelingen de Booqi-product-ID. Je vindt deze in de product-URL of in het Booqi-productoverzicht.
## Zo werkt de koppeling
1. GetYourGuide vraagt de beschikbaarheid op bij Booqi voordat een tijdslot wordt aangeboden.
2. Wanneer een klant een boeking start, maakt GetYourGuide een reservering aan in Booqi.
3. Zodra de betaling is bevestigd, bevestigt GetYourGuide de boeking en maakt Booqi de tickets aan.
4. Als een boeking wordt geannuleerd, stuurt GetYourGuide de annulering naar Booqi en komt de capaciteit weer vrij.
Boekingen die via deze koppeling worden aangemaakt, worden in Booqi gemarkeerd als boekingen via **GetYourGuide reseller**.
## De koppeling testen
Controleer vóór je producten live zet op GetYourGuide of:
* GetYourGuide de beschikbaarheid voor elk gekoppeld product kan ophalen.
* De juiste ticketcategorieën worden teruggegeven.
* Een testreservering kan worden aangemaakt en geannuleerd.
* Een bevestigde boeking de juiste tickets in Booqi aanmaakt.
* Een annulering de Booqi-bestelling bijwerkt en de beschikbaarheid herstelt.
## Problemen oplossen
**GetYourGuide ontvangt een authenticatiefout**
Controleer of de add-on is ingeschakeld in Booqi en of de gebruikersnaam en het wachtwoord voor Basic Authentication in beide systemen exact overeenkomen.
**GetYourGuide kan een product niet vinden**
Controleer of het product is ingeschakeld in Booqi, binnen de productselectie voor GetYourGuide valt en is gekoppeld met de juiste Booqi-product-ID.
**Een ticketcategorie kan niet worden geboekt**
Koppel de betreffende GetYourGuide-categorie, bijvoorbeeld `ADULT` of `CHILD`, aan de overeenkomende Booqi-doelgroepcategorie.
**Beschikbaarheid ontbreekt of is onjuist**
Controleer of het product actieve datums of tijdsloten heeft, voldoende capaciteit heeft en binnen de productselectie van de GetYourGuide-add-on valt.
**Een boeking kan niet worden geannuleerd**
Boekingen kunnen niet meer worden geannuleerd na het inchecken of nadat het geboekte tijdstip is verstreken.