Automatise Xero avec n8n : 8 opérations sur 2 ressources

Pourquoi automatiser

À quoi sert l'intégration Xero n8n ?

L'intégration Xero n8n, c'est un nœud livré avec n8n qui parle à l'API comptable de Xero à ta place. Il couvre 8 opérations réparties sur 2 ressources : Contact et Invoice. Créer un contact, en lire un, en lister plusieurs, en modifier un, et les quatre mêmes gestes côté factures. Chaque appel cible une organisation Xero précise, choisie dans le nœud, donc aucun risque d'écrire dans les mauvais livres.

Premier terrain de jeu : la facturation récurrente. Une liste d'abonnements dans Google Sheets, un passage par invoice.create avec Type sur ACCREC, et le lot de factures clients du mois existe en quelques secondes d'exécution. Beaucoup d'équipes laissent Status sur DRAFT le temps d'un contrôle humain, puis repassent avec invoice.update pour tout basculer en AUTHORISED.

Deuxième usage, moins glamour mais très demandé : les factures fournisseurs. Une pièce jointe arrive dans Gmail, un nœud d'extraction sort le montant et le fournisseur, et invoice.create enregistre une facture d'achat avec Type sur ACCPAY. Si le fournisseur n'existe pas encore, contact.create le crée juste avant et renvoie l'identifiant que la facture attend.

Troisième usage : le pilotage. invoice.getAll avec Return All activé enchaîne les pages de l'API jusqu'à la dernière facture, ce qui permet de reconstituer un encours complet chaque matin et d'en poster le résumé dans Slack. Le paramètre Statuses restreint le lot aux factures autorisées, et Where prend le relais quand le filtre voulu n'a pas de champ dédié.

Il faut aussi savoir où le nœud s'arrête. Contacts et factures, rien d'autre : les paiements, les avoirs, les écritures bancaires et les rapports n'ont aucune opération ici. Le nœud HTTP Request les atteint quand même, puisqu'il appelle n'importe quel endpoint de l'API Xero en réutilisant le même credential via l'authentification prédéfinie. Autre limite structurante, l'absence de trigger Xero : un déclenchement à heure fixe passe par un Schedule Trigger, un déclenchement à l'événement par un nœud Webhook, c'est-à-dire une URL que n8n expose et qu'un autre service appelle.

Si le choix de l'outil comptable n'est pas encore figé, le nœud Quickbooks joue dans la même catégorie avec d'autres ressources. Et si c'est n8n qui est nouveau pour toi, la Formation n8n déroule credentials, expressions et gestion d'erreur avant de brancher un workflow sur une compta en production.

Connexion

Comment connecter Xero à n8n ?

01
Créer une application custom connection chez Xero
Direction My Apps, dans le portail développeur de Xero, pour créer une application OAuth2 de type custom connection. Choisis Web app comme Integration Type, puis renseigne dans Company or Application URL l'adresse de ton serveur n8n ou de son reverse proxy, qui ressemble à https://ton-compte.app.n8n.cloud/ sur l'offre hébergée. Petit piège à connaître tout de suite : Xero refuse les noms d'application qui contiennent n8n.
02
Faire correspondre l'URL de redirection
Dans n8n, ouvre le menu Credentials et crée un credential Xero. Un credential, c'est le bloc d'identifiants que tu configures une fois et que tous tes workflows réutilisent ensuite. Il affiche une OAuth Redirect URL : recopie-la côté Xero comme OAuth 2.0 redirect URI, enregistre l'application, puis ramène dans n8n le Client ID et le Client Secret qu'elle a générés.
03
Ajouter les scopes et choisir l'organisation
Les scopes délimitent ce que la connexion a le droit de toucher. Ajoute accounting.contacts et accounting.transactions à l'application pour couvrir tout ce que sait faire le nœud, puis termine l'autorisation OAuth2 depuis n8n. De retour dans le nœud, la liste Organization Name or ID affiche les organisations Xero accessibles, et ce champ est requis sur les 8 opérations.

Actions

Ce que le nœud Xero sait faire

Le nœud Xero expose 8 opérations sur 2 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	Update
Contact	✓	✓	✓	✓
Invoice	✓	✓	✓	✓

Contact

4 opérations

01

Create a contact

contact.create

Ce que tu vois dans n8n

Notes & cas d'usage

Crée une fiche client ou fournisseur dans Xero et renvoie son identifiant, celui dont les opérations suivantes ont besoin.

Paramètres clés

Organization Name or ID : l'organisation Xero dans laquelle la fiche est écrite, choisie dans la liste ou construite par expression, par exemple {{ $json.orgId }}.
Name : le nom complet de la personne ou de la société, seul champ descriptif exigé par Xero.
Additional Fields : la collection qui regroupe Email, Tax Number ou Default Currency, soit 15 champs facultatifs.

Cas d'usage

un nouveau client signé dans le CRM arrive en compta sans ressaisie.

02

Get a contact

contact.get

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère une fiche précise avec tout son contenu : adresses, coordonnées bancaires, comptes par défaut.

Paramètres clés

Organization Name or ID : les livres dans lesquels chercher, requis ici comme partout ailleurs.
Contact ID : l'identifiant Xero de la fiche, jamais son nom affiché. Il vient en général du nœud précédent sous la forme {{ $json.ContactID }}.

Cas d'usage

vérifier l'adresse de facturation juste avant d'envoyer un document, plutôt que de faire confiance à une copie stockée ailleurs.

03

Get many contacts

contact.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Liste les contacts de l'organisation et sort un item n8n par fiche.

Paramètres clés

Return All : coché, n8n parcourt toutes les pages jusqu'au dernier contact ; décoché, Limit fixe le nombre de fiches rapportées.
Include Archived : décide si les contacts passés en ARCHIVED remontent avec les actifs.
Where et Order By : une condition de filtrage et l'élément qui sert à trier le résultat.

Cas d'usage

un contrôle trimestriel qui repère les fiches sans numéro de TVA avant la déclaration.

04

Update a contact

contact.update

Ce que tu vois dans n8n

Notes & cas d'usage

Modifie une fiche existante. Seuls les champs renseignés partent vers Xero, le reste de la fiche ne bouge pas.

Paramètres clés

Contact ID : désigne la fiche à corriger, sans lui l'opération ne sait pas sur quoi travailler.
Update Fields : 16 champs facultatifs, dont Name, Account Number, Bank Account Details et Contact Status.
Contact Status : la valeur GDPRREQUEST marque une fiche visée par une demande d'effacement.

Cas d'usage

archiver d'un coup les fournisseurs inactifs repérés par l'opération précédente.

Invoice

4 opérations

05

Create an invoice

invoice.create

Ce que tu vois dans n8n

Notes & cas d'usage

Émet une facture et renvoie son identifiant Xero ainsi que son numéro.

Paramètres clés

Type : ACCREC pour une facture de vente, ACCPAY pour une facture d'achat. Aucune valeur par défaut, le choix est obligatoire.
Contact ID : le tiers concerné, souvent l'identifiant renvoyé par une opération contact juste avant.
Line Items : chaque ligne porte une Description, une Quantity et un Unit Amount.
Status : DRAFT garde la facture hors du journal, AUTHORISED la valide.

Cas d'usage

transformer un bon de commande validé en facture datée du jour.

06

Get an invoice

invoice.get

Ce que tu vois dans n8n

Notes & cas d'usage

Ramène une facture unique, avec ses lignes, ses totaux et son statut du moment.

Paramètres clés

Organization Name or ID : l'organisation qui détient la facture, prise dans la liste ou calculée par expression.
Invoice ID : l'identifiant technique Xero, à ne pas confondre avec le numéro de facture lisible imprimé sur le document.

Cas d'usage

un agent de support consulte l'état réel d'une facture pendant l'appel du client, sans ouvrir Xero.

07

Get many invoices

invoice.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie un lot de factures, prêt à être filtré, totalisé ou exporté par les nœuds suivants.

Paramètres clés

Return All : décoché par défaut, et c'est alors Limit qui plafonne le lot. Coché, n8n demande les pages suivantes jusqu'à épuisement du journal.
Statuses : sélection multiple parmi DRAFT, SUBMITTED et AUTHORISED.
Created By My App : limite le résultat aux factures créées par ta propre connexion.

