# Importation des adhésions HelloAsso

<span style="white-space: pre-wrap;">HelloAsso permet d'exporter les adhésions au format CSV. Nous utilisons cette fonctionnalité pour importer </span>**"rapidement"** <span style="white-space: pre-wrap;"> les adhésions HelloAsso sur </span>[CiviCRM](https://crm.aml-lyon1.fr/civicrm/home)<span style="white-space: pre-wrap;">. Cette opération doit être faite assez régulièrement, idéalement avant chaque CA pour que </span>[les adhérents reçoivent bien leur convocation](https://wiki.aml-lyon1.fr/books/guides-dutilisation-de-linfrastructure-aml/chapter/mailings-pour-la-communication-et-le-secretariat).

#### Téléchargement des données d'adhésion

Sur HelloAsso, rendez-vous dans les informations de la billetterie pour afficher la liste des adhésions.

<p class="callout info">Assurez-vous d'aller sur la billetterie pour l'année universitaire en cours. Si elle n'existe pas, consultez le Bureau.</p>

<span style="white-space: pre-wrap;">Nous devons télécharger les adhésions réalisées </span>**après la dernière importation.**<span style="white-space: pre-wrap;"> Si vous ne vous souvenez pas de cette date, recherchez dans la liste </span>**l'adhésion la plus ancienne qui n'a pas été comptabilisée sur CiviCRM.**<span style="white-space: pre-wrap;"> Pour cela, vous pouvez aller sur </span>[CiviCRM](https://crm.aml-lyon1.fr/civicrm/home)<span style="white-space: pre-wrap;">, et rechercher le nom de l'adhérent. S'il son contact existe, allez sur son profil dans la rubrique </span>`<span class="editor-theme-code">Adhésions</span>`. Vous verrez sur cette page si son adhésion pour l'année universitaire en cours a été importée ou non.

Téléchargez le .CSV en spécifiant cette date de dernière importation.

<p class="callout info">Si la dernière importation a été faites le 20 Octobre, importez les adhésions depuis le 21 Octobre.</p>

#### Nettoyage des données

Ouvrez le .CSV dans un tableur (Excel, Libreoffice Calc, Google Sheets...) et assurez-vous que tous les noms ont le bon format (nom de famille en majuscule, prénom avec une majuscule au début seulement).

[![image.png](https://wiki.aml-lyon1.fr/uploads/images/gallery/2026-04/scaled-1680-/RymAqxHHyoWTIRl0-image.png)](https://wiki.aml-lyon1.fr/uploads/images/gallery/2026-04/RymAqxHHyoWTIRl0-image.png)Dans cette example, "Jobs" devrait être changé" en "JOBS".

Sauvegardez le fichier. Gardez votre tableur, il sera nécessaire plus tard.

### Création des contacts

<span style="white-space: pre-wrap;">Nous devons nous assurer que chaque adhérent possède un contact existant dans CiviCRM. Pour cela, dans CiviCRM, allez dans </span>`<span class="editor-theme-code">Contacts > Importer des contacts</span>`.

##### Fichier à importer

Sélectionnez le CSV que vous avez nettoyé.

##### Séparateur de champs

<span style="white-space: pre-wrap;">Indiquez le point virgule </span>`<span class="editor-theme-code">;</span>`.

##### En cas de doublon

<span style="white-space: pre-wrap;">Sélectionnez </span>`<span class="editor-theme-code">Remplir les champs vides</span>`.

##### Règle de dédoublonnage

<span style="white-space: pre-wrap;">Sélectionnez </span>`<span class="editor-theme-code">Nom de famille & Prénom - General</span>`.

<p class="callout warning align-justify">Cette règle est très importante. Elle permet d'éviter la création de plusieurs entités contact pour la même personne physique.</p>

##### Format des dates

<span style="white-space: pre-wrap;">Sélectionnez </span>`<span class="editor-theme-code">jj/mm/aaaa</span>`.

##### Modèle d'import

<span style="white-space: pre-wrap;">Sélectionnez </span>`<span class="editor-theme-code">HelloAsso Contacts</span>`.

Cliquez sur "Suivant".

#### Correspondance des champs

Normalement, le modèle d'import devrait avoir correctement renseigné la correspondance des champs, mais nous allons vérifier.

À gauche se trouve le nom des colonnes du fichier CSV importé. À droite se trouve le champ correspondant. 3 correspondances doivent être renseignées :

- <span style="white-space: pre-wrap;">La colonne </span>`<span class="editor-theme-code">Nom adhérent</span>`<span style="white-space: pre-wrap;"> doit correspondre au champ </span>`<span class="editor-theme-code">Nom de famille</span>`.
- <span style="white-space: pre-wrap;">La colonne </span>`<span class="editor-theme-code">Prénom adhérent</span>`<span style="white-space: pre-wrap;"> doit correspondre au champ </span>`<span class="editor-theme-code">Prénom</span>`.
- <span style="white-space: pre-wrap;">La colonne </span>`<span class="editor-theme-code">Adresse e-mail</span>`<span style="white-space: pre-wrap;"> doit correspondre au champ </span>`<span class="editor-theme-code">Courriel</span>`.

Lorsque vous vous êtes assurés que les correspondances sont bien faites, cliquez sur "Suivant".

#### Importation

CiviCRM vous indique si des lignes du CSV sont invalides. Assurez-vous qu'il n'y a pas de soucis (où au moins que les soucis soient attendus).

[![image.png](https://wiki.aml-lyon1.fr/uploads/images/gallery/2026-04/scaled-1680-/jrXAfaWpxK3WMbfV-image.png)](https://wiki.aml-lyon1.fr/uploads/images/gallery/2026-04/jrXAfaWpxK3WMbfV-image.png)

Aucune ligne est invalide, on peut continuer.

Si tout est bon, cliquez sur "Importer maintenant &gt;&gt;".

<p class="callout info align-justify">Recommandé : Vérifiez qu'il n'y a pas de doublons dans la base.  
<span style="white-space: pre-wrap;">Allez dans </span>`<span class="editor-theme-code">Contacts > Gérer les doublons</span>`<span style="white-space: pre-wrap;">. Sur </span>`<span class="editor-theme-code">Nom de famille & Prénom</span>`<span style="white-space: pre-wrap;">, cliquez sur le bouton </span>`<span class="editor-theme-code">Utiliser cette règle</span>`<span style="white-space: pre-wrap;"> et validez. Cela affichera les contacts qui ont le même prénom et nom de famille, ou alors affichera une notification comme quoi il n'y en a pas. S'il y en a, la procédure de fusion étant compliquée, demandez aux responsables infrastructure.</span></p>

### Importation des adhésions

Nous sommes assurés que chaque adhérent a un contact associé. Nous allons maintenant indiquer à CiviCRM que ces contacts ont adhéré pour l'année universitaire en cours.

<span style="white-space: pre-wrap;">Allez dans </span>`<span class="editor-theme-code">Adhésions > Importer des adhésions</span>`.

##### Fichier à importer

Choisissez le même CSV que précédemment.

##### Séparateur de champs

<span style="white-space: pre-wrap;">Indiquez le point virgule </span>`<span class="editor-theme-code">;</span>`.

##### Modèle d'import

<span style="white-space: pre-wrap;">Sélectionnez </span>`<span class="editor-theme-code">Import Adhésions HelloAsso</span>`.

Cliquez sur "Suivant".

Sur cette page :

##### Adhésion

<span style="white-space: pre-wrap;">Sélectionnez </span>`<span class="editor-theme-code">Mettre à jour l'existant</span>`.

##### Contact de l'adhésion

<span style="white-space: pre-wrap;">Sélectionnez </span>`<span class="editor-theme-code">Faire correspondre à un contact existant</span>`.

##### Dedupe rule

<span style="white-space: pre-wrap;">Sélectionnez </span>`<span class="editor-theme-code">Nom de famille & Prénom (Unique Match)</span>`.

<p class="callout info">Ces options sont données à titre indicatif. Je pense par exemple qu'il est possible de faire la création des contacts directement à cette étape. Si vous souhaitez faire des tests et faire évoluer cette procédure, n'hésitez pas !</p>

##### Date format

<span style="white-space: pre-wrap;">Sélectionnez </span>`<span class="editor-theme-code">jj/mm/aaaa</span>`.

#### Correspondance de champs

Normalement, le modèle d'import devrait avoir correctement renseigné la correspondance des champs, mais nous allons vérifier.

À gauche se trouve le nom des colonnes du fichier CSV importé. À droite se trouve le champ correspondant. Les correspondances suivantes doivent être renseignées :

- <span style="white-space: pre-wrap;">La colonne </span>`<span class="editor-theme-code">Date de la commande</span>`<span style="white-space: pre-wrap;"> doit correspondre au champ </span>`<span class="editor-theme-code">Date de début de l'adhésion</span>`.
- <span style="white-space: pre-wrap;">La colonne </span>`<span class="editor-theme-code">Nom adhérent</span>`<span style="white-space: pre-wrap;"> doit correspondre au champ </span>`<span class="editor-theme-code">Nom de famille</span>`.
- <span style="white-space: pre-wrap;">La colonne </span>`<span class="editor-theme-code">Prénom adhérent</span>`<span style="white-space: pre-wrap;"> doit correspondre au champ </span>`<span class="editor-theme-code">Prénom</span>`.
- <span style="white-space: pre-wrap;">La colonne </span>`<span class="editor-theme-code">Adresse e-mail</span>`<span style="white-space: pre-wrap;"> doit correspondre au champ </span>`<span class="editor-theme-code">Courriel</span>`.

<span style="white-space: pre-wrap;">Deux autres "fausses" colonnes doivent être renseignées. Ce sont des valeurs qui seront appliquées à toutes les adhésions. Elles ne dépendent pas de colonnes venant du .CSV. Si elles n'existent pas, cliquez sur le bouton </span>`<span class="editor-theme-code">+ Add Row</span>`.

- `<span class="editor-theme-code">Type de membre</span>`<span style="white-space: pre-wrap;"> doit prendre le nom de l'adhésion pour l'année en cours. Par exemple, pour l'année 2025-2026, le champ doit prendre la valeur "Adhérent 2025-2026".</span>
- `<span class="editor-theme-code">Source de l'adhésion</span>`<span style="white-space: pre-wrap;"> doit prendre comme valeur "Import HelloAsso".</span>

[![image.png](https://wiki.aml-lyon1.fr/uploads/images/gallery/2026-04/scaled-1680-/rsugnW2oyHzjDGIJ-image.png)](https://wiki.aml-lyon1.fr/uploads/images/gallery/2026-04/rsugnW2oyHzjDGIJ-image.png)

Les 2 valeurs supplémentaires.

<p class="callout info">**Concernant le type de membre :**  
<span style="white-space: pre-wrap;">L'adhésion pour l'année en cours doit être créée. Pour vous assurer qu'elle existe, allez dans </span>`<span class="editor-theme-code">Adhésions > Tableau de bord</span>`. Ici vous voyez la liste des adhésions existantes. Nous en faison une par année universaire.  
  
[![image.png](https://wiki.aml-lyon1.fr/uploads/images/gallery/2026-04/scaled-1680-/f7PnWCYtAYKro3Xu-image.png)](https://wiki.aml-lyon1.fr/uploads/images/gallery/2026-04/f7PnWCYtAYKro3Xu-image.png)  
Ici, 2 types existent : Adhérent 2024-2025 et Adhérent 2025-2026.  
  
<span style="white-space: pre-wrap;">Si l'adhésion pour l'année en cours n'existe pas, demandez au Bureau ou au pôle infrastructure de la créer en allant dans </span>`<span class="editor-theme-code">Administrer > CiviMember > Types d'adhésion</span>`.</p>

Lorsque vous vous êtes assurés que les correspondances sont bien faites, cliquez sur "Suivant", puis cliquez sur "Importer maintenant &gt;&gt;".

### Importer les groupes

Si la billetterie HelloAsso a bien été faite, les adhérents ont pu choisir s'ils souhaitaient être abonnés aux différentes newsletters de l'AML, à savoir Event et CA. Nous allons renseigner leur choix en les ajoutant aux groupes correspondants.

La technique pour faire cela est de reprendre la procédure de création des contacts détaillée plus tôt dans cette procédure, avec une petite différence : nous allons précisé un groupe dans lequel ajouter les contacts.

#### Pour chaque mailing (Event puis CA)

#### Création du CSV

<span style="white-space: pre-wrap;">Supprimer toutes les lignes pour lesquelles la réponse est "Non" à la colonne correspondant au mailing. Par exemple, si vous faites l'ajout au groupe Event, supprimez toutes les lignes pour lesquelles la colonne </span>`<span class="editor-theme-code">Je souhaite être tenu informé, par mail, des évènements à venir de l'AML</span>`<span style="white-space: pre-wrap;"> est </span>`<span class="editor-theme-code">Non</span>`. Sauvegardez ce CSV.

#### Importation

<span style="white-space: pre-wrap;">Suivez la procédure "Création des contacts" détaillée plus tôt. </span>**Cependant, avant de valider en appuyant sur "Importer maintenant &gt;&gt;", cliquez sur `<strong class="editor-theme-bold editor-theme-code">Ajouter les enregistrements importés au groupe existant</strong>` et choisissez le groupe correspondant.**

- <span style="white-space: pre-wrap;">Mailing Event : Choisissez le groupe </span>`<span class="editor-theme-code">Mailing Event</span>`
- <span style="white-space: pre-wrap;">Mailing CA : Choisissez le groupe </span>`<span class="editor-theme-code">Mailing CA 20XX-20XX</span>`<span style="white-space: pre-wrap;"> correspondant à l'année universitaire en cours. Si le groupe n'existe pas, demandez au bureau ou au pôle infrastructure de le créer.</span>

Cliquez sur "Importer maintenant &gt;&gt;". Les groupes seront ajoutés aux personnes concernées.

<p class="callout info">Vérification : Normalement, vous devriez obtenir un résultat similaire à l'image suivante, c'est-à-dire 0 nouveau contacts créés et X contacts ajoutés au groupe sélectionné.  
  
![image.png](https://wiki.aml-lyon1.fr/uploads/images/gallery/2026-04/scaled-1680-/cCRThyUPdv28IaG0-image.png)  
Les lignes invalides viennent des lignes vides résultantes de la suppression des adhérents ne souhaitant pas être abonnés au mailing, il est possible que vous ne les aillez pas en fonction de comment vous avez produit le nouveau CSV.</p>

Réitérez la procédure pour l'autre mailing.