Documentation Hela
Hela est le logiciel de gestion des petites et moyennes entreprises : ventes, caisse, stock, achats, trésorerie, devis, factures, réservations. La version 3.0 l'ouvre vers l'extérieur. Cette documentation décrit tout ce qui permet de connecter Hela à autre chose : l'API publique, les webhooks, les applications d'automatisation, chaque partenaire du catalogue et chaque régime de facturation électronique.
Ce que vous pouvez faire
| Vous voulez… | Lisez |
|---|---|
| Appeler Hela depuis votre code, un script, un site | L'API en un coup d'œil, puis Première clé, premier appel |
| Être prévenu quand quelque chose se passe (une facture payée, un stock bas) | Webhooks et le catalogue des événements |
| Brancher Hela sans écrire de code | Zapier, Make, n8n, Power Automate |
| Laisser un assistant IA lire vos ventes ou rédiger un devis | Serveur MCP |
| Envoyer vos écritures à votre comptable | Odoo, QuickBooks, Xero, Yuki, Exact, Pennylane ou les exports |
| Encaisser par carte ou par mobile money | Stripe, Mollie, PayPal, Square, SumUp, Mobile money |
| Rapprocher le relevé bancaire | Banque |
| Vendre sur Shopify ou WooCommerce | Shopify, WooCommerce |
| Archiver, faire signer, prévenir | Drive, OneDrive, Dropbox, Yousign, DocuSign, WhatsApp, Slack, SMS |
| Respecter la facturation électronique de votre pays | Comment Hela traite les régimes, puis la page de votre pays |
Trois idées à garder en tête
Une entreprise, un espace. Tout dans Hela appartient à une entreprise (companyId). Une clé d'API appartient à une entreprise, un webhook aussi, une connexion Odoo aussi. Un compte qui gère trois entreprises crée trois jeux de clés.
Un événement, plusieurs destinataires. Quand une facture est émise, Hela écrit un événement invoice.issued dans son journal. Ce même événement nourrit vos webhooks, la ligne dans Google Sheets, l'écriture dans Odoo, le PDF dans Drive, la transmission au fisc. Vous n'avez rien à câbler : connecter un partenaire suffit.
L'argent est en entiers. Un montant est toujours un entier en unité mineure (centimes, ou l'unité elle-même pour le franc congolais qui n'a pas de décimales), accompagné de sa devise. { "amount": 12500, "currency": "USD" } vaut 125,00 USD. L'API ne renvoie jamais un nombre à virgule pour de l'argent.
Où tourne tout cela
Hela est hébergé par nous ou par vous. L'API, les webhooks et les connecteurs sont identiques dans les deux cas ; seuls changent l'adresse de base et les clés des partenaires OAuth, que l'exploitant du serveur fournit. La page Clés et variables d'environnement s'adresse à celui qui héberge.
Conventions de cette documentation
- Les adresses sont données relatives à la base de l'API, par exemple
GET /companies/{companyId}/sales. La base esthttps://<votre-serveur>/v1. - Les exemples utilisent
curlet un peu de JavaScript. Le SDK TypeScript fait la même chose en une ligne. - Les mots entre chevrons
<…>sont à remplacer. Les{…}dans une adresse sont des paramètres de chemin.