Cas d'usage

alimenter chaque lundi une balance âgée dans un tableur.

08

Update an invoice

invoice.update

Ce que tu vois dans n8n

Notes & cas d'usage

Retouche une facture déjà enregistrée dans Xero, statut compris.

Paramètres clés

Invoice ID : la facture à modifier, champ requis.
Update Fields : 15 champs facultatifs, parmi lesquels Due Date, Reference, Currency Rate et Line Items.
Send To Contact : marque la facture comme envoyée dans Xero, uniquement sur une facture déjà approuvée.

Cas d'usage

basculer en AUTHORISED un lot de brouillons une fois le contrôle du responsable passé.

Besoin d'aide

Besoin d'aide pour automatiser Xero avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Xero et n8n, les questions qui arrivent ensuite

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

Oui du côté de n8n. Le nœud Xero est livré avec n8n : rien à installer, aucun module à acheter, et le comportement est identique sur n8n Cloud et sur une instance auto-hébergée en Docker ou npm, sous la Community Edition et sa licence Sustainable Use. Ce que coûte ton abonnement Xero est une autre histoire, elle dépend de ton contrat avec l'éditeur. Le vrai coût de l'intégration, c'est le temps de mise en place : une application custom connection dans le portail développeur, un credential dans n8n, et tous les workflows suivants le réutilisent.

02Quels credentials faut-il pour connecter Xero à n8n ?

Un credential OAuth2, et c'est la seule méthode proposée. Tu crées une application custom connection dans le portail développeur de Xero, qui génère un Client ID et un Client Secret à coller dans n8n. L'application doit être déclarée en Web app, son champ Company or Application URL pointe vers ton serveur n8n, et l'OAuth Redirect URL affichée par n8n doit figurer côté Xero comme redirect URI. Ajoute les scopes accounting.contacts et accounting.transactions pour couvrir tout le nœud. Un détail piège beaucoup de monde : Xero refuse les noms d'application contenant n8n.

03Quelles sont les limites du nœud Xero dans n8n ?

Il couvre 2 ressources et 8 opérations, pas une de plus. Contacts et factures se créent, se lisent, se listent et se modifient, mais rien ne se supprime, et les paiements, avoirs, écritures bancaires ou rapports n'ont aucune opération dédiée. Pour ces cas, le nœud HTTP Request appelle n'importe quel endpoint de l'API Xero en réutilisant le même credential via l'authentification prédéfinie, donc sans seconde application à déclarer. L'autre limite se cache dans les listes : avec Return All décoché, seuls les résultats jusqu'à Limit reviennent, et un export que tu croyais complet ne l'est pas.

04Le nœud Xero réagit-il en temps réel ?

Non, parce qu'il n'existe pas de nœud trigger Xero dans n8n. Rien ne réveille un workflow depuis Xero, c'est donc à toi de choisir le point de départ. Le Schedule Trigger lance le workflow à intervalle fixe et va lire ce qui a changé, ce qui convient aux exports de nuit et aux rapprochements quotidiens. Le nœud Webhook, lui, expose une URL que n8n met à disposition et qu'un autre service appelle au moment où l'événement se produit, par exemple un outil de commande qui pousse une vente vers la compta. Le trigger d'un autre outil fait aussi très bien l'affaire.

05n8n ou Make pour Xero ?

Ça dépend d'où doit tourner le workflow et de comment tu veux payer. Make est une plateforme hébergée, sans auto-hébergement, facturée à l'opération : un traitement qui boucle sur un long journal de factures coûte de plus en plus cher à mesure que le volume monte. n8n existe aussi en version hébergée, mais il peut s'auto-héberger, ce qui garde les données comptables sur une infrastructure que tu maîtrises et sort le compteur d'opérations de l'équation. Les deux offrent un éditeur visuel. En résumé honnête : Make démarre plus vite, n8n prend l'avantage dès que le volume, la maîtrise des données ou les appels API sur mesure entrent en jeu.

Créer une application custom connection chez Xero

Faire correspondre l'URL de redirection

Ajouter les scopes et choisir l'organisation

Besoin d'aide pour automatiser Xero avec n8n ?