Connecter un partenaire
Les intégrations se gèrent dans Administration → Intégrations. La page montre le catalogue complet, le pays de l'entreprise en premier, et l'état de chaque connexion.
Trois sortes de partenaires
| Sorte | Ce que c'est | Exemple |
|---|---|---|
| Connecteur | Un service auquel Hela se connecte et avec lequel il échange tout seul | Odoo, Stripe, Google Drive, Clockify |
| Guide | Un service qui se branche par l'API, les webhooks ou un export, sans connexion propre | Sage, PayPal, Shopify, Zapier |
| Régime fiscal | Une autorité à laquelle Hela transmet les factures ; s'active depuis la page Conformité | eTIMS, Peppol, FNE |
Connecter
Deux façons, selon le partenaire :
Par OAuth (Google, Microsoft, Dropbox, QuickBooks, Xero, Yuki, Exact, Pennylane, Sage, Zoho Books, DocuSign) : un bouton Continuer avec … vous envoie chez le partenaire, vous acceptez, vous revenez. Hela conserve un jeton renouvelable, jamais votre mot de passe. Quelqu'un doit avoir enregistré une application chez ce partenaire : soit l'exploitant du serveur, une fois pour tous (voir Clés et variables d'environnement), soit votre entreprise elle-même. Dans ce second cas la page du connecteur vous donne l'adresse de retour à déclarer dans la console développeur du partenaire, puis vous demande l'identifiant client et le secret qu'elle vous remet ; le secret est chiffré comme toute autre clé, et le bouton Continuer avec … apparaît aussitôt. Si les deux existent, la vôtre l'emporte.
Par clé (Odoo, Stripe, Mollie, les mobile money, Yousign, Clockify, Toggl, WhatsApp, Slack…) : un formulaire demande les identifiants que le partenaire vous a donnés. Ils sont chiffrés (AES-256-GCM) avant d'être enregistrés et ne sont jamais réaffichés — le champ montre Renseigné et se laisse vide pour conserver.
Après la connexion
- Réglages : ce que le partenaire reçoit, et comment. Par exemple inclure les ventes de comptoir pour un connecteur comptable, ou le portefeuille à créditer pour un fournisseur de paiement.
- Tester : un appel réel au partenaire, pour vérifier que les identifiants sont bons.
- Synchroniser : pour les partenaires qui tirent des données (Clockify, Toggl, les taux de change), lance l'import maintenant au lieu d'attendre le prochain passage horaire.
- Journal : les cent derniers échanges, avec ce qui a été envoyé, ce qui est revenu et, en cas d'erreur, la réponse du partenaire.
- Adresse de notification : pour les partenaires qui préviennent Hela (paiements, signatures), l'adresse à coller dans leur configuration de webhooks. Hela vérifie la signature de chacun.
Ce qui circule
Chaque connecteur s'abonne à des événements. Quand l'événement se produit, un travail est mis en file et exécuté par le serveur en arrière-plan, avec réessai en cas d'échec (jusqu'à huit fois, à intervalle croissant). L'application ne ralentit jamais parce qu'Odoo est lent.
Un document poussé chez un partenaire garde un lien vers son identifiant distant : la vente n° 42 sait qu'elle est la facture INV/2026/0042 dans Odoo. Le lien évite les doublons et permet d'ouvrir le document chez le partenaire depuis Hela.
Automatique ou à la demande
Deux façons de travailler, et chaque partenaire a la sienne.
Automatique : une fois connecté, l'opération suffit. Une vente, une facture, un paiement, un achat, un séjour, un mouvement de stock part chez le partenaire sans qu'on y pense ; dans l'autre sens, ce qu'il reçoit (une commande, un paiement, des heures, un relevé) arrive dans Hela.
À la demande : le partenaire attend un geste, sur la page où il a du sens — un bouton sur la facture, à la caisse, sur le tableau.
| Famille | Connexion | Après une opération, tout seul | Sur un geste |
|---|---|---|---|
| Comptabilité (Odoo, QuickBooks, Xero, Yuki, Exact, Pennylane, Sage, Zoho) | bouton, sauf Odoo (clés de l'instance) | vente, facture, paiement, achat écrits dans les livres | — |
| Paiements (Stripe, Mollie, Square, SumUp par bouton ; PayPal, mobile money, Wave, Flutterwave, Paystack par clés) | bouton ou clés | le paiement confirmé par le fournisseur est encaissé, la facture passe payée | Lien de paiement, Demander sur le téléphone sur la facture ; mode En ligne à la caisse ; Payer en ligne sur la facture reçue par le client |
| Banque (GoCardless, Ponto, Plaid ; relevés) | clés ; import de fichier | les mouvements arrivent dans le rapprochement toutes les heures | import d'un relevé, choix d'une suggestion |
| Commerce (Shopify, WooCommerce) | clés de l'app privée | commandes en ventes ; stock réécrit à chaque mouvement | — |
| Agenda (iCal, Google Calendar) | adresse / bouton | séjours poussés et lus | — |
| Archives (Drive, OneDrive, Dropbox) | bouton | chaque facture, devis signé, achat, clôture de caisse déposé | Archiver maintenant sur le document |
| Feuilles (Google Sheets, Excel Online) | bouton | une ligne par événement, catalogue relu | Vers la feuille sur Ventes, Achats, Partenaires, Catalogue, Trésorerie, Heures |
| Signature (Yousign, DocuSign) | clé / bouton | la signature reçue est enregistrée | Envoyer en signature sur le devis ou la facture |
| Heures (Clockify, Toggl) | clé | les heures importées chaque heure | Synchroniser |
| Messagerie (Slack par bouton ; WhatsApp, Teams, Telegram, Twilio, Africa's Talking par clés) | bouton ou clés | les alertes choisies partent dans le canal | envoi d'un reçu ou d'une facture au client |
| Taux (BCE, Open Exchange Rates) | rien / clé | le taux du jour proposé chaque matin | — |
| Fisc (Peppol, eTIMS, EBM, VFD, EFRIS, FNE, e-MECeF…) | enrôlement depuis Conformité | chaque facture émise transmise | Transmettre sur la facture |
Les connexions « par bouton » demandent que l'exploitant ait enregistré Hela chez le partenaire une fois pour toutes (back-office → Intégrations et clés) ; à défaut, la page du connecteur propose la clé, ou votre propre application.
Sur un document
Sur une facture ou un devis, une carte Partenaires apparaît quand au moins un service connecté peut agir : créer un lien de paiement, demander un paiement sur le téléphone du client, envoyer en signature, archiver, transmettre au fisc. La même carte montre ce qui a déjà été fait et son état.
Déconnecter
Déconnecter oublie les identifiants et cesse les envois. Les documents déjà poussés restent chez le partenaire ; les liens sont conservés, de sorte qu'une reconnexion ne crée pas de doublons.
Plafonds
Le nombre de connexions simultanées dépend du plan de l'abonnement (integrations dans les plafonds). Un connecteur de plus que le plan n'autorise est refusé avec un message explicite.