Handleiding Cineville koppeling

Algemeen

Aankopen, reserveringen, bevestigingen, en annuleringen van Cineville tickets kunnen via de kassa en/of de online Cineville koppeling automatisch worden gedeeld met de externe database van Cineville. De Cineville koppeling is niet standaard beschikbaar en vergt een aparte inrichting in ActiveTickets en activatie bij Cineville. Heb je interesse? Neem contact op met onze collega's van de Sales afdeling, zij informeren je graag over de opties en kosten.

ActiveTickets biedt naast de originele Cineville koppeling via de kassa sinds het voorjaar van 2020 nieuwe opties aan voor het afhandelen van online Cineville bestellingen. 

De volgende varianten zijn binnen ActiveTickets nu beschikbaar voor het bestellen van Cineville tickets:

Basiskoppeling (zonder online pasvalidatie): 

Dit is de originele Cineville koppeling. Online bestellen van een Cineville ticket is mogelijk, maar de pasvalidatie en controle op de Cineville regels vindt pas plaats bij het afhalen van de bestelling in de kassa.

• Pashouder bestelt online de unieke Cineville-kaartsoort die staat ingesteld in de Cineville-koppeling. 
• De Cineville pas wordt gevalideerd bij het afhalen van de bestelling in de kassa, en pas op dat moment - na controle op geldigheid pas en rechten - wordt de order (via de kassa) geregistreerd bij Cineville. 
• Op locatie ontvangt de bezoeker een ticket met geldige barcode.

Basiskoppeling (met online pasvalidatie): 

• Pashouder bestelt online de unieke Cineville-kaartsoort die staat ingesteld in de Cineville-koppeling, en moet per Cineville-ticket direct een geldig Cineville-pasnummer invoeren met de juiste rechten om het bestelproces te kunnen afronden. 
• Via de api met Cineville wordt in het online bestelproces gecontroleerd op geldigheid en rechten van de pashouder, zodat geen kaarten besteld kunnen worden waar de pashouder geen recht (meer) op heeft. 
• Afhalen van de bestelling in de kassa blijft nodig om het definitieve bezoek bij Cineville te registreren en een ticket met barcode te verkrijgen.

Basiskoppeling (met online pasvalidatie en Cineville Activatie zuil): 

• Pashouder bestelt online de unieke Cineville-kaartsoort die staat ingesteld in de Cineville-koppeling, en moet per Cineville-ticket een geldig Cineville-pasnummer invoeren om het bestelproces te kunnen afronden. 
• Via de api met Cineville wordt direct in het online bestelproces gecontroleerd op geldigheid en rechten van de pashouder, zodat geen kaarten besteld kunnen worden waar de pashouder geen recht (meer) op heeft. 
• De besteller ontvangt direct na het bestellen een ticket met QR-code, die pas scanbaar (geldig) is als de ticket geactiveerd is binnen de daarvoor gestelde termijn op locatie (vanaf 90 minuten voor aanvang voorstelling). 
• Dit activeren kan via het speciaal hiervoor ingericht Cineville activatie punt (Ipad in houder of zuil), zodat Cinevillers niet via de reguliere kassarij hoeven voor het afhalen van hun bestelling. Dit bespaart wachttijd voor de Cineville bezoeker en verwerkingstijd aan de reguliere kassa. Activatie van het ticket zorgt ervoor dat de reservering bij Cineville definitief wordt omgezet naar een bezoek. Naast activatie aan de zuil blijft het ook mogelijk het ticket via de kassa te activeren.

Hieronder vind je de informatie over de minimaal noodzakelijke basiskoppeling en de inrichting daarvan. Klik hier voor informatie over de combinatie met de online Cineville checker en Cineville Activatie App.

Basisinrichting Cineville (zonder online checker)

Voor het gebruik van de basiskoppeling met Cineville moet je als organisatie eerst zijn aangemeld bij Cineville, waarna ActiveTickets de koppeling kan activeren met behulp van de beschikbaar gestelde klantspecifieke api-key.

