n8n

Le nœud communautaire n8n-nodes-hela apporte Hela dans n8n, que vous l'hébergiez vous-même ou que vous utilisiez n8n cloud.

Installer

Dans n8n : Settings → Community nodes → Install, puis n8n-nodes-hela. Sur une instance Docker, la variable N8N_COMMUNITY_PACKAGES_ENABLED=true doit être posée.

Identifiants

Créez des identifiants Hela API :

• API key : une clé créée dans Administration → Développeurs, avec les portées voulues plus webhooks:manage et events:read si vous utilisez le déclencheur ;
• Base URL : https://<votre-serveur>/v1 ; laissez la valeur par défaut pour le service hébergé.

Nœuds

Hela Trigger — un déclencheur par webhook. Choisissez les événements (invoice.paid, stock.low, *…). Le nœud crée le webhook à l'activation du workflow et le supprime à la désactivation ; il vérifie la signature Hela-Signature de chaque envoi avec le secret qu'il a reçu.

Hela — les opérations, par ressource :

Ressource	Opérations
Sale	Get, Get Many, Create, Record Payment, Cancel, Refund
Quote	Get, Get Many, Create, Convert
Purchase	Get, Get Many, Create, Receive, Record Payment
Partner	Get, Get Many, Create, Update, Statement
Item	Get Many, Create, Update
Stock	Get Levels, Get Movements
Transaction	Get Many, Create
Time Entry	Get Many, Upsert, Bill
Event	Get Many
Report	Summary, Receivables

Les opérations d'écriture envoient un Idempotency-Key dérivé de l'identifiant d'exécution n8n et de l'élément, de sorte qu'une relance ne duplique rien.

Exemple : facture payée → écriture dans votre base

Hela Trigger (invoice.paid) → Set (aplatir data) → Postgres (insert)

Le déclencheur sort un élément par événement, avec data au complet et data.total.amount en unité mineure ; un nœud Set avec {{ $json.data.total.amount / 100 }} donne le montant lisible pour une devise à deux décimales — ou utilisez l'expression {{ $helaMajor($json.data.total) }} que le nœud expose.

Code source

integrations/n8n-nodes-hela dans le dépôt Hela, publié sur npm sous le même nom. Licence MIT.