1. Yesplan-integratie instellen in Paylogic
2. Integratie instellen in Yesplan
3. Een evenement publiceren van Yesplan naar Paylogic
4. Extra informatie

Voordat je de Yesplan-integratie kunt instellen, moet Yesplan geactiveerd zijn voor jouw account. Neem contact op met je Client Success Manager om dit te laten activeren.

1. Yesplan-integratie instellen in Paylogic

1. Ga naar de Paylogic backoffice. Klik op ‘Merchant’ in het menu, vervolgens op ‘Integraties’ en daarna op ‘Yesplan’.
   
2. Je komt op de Yesplan-integratiepagina. Klik op ‘API-token aanmaken’.
3. Je API credentials zijn nu aangemaakt en worden weergegeven. Kopieer en bewaar de secret en Client ID op een veilige plek. Je hebt beide nodig in latere stappen.
4. Klik op ‘Doorgaan’.
5. Nu je de API-referenties hebt aangemaakt, kun je ook sjabloonevenementen toevoegen. Een sjabloonevenement is nodig voor de integratie. Dit sjabloonevenement wordt gebruikt als basis voor je nieuwe evenement.
6. Klik op ‘Toevoegen sjabloon evenementen’.
7. Er opent een venster waarin je alle evenementen kunt selecteren die je als sjabloon wilt gebruiken om evenementen vanuit Yesplan aan te maken. Nadat je de sjabloonevenementen hebt geselecteerd, klik je op ‘Voeg geselecteerde evenementen toe’.
8. De geselecteerde evenementen worden nu weergegeven als sjabloonevenementen en je hebt dit deel van de integratie voltooid.
   

2. Integratie instellen in Yesplan

2.1 Groep toevoegen

1. Ga naar je Yesplan-applicatie en log in.
2. Beweeg je muis over je accountnaam in het onderste menu en selecteer ‘System settings’.
3. Klik op ‘Events’ in de bovenste rij menu-items.
4. Klik op ‘+ Add a Group’.
5. Dubbelklik op ‘New’ en vervang ‘New’ door ‘Paylogic’. Bevestig met ‘OK’.
6. Klik nu op ‘Open’ bij de Paylogic-groep.
7. Klik op ‘+ Add a Field’.
1. Selecteer ‘Publication trigger’ als type en schrijf ‘Publish on Paylogic’ als label. Klik op ‘Add’.
8. Klik opnieuw op ‘+ Add a Field’.
1. Selecteer ‘Dropdown’ als type en schrijf ‘Event Template’ als label. Klik op ‘Add’.
9. Klik opnieuw op ‘+ Add a Field’.
1. Selecteer ‘Date and time input’ als type en schrijf ‘Sale Start’ als label. Klik op ‘Add’.
10. Klik opnieuw op ‘+ Add a Field’.
1. Selecteer ‘Date and time input’ als type en schrijf ‘Sale End’ als label. Klik op ‘Add’.
11. Klik op ‘Add’ onder ‘Where or When to Show’ in de tabel.
12. Selecteer ‘Info’.
13. Je ziet nu ‘Info’ in de ‘Inspector Tabs’-kolom voor al je velden.
14. Dubbelklik als laatste op ‘Description’ in de rij ‘Event Template’ en voeg de volgende zin toe:
1. “The template event to be used when first publishing this event on Paylogic. Note: this option cannot be changed after publishing for the first time.”
   
2. Bevestig met ‘OK’.
   

2.2 Integratie toevoegen

