Activeer de Urban Sports Club API
Verbind je Eversports Manager met je Urban Sports Club account
Met de Urban Sports Club (USC) API-integratie wordt je rooster automatisch gesynchroniseerd tussen Eversports Manager en Urban Sports Club. Boekingen en annuleringen worden in real time overgezet, waardoor het beheer makkelijker en efficiënter wordt.
1. Activeer de Urban Sports Club API-extensie
Om te starten:
-
Navigeer naar het menu Markt (linksonder in je Eversports Manager).
-
Selecteer Urban Sports Club API en klik op Meer informatie.
-
Volg de activatiestappen.
-
Je ontvangt een bevestigingsmail met verdere informatie.
2. Activeer je activiteiten voor Urban Sports Club
Je kunt kiezen welke activiteiten (lessen of trainingen) beschikbaar zijn op Urban Sports Club:
-
Ga naar de activiteit instellingen
- Ga naar het tabblad Voorwaarden > Geavanceerde instellingen > Registratievoorwaarden
- vind je de optie "Aggregator boekingslimiet". Hier kun je de instelling wijzigen in “Sta boekingen van aggregators toe”.
- Optioneel kun je het aantal plekken beperken dat beschikbaar is voor boekingen via aggregatoren.
- Vergeet de instellingen niet op te slaan onderaan in tabblad Sessies.
3. Urban Sports Club ondersteuning informeren
Na het activeren van je eerste activiteiten:
-
Neem contact op met het Urban Sports Club API-supportteam om de koppeling te voltooien.
Het USC API-supportteam koppelt je Eversports Manager aan je USC API-account. -
Je moet de Location UUID’s sturen van alle locaties die je wilt koppelen.
Zo vind je je Location UUID’s:
-
Ga naar Instellingen > Aggregatoren.
-
Kopieer de Location UUID’s met de kopieerknop.
-
Plak de UUID’s in het daarvoor bestemde typeform formulier.
Je krijgt een melding zodra de USC-installatie voltooid is.
Belangrijk: Heb je dubbele of ongebruikte locaties? Neem dan contact op met onze klantenservice (support@eversports.com) zodat we deze kunnen samenvoegen.
4. Hoe de API werkt
Zodra je Urban Sports Club API-koppeling compleet is, worden de volgende processen geautomatiseerd:
Synchronisatie van activiteiten
Alle lessen of trainingen die als beschikbaar voor aggregatoren zijn gemarkeerd, worden automatisch gesynchroniseerd met Urban Sports Club – je hoeft je rooster dus niet dubbel te beheren.
Synchronisatie van boekingen & annuleringen
Wanneer een USC-klant via de USC API boekt of annuleert:
-
De boeking of annulering wordt direct overgezet naar je Eversports Manager.
-
Deze verschijnen in dezelfde activiteitenlijst als je reguliere boekingen.
-
Het product “Urban Sports Club API” wordt automatisch toegewezen en kan niet handmatig uit de activiteit worden verwijderd.
Aanmaken van klanten via de API
- Wanneer iemand via USC boekt:
-
Wordt er een klantenprofiel aangemaakt in je Eversports Manager.
-
Het aggregator-ID wordt in het profiel opgeslagen om toekomstige boekingen van dezelfde gebruiker te koppelen.
-
- Als een klant al in je systeem bestaat:
-
Je kunt handmatig het USC-ID toevoegen:
-
Ga naar het klantprofiel.
-
Ga in het tabblad Details naar Klant-ID’s van aggregatoren.
-
Klik op de drie puntjes en voer het USC-ID in.
-
-
Hiermee zorg je dat toekomstige boekingen aan het bestaande profiel worden gekoppeld in plaats van dat er duplicaten ontstaan.
5. Overige informatie over de USC API
5.1 Nieuwe sporttypes toevoegen
Als je van plan bent om nieuwe sporttypes toe te voegen in je Eversports Manager en activiteiten met deze sporttypes aan te maken, informeer dan vooraf het USC-team. Dit zorgt ervoor dat alle activiteiten correct gesynchroniseerd worden.
5.2 Annuleringsdeadlines voor USC-leden
Eversports deelt je annuleringsvoorwaarden automatisch met USC via de API. In principe neemt USC je bestaande annuleringsdeadlines over.
Let op:
-
Als je annuleringsdeadline ≤ 12 uur is, blijft deze ongewijzigd voor USC-leden.
-
Als je annuleringsdeadline > 12 uur is, verkort USC deze automatisch naar 12 uur, volgens hun algemene beleid voor alle leden.
5.3 Synchronisatie tussen Eversports en USC
- USC synchroniseert informatie uit de Eversports API elke 30 minuten, dus wijzigingen in je Eversports Manager zouden binnen dat tijdsbestek zichtbaar moeten zijn bij USC.
- Boekingen en annuleringen worden real time bijgewerkt.
5.4 Wanneer worden lessen geannuleerd bij USC?
Als je de tijd van een les in Eversports wijzigt, annuleert USC deze lessen automatisch voor hun leden. Houd hier rekening mee: USC-leden moeten de les daarna opnieuw boeken.
5.5 Hoe verschijnen activiteitbeschrijvingen van Eversports op USC?
USC importeert je les- en activiteitbeschrijvingen rechtstreeks uit Eversports. Hun systeem ondersteunt echter geen HTML-opmaak.
Dat betekent dat HTML-tags (zoals vetgedrukte tekst, kopjes of speciale opmaak) worden verwijderd. De beschrijving kan daardoor als één lange, niet-geformatteerde zin verschijnen.