Overgang nieuwe Cineville koppeling 2026 (CultureKit)

Algemeen

In 2026 is voor alle filmtheaters en festivals die gebruik maken van de Cineville koppeling een overgang op de nieuwe Cineville API via het CultureKit platform noodzakelijk. Technisch verandert de manier waarop shows worden doorgegeven naar Cineville en de manier waarop reserveringen en bezoeken aan Cineville moeten worden doorgegeven en hoe deze aan de kant van Cineville worden geregistreerd.

Daarnaast zitten er een aantal aanvullende features wat betreft inrichtingsmogelijkheden in de nieuwe koppeling die voorheen nog niet beschikbaar waren. Voor de bezoeker zelf zijn de veranderingen niet zichtbaar. Voor elke aansluiting moet een nieuwe sleutel voor de aansluiting worden ingesteld en de nieuwe werking ingeschakeld worden.

Cineville heeft de aansluitgegevens van alle aangesloten filmtheaters en festivals al aan ActiveTickets verstrekt, dus je hoeft deze niet apart op te vragen bij Cineville. ActiveTickets verzorgt de afstemming met Cineville voor elke aansluiting.

Voor deze overgang is actie vereist van:

ActiveTickets i.o.m. klant: afstemmen van een overgangsdatum en de basisinstellingen. ActiveTickets activeert de CultureKit integratie op het afgesproken moment. Dit neemt ongeveer een uur in beslag, waarin tijdens het uitvoeren van de migratie geen Cineville kaart verkocht mag worden (de kassa's moeten dan zijn uitgeschakeld) en ook geen nieuwe voorstellingen gepubliceerd mogen worden op de websitekassa. ActiveTickets neemt in januari/februari zelf contact op voor het afstemmen van de datum in verband met het spreiden van de migraties in overleg met Cineville. Alle klanten moeten voor de zomer van 2026 over zijn op de nieuwe koppeling.
ActiveTickets i.o.m. Cineville: afstemmen van de overgangsdatum per klant en het inschakelen van het nieuwe importeerproces voor Cineville voorstellingen.
Programmeur: juiste koppeling van te gebruiken Cineville kaartsoorten en boekingsprijzen in prijzenschema's, bepalen van ticket url voor Cineville website, inrichting van mee te geven Cineville kenmerken en ondertiteling voor publicatie op de Cineville website en app en deze aan voorstellingen koppelen (waar gewenst). De programmeur moet op de hoogte zijn van het migratiemoment, want tijdens het uitvoeren van de migratie mogen er geen nieuwe voorstellingen gepubliceerd worden naar Cineville.

In deze toelichting lees je meer over de wijzigingen voor wat betreft de inrichtingsmogelijkheden.

Er is voor deze overgang naar CultureKit geen actie vereist van:

Je webbouwer: er zijn geen wijzigingen in de weergave van de Cineville checker in de webshop. De aanpassingen in de technische afhandeling en de aansluiting op de Cineville API verlopen helemaal via ActiveTickets.
Kassapersoneel en scanpersoneel: er zijn geen wijzigingen in de manier waarop Cineville tickets moeten worden afgehaald in de kassa of het scannen van Cineville aan de zaal. Wel moeten de kassamedewerkers die tijdens de migratie aan het werk zijn weten dat er dat moment instellingen omgeschakeld worden, zodat de juiste maatregelen genomen kunnen worden (bijvoorbeeld het bijhouden van pasnummers van bezoekers) als er om wat voor reden dan ook vertraging optreedt.

Er - afhankelijk van je eerdere inrichting - in uitzonderingsgevallen wijzigingen zijn voor je administratie, doordat het instellen van een boekingsprijs hoger dan 0 euro in het prijzenschema nodig is (dit is dan de afrekenprijs met Cineville). Er wordt dan ook apart omzet geregistreerd in de rapportages op basis van boekingsprijs.

Ook staat in de nieuwe koppeling de "Cineville sweep" (die niet bevestigde Cineville bezoeken automatisch opruimt na de gestelde ophaaldeadline) altijd aan en resulteert een gesweepte boeking in de rapportages ook altijd in een terugboeking (dat was tot nu toe al zo bij klanten die al gebruik maakten van de nieuwste sweep). Check bij de afstemming over de basisinstellingen bij ActiveTickets welke situatie geldt voor jouw organisatie om te zien of er op dat gebied een verandering in de rapportages is.

Wat verandert er?

Kort samengevat zijn er de volgende wijzigingen ten opzichte van de oude koppeling:

Inrichting:

Er kan in de nieuwe koppeling gewerkt worden met meer dan 1 Cineville kaartsoort. In de oude koppeling was maar 1 unieke Cineville kaartsoort mogelijk.
Cineville kan op de website aparte labels tonen voor ondertiteling talen en andere relevante labels zoals Voorpremière, die je in ActiveTickets per show kunt koppelen via voorstellingskenmerken (Opvoeringskenmerken).
In de nieuwe koppeling moet per show een link worden meegegeven naar Cineville voor de doorverwijzing vanaf de Cineville website naar je verkooppagina. Dit gaat automatisch, maar de opbouw van deze URL wordt apart ingesteld per klant, omdat dit afhankelijk is van je integratie. Als dit niet staat ingesteld werkt het doorgeven van de shows wel, maar Cineville toont dan in de eigen agenda alleen een knop naar de hoofdwebsite en niet naar een specifieke show.
Het instellen van een boekingsprijs hoger dan 0 is nodig voor de werking
De automatische sweep voor niet afgehaalde Cineville boekingen moet in de nieuwe koppeling altijd aan staan. Dit is noodzakelijk voor een juiste registratie van de ophaaldeadline van boekingen bij Cineville.

Registratie van shows bij Cineville:

ActiveTickets stuurt de Cineville voorstellingen naar Cineville, in plaats van dat Cineville deze zelf ophaalt uit de webservices. ActiveTickets stuurt ook updates naar Cineville bij relevante wijzigingen op een show die al gedeeld was, zoals een wijziging van datum of tijd.
ActiveTickets stuurt elke 15 minuten nieuw opgevoerde shows en wijzigingen naar Cineville, waarna er nog maximaal 15 minuten verwerkingstijd is aan de kant van Cineville, voordat gereserveerd kan worden.
Een alternatieve titel die is ingesteld voor een show wordt niet meegegeven naar Cineville. Doorgifte van speciale eigenschappen van een show die je in de Cineville agenda zichtbaar wilt maken, zoals special, 3D of première, verloopt via voorstellingskenmerken. Cineville heeft hiervoor zelf de selectie gemaakt voor wat betreft de labels die beschikbaar zijn in de koppeling.

Gebruik:

Een tijdelijke pasbarcode en een definitieve pasbarcode die gekoppeld is aan dezelfde Cineville pashouder kunnen door elkaar heen gebruikt worden. Dat wil zeggen dat een reservering die online is gedaan met een tijdelijke pas, ook kan worden teruggevonden en bevestigd als bezoek door het scannen van de definitieve pas (en andersom). Dit is nu mogelijk doordat de boekingen gelinkt kunnen worden aan een klant ID van Cineville. In de oude werking kon dit niet.

Wat niet wijzigt:

Je deelt de Cineville voorstellingen nog steeds op dezelfde manier met Cineville als voorheen, door deze te delen op de juiste Cineville ledengroep en de website kassa actief te maken voor een voorstelling.
Alle tijdregels van Cineville voor wat betreft het kunnen aanmelden van een bezoek of het kunnen boeken van voorstellingen binnen hetzelfde tijdsblok zijn gelijk aan de oude werking.
Het bestelproces en aanmeldproces dat de klant doorloopt.

Checklist afstemmen met ActiveTickets

Stem voor de overstap de volgende onderdelen af met ActiveTickets:

Een datum waarop de nieuwe koppeling wordt ingeschakeld door ActiveTickets. Vanaf dat moment worden alle reserveringen en bezoeken afgehandeld volgens het nieuwe proces. ActiveTickets voert op die datum een migratiescript uit waarmee alle voorstellingen die plaatsvinden in de toekomst bij Cineville worden omgezet naar CultureKit shows. Op dit overgangsmoment mogen er geen verkopen plaatsvinden op Cineville kaarten. Reserveringen die al gedaan zijn voor shows in de toekomst worden met het migratiescript ook omgezet naar reserveringen met CultureKit referenties.
De ophaaldeadline die ingesteld moet worden voor Cineville kaarten.
Of je annuleren van Cineville kaarten via de bestelgeschiedenis wilt toestaan, en tot hoeveel minuten voor start voorstelling.
Het inschakelen van werken met verkoopprijs en boekingsprijs, als dit nog niet zo was ingesteld voor je organisatie.
Welke kaartsoorten je wilt koppelen aan de Cineville checker.
Welke ondertiteling talen je wilt kunnen kiezen.
De basisopbouw van de ticketlink die op de Cineville website bij een show getoond moet worden. Er kan zowel verwezen worden naar het subdomein als naar een pagina op je hoofdwebsite, en indien gewerkt wordt met Customkeys in plaats van de ActiveTickets Show ID's, kan dat ook zo worden ingericht in deze doorverwijzing.

Inrichting

Twee zaken richt je zelf in:

de eventuele extra kaartsoorten die je wilt laten werken via de Cineville koppeling en de toevoeging daarvan aan je prijzenschema's.
eventuele voorstellingskenmerken die je wilt meegeven bij shows richting Cineville

Bij de kaartsoorten is het van belang om deze door te geven aan ActiveTickets, ook als je later nieuwe aanmaakt. ActiveTickets verbindt deze aan de Cineville checker via het Systeemtype. Je kunt zelf controleren in het kaartsoortbeheer of een kaartsoort gekoppeld is aan Cineville of niet, maar deze eigenschap niet bewerken vanwege de financiële consequenties die het voor de afrekening met Cineville heeft als je deze eigenschap per ongeluk zelf weg zou halen. Als je een duplicaat maakt van een al gekoppelde Cineville kaartsoort, dan wordt het duplicaat wel direct al gekoppeld aan de checker. Je hoeft in dat geval geen seintje aan ActiveTickets te geven.

Voor een juiste doorgifte van speciale labels naar Cineville maak je hiervoor de gewenste Voorstellingskenmerken aan.

Zodra CultureKit actief is gemaakt door ActiveTickets voor je organisatie zie je in een voorstellingskenmerk niet alleen de interne naam die in ActiveTickets gebruikt wordt, maar ook een apart veld voor de Cineville tag.

Je kiest hier uit een dropdown het juiste bijbehorende Cineville label; dit zijn de labels die vanuit Cineville bepaald zijn. Stel je niks in bij Cineville tag, dan wordt ook niks doorgegeven naar Cineville als je het kenmerk koppelt aan een show.

In de nieuwe koppeling gaat Cineville anders om met ondertiteling.

Voor CultureKit moet je daarvoor de nieuwe kenmerken uit de dropdown gebruiken die je herkent aan het woord "subtitles" met daarachter de taalcode. In de dropdown zijn voor de overzichtelijkheid standaard alleen de meest voorkomende ondertiteling talen beschikbaar volgens de nieuwe opzet. Cineville ondersteunt echter een zeer lange lijst met taalcoderingen. Wil je specifieke talen toevoegen, geef de extra talen dan door aan ActiveTickets. Wij maken dan de juiste Cineville tags dan beschikbaar in de dropdown. Wij kunnen dit ook doen voor eventuele andere nieuwe labels die Cineville in de toekomst beschikbaar stelt.

Let op: het oude Cineville label englishSubs wordt door Cineville niet meer gebruikt. Het oude Cineville label voor "Geen ondertiteling", noSubtitles, blijft nog wel bestaan, dit wordt ook in CultureKit uitgelezen door Cineville om "Geen ondertiteling" te tonen op de Cineville website.

Hieronder vind je een lijst van de vertaling van de beschikbare Cineville tags, naar de weergave op de hoofdwebsite en app van Cineville:

preview = voorpremière

classic = klassieker

modernClassic = moderne klassieker

sneakPreview = sneak preview

3d = 3D

70mm = 70mm

special = special

outdoorCinema = buitenfilm

noSubtitles = Geen ondertiteling

Voorbeeld van hoe zo'n label in de Cineville agenda getoond wordt:

Je koppelt een voorstellingskenmerk in het beheer van de voorstelling zelf of via het Voorstellingenoverzicht in de backoffice (zet dan de kolom Kenmerken aan en kies direct een of meer kenmerken door te klikken in het kenmerk veld van een voorstelling).

In het Voorstellingenoverzicht kan het ook in bulk gedaan worden voor een lijst van geselecteerde voorstellingen via de Acties knop.

De upload van de shows naar Cineville herkent of een show een kenmerk heeft met een Cineville tag, en geeft dit dan door naar Cineville.

Herkenning oude en nieuwe stijl boeking

Hoewel het afhalen en aanmelden van Cineville bezoeken in de koppeling niet wijzigt is het onderscheid tussen een oude stijl boeking en een nieuwe stijl boeking wel zichtbaar in de kassa. De Cineville referentie die je terugziet bij een CultureKit Cineville transactie in de kassa heeft een andere opbouw, dit is een langer nummer onderbroken door streepjes.

Op die manier weet je of je te maken hebt met een boeking die nog via de originele koppeling wordt afgehandeld of via CultureKit.

Heb je nog verdere vragen over de migratie naar CultureKit, dan kan je uiteraard altijd contact opnemen met onze Support Afdeling. We helpen je graag verder.

***