Guide complet de l’intégration HaloPSA et Pennylane : installation, configuration et bonnes pratiques pour automatiser vos flux financiers.

Ce guide vous accompagne dans la configuration de l'intégration HaloPSA × Pennylane : ce qu'il faut préparer de chaque côté, comment connecter les deux, et comment lancer votre première synchronisation. Pour savoir ce que fait l'intégration et ce qu'elle coûte, consultez la page de l'intégration Halo × Pennylane.
Une fois configurée, l'intégration fonctionne toute seule : les clients, articles, devis et factures que vous enregistrez dans HaloPSA arrivent dans Pennylane en une minute environ, et les paiements, les décisions sur les devis et les enregistrements créés dans Pennylane reviennent dans HaloPSA toutes les quelques minutes.
Halentra crée votre tenant d'intégration et vous y invite par e-mail. La configuration se fait ensuite en cinq étapes :
Créez une application d'API, et vérifiez les statuts, articles et codes de taxe utilisés par la synchronisation.
Saisissez les identifiants de l'application d'API, puis connectez-vous à Pennylane et approuvez l'accès.
Indiquez à l'intégration quels statuts HaloPSA signifient envoyé, accepté, refusé, expiré et facturé.
Définissez les sens de synchronisation, les e-mails aux clients et la période des données, et liez les enregistrements qui existent déjà des deux côtés.
Une synchronisation en masse lie et crée les enregistrements des deux côtés. À la fin, la synchronisation continue démarre d'elle-même.
La carte Configuration en haut de la page Paramètres de votre tenant suit les mêmes étapes : elle montre ce qui est fait, ouvre chaque étape pour vous, et lance la première synchronisation une fois que tout ce qui la précède est réglé. Rien n'est synchronisé avant.
L'intégration lit et écrit vos enregistrements de facturation via l'API HaloPSA. Dans HaloPSA, accédez à Configuration › Integrations › HaloPSA API, ouvrez View Applications et ajoutez une nouvelle application :
Application Identity donne à l'intégration sa propre identité : elle ne dépend ainsi du compte d'aucune personne en particulier, et ses modifications se distinguent facilement de celles de votre équipe.
Dans l'onglet Permissions de l'application, cochez celles-ci :
Enregistrez l'application et copiez son Client ID et son Client Secret pour l'étape 2.
Vous les choisirez à l'étape 3 : vérifiez d'abord qu'ils existent dans HaloPSA.
Le code de taxe de chaque article doit avoir un taux pris en charge par Pennylane : 0 %, 0,9 %, 1,05 %, 1,75 %, 2,1 %, 4 %, 5 %, 5,5 %, 6 %, 6,5 %, 8,5 %, 9,2 %, 10 %, 13 %, 16 %, 19,6 % ou 20 %. Une ligne avec un autre taux est envoyée à 20 %, avec un avertissement dans les journaux de synchronisation.
Pennylane utilise aussi l'adresse de facturation, le numéro de TVA, les conditions de paiement et l'e-mail de comptabilité de chaque client. Vérifiez-les sur vos principaux clients avant la première synchronisation.
Pour tenir les devis et les factures d'un client à l'écart de Pennylane, utilisez l'indicateur exclu de la synchronisation des factures propre à HaloPSA : l'intégration le respecte.
Sur la page Paramètres de votre tenant, la section Identifiants contient une carte pour chaque système.
https://yourcompany.halopsa.com, ainsi que l'ID client et le secret de l'étape 1. L'intégration vérifie la connexion et crée le webhook dans HaloPSA pour vous. Laissez ce webhook tel quel : s'il est désactivé ou supprimé, les modifications faites dans HaloPSA n'arrivent plus dans Pennylane.Si HaloPSA affiche Limité, il manque à l'application d'API certaines des permissions ci-dessus. Une fois connectées, les deux connexions sont vérifiées toutes les heures, et vous êtes prévenu si l'une cesse de fonctionner.
Ouvrez Statuts et valeurs par défaut HaloPSA dans la section Règles de synchronisation et renseignez les huit valeurs :
Les deux statuts Envoyé décident aussi du moment où Pennylane envoie un e-mail à vos clients, si vous l'activez à l'étape 4.
Le bouton Remplir suggère un statut pour chaque ligne dont le nom correspond, comme « Accepted » ou « Approved ». Vérifiez les suggestions avant d'enregistrer.
Les clients, produits, devis et factures sont synchronisés dans les deux sens par défaut. Envoyez un type d'enregistrement uniquement vers Pennylane, ramenez-le uniquement vers HaloPSA, ou désactivez-le.
Dans le même panneau, deux interrupteurs confient l'envoi à Pennylane : vos clients reçoivent leurs devis et leurs factures depuis Pennylane, sans que personne ait à les envoyer à la main.
Les deux sont désactivés par défaut, et ne fonctionnent que tant que ce type d'enregistrement est synchronisé vers Pennylane. Les e-mails utilisent vos paramètres d'e-mail Pennylane : les factures partent vers l'e-mail de comptabilité du client dans HaloPSA, et les devis vers le contact du devis. Une synchronisation en masse ne les envoie jamais : les activer n'envoie donc pas d'e-mails à vos clients au sujet d'anciens documents.
La Période des données définit la date à partir de laquelle les devis et les factures sont synchronisés, ou conserve tout votre historique. Les clients et les produits sont toujours synchronisés en entier. Une période courte est le moyen le plus sûr de vérifier votre configuration lors d'une première synchronisation, et vous pourrez l'élargir ensuite.
Les Enregistrements existants ne comptent que si certains clients ou produits existent déjà à la fois dans HaloPSA et dans Pennylane. La première synchronisation lie d'elle-même les enregistrements qui portent exactement le même nom. Quand les noms diffèrent, par exemple « Acme » dans HaloPSA et « ACME SAS » dans Pennylane, liez-les ici d'abord, sinon la synchronisation crée une deuxième copie. Mapper automatiquement par nom lie toutes les correspondances exactes en un clic, et Exclusions tient des enregistrements complètement à l'écart de la synchronisation.
Cliquez sur Lancer à la dernière étape de la carte Configuration. La confirmation indique ce qui va changer de chaque côté : lisez-la, puis confirmez.
La synchronisation en masse traite les clients, les produits, les devis et les factures, dans cet ordre :
Elle prend de quelques minutes pour une petite société à quelques heures pour un long historique. Vous pouvez la suivre sur la page Journaux de sync, ou fermer la page et recevoir un e-mail à la fin. Une synchronisation en masse n'envoie jamais d'e-mails à vos clients, même avec les e-mails aux clients activés.
À la fin, la carte Configuration disparaît et la synchronisation continue démarre d'elle-même. Tous les réglages restent modifiables ensuite, et vous pouvez relancer une synchronisation en masse à tout moment, par exemple après avoir lié des enregistrements oubliés ou élargi la période des données.
Le tableau de bord montre les dernières synchronisations, le nombre d'enregistrements liés et l'activité du mois. Un bandeau apparaît quand quelque chose demande votre attention, comme une connexion qui ne fonctionne plus ou des échecs à examiner.
Chaque enregistrement synchronisé, ignoré ou en échec apparaît dans les Journaux de sync avec ses identifiants HaloPSA et Pennylane et, en cas d'échec, la raison. Un enregistrement en échec est réessayé automatiquement avant de rester en échec.
Vous pouvez aussi demander à l'intégration d'ouvrir un ticket dans HaloPSA quand un enregistrement échoue encore après ses nouvelles tentatives ou qu'une connexion est perdue, et choisir les notifications par e-mail que vous recevez.
Notre guide de configuration détaillé, fourni avec l'intégration, couvre chaque réglage et chaque message des journaux de synchronisation.
Non. L'intégration le crée quand vous connectez HaloPSA, et propose de le recréer s'il est un jour désactivé ou supprimé.
Pour lire vos statuts de devis, statuts de facture, groupes d'articles et taxes, parmi lesquels vous choisissez pendant la configuration. En dehors de son webhook, l'intégration n'écrit que des clients, articles, devis, factures, avoirs et tickets d'incident.
Non. Vous vous connectez à Pennylane et approuvez l'accès, via l'autorisation propre à Pennylane.
Oui. Choisissez une période des données récente pour la première synchronisation, vérifiez le résultat dans Pennylane, puis élargissez la période et relancez une synchronisation en masse. Gardez à l'esprit que les factures synchronisées sont finalisées dans Pennylane.
Oui. Activez Envoyer les devis via Pennylane ou Envoyer les factures via Pennylane, et Pennylane envoie chaque devis ou facture par e-mail quand il atteint votre statut Envoyé dans HaloPSA. Les anciens documents repris par une synchronisation en masse ne sont jamais envoyés.
Oui. Tous les réglages restent modifiables. Après avoir lié des enregistrements oubliés ou élargi la période des données, relancez une synchronisation en masse : les enregistrements déjà liés ne sont jamais créés deux fois.
Les modifications faites dans Pennylane sont rattrapées à la reprise. Celles faites dans HaloPSA pendant la pause ne le sont pas : enregistrez à nouveau ces enregistrements dans HaloPSA, ou lancez une synchronisation en masse.
Réservez une démo sur votre propre configuration, et nous préparons votre tenant.