Nouveau : l'intégration Halo × Pennylane par Halentra est en ligne. Découvrez-la
Halentra
Accueil/Guides/Intégration HaloPSA × Pennylane by Halentra
12 min de lecture

Intégration HaloPSA × Pennylane by Halentra

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

HaloPSA × Pennylane

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.

Dans HaloPSADans PennylaneSens
ClientsClientsDans les deux sens
ArticlesProduitsDans les deux sens
DevisDevisDans les deux sens
FacturesFactures clientsDans les deux sens
AvoirsAvoirsDe HaloPSA vers Pennylane
Factures d'acompteFactures d'acompteDe HaloPSA vers Pennylane

La configuration en bref

Halentra crée votre tenant d'intégration et vous y invite par e-mail. La configuration se fait ensuite en cinq étapes :

1
Préparer HaloPSA

Créez une application d'API, et vérifiez les statuts, articles et codes de taxe utilisés par la synchronisation.

2
Connecter HaloPSA et Pennylane

Saisissez les identifiants de l'application d'API, puis connectez-vous à Pennylane et approuvez l'accès.

3
Configurer les statuts et valeurs par défaut

Indiquez à l'intégration quels statuts HaloPSA signifient envoyé, accepté, refusé, expiré et facturé.

4
Choisir ce qui est synchronisé

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.

5
Lancer la première synchronisation

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.

Avant de commencer
  • Les factures sont finalisées dans Pennylane immédiatement. Chaque facture synchronisée depuis HaloPSA est numérotée et verrouillée dès sa création, comme si vous l'aviez finalisée vous-même. Vérifiez votre configuration avec une petite première synchronisation avant d'envoyer tout votre historique.
  • Exercices comptables. Pennylane n'accepte que des factures datées dans l'un de ses exercices comptables. Assurez-vous qu'ils couvrent les dates à partir desquelles vous synchroniserez.
  • Les montants sont en euros, avec les taux de TVA français.

Étape 1 : préparer HaloPSA

Créer l'application d'API

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 :

ParamètreValeur
Application namePar exemple « Intégration Pennylane »
AuthenticationClient ID and Secret
Login TypeAgent
Agent to log in asApplication Identity
Identity RolesAdministrator

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 :

PermissionUtilité
adminLire vos statuts de devis, statuts de facture, groupes d'articles et taxes
admin:webhooksCréer le webhook qui envoie vos modifications à l'intégration
edit:customersClients
edit:itemsArticles
edit:quotesDevis
edit:invoicesFactures et avoirs
edit:ticketsTickets d'incident ouverts quand quelque chose échoue

Enregistrez l'application et copiez son Client ID et son Client Secret pour l'étape 2.

Vérifier vos statuts et articles

Vous les choisirez à l'étape 3 : vérifiez d'abord qu'ils existent dans HaloPSA.

  • Des statuts de devis, dans Config › Quotes & Orders › Quote Statuses : un pour chacun des cas envoyé, accepté, refusé et expiré, et un ou plusieurs indiquant que le devis a été facturé, comme Closed ou Converted to order.
  • Un statut de facture pour les factures envoyées, dans Config › Billing › Invoice Statuses.
  • Un groupe d'articles pour les produits créés dans Pennylane.
  • Un article pour les acomptes.

Vérifier les codes de taxe et les informations de facturation

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.

Étape 2 : connecter HaloPSA et Pennylane

Sur la page Paramètres de votre tenant, la section Identifiants contient une carte pour chaque système.

  • HaloPSA : cliquez sur Connecter et saisissez l'adresse de votre HaloPSA, comme 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.
  • Pennylane : cliquez sur Connecter, connectez-vous à Pennylane et approuvez l'accès. Aucune clé d'API n'est à créer ni à copier. Connectez-vous avec un utilisateur qui a accès à la société depuis laquelle vous facturez.

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.

Étape 3 : configurer les statuts et valeurs par défaut

Ouvrez Statuts et valeurs par défaut HaloPSA dans la section Règles de synchronisation et renseignez les huit valeurs :

  • Statut de devis - Envoyé, Accepté, Refusé, Expiré : un devis accepté dans Pennylane passe à votre statut Accepté dans HaloPSA, et définir ce statut dans HaloPSA marque le devis Pennylane comme accepté. Il en va de même pour refusé et expiré.
  • Statut de devis - Facturé : un ou plusieurs statuts qui marquent le devis Pennylane comme facturé.
  • Statut de facture - Envoyée : le statut qui signifie qu'une facture est partie chez le client.
  • Groupe d'articles par défaut et Article d'acompte par défaut : ceux que vous avez vérifiés à l'étape 1.

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.

Étape 4 : choisir ce qui est synchronisé

Sens de synchronisation

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.

Laissez Pennylane envoyer vos devis et factures par e-mail

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.

  • Envoyer les devis via Pennylane : quand un devis HaloPSA passe à votre statut de devis Envoyé, Pennylane envoie le devis par e-mail au client.
  • Envoyer les factures via Pennylane : quand une facture HaloPSA passe à votre statut de facture Envoyée, Pennylane envoie la facture et son PDF par e-mail au client. Chaque facture est envoyée une seule fois au plus.

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.

Période des données et enregistrements existants

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.

Étape 5 : lancer la première 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 :

  • Les enregistrements liés des deux côtés sont mis à jour dans HaloPSA avec les informations de Pennylane.
  • Les enregistrements présents d'un seul côté sont créés de l'autre.
  • Les devis et factures déjà liés voient seulement leur statut mis à jour.

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.

Après la configuration : garder un œil sur la synchronisation

Savoir où vous en êtes

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.

Problèmes fréquents à la configuration

Ce que vous voyezQue faire
Une synchronisation en masse ne trouve aucun devis ni aucune factureVérifiez la période des données : tous les documents sont peut-être plus anciens.
Taux de taxe non pris en charge, synchronisé à 20 %Corrigez le code de taxe de l'article dans HaloPSA, puis vérifiez le document Pennylane.
Facture hors exercice comptable, non créée ou laissée en brouillonOuvrez l'exercice comptable dans Pennylane, puis finalisez le brouillon ou enregistrez à nouveau la facture dans HaloPSA.
Un client apparaît deux fois dans PennylaneIl existait des deux côtés sous des noms différents. Liez la bonne paire et supprimez le doublon dans Pennylane.
Les produits créés dans Pennylane n'apparaissent pas dans HaloPSADéfinissez le groupe d'articles par défaut à l'étape 3.
Les modifications HaloPSA n'arrivent pas dans PennylaneVérifiez dans le tableau de bord s'il y a un problème de webhook ou de connexion, et que ce type d'enregistrement est synchronisé vers Pennylane.

Notre guide de configuration détaillé, fourni avec l'intégration, couvre chaque réglage et chaque message des journaux de synchronisation.

Tarifs

  • Gratuit pour les organisations qui ont au moins 5 licences HaloPSA achetées via Halentra.
  • 69 € / mois pour les organisations dont les licences HaloPSA ne passent pas par Halentra.

Questions fréquentes

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.

Prêt à connecter HaloPSA à Pennylane ?

Réservez une démo sur votre propre configuration, et nous préparons votre tenant.