Zapier

L'application Hela pour Zapier relie une entreprise Hela à plus de sept mille applications sans écrire de code : une facture payée crée une ligne dans Google Sheets, un nouveau client part dans Mailchimp, un stock bas ouvre une tâche dans Trello.

Connecter

1. Dans Zapier, ajoutez une étape Hela et choisissez Sign in to Hela.
2. Collez une clé d'API créée dans Administration → Développeurs. Donnez-lui les portées des déclencheurs et actions que vous comptez utiliser, plus webhooks:manage (c'est ainsi que Zapier s'abonne aux événements) et events:read.
3. Indiquez l'adresse de l'API si votre Hela est auto-hébergé ; laissez vide pour le service hébergé.

Zapier affiche le nom de l'entreprise pour confirmer la connexion.

Déclencheurs

Chaque déclencheur correspond à un événement. Zapier crée un webhook dans votre entreprise à l'activation du Zap et le supprime à sa désactivation — vous le verrez dans la liste des webhooks avec la source api:<nom de la clé>.

Déclencheur	Événement
New Sale	sale.created
Invoice Issued	invoice.issued
Invoice Paid	invoice.paid
Payment Received	payment.received
Invoice Overdue	invoice.overdue
New Quote / Quote Accepted	quote.created, quote.accepted
Purchase Received	purchase.received
Low Stock	stock.low
Cash Session Closed	cash_session.closed
New Partner	partner.created
Order Request Received	order_request.received
Fiscal Submission Accepted / Rejected	fiscal.accepted, fiscal.rejected

Les montants arrivent en deux champs : total.amount (entier, unité mineure) et total.currency. Un champ pratique total_major donne le montant lisible (125.00).

Actions

Action	Ce qu'elle fait
Create Sale	Crée une vente ou une facture à partir de lignes.
Record Payment	Enregistre un paiement sur une facture.
Create Quote	Crée un devis.
Create Partner	Crée un client ou un fournisseur.
Create Expense	Enregistre une dépense.
Create Time Entry	Ajoute des heures pour un client.
Find Partner	Cherche un partenaire par nom, e-mail ou téléphone.
Find Item	Cherche un article par nom ou référence.

Les actions utilisent l'en-tête Idempotency-Key avec l'identifiant de l'exécution Zapier : un Zap rejoué ne crée pas deux fois la vente.

Exemples

• Facture payée → ligne Google Sheets : déclencheur Invoice Paid, action Create Spreadsheet Row. (Si vous préférez un tableau complet et à jour, le connecteur Google Sheets le fait sans Zap.)
• Commande Shopify → vente Hela : déclencheur New Order de Shopify, action Find Partner puis Create Sale.
• Stock bas → message Slack : déclencheur Low Stock, action Send Channel Message. (Le connecteur Slack le fait aussi, sans Zap.)

Installer l'application

L'application est publiée dans l'annuaire Zapier sous le nom Hela. Si vous préférez une version privée (pour un Hela auto-hébergé, ou en attendant la revue de l'annuaire), son code source est dans le dépôt Hela, sous integrations/zapier, prêt pour zapier push.