Deze instructies helpen je om een API-actie in te stellen voor een nieuw seizoen. Er moet dus al een actie zijn of hebben plaats gevonden met deze API-partner.
Als jullie nog niet eerder met de API-partner hebben gewerkt via Ticketcounter, dan adviseren we je om de actie aan te melden via het juiste “API-koppelingen” aanmeldformulier, te vinden op Aanmeldformulieren PM. Dan kan Ticketcounter de koppeling en de eerste actie voor je opzetten.
Deze instructies gelden niet voor de API koppeling met GetYourGuide en TUI Musement. Hiervoor komen nog een aanvullende instructies i.v.m. afwijkende werkwijze dus die aanvragen kun je naar Ticketcounter sturen.
Verkooptijdvak kopiëren
Ga naar Instellingen → Tickets → Price keys. Klap het evenement met de API-actie open tot je bij het verkooptijdvak bent.
Hieronder zie je een voorbeeld van de API-partner House of tickets. Het verkooptijdvak in dit voorbeeld heeft een verkoopperiode van 01-01-2025 t/m 31-12-2025.
Je kunt het verkooptijdvak kopiëren via het pijltje achter Bewerken → Kopiëren. Hiermee creëer je een exacte kopie van het originele verkooptijdvak. Alle instellingen en pricetypes worden dan gekopieerd.
Verkooptijdvak aanpassen
Het evenement klapt standaard dicht dus je dient het evenement weer open te klappen tot je bij het nieuwe verkooptijdvak bent. De kopie krijgt standaard de naam 'Copy'. Met Bewerken kun je de het verkooptijdvak aanpassen.
Stel de Verkoop start in op de datum van ‘vandaag’ zodat de tickets actief zijn en de API-partner de pricetypes kan ophalen via de API.
De Verkoop stop is doorgaans gelijk aan de einddatum van de capaciteit. Als de capaciteit met één jaar is verlengd, dan kun je de Verkoop stop ook met één jaar verlengen.
De Verkoop stop (capaciteiten) is een belangrijke instelling voor als je pricetypes verkoopt die aan een capaciteit zijn gekoppeld. Het systeem kijkt naar de eindtijd van het tijdslot en bepaalt vanaf die tijd wanneer de capaciteit uit de verkoop mag.
Geldig van en Geldig tot bepalen de geldigheid van tickets zonder capaciteit. Verleng dit met dezelfde periode als Verkoopperiode. Of als er niks is ingesteld, kun je het leeg laten.
Ticket vanaf (tijdslot) en Ticket till (timeslot) bepalen de geldigheid van tickets op capaciteit. Zoals het hieronder is ingesteld, zijn de tickets de hele dag scanbaar vanaf 00:00 tot 23:59 uur.
Aanbod
Open het nieuwe verkooptijdvak en controleer het aanbod. Voeg eventueel nieuwe pricetypes toe of pas deze aan. Als er nieuwe prijsafspraken zijn met de API-partner dien je de prijs ook aan te passen. Indien nodig kun je de capaciteit aanpassen (als de capaciteit alleen is verlengd, dan is dat niet nodig). Controleer dat de scandefinitie ook ingesteld is.
Opleveren en testen
Stuur de Eventkey, Performancekey en pricekeys naar jouw contactpersoon zodat zij de koppeling kunnen opzetten. Of als je zelf het beheer doet bij de API-partner, kun je de koppeling opzetten met behulp van deze keys.
Vraag ook om testtickets of maak deze aan en gebruik de Ticket informatie optie van de scanner om de QR-code te controleren. Deze dient scanbaar te zijn en de juiste geldigheid te tonen.
Bij twijfel, aarzel niet om contact met ons op te nemen. Wij controleren de actie graag voor je. Of als je een error krijgt, stuur ons dan een mail en geef vermeld welke aanvraag je doet en welke error je krijgt. Zo kunnen wij jouw vraag sneller beantwoorden.