Hello Asso
YellowBox Store
Objet
Le plugin Hello Asso permet à l’administrateur de la base YellowBox CRM de récupérer les cotisations et/ou dons qui ont été payées et/ou versées à son association via le site Hello Asso.
Installation
Téléchargement à partir du YellowBox Store
Le plugin est téléchargeable par l’administrateur depuis le YellowBox Store accessible via le bouton 
de la barre de notification.
Cliquer sur le pavé du plugin pour voir le descriptif et accéder aux fonctions d’installation et de mise à jour.
Cliquer sur le bouton [Installer] pour l’ajouter à la liste des plugins paramétrables dans votre YellowBox CRM.
Ce plugin est gratuit et ne nécessite pas d’activation particulière.
Paramétrage
Le plugin Hello Asso peut faire l’objet d’une seule utilisation dans la base YellowBox CRM. Dans le cas où plusieurs plugins sont paramétrés via le menu paramétrage/Automatismes/Traitements/Traitements/Plugins seul le premier plugin sera effectivement connecté au compte Hello Asso de l’organisation.
Cliquer sur le bouton [+ Ajouter]
- Ajouter un nouveau plugin
- Donner un nom unique qui vous permettra de le repérer
- Sélectionner dans la listes des plugins disponibles ‘Hello Asso’
- Sélectionner l’instance désirée
Les instances disponibles
Une seule instance est disponible avec ce plugin.
Récupération des paiements de HelloAsso (fonction)
Cette instance permet de récupérer les paiements réalisés (cotisations et/ou dons) via le portail Hello Asso et d’alimenter une table paramétrée dans YellowBox CRM.
Pour que le plugin soit actif, il est nécessaire d’effectuer la connexion avec le compte Hello Asso. Pour ce faire, il convient de :
- Cliquer sur le bouton [Autoriser] du bloc ‘Autorisation d’accès aux données’.
Un nouvel onglet s’ouvre et propose une page Hello Asso qui permet d’établir la connexion entre Hello Asso et YellowBox CRM :
Dans le nouvel écran de Hello Asso :
- Sélectionner la base Hello Asso pour laquelle les paiements doivent être récupérés
- Cliquer sur [Etablir le lien]
L'onglet affichant le message confirmation de l'établissement de la connexion peut être fermé pour revenir sur l'onglet de paramétrage de YellowBox CRM et compléter les correspondances suivantes :
Seules les correspondances non explicites ou demandant un complément d’information sont ci-dessous développées :
Type de paiement à récupérer
Paramètre obligatoire Faire un choix entre [Cotisations], [Dons] ou [Cotisations et dons]
REmarque : dans tous les cas une seule et même table sera alimentée.
Table paiement
Paramètre obligatoire
Type de paiement récupéré
Paramètre obligatoire Permet de récupérer la qualification du paiement Cotisation ou Don selon le cas.
id Paiement HelloAsso
Paramètre obligatoire
Permet de dédoublonner le paiement en cas de récupérations multiples Le paiement peut se décomposer en une partie pour une cotisation et une seconde partie pour un don. Ces deux parties auront le même ID_HelloAsso de paiement. Un ID_Hello Asso selon l’item sera alors associé à la cotisation et au don de manière à pouvoir dédoublonner si les informations en provenance de Hello Asso sont à nouveau intégrées dans la base YellowBox CRM.
Identification d’un item de paiement
Paramètre obligatoire Cf. Id Paiement HelloAsso
Campagne
Montant
Paramètre obligatoire
Etat
Versé
Date paiement
Moyen de paiement
Table contributeur
Paramètre obligatoire
Au niveau de la structure, il est recommandé de paramétrer cette table comme table principale de la table associée aux paiements. Le champ id_elementdefaut affiche alors automatiquement le contributeur associé au paiement.
Email (dédoublonnage)
Paramètre obligatoire
Il est possible de renseigner un ou plusieurs emails de la table contributeur sélectionnée à ce niveau. La fiche contributeur correspondant au payeur est recherchée sur la correspondance du premier email renseigné. En cas de recherche infructueuse, une nouvelle recherche est réalisée sur le second et ainsi de suite. Dès lors qu’une fiche contient l’email utilisé lors du paiement, le lien est effectué entre la fiche du contributeur et la fiche cotisation ou don. Dans le cas où aucune fiche contributeur ne contient l’email utilisé lors du paiement, une nouvelle fiche de type contributeur est créée (avec uniquement prénom, nom et email renseigné sur le premier email de la correspondance). Cette nouvelle fiche est alors reliée à la fiche cotisatoin/don créée.
Nom
Prénom
Nombre de jours à synchroniser
Permet notamment d’intialiser la base des paiements et/ou d’avoir une sécurité pour récupérer les informations sur les n jours précédents.
Champs sélectionnables
Il est possible de sélectionner via la liste déroulante un ou plusieurs champs de la table sélectionnée pour consigner les cotisations et les dons. Pour chaque champ sélectionné, une nouvelle ligne apparaît dans le paramétrage du plugin et permet ainsi pour chacun la saisie d’une valeur fixe.
Intégration
Ce plugin paramétré peut être intégré dans des processus mis à disposition pour les utilisateurs via paramétrage de l’administrateur selon les écrans disponibles. Il est ainsi tout à fait possible de paramétrer le déclenchement de la récupération de paiements en mode immédiat ou planifié.