Voor de werking van de basiskoppeling is (naast overige instellingen die AT verzorgt) verder nodig:

• Koppeling van een uniek kaartsoort ID voor Cineville kaarten. De Cineville kaartsoort moet hiervoor worden aangemaakt in de backoffice. ActiveTickets sluit het ID van deze kaartsoort aan op de koppeling. De koppeling werkt op basis van deze unieke kaartsoort (er kunnen niet meerdere kaartsoorten voor Cineville aangemaakt worden).
• De unieke Cineville kaart moet aan het prijzenschema van een voorstelling worden toegevoegd en beschikbaar worden gemaakt op de gewenste kassa's om de koppeling te kunnen gebruiken. Vul als prijs 0,00 euro in (en eventueel een boekingsprijs).
• Voorstellingen met Cineville kaart in het prijzenschema moeten worden gedeeld op door ActiveTickets aangemaakte Cineville Ledengroep waarop de gegevens gedeeld worden met Cineville
• Wil je Cineville kaarten online aanbieden, maak deze dan ook op de website kassa beschikbaar. De besteller moet langs de kassa om zijn pas te valideren en mag pas bij afhalen een scanbare barcode ontvangen. Om ervoor te zorgen dat de online besteller niet direct na zijn online bestelling een ticket pdf met barcode krijgt, is een aanvullende instelling in de Cineville kaartsoort nodig: een barcode template moet worden ingesteld (zie uitleg hieronder).

Barcode template instellen Cineville

Online bestelde Cineville kaarten worden standaard in ActiveTickets verwerkt als "betaalde", afgeronde transacties, ze hebben dus in ActiveTickets GEEN reservering status. Dit om het mogelijk te maken wel een ticket te kunnen verzenden aan de bezoeker. Op dit ticket moet de barcode vervangen worden door een tekst, zodat de bezoeker pas bij het afhalen in de kassa na validatie van zijn pas een ticket met scanbare barcode ontvangt. 

Je stelt dit in door het selecteren van een barcode template in de Cineville kaartsoort:

Je maakt dit Barcode template met de gewenste tekst aan in de backoffice onder de menu optie Websitekarakteristieken > Templates:

Klik op Templates en dan op Nieuw in de menubalk:

Vul bij Omschrijving een interne naam in voor het label (niet zichtbaar voor bezoeker) en in het tekstvak bij Nederlands en eventueel Engels de tekst in die in de plaats van de barcode getoond moet worden op het Cineville e-ticket. Bijvoorbeeld “Meldt u bij de kassa met uw Cinevillepas voor uw ticket. 15 minuten voor aanvang van de voorstelling vervalt deze reservering.”

Na opslaan kun je dit template kiezen in de dropdown bij Barcode template in de kaartsoort en wordt op de pdf van het e-ticket de tekst getoond op de plek van de barcode.

Alternatieve inrichting via een afzonderlijke Reserveren-webshop

Het is bij gebruik van alleen de basiskoppeling (zonder online checker) eventueel mogelijk om de online Cineville-bestellingen wel in ActiveTickets te registreren met de status Reservering in plaats van een "betaalde" transactie via een aparte webshop waarin de betaalwijze Reserveren beschikbaar is. 

Het gevolg daarvan is dat de besteller een reserveringsbevestiging krijgt zonder e-ticket pdf en dus geen reguliere bevestigingsmail. De reserveringen kunnen in de kassa op dezelfde manier worden afgehaald als de Cineville tickets die met het standaard proces zijn besteld. Het nadeel van deze werkwijze is dat Cinevillers voor hun kaart een andere bestelroute (via tweede shop) moeten doorlopen dan voor normale kaarten, waardoor combinatiebestellingen niet binnen 1 transactie kunnen worden afgerond. Het advies van ActiveTickets is daarom het standaard proces te hanteren.

Online Cineville ticket basis (zonder online checker)

Bij het bestellen van een online Cineville ticket - zonder online pasvalidatie - verloopt het proces van bestellen tot afhalen volgens de volgende stappen: