1. Configurer l'intégration Yesplan dans Paylogic
2. Configurer l'intégration dans Yesplan
3. Publier un événement de Yesplan vers Paylogic
4. Informations supplémentaires

Avant de pouvoir configurer l'intégration Yesplan, Yesplan doit être activé pour votre compte. Contactez votre Client Success Manager pour l'activer.

1. Configurer l'intégration Yesplan dans Paylogic

1. Accédez au back-office de Paylogic. Cliquez sur « Vendeur » dans le menu, puis sur « Intégrations » et enfin sur « Yesplan ».
2. Vous arrivez sur la page d'intégration Yesplan. Cliquez sur « Créer un jeton API ».
3. Vos identifiants API sont maintenant générés et affichés. Copiez et enregistrez en lieu sûr le secret et l’ID Client, vous en aurez besoin plus tard.
4. Cliquez sur « Continuer ».
5. Maintenant que vos identifiants API sont créés, vous pouvez ajouter des événements modèles. Un événement modèle est nécessaire pour l'intégration et servira de base pour la création de nouveaux événements.
6. Cliquez sur « Ajouter des modèles d’événements ».
7. Une fenêtre s'ouvre avec la liste des événements disponibles. Sélectionnez ceux que vous souhaitez utiliser comme modèles pour Yesplan. Après avoir sélectionné vos événements modèles, cliquez sur « Ajouter les événements sélectionnés ».
8. Les événements sélectionnés apparaissent maintenant comme événements modèles. Cette partie de l'intégration est terminée.

2. Configurer l'intégration dans Yesplan

1. Ouvrez votre application Yesplan et connectez-vous.
2. Passez votre souris sur votre nom de compte en bas du menu et sélectionnez « Paramètres système ».
3. Cliquez sur « Événements » dans la barre de menu supérieure.
4. Cliquez sur « + Ajouter un groupe ».
5. Double-cliquez sur « New », remplacez-le par « Paylogic », puis confirmez avec « OK ».
6. Cliquez maintenant sur « Ouvrir » à côté du groupe Paylogic.
7. Ajoutez les champs suivants un par un :
1. « Déclencheur de publication » (Type : Publication trigger, Libellé : « Publier sur Paylogic »)
2. « Modèle d’événement » (Type : Dropdown, Libellé : « Event Template »)
3. « Début des ventes » (Type : Date et heure, Libellé : « Sale Start »)
4. « Fin des ventes » (Type : Date et heure, Libellé : « Sale End »)
8. Sous « Où ou quand afficher », cliquez sur « Ajouter », puis sélectionnez « Info ».
9. Double-cliquez sur « Description » de la ligne « Event Template » et ajoutez cette phrase :
1.  « L’événement modèle utilisé pour la première publication sur Paylogic. Remarque : cette option ne peut pas être modifiée après la première publication. »
10. Confirmez avec « OK ».

