Contexte :

Les administrateurs immobiliers et les administrateurs de communauté peuvent désormais gagner du temps en important plusieurs locataires à la fois grâce à la nouvelle fonction d’importation en masse dans le système d’exploitation ButterflyMX. Cette fonction vous permet de télécharger un fichier CSV contenant les informations des locataires au lieu d’ajouter les résidents un par un. Si vous souhaitez utiliser cette fonction en tant qu’administrateur immobilier ou administrateur de communauté, veuillez contacter votre gestionnaire de réussite client ou le support pour activer cette fonctionnalité pour votre immeuble.

Avant de commencer

• Préparez un fichier CSV.
  • Les colonnes requises sont : prénom, nom, courriel et code de l’unité.
  • S’il n’y a pas d’unités dans l’immeuble, le numéro d’étage est également requis.
  • Téléchargez le modèle d’importation pour unités standards ou unités commerciales
    • Les modèles respectifs se trouvent en pièce jointe au bas de cet article

Comment importer des locataires

1. Connectez-vous au système d’exploitation ButterflyMX
2. Accédez à l’écran de la liste des locataires et choisissez Ajouter un locataire > Importer CSV.
3. Choisissez un type d’importation - Unités standards ou unités commerciales
   • Téléchargez le modèle d’importation pour unités standards.
   • Téléchargez le modèle d’importation pour unités commerciales.
4. Cliquez sur Parcourir les fichiers et sélectionnez votre fichier CSV préparé
5. Vérifiez l’aperçu de votre importation pour vous assurer que les données apparaissent correctement
   • Le système tentera de détecter automatiquement le type de données dans cette colonne et le sélectionnera pour vous.
     • S’il ne trouve pas de correspondance, le menu déroulant affichera « Assign ».

   • Vous pouvez supprimer les lignes ou colonnes indésirables avant l’importation.

     

6. Une fois que tout est mappé, cliquez sur Suivant
7. Cliquez sur Importer (en bas) pour commencer le processus d’importation
8. Cliquez de nouveau sur Importer dans la fenêtre contextuelle de confirmation qui apparaît

9. Une fenêtre contextuelle vous indiquera que l’importation des locataires est en cours. Pour les importations plus volumineuses, le processus peut prendre jusqu’à 10 minutes. Vous pouvez fermer la fenêtre du navigateur à ce stade si vous le souhaitez.

   

10. Après quelques minutes, vous recevrez un courriel vous informant que l’importation est terminée.
    1. Le modèle de courriel d’importation terminée inclut le nombre d’enregistrements réussis et échoués.

    2. Un lien apparaît uniquement s’il y a du travail à faire

       

    3. Le lien dans le courriel vous mène à un écran de révision affichant uniquement le fichier concerné, sans en-têtes repliables.

       

       • Il y a un bouton Importer pour l’écran complet

Onglet Révision requise

1. L’onglet « Révision requise » affiche tous les fichiers avec des enregistrements en attente, chaque fichier dans sa propre section repliable. S’il n’y a qu’un seul fichier, il sera développé par défaut.
   • Développer un fichier montre tous les enregistrements de ce fichier qui nécessitent une révision.
2. La colonne Statut affiche tous les messages d’erreur.
   • S’il y a plusieurs colonnes, une barre de défilement apparaîtra. La colonne Statut restera visible en permanence.

3. Une fois que vous modifiez un enregistrement, son statut passe à « Prêt pour importation ».

   

4. Une fois que vous avez révisé tous les enregistrements d’un fichier, vous pouvez les soumettre en lot.

Onglet Historique des importations

Vous pouvez consulter le statut des importations dans Historique des importations

1. Dans la liste d’historique, le lien du nom de fichier vous permet de télécharger le fichier.
2. Les utilisateurs importés avec succès seront comptabilisés dans la colonne « Utilisateurs importés »
3. Si l’importation est terminée mais qu’il reste du travail à faire, vous verrez « Révision ». Les locataires avec des erreurs d’importation peuvent aussi être révisés sous « Révision requise »
   • Le point rouge indique qu’une importation passée nécessite votre attention.

4. Si vous avez précédemment téléchargé un fichier sans le soumettre pour importation, vous verrez un bouton « Assign » pour reprendre là où vous vous êtes arrêté.

   

Que se passe-t-il après l’importation

Une fois l’importation terminée :

• Tous les locataires apparaîtront dans votre liste de locataires dans le système d’exploitation ButterflyMX
• Les locataires recevront des invitations par courriel pour télécharger l’application ButterflyMX
• Les locataires peuvent immédiatement utiliser l’application pour ouvrir les portes, gérer les passes visiteurs et consulter l’historique des appels
• Vous pouvez modifier les informations individuelles des locataires au besoin depuis la page Locataires

Dépannage

Importation échouée ou affichage d’erreurs

Si votre importation échoue, vérifiez ces problèmes courants :

• Les numéros d’unité ne correspondent pas : Vérifiez que les numéros d’unité dans votre CSV correspondent exactement aux unités créées dans le système d’exploitation ButterflyMX
• Format de courriel invalide : Assurez-vous que toutes les adresses courriel sont correctement formatées (nom@domaine.com)
• Entrées en double : Vérifiez que vous n’importez pas des locataires déjà existants dans le système
• Champs requis manquants : Toutes les colonnes (Prénom, Nom, Courriel, Téléphone, Unité) doivent contenir des valeurs
• Problème de format de fichier : Confirmez que votre fichier est enregistré en .csv, pas en .xlsx ou autre format

Certains locataires importés, d’autres non

Le processus d’importation ignorera les lignes contenant des erreurs et importera les entrées valides. Examinez le message d’erreur pour identifier quelles lignes ont échoué et pourquoi. Vous pouvez :

• Créer un nouveau CSV avec seulement les entrées échouées après avoir corrigé les erreurs
• Ajouter manuellement les locataires restants via le flux standard Ajouter un résident

Les locataires ne reçoivent pas les invitations à l’application

Si les locataires ne reçoivent pas leurs invitations à l’application :

• Rappel : les invitations ne sont pas envoyées avant 8 h, heure locale
• Vérifiez que les adresses courriel dans votre CSV sont correctes
• Demandez aux locataires de vérifier leurs dossiers de pourriels/courriers indésirables
• Renvoyez les invitations individuellement depuis la page Résidents en cliquant sur les trois points à côté du nom du locataire et en sélectionnant « Renvoyer l’invitation »

Vous ne voyez pas le bouton Importer des locataires

Si vous ne voyez pas l’option Importer des locataires :

• Confirmez que vous avez les permissions d’administrateur immobilier ou d’administrateur de communauté
• Contactez votre représentant ButterflyMX pour activer le drapeau de fonctionnalité d’importation pour votre propriété
• Essayez de vous déconnecter puis de vous reconnecter pour actualiser vos permissions

Meilleures pratiques

• 📊 Testez d’abord avec un petit lot : Importez initialement 5 à 10 locataires pour vous assurer que votre CSV est bien formaté
• 🔍 Vérifiez bien les numéros d’unité : Les mauvaises affectations d’unités sont l’erreur la plus courante lors de l’importation
• 📧 Informez les locataires à l’avance : Prévenez les résidents qu’ils recevront des invitations à l’application
• 💾 Conservez une sauvegarde : Enregistrez votre fichier CSV original au cas où vous auriez besoin de le consulter plus tard
• ✅ Vérifiez après l’importation : Contrôlez quelques profils de locataires pour vous assurer que les informations ont été importées correctement