1. Ga naar je Yesplan-applicatie en log in.
2. Beweeg je muis over je accountnaam in het onderste menu en selecteer ‘System settings’.
3. Klik op ‘Integrations’ in de bovenste rij menu-items.
4. Klik op het ‘+’ icoon. Voer ‘Paylogic’ in als naam en klik op ‘Add’.
5. Selecteer ‘Generic ticketing’ als ‘Integration Type’.
6. Nu wordt een reeks nieuwe opties geopend. Stel de volgende instellingen in:
1. Authentication Type: OAuth 2.0
2. Grant Type → Client Credentials
3. URL of resources server: https://partner.paylogic.com/yesplan
4. URL of authorization server: https://partner.paylogic.com/yesplan/token
5. Client ID: Vul hier de Client ID in die je in Paylogic hebt gegenereerd (stap 1.3).
6. Client Secret: Vul hier de secret in die je in Paylogic hebt gegenereerd (stap 1.3).
7. Klik op ‘Verify’ in het veld ‘Connection to Ticketing System’. Je zou nu ‘Verified’ naast de knop moeten zien.
8. Ga naar de instelling ‘Mappings’ en klik op ‘Click to update’. Je zou nu ‘Updated’ naast de knop moeten zien.
9. Vink alle selectievakjes onder ‘Protocol Support’ uit.
10. Ga naar Actions → Publish en selecteer de trigger die je in de evenementen-groep hebt aangemaakt (zie 2.1.8).
11. Klik opnieuw op ‘Click to update’ bij de instelling ‘Mappings’. Je zou nu ‘Updated’ naast de knop moeten zien.
12. In de ‘Publishing Events – Data Flow from Yesplan to Ticketing System’ sectie voeg de volgende velden toe:
1. event_uid
1. Selecteer ‘paylogic_template’ in de dropdown als ‘Field in Yesplan’.
2. Selecteer ‘template_events’ in de dropdown als ‘Mapping’.
3. Klik op ‘Add’.
2. sale_start
1. Selecteer ‘paylogic_salestart’ in de dropdown als ‘Field in Yesplan’.
2. Klik op ‘Add’.
3. sale_end
1. Selecteer ‘paylogic_saleend’ in de dropdown als ‘Field in Yesplan’.
2. Klik op ‘Add’.
4. subtitle
1. Dit veld is optioneel, maar je kunt dit gebruiken om ook de ondertitel in het Paylogic-evenement vooraf in te vullen.
2. Je kunt dit bijvoorbeeld mappen naar ‘production_subtitle’.
5. project_code
1. Dit veld is ook optioneel, maar kan worden gebruikt om het projectcodeveld in een Paylogic-evenement vooraf in te vullen. Dit kan handig zijn om een interne ID, die je in Yesplan gebruikt voor een evenement, ook in Paylogic op te slaan.
2. Map dit naar het overeenkomstige gegevensveld in Yesplan.
13. Het is ook mogelijk om gegevens van Paylogic naar Yesplan te synchroniseren. Als je dit wilt, kun je de velden instellen zoals hieronder of een selectie maken van de velden die je wilt gebruiken. In de ‘Remote Data – Data Flow from Ticketing System to Yesplan’ sectie kun je de volgende velden toevoegen:
1. total_available_tickets
1. Selecteer ‘ticketing_available_tickets’ in de dropdown als ‘Field in Yesplan’.
2. Klik op ‘Add’.
2. total_capacity
1. Selecteer ‘ticketing_capacity’ in de dropdown als ‘Field in Yesplan’.
2. Klik op ‘Add’.
3. total_not_scanned_tickets
1. Selecteer ‘ticketing_tickets_not_scanned’ in de dropdown als ‘Field in Yesplan’.
2. Klik op ‘Add’.
4. Total_scanned_tickets
1. Selecteer ‘ticketing_tickets_scanned’ in de dropdown als ‘Field in Yesplan’.
2. Klik op ‘Add’.
5. total_sold_tickets
1. Selecteer ‘ticketing_sold_tickets_paid’ in de dropdown als ‘Field in Yesplan’.
2. Klik op ‘Add’.

3. Een evenement publiceren van Yesplan naar Paylogic

1. Ga naar je Yesplan-applicatie en log in.
2. Selecteer ‘Events’ in het onderste menu.
3. Open het evenement dat je naar Paylogic wilt publiceren.
4. Zoek het gedeelte ‘Paylogic’.
5. Klik op ‘Show all’.
6. In het veld ‘Event Template’ kun je het sjabloonevenement selecteren dat je als basis voor je nieuwe evenement wilt gebruiken.
7. Belangrijk om te weten: alle instellingen van het sjabloonevenement worden gekopieerd naar het nieuwe evenement, behalve de volgende velden. Deze worden in Paylogic ingevuld met gegevens uit je Yesplan-evenement:
1. Event Title
2. Event subtitle (optioneel)
3. Event date/time start
4. Event date/time end
5. Location
6. Sale date/time start
7. Sale date/time end
8. Project code (optioneel)
8. Vul de datums en tijden in voor de velden ‘Sale Start’ en ‘Sale End’.
9. Klik op ‘Publish Event’ in het veld ‘Publish on Paylogic’.
10. Je zou een bevestiging moeten krijgen dat de actie succesvol was.
11. Het evenement is nu aangemaakt in Paylogic! Ga naar de Paylogic backoffice om het evenement te controleren.
    

4. Extra informatie

1. Wanneer je een nieuw sjabloonevenement wilt toevoegen en dit hebt toegevoegd in de Paylogic backoffice, moet je de mappings in Yesplan ook bijwerken. Dit doe je via System settings > Integrations > Paylogic.
2. Total sold tickets die gesynchroniseerd worden van Paylogic naar Yesplan kunnen gastenlijst tickets, kortingskaarten, etc. bevatten en weerspiegelen mogelijk niet exact wat wordt verwacht bij “ticketing_sold_tickets_paid”.
3. De gegevensvelden worden bijgewerkt telkens wanneer je een evenement opent. Klikken op ‘update’ werkt niet als de laatste update recent was; dit is een beperking in Yesplan.
4. De publicatie van Yesplan naar Paylogic kan maar één keer worden uitgevoerd. Latere wijzigingen in Yesplan worden niet doorgestuurd naar Paylogic. Wijzigingen in het Paylogic-evenement worden ook niet teruggestuurd naar Yesplan.
5. De locatie wordt genegeerd om te voorkomen dat er veel dubbele locaties worden aangemaakt. De locatie van het sjabloonevenement wordt gebruikt bij het aanmaken van een nieuw evenement.