1. Accédez à votre application Yesplan et connectez-vous.
2. Passez la souris sur votre nom de compte dans le menu inférieur et sélectionnez "Paramètres du système".
3. Cliquez sur "Intégrations" dans la rangée supérieure des menus.
4. Cliquez sur l'icône "+". Entrez "Paylogic" comme nom et cliquez sur "Ajouter".
5. Sélectionnez "Billetterie générique" comme "Type d'intégration".
6. Une série de nouvelles options s'ouvrira. Configurez les paramètres suivants :
1. Type d'authentification: OAuth 2.0
2. Type d'autorisation → Identifiants client
3. URL du serveur de ressources: https://partner.paylogic.com/yesplan
4. URL du serveur d'autorisation: https://partner.paylogic.com/yesplan/token
5. ID client: Entrez ici l'ID client généré dans Paylogic (étape 1.3).
6. Secret client: Entrez ici le secret généré dans Paylogic (étape 1.3).
7. Cliquez sur "Vérifier" dans le champ "Connexion au système de billetterie". Vous devriez voir "Vérifié" à côté du bouton.
8. Accédez au paramètre "Mappages" et cliquez sur "Cliquez pour mettre à jour". Vous devriez voir "Mis à jour" à côté du bouton.
9. Décochez toutes les cases sous "Support du protocole".
10. Allez dans Actions → Publier et sélectionnez le déclencheur que vous avez créé dans le groupe d'événements (voir 2.1.8).
11. Cliquez à nouveau sur "Cliquez pour mettre à jour" dans le paramètre "Mappages". Vous devriez voir "Mis à jour" à côté du bouton.
12. Dans la section "Publication des événements - Flux de données de Yesplan vers le système de billetterie", ajoutez les champs suivants :
1. event_uid
1. Sélectionnez "paylogic_template" dans la liste déroulante comme "Champ dans Yesplan".
2. Sélectionnez "template_events" dans la liste déroulante comme "Mappage".
3. Cliquez sur "Ajouter".
2. sale_start
1. Sélectionnez "paylogic_salestart" dans la liste déroulante comme "Champ dans Yesplan".
2. Cliquez sur "Ajouter".
3. sale_end
1. Sélectionnez "paylogic_saleend" dans la liste déroulante comme "Champ dans Yesplan".
2. Cliquez sur "Ajouter".
4. subtitle
1. Ce champ est optionnel, mais vous pouvez l'utiliser pour préremplir le sous-titre de l'événement Paylogic.
2. Vous pouvez par exemple l'associer à "production_subtitle".
5. project_code
1. Ce champ est également optionnel, mais peut être utilisé pour préremplir le champ du code projet dans un événement Paylogic. Cela peut être utile pour stocker un identifiant interne utilisé dans Yesplan pour un événement.
2. Associez-le au champ de données correspondant dans Yesplan.
13. Il est également possible de synchroniser des données de Paylogic vers Yesplan. Si vous le souhaitez, vous pouvez configurer les champs comme ci-dessous ou sélectionner ceux que vous souhaitez utiliser. Dans la section "Données distantes - Flux de données du système de billetterie vers Yesplan", ajoutez les champs suivants :
1. total_available_tickets
1. Sélectionnez "ticketing_available_tickets" dans la liste déroulante comme "Champ dans Yesplan".
2. Cliquez sur "Ajouter".
2. total_capacity
1. Sélectionnez "ticketing_capacity" dans la liste déroulante comme "Champ dans Yesplan".
2. Cliquez sur "Ajouter".
3. total_not_scanned_tickets
1. Sélectionnez "ticketing_tickets_not_scanned" dans la liste déroulante comme "Champ dans Yesplan".
2. Cliquez sur "Ajouter".
4. total_scanned_tickets
1. Sélectionnez "ticketing_tickets_scanned" dans la liste déroulante comme "Champ dans Yesplan".
2. Cliquez sur "Ajouter".
5. total_sold_tickets
1. Sélectionnez "ticketing_sold_tickets_paid" dans la liste déroulante comme "Champ dans Yesplan".
2. Cliquez sur "Ajouter".

3. Publier un événement de Yesplan vers Paylogic

1. Dans Yesplan, connectez-vous et ouvrez « Événements ».
2. Sélectionnez l’événement que vous souhaitez publier.
3. Trouvez la section « Paylogic » et cliquez sur « Tout afficher ».
4. Dans le champ « Event Template », choisissez l’événement modèle à utiliser.
5. Les paramètres du modèle seront copiés, sauf les champs suivants, qui seront renseignés par Yesplan :
1. Titre de l’événement
2. Sous-titre (optionnel)
3. Date/heure de début et de fin
4. Lieu
5. Date/heure de début et de fin des ventes
6. Code projet (optionnel)
6. Remplissez les dates et heures dans « Sale Start » et « Sale End ».
7. Cliquez sur « Publier l’événement ».
8. Un message de confirmation doit apparaître.
9. L’événement est maintenant créé dans Paylogic ! Vous pouvez le vérifier dans le back-office de Paylogic.

4. Informations supplémentaires

1. Lorsque vous ajoutez un nouvel événement modèle dans le back-office Paylogic, mettez à jour les mappings dans Yesplan via : Paramètres système > Intégrations > Paylogic.
2. Les billets vendus totalisés synchronisés entre Paylogic et Yesplan peuvent inclure des billets invités, des cartes de réduction, etc. Ils ne correspondent pas toujours exactement au champ « ticketing_sold_tickets_paid ».
3. Les données se mettent à jour à l’ouverture d’un événement. L’option « Mettre à jour » ne fonctionne pas immédiatement si une mise à jour récente a déjà été effectuée (limitation Yesplan).
4. La publication Yesplan → Paylogic ne peut être effectuée qu’une seule fois. Les modifications ultérieures dans Yesplan ne sont pas synchronisées avec Paylogic, et vice versa.
5. Le lieu est ignoré pour éviter les doublons. Celui de l’événement modèle est utilisé à la création d’un nouvel événement.