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 est https://<votre-serveur>/v1.
• Les exemples utilisent curl et 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.