Ressources · Intégration n8n

Intégration Invoice Ninja n8nAutomatiser Invoice Ninja avec n8n.

Chaque facture, chaque paiement et chaque dépense d'Invoice Ninja peut devenir une étape de workflow. L'intégration Invoice Ninja n8n pose un nœud de 31 opérations réparties sur 7 objets, et un trigger qui écoute 5 événements de création par webhook. Pour les équipes finance et ops qui facturent déjà là.

Tester l'intégration Invoice Ninja sur n8n Voir les 31 opérations

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert l'intégration Invoice Ninja n8n ?

Deux briques, un seul credential. Le nœud Invoice Ninja lit et écrit les objets de la facturation : clients, factures, paiements, dépenses, transactions bancaires, devis et tâches, soit 31 opérations. Le trigger Invoice Ninja tient l'autre bout et lance un workflow dès qu'un enregistrement est créé dans l'outil. Un credential, c'est l'accès que n8n garde en mémoire : tu le configures une fois, les deux nœuds s'en servent.

Premier réflexe : la relance. Get many invoices avec Client Status sur Overdue et Return All activé parcourt toutes les pages de l'API au lieu de s'arrêter au premier paquet. Un nœud Code regroupe les documents par compte, et la relance part une fois par client, pas une fois par facture. Le tableau de suivi atterrit dans Google Sheets, l'alerte dans Slack.

Deuxième usage : la facture qui part toute seule. Le trigger réagit à create_invoice, Get an invoice avec l'option Include sur Client rapatrie le compte concerné, puis Email an invoice envoie le document. Personne n'ouvre l'outil pour cliquer sur « envoyer ».

Troisième usage : le rapprochement bancaire. Get many bank transactions liste ce que le flux a ramené, Match payment to a bank transaction rattache une ligne au paiement correspondant. Les équipes qui encaissent en devises via Wise enchaînent souvent les deux dans la même exécution.

Les dépenses suivent la même logique. Create an expense accepte un Amount, un Vendor Name or ID et une Category Name or ID. Un justificatif capté dans une boîte mail finit enregistré au bon fournisseur, avec Billable coché quand le coût doit repartir sur une facture client.

Quand un endpoint de l'API Invoice Ninja ne fait pas partie du nœud, le nœud HTTP Request l'appelle directement et réutilise le même credential via l'authentification prédéfinie. Le workflow reste d'un seul tenant, sans deuxième jeu de clés à gérer.

Deux points à connaître avant de construire. Le credential suppose un compte Invoice Ninja sur un plan qui accepte les intégrations API, donc Pro ou Enterprise. Et chaque opération porte une option API Version, v4 ou v5, qui doit correspondre à l'instance visée par l'URL. Pour un comparatif de plateformes, l'Avis n8n creuse le sujet, et la passerelle comptable se traite plutôt du côté de Xero.

Connexion

Comment connecter Invoice Ninja à n8n ?

01
Générer un token API
Dans Invoice Ninja, direction Settings > Account Management > API Tokens, puis génère un token. Les intégrations API tournent sur les plans Pro et Enterprise : vérifie le plan du compte avant tout le reste, ça évite de chercher une erreur qui n'en est pas une. Copie le token dès qu'il s'affiche, c'est la seule valeur qui prouve qui appelle l'API.
02
Créer le credential dans n8n
Côté n8n, menu Credentials, puis ajoute un credential Invoice Ninja API. Trois champs comptent. URL prend l'une des URL par défaut quand Invoice Ninja héberge l'installation, ou l'adresse de ton instance si tu l'héberges toi-même. API Token reçoit la valeur copiée juste avant. Secret reste optionnel : ce champ n'existe que pour les utilisateurs de l'API v5.
03
Choisir une ressource et exécuter
Pose le nœud Invoice Ninja sur le canvas et sélectionne le credential dans la liste déroulante. Choisis une ressource, puis une opération, par exemple Client et Get many clients. Règle API Version sur la version de ton instance, v4 ou v5. Exécute l'étape seule : des enregistrements réels qui reviennent, c'est que le token, l'URL et la version sont d'accord.

Déclencheurs

Qu'est-ce qui déclenche un workflow Invoice Ninja ?

Invoice Ninja Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans Invoice Ninja. Il écoute 5 événements, listés ci-dessous par famille. Tu en choisis un ou plusieurs, tu actives le workflow : n8n enregistre le webhook (l'URL que Invoice Ninja appelle) sur ton compte.

Ce que tu vois dans n8n

Tous les événements, par famille

Une ligne par objet, une puce par action. L'événement à cocher dans le nœud s'écrit objet.action ; survole une puce pour lire quand il se déclenche.

create_client.*1

create_client.
- create_client

create_invoice.*1

create_invoice.
- create_invoice

create_payment.*1

create_payment.
- create_payment

create_quote.*1

create_quote.
- create_quote

create_vendor.*1

create_vendor.
- create_vendor

Notes de configuration

01Set up the Invoice Ninja TriggerLe nœud trigger est en version 2 et fonctionne par webhook, c'est-à-dire une URL que n8n enregistre auprès d'Invoice Ninja à l'activation du workflow. Chaque événement arrive ensuite en quelques secondes, sans polling, donc sans vérification répétée à intervalle fixe.

Le nœud trigger est en version 2 et fonctionne par webhook, c'est-à-dire une URL que n8n enregistre auprès d'Invoice Ninja à l'activation du workflow. Chaque événement arrive ensuite en quelques secondes, sans polling, donc sans vérification répétée à intervalle fixe.

Paramètres clés

Event : la création à écouter, parmi les 5 valeurs proposées par le nœud.
API Version : v4 ou v5, à aligner sur l'instance du credential.

Quand l'utiliser

dès que le départ du workflow appartient à l'outil de facturation et pas à une horloge. Un devis accepté à minuit, une dépense saisie un dimanche, un paiement enregistré pendant que l'équipe est déconnectée : l'exécution part quand même. Active d'abord le workflow, puis crée un enregistrement de test dans Invoice Ninja pour voir arriver la charge utile.

02Invoice CreatedAvec Event sur Invoice Created, le workflow démarre à chaque nouvelle facture dans Invoice Ninja, qu'elle vienne d'une saisie manuelle, d'un modèle récurrent ou d'une autre automatisation.

Avec Event sur Invoice Created, le workflow démarre à chaque nouvelle facture dans Invoice Ninja, qu'elle vienne d'une saisie manuelle, d'un modèle récurrent ou d'une autre automatisation.

Paramètres clés

Event : create_invoice, la seule valeur utile pour cette branche.

Cas d'usage

enchaîne Email an invoice juste derrière le trigger et le document part sans intervention. Autre montage : Get an invoice avec Include sur Client, puis archivage d'une copie là où la compta range ses pièces. La facturation reste la source de vérité, le workflow ne transporte que les conséquences.

Quand l'utiliser

choisis cet événement quand c'est le document qui compte, pas l'argent derrière. Une facture récurrente émise pendant la nuit arrive dans le workflow exactement comme une saisie manuelle : une seule branche traite les deux cas, et plus personne ne vérifie une liste au réveil. Pratique aussi pour archiver systématiquement, sans dépendre de la mémoire de quelqu'un.

03Payment CreatedPayment Created réagit à l'enregistrement d'un paiement dans Invoice Ninja. La valeur est create_payment, et c'est la branche qui referme la boucle d'une facture envoyée plusieurs jours plus tôt.

Payment Created réagit à l'enregistrement d'un paiement dans Invoice Ninja. La valeur est create_payment, et c'est la branche qui referme la boucle d'une facture envoyée plusieurs jours plus tôt.

Paramètres clés

Event : create_payment, déclenché à la création de l'enregistrement de paiement.
API Version : même valeur que sur le nœud qui tourne juste après.

Cas d'usage

poster une ligne dans le canal de l'équipe pour que personne ne relance un client qui a déjà payé. Ou enchaîner Get a payment avec Include sur Client pour récupérer le compte dans la même exécution, puis écrire le montant dans le suivi de trésorerie que le responsable finance consulte vraiment.

Quand l'utiliser

dès qu'un autre système doit connaître l'encaissement avant la clôture du mois. Garde la branche courte : une lecture, une écriture, un message, ça suffit presque toujours.

04Quote CreatedQuote Created démarre un workflow dès qu'un nouveau devis est enregistré dans Invoice Ninja, quel que soit le stade de la vente derrière.

Quote Created démarre un workflow dès qu'un nouveau devis est enregistré dans Invoice Ninja, quel que soit le stade de la vente derrière.

Paramètres clés

Event : create_quote, la seule valeur utile pour cette branche.

Cas d'usage

relire l'enregistrement avec Get a quote, ajouter client dans Include quand le compte compte, puis publier le résumé dans le canal où l'équipe commerciale suit les nouvelles affaires. Un montage plus court enchaîne Email a quote juste après le trigger, une fois qu'une étape de validation a donné son feu vert.

Quand l'utiliser

choisis cet événement quand c'est l'apparition du devis qui compte pour la suite, pas un changement de statut sur un devis existant. L'associer à une étape de validation évite qu'un brouillon parte chez le client avant relecture.

05Client Created and Vendor CreatedCes deux-là surveillent l'annuaire plutôt que les documents. Client Created part sur create_client, Vendor Created sur create_vendor, chacun sur son propre nœud trigger quand un workflow a besoin des deux.

Ces deux-là surveillent l'annuaire plutôt que les documents. Client Created part sur create_client, Vendor Created sur create_vendor, chacun sur son propre nœud trigger quand un workflow a besoin des deux.

Paramètres clés

Event : create_client ou create_vendor, selon le côté du registre concerné.

Cas d'usage

sur un nouveau client, lancer Get a client avec Include sur Invoices pour voir tout de suite si quelque chose traîne déjà sur le compte. Sur un nouveau fournisseur, préparer le terrain pour Create an expense, dont le champ Vendor Name or ID attend que ce fournisseur existe. Les deux gardent le CRM et la facturation sur la même liste de noms.

Quand l'utiliser

quand le vrai problème, ce sont les doublons. Un annuaire qui dérive coûte bien plus de temps plus tard que les 5 minutes passées à brancher la branche aujourd'hui.

Actions

Que sait faire le nœud Invoice Ninja ?

Le nœud Invoice Ninja expose 31 opérations sur 7 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

Matrice ressources × opérations
Ressource	Create	Get	Get Many	Delete	Email	Match Payment
Bank Transaction	✓	✓	✓	✓		✓
Client	✓	✓	✓	✓
Expense	✓	✓	✓	✓
Invoice	✓	✓	✓	✓	✓
Payment	✓	✓	✓	✓
Quote	✓	✓	✓	✓	✓
Task	✓	✓	✓	✓

Bank Transaction

5 opérations

Create a bank transaction

bank_transaction.create

Ce que tu vois dans n8n

Notes & cas d'usage

L'opération inscrit une ligne dans les transactions bancaires d'Invoice Ninja, pratique quand le mouvement vient d'ailleurs que d'un connecteur bancaire. Rien n'est obligatoire, tout se joue dans Additional Fields.

Paramètres clés

Amount : le montant du mouvement, souvent repris de l'étape précédente avec {{ $json.field }}.
Base Type : CREDIT pour un dépôt, DEBIT pour un retrait.
Bank Integration Name or ID : le compte concerné, choisi dans la liste ou fourni en identifiant via une expression.
Date et Description : la date du mouvement et le libellé qui figure sur le relevé.

Cas d'usage

rejouer un relevé exporté en lignes, une transaction par ligne, avant que quelqu'un attaque le rapprochement.

Delete a bank transaction

bank_transaction.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprimer une ligne tient à une seule valeur. L'opération efface la transaction bancaire dont tu donnes l'identifiant, et rien d'autre.

Paramètres clés

Bank Transaction ID : requis, l'identifiant de la ligne à retirer, généralement transmis par l'étape de listing sous la forme {{ $json.field }}.
API Version : v4 ou v5, selon l'instance visée par le credential.

Cas d'usage

un import lancé deux fois laisse le même mouvement en double. Place cette opération derrière l'étape qui repère le doublon, le flux reste propre sans que personne ouvre l'outil.

Get a bank transaction

bank_transaction.get

Ce que tu vois dans n8n

Notes & cas d'usage

Un identifiant entre, une transaction bancaire sort. L'opération récupère les données d'une seule ligne pour que la suite du workflow décide quoi en faire.

Paramètres clés

Bank Transaction ID : requis, l'identifiant de la ligne à lire.
API Version : v4 ou v5, la même sur tous les nœuds Invoice Ninja du workflow.

Cas d'usage

avant de rattacher une ligne à un paiement, la relire et laisser un nœud IF contrôler le montant et le libellé. Un mouvement douteux s'arrête là plutôt que d'atterrir sur une fiche client.

Get many bank transactions

bank_transaction.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Lister le flux bancaire s'accompagne du duo habituel d'interrupteurs, et ce sont eux qui décident de ce que le workflow voit vraiment.

Paramètres clés

Return All : coché, n8n enchaîne les pages de l'API et ramène toutes les transactions ; décoché, il s'arrête à Limit.
Limit : le nombre maximal de transactions renvoyées quand Return All reste décoché, utile pendant les tests.

Cas d'usage

une exécution mensuelle qui ramène tout le flux, regroupe les lignes par compte et dépose le résultat dans le tableau que le comptable ouvre à la clôture.

Match payment to a bank transaction

bank_transaction.matchPayment

Ce que tu vois dans n8n

Notes & cas d'usage

Le rapprochement se joue ici : l'opération relie une transaction bancaire à un paiement, et la ligne cesse d'être un mouvement orphelin dans le flux.

Paramètres clés

Bank Transaction ID : requis, la ligne à rapprocher.
Payment Name or ID : le paiement auquel la rattacher, choisi dans la liste ou fourni en identifiant via une expression.

Cas d'usage

après Get many bank transactions, un nœud Code apparie chaque encaissement au paiement qui lui correspond, puis cette opération applique l'appariement item par item.

Client

4 opérations

Create a client

client.create

Ce que tu vois dans n8n

Notes & cas d'usage

Une fiche client se construit à partir de blocs optionnels plutôt que d'un formulaire figé, d'où l'absence de champ obligatoire.

Paramètres clés

Contacts : le bloc répétable où First Name, Last Name, Email et Phone décrivent les personnes à facturer.
Billing Address et Shipping Address : les deux blocs d'adresse, avec Street Address, City, Postal Code et Country Code Name or ID.
Additional Fields : Client Name, VAT Number, Website, Private Notes et le reste du profil.

Cas d'usage

un deal signé dans le CRM crée le compte dans Invoice Ninja, contact compris, et la première facture n'attend pas une saisie manuelle.

Delete a client

client.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Le compte disparaît d'Invoice Ninja dès l'exécution, donc cette opération se place derrière une étape sûre de sa cible.

Paramètres clés

Client ID : requis, l'identifiant du compte à retirer.
API Version : v4 ou v5, la même valeur que partout ailleurs dans le workflow.

Cas d'usage

les comptes de test que tout le monde crée en branchant le credential. Un workflow de ménage les liste, filtre sur une convention de nommage, et cette opération les retire en une passe au lieu d'une dizaine de clics.

Get a client

client.get

Ce que tu vois dans n8n

Notes & cas d'usage

Lire un compte donne au workflow les détails que la charge utile du trigger ne transporte pas toute seule, et ça peut venir avec l'historique de facturation.

Paramètres clés

Client ID : requis, l'identifiant du compte à lire.
Include : sur Invoices, la réponse embarque aussi les factures du client, ce qui économise un second appel.

Cas d'usage

avant l'envoi d'une relance, récupérer le compte avec Include sur Invoices et laisser le workflow vérifier ce qui reste ouvert. Un client sans encours sort de la séquence.

Get many clients

client.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

L'annuaire client revient sous forme de liste, que tu peux resserrer avant même qu'elle atteigne le nœud suivant.

Paramètres clés

Return All : coché, tous les clients remontent page après page ; décoché, l'exécution s'arrête à Limit.
Status : Active, Archived ou Deleted, pour ne synchroniser que les comptes vivants.
Created At et Updated At : les filtres de date qui rendent une exécution incrémentale.

Cas d'usage

une synchro nocturne qui lit les clients modifiés depuis la veille et pousse les changements vers le CRM, au lieu de reparcourir tout le portefeuille.

Expense

4 opérations

Create an expense

expense.create

Ce que tu vois dans n8n

Notes & cas d'usage

Enregistrer un coût tient en un appel, et les 17 champs d'Additional Fields décident du niveau de détail qui arrive dans les comptes.

Paramètres clés

Amount : le montant dépensé.
Vendor Name or ID et Category Name or ID : qui a été payé et sous quelle rubrique, depuis la liste ou en identifiant via une expression.
Billable : coché quand le coût doit repartir sur un client.
Expense Date, Payment Type et Transaction Reference : quand, comment et sous quelle référence le règlement a eu lieu.

Cas d'usage

un justificatif extrait d'une boîte mail devient une dépense avec son fournisseur et sa catégorie déjà renseignés.

Delete an expense

expense.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Une dépense qui n'aurait jamais dû être enregistrée quitte les comptes ici, un enregistrement par exécution.

Paramètres clés

Expense ID : requis, l'identifiant du coût à retirer.
API Version : v4 ou v5, aligné sur l'instance derrière le credential.

Cas d'usage

une boîte de réception qui transfère deux fois le même justificatif crée le coût en double. Une branche de déduplication garde le premier enregistrement et envoie le second dans cette opération, pour que le mois se ferme sur le bon total.

Get an expense

expense.get

Ce que tu vois dans n8n

Notes & cas d'usage

Relire un coût unitaire donne au workflow une valeur à citer, à joindre ou à comparer plus loin.

Paramètres clés

Expense ID : requis, l'identifiant de la dépense à lire, couramment fourni sous la forme {{ $json.field }} depuis l'étape précédente.
API Version : v4 ou v5, comme le reste du workflow.

Cas d'usage

un générateur de rapport mensuel boucle sur une liste d'identifiants, lit chaque dépense une par une et assemble le détail derrière les totaux transmis à la direction.

Get many expenses

expense.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Les coûts reviennent en liste, et les deux interrupteurs ci-dessous décident si cette liste est complète ou juste un échantillon.

Paramètres clés

Return All : coché, n8n suit les pages de l'API jusqu'à la dernière dépense ; décoché, il s'arrête à Limit.
Limit : le nombre maximal de dépenses à ramener, réglage raisonnable pendant la construction du workflow.

Cas d'usage

une exécution de fin de mois qui lit toutes les dépenses, les additionne par catégorie dans un nœud Code et envoie la ventilation avant que le comptable la réclame.

Invoice

5 opérations

Create an invoice

invoice.create

Ce que tu vois dans n8n

Notes & cas d'usage

C'est ici qu'un document prend vie, avec ses lignes et ses 23 champs optionnels.

Paramètres clés

Invoice Items : le bloc répétable des lignes, chacune avec Description, Cost, Hours et Service.
Client Name or ID : le compte facturé, depuis la liste ou en identifiant via une expression.
Invoice Status : 1 pour Draft, 2 pour Sent.
Due Date, Tax Name 1 et Tax Rate 1 : l'échéance et la ligne de taxe portée par le document.
Email Invoice : coché, l'envoi par mail se fait dans le même appel.

Cas d'usage

transformer une affaire gagnée en brouillon qu'un humain relit avant départ.

Delete an invoice

invoice.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Un identifiant, une facture en moins dans Invoice Ninja.

Paramètres clés

Invoice ID : requis, l'identifiant du document à retirer.
API Version : v4 ou v5, cohérente avec l'instance du credential.

Cas d'usage

une automatisation partie de travers a créé toute une série de brouillons sur le mauvais compte un dimanche soir. Filtre la liste sur Created At via Get many invoices, vérifie-la à l'œil, puis n'envoie que ces identifiants-là dans cette opération.

Email an invoice

invoice.email

Ce que tu vois dans n8n

Notes & cas d'usage

L'envoi est une opération à part, distincte de la création : un document peut donc être relu d'abord, puis expédié plus tard par un autre workflow.

Paramètres clés

Invoice ID : requis, l'identifiant de la facture à envoyer.
API Version : v4 ou v5, selon l'instance.

Cas d'usage

un workflow du lundi lit les factures encore à l'état de brouillon, attend une validation dans l'outil de discussion, puis fait passer les identifiants validés dans cette opération. Rien ne part sans un accord, et personne n'ouvre l'outil pour cliquer.

Get an invoice

invoice.get

Ce que tu vois dans n8n

Notes & cas d'usage

Relire un document, c'est ce qui transforme la charge utile d'un trigger en matière exploitable, surtout quand les coordonnées du client comptent.

Paramètres clés

Invoice ID : requis, l'identifiant de la facture à lire.
Include : sur Client, la réponse ramène le client en même temps que la facture.

Cas d'usage

juste après le déclenchement sur create_invoice, lire le document avec Include sur Client pour que la notification nomme le compte au lieu d'afficher un identifiant nu.

Get many invoices

invoice.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

La bête de somme du poste client, parce que ses 7 options font arriver la liste déjà filtrée.

Paramètres clés

Client Status : All, Paid, Unpaid ou Overdue, le filtre sur lequel reposent la plupart des workflows de relance.
Return All : coché, toutes les factures correspondantes remontent page par page ; décoché, l'exécution s'arrête à Limit.
Invoice Number et Status : pour viser un document précis, ou écarter les enregistrements Archived et Deleted.

Cas d'usage

une exécution Overdue chaque lundi qui regroupe les factures par client et prépare une relance par compte, pas une par document.

Payment

4 opérations

Create a payment

payment.create

Ce que tu vois dans n8n

Notes & cas d'usage

Enregistrer un encaissement sur un document, c'est ce qui sort une facture de la liste des relances, et cette opération le fait en une étape.

Paramètres clés

Invoice Name or ID : le document réglé, depuis la liste ou en identifiant via une expression.
Amount : la somme reçue, qui peut différer du total de la facture sur un règlement partiel.
Payment Type : Bank Transfer, Cash, SEPA et le reste de la liste.
Transfer Reference : la référence bancaire, pour retrouver la ligne plus tard.

Cas d'usage

une notification de virement reçue d'une passerelle devient un paiement sur la bonne facture.

Delete a payment

payment.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Un encaissement saisi sur la mauvaise facture se corrige ici, en retirant l'enregistrement de paiement lui-même.

Paramètres clés

Payment ID : requis, l'identifiant du paiement à retirer.
API Version : v4 ou v5, la version utilisée par le reste du workflow.

Cas d'usage

un import qui a crédité deux fois la même facture laisse un document à découvert et un autre en trop. Retire l'enregistrement fautif avec cette opération, puis reconstruis le bon avec Create a payment dans la même exécution.

Get a payment

payment.get

Ce que tu vois dans n8n

Notes & cas d'usage

Un paiement unique revient avec son détail, et si besoin avec le compte auquel il appartient.

Paramètres clés

Payment ID : requis, l'identifiant du paiement à lire.
Include : sur Client, le client voyage avec le paiement dans la même réponse.

Cas d'usage

un message de remerciement qui nomme le client et le montant, construit juste après l'événement create_payment sans second appel sur le compte.

Get many payments

payment.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

L'historique des encaissements arrive en liste, filtrable sur les dates ou sur l'état des enregistrements.

Paramètres clés

Return All : coché, n8n parcourt toutes les pages de paiements ; décoché, l'exécution s'arrête à Limit.
Created At et Updated At : la paire de filtres de date qui transforme un rechargement complet en une exécution incrémentale, quotidienne ou hebdomadaire, bien plus légère à faire tourner.
Include : sur Client, chaque paiement porte son compte, ce qui évite une lecture par ligne.

Cas d'usage

un point de trésorerie quotidien listant les paiements de la veille avec le client sur chaque ligne, envoyé au responsable finance avant la réunion du matin.

Quote

5 opérations

Create a quote

quote.create

Ce que tu vois dans n8n

Notes & cas d'usage

L'opération écrit un nouveau devis dans Invoice Ninja, lignes comprises, et rend l'enregistrement créé au workflow.

Paramètres clés

Invoice Items : la collection répétable qui porte les lignes du devis, une entrée par Add Invoice Item.
Client Name or ID : tu choisis le client dans la liste, ou tu passes un identifiant par une expression, c'est-à-dire un bout de code comme {{ $json.field }} qui lit une valeur de l'item entrant.
Quote Status : deux valeurs proposées, 1 (Draft) et 2 (Sent).
Due Date : une date, à régler dans Additional Fields.

Cas d'usage

un formulaire commercial remplit les lignes et crée le devis en brouillon, pour qu'une personne le relise avant qu'il parte chez le client.

Delete a quote

quote.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprimer un devis ne demande qu'un identifiant. L'appel vise un seul enregistrement, d'où l'étape de contrôle qu'on place presque toujours devant.

Paramètres clés

Quote ID : l'identifiant requis du devis à supprimer. Un champ requis laissé vide bloque l'exécution du nœud, donc alimente-le par une expression du type {{ $json.field }} plutôt qu'à la main.
API Version : v4 ou v5, selon l'instance Invoice Ninja derrière le credential, l'identifiant de connexion enregistré une fois dans n8n.

Cas d'usage

les devis générés pendant un test se nettoient en une passe, au lieu d'être archivés un par un dans l'interface.

Email a quote

quote.email

Ce que tu vois dans n8n

Notes & cas d'usage

L'envoi au client tient dans une opération dédiée : le workflow désigne un devis, Invoice Ninja l'envoie par email. Ni gabarit à monter, ni nœud d'envoi intercalé.

Paramètres clés

Quote ID : l'identifiant requis du devis à envoyer, en général récupéré du nœud qui l'a créé ou lu, par exemple {{ $json.field }}.
API Version : le même choix v4 ou v5 que sur le reste du nœud.

Cas d'usage

un devis créé en début de workflow part chez le client dès qu'une étape de validation renvoie un feu vert.

Get a quote

quote.get

Ce que tu vois dans n8n

Notes & cas d'usage

Un devis, lu par son identifiant, avec les données qu'Invoice Ninja renvoie pour cet enregistrement. Pratique quand une branche a besoin du devis complet et pas seulement de son numéro.

Paramètres clés

Quote ID : requis, l'identifiant du devis à lire.
Include : la collection Options propose une valeur, client.

Cas d'usage

un événement Quote Created arrive, le workflow relit le devis avec client inclus, puis publie le détail dans le canal où l'équipe commerciale suit les affaires en cours.

Get many quotes

quote.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Celle-ci lit plusieurs devis d'un coup, ce qui fait tourner les workflows de reporting et d'export.

Paramètres clés

Return All : activé, n8n enchaîne les pages de l'API et ramène tous les devis ; désactivé, Limit fixe le nombre maximal d'items renvoyés.
Status : trois valeurs, active, archived et deleted.
Quote Number : une valeur texte de la collection Options, pour resserrer la lecture.
Created At et Updated At : des dates, dans la même collection.

Cas d'usage

un passage hebdomadaire récupère les devis active avec Return All, et les écrit dans le tableau que l'équipe commerciale consulte déjà.

Task

4 opérations

Create a task

task.create

Ce que tu vois dans n8n

Notes & cas d'usage

Le temps facturable trouve sa place ici : l'opération crée une tâche dans Invoice Ninja, avec ou sans les heures déjà consignées dessus.

Paramètres clés

Time Logs : la collection répétable des périodes enregistrées, une entrée par Add Time Log.
Client Name or ID et Project Name or ID : les deux viennent d'une liste déroulante et acceptent tous les deux un identifiant passé par expression quand la valeur arrive d'un nœud précédent.
Duration (Hours) : un nombre, à renseigner dans Additional Fields.

Cas d'usage

un ticket clôturé dans l'outil de support crée la tâche correspondante, projet renseigné, pour que les heures soient prêtes au moment de facturer.

Delete a task

task.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Les tâches s'accumulent vite dès qu'un workflow en crée tout seul. Cette opération en retire une, désignée par son identifiant.

Paramètres clés

Task ID : requis. C'est l'identifiant Invoice Ninja de la tâche, pas sa description, et une valeur vide bloque le nœud avant l'appel.
API Version : v4 ou v5, selon l'instance visée par le credential.

Cas d'usage

une tâche en double repérée par une étape de comparaison disparaît aussitôt, pour que les heures ne soient comptées qu'une fois sur la facture.

Get a task

task.get

Ce que tu vois dans n8n

Notes & cas d'usage

Lire une seule tâche donne au workflow ce qu'Invoice Ninja garde dessus. C'est le premier geste habituel avant qu'une branche décide de la suite.

Paramètres clés

Task ID : requis, l'identifiant de la tâche à lire, souvent passé en {{ $json.field }} depuis le nœud d'avant.
Include : une valeur là aussi, client.

Cas d'usage

avant de transformer une tâche en ligne de facturation, le workflow la relit avec client inclus et confronte les valeurs à ce que le chef de projet a saisi.

Get many tasks

task.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Lecture en masse des tâches, pour les workflows qui comptent les heures plutôt que de les traiter une par une.

Paramètres clés

Return All : activé, n8n suit les pages de l'API jusqu'à avoir lu toutes les tâches ; désactivé, Limit fixe le nombre maximal de tâches renvoyées.
Include : la collection Options propose client.
API Version : v4 ou v5.

Cas d'usage

en fin de mois, le workflow lit toutes les tâches avec Return All, regroupe les heures par client, et passe les totaux au nœud qui prépare la facturation.

Besoin d'aide

Besoin d'aide pour automatiser Invoice Ninja avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Invoice Ninja et n8n, les questions qui reviennent

01L'intégration Invoice Ninja n8n est-elle gratuite ?

Oui du côté n8n. Le nœud Invoice Ninja et le trigger Invoice Ninja sont livrés avec n8n : rien à installer, aucun coût supplémentaire, que les workflows tournent sur n8n Cloud ou sur une instance auto-hébergée en Community Edition sous licence Sustainable Use. Un workflow se comporte de la même façon dans les deux cas. Côté Invoice Ninja, la réponse est différente : les intégrations API sont disponibles sur les plans Pro et Enterprise. Un compte sur un plan inférieur ne pourra pas générer le token dont le credential a besoin. Vérifie le plan d'abord, construis ensuite.

02Quels credentials faut-il pour connecter Invoice Ninja à n8n ?

Un seul credential, basé sur une clé API, et il sert au nœud comme au trigger. Il contient trois choses. Une URL, l'une des adresses par défaut quand Invoice Ninja héberge l'installation, ou l'adresse de ton propre serveur en auto-hébergement. Un API Token, généré dans Settings, puis Account Management, puis API Tokens. Et un Secret optionnel, champ disponible uniquement pour les utilisateurs de l'API v5. Une fois enregistré dans le menu Credentials, ce credential apparaît dans la liste déroulante de tous les nœuds Invoice Ninja ajoutés ensuite : aucune configuration à refaire workflow par workflow.

03Quelles limites a le nœud Invoice Ninja dans n8n ?

Le nœud expose 31 opérations réparties sur 7 objets, ce qui couvre le cycle de facturation quotidien. Deux limites méritent d'être anticipées. La pagination d'abord : sur toute opération de listing, il faut cocher Return All pour que n8n parcoure toutes les pages de l'API, sinon l'exécution s'arrête au nombre fixé par Limit. Ensuite, quand un endpoint de l'API Invoice Ninja ne fait pas partie de ces 31 opérations, le nœud HTTP Request l'appelle directement en réutilisant le même credential via l'authentification prédéfinie, donc sans second token. Dernier point, chaque opération porte une option API Version, v4 ou v5, à aligner sur l'instance.

04Le trigger Invoice Ninja réagit-il en temps réel ?

Oui. Le trigger fonctionne par webhook, c'est-à-dire une URL que n8n enregistre auprès d'Invoice Ninja à l'activation du workflow. Invoice Ninja appelle ensuite cette URL à chaque événement : l'exécution démarre en quelques secondes, sans polling, donc sans vérification répétée à intervalle fixe. Cinq événements sont disponibles, un par création d'enregistrement : Client Created, Invoice Created, Payment Created, Quote Created et Vendor Created. Le paramètre Event désigne celui qu'un nœud trigger donné écoute. Le nœud trigger est en version 2 et porte la même option API Version que le nœud principal, à garder sur la même valeur.

05n8n ou Make pour Invoice Ninja ?

Ça dépend de l'endroit où les workflows doivent vivre et de la façon dont tu veux les payer. Make est une plateforme d'automatisation hébergée, sans option d'auto-hébergement, facturée à l'opération : pratique pour une équipe qui ne veut rien administrer. n8n s'auto-héberge avec Docker ou npm, ou s'utilise sur n8n Cloud, et le workflow reste identique dans les deux cas. Sur des données de facturation, ce choix d'hébergement tranche souvent : un registre de factures qui doit rester sur ton serveur oriente vers n8n auto-hébergé. La logique visuelle diffère aussi, donc monte le même petit workflow des deux côtés et garde celui que ton équipe lit le plus vite.

Générer un token API

Créer le credential dans n8n

Choisir une ressource et exécuter

Tous les événements, par famille

Notes de configuration

Besoin d'aide pour automatiser Invoice Ninja avec n8n ?