Intégration ERPNext n8nAutomatiser ERPNext avec n8n.
Un seul nœud peut-il piloter tout un ERP ? L'intégration ERPNext n8n expose une ressource, Document, et 5 opérations dessus, de quoi créer, lire, modifier et supprimer n'importe quel DocType de ton instance. Aucun nœud trigger n'est fourni : c'est un planning ou un webhook qui lance le workflow.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
Que fait vraiment l'intégration ERPNext n8n ?
L'intégration ERPNext n8n, c'est un nœud qui parle à l'API d'ERPNext avec une clé API et son secret. Il expose une seule ressource, Document, et 5 opérations dessus : créer, supprimer, récupérer, lister et mettre à jour. Comme ERPNext range presque tous ses objets sous forme de DocType, ces 5 opérations couvrent bien plus que 5 types d'enregistrement.
Premier terrain de jeu : la saisie. Une ligne ajoutée dans un onglet Google Sheets, un formulaire de site qui appelle un webhook (une URL que n8n expose et qu'un service extérieur vient frapper), et le workflow finit par document.create qui écrit un Customer dans ERPNext. La collection Properties se remplit champ par champ, et ERPNext renvoie le nom du document qu'il vient d'attribuer.
Deuxième terrain : les exports. document.getAll avec Return All activé enchaîne les pages de l'API et ramène tous les documents d'un DocType, pendant que Field Names or IDs réduit la réponse aux colonnes qui servent vraiment. Le résultat part dans un mail via Gmail, ou vers une feuille partagée avec la compta.
Troisième terrain : garder ERPNext aligné sur les outils voisins. Une écriture passée dans Xero ou dans Quickbooks alimente document.update, qui ne touche que les propriétés listées et laisse le reste de la fiche intact.
Quand basculer sur HTTP Request ? Dès que tu sors du document. Le nœud gère une ressource, Document, et rien d'autre. Lancer un rapport ou appeler une méthode serveur, ça n'y est pas. Le nœud HTTP Request, lui, appelle n'importe quel endpoint de l'API et réutilise le même credential ERPNext via l'authentification prédéfinie. Pas de deuxième clé à gérer.
Deux limites à connaître avant de construire. ERPNext n'a pas de nœud trigger dans n8n : le workflow démarre ailleurs, avec un Schedule Trigger à intervalle fixe, un Webhook n8n appelé par un service tiers, ou le trigger d'un autre outil. Et créer, récupérer, modifier ou supprimer traitent un document par item, donc un traitement en masse passe par une boucle sur les items. Si n8n est nouveau pour toi, la Formation n8n pose ces bases.
Comment connecter ERPNext à n8n ?
- 01
Générer la clé API et son secret
Dans ERPNext, va dans Settings, puis My Settings, puis API Access, et génère une API Key. L'API Secret est produit au même moment et affiché une seule fois : copie les deux avant de quitter l'écran. La clé hérite des droits du compte utilisateur auquel elle appartient, ce qui reste la façon la plus simple de limiter ce que tes workflows peuvent toucher. Un System Manager peut aussi générer des clés pour d'autres utilisateurs.
- 02
Indiquer où tourne ton ERPNext
Le credential réclame un Environment. En hébergement cloud, tu donnes ton Subdomain et tu choisis un Domain entre
erpnext.cometfrappe.cloud. En auto-hébergement, tu donnes le Domain complet sur lequel ERPNext répond. Reste l'option Ignore SSL Issues, qui laisse n8n se connecter quand la validation du certificat SSL n'est pas disponible. - 03
Enregistrer une fois, réutiliser partout
Un credential se crée une seule fois dans le menu Credentials de n8n, puis il apparaît dans la liste déroulante de chaque nœud ERPNext que tu ajoutes, sur n8n Cloud comme sur une instance auto-hébergée. Le même credential alimente aussi un nœud HTTP Request via l'authentification prédéfinie : c'est comme ça qu'on atteint les endpoints absents du nœud sans stocker une deuxième copie de la clé.
Ce que le nœud ERPNext sait faire
Le nœud ERPNext expose 5 opérations sur 1 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
Document
5 opérationsCreate a document
document.createCe que tu vois dans n8n
Notes & cas d'usage
Choisis un type d'enregistrement, décris ses champs, et n8n écrit un nouveau document dans ERPNext. La réponse contient le nom du document attribué par ERPNext, que tu réutilises dans la suite du workflow.
Paramètres clés
- DocType Name or ID : le type d'enregistrement à créer, pris dans la liste que n8n charge depuis ton instance ou posé par une expression comme
{{ $json.docType }}. Le placeholder afficheCustomer. - Properties : une entrée par champ à remplir, ajoutée avec Add Property. Ce que tu laisses de côté garde ce que le DocType prévoit.
Delete a document
document.deleteCe que tu vois dans n8n
Notes & cas d'usage
Supprime définitivement un enregistrement d'ERPNext. Rien ne revient à part la confirmation, donc ce que tu veux garder se met de côté dans un nœud placé avant.
Paramètres clés
- DocType Name or ID : le type de l'enregistrement visé, puisqu'un nom n'est unique qu'à l'intérieur de son propre type.
- Document Name : le nom, c'est-à-dire l'identifiant, du document à supprimer, souvent repris d'une étape précédente avec
{{ $json.name }}.
Get a document
document.getCe que tu vois dans n8n
Notes & cas d'usage
Lit un enregistrement et passe l'ensemble de ses champs au nœud suivant. Pratique dès qu'un workflow connaît un identifiant mais pas le détail qui va avec.
Paramètres clés
- DocType Name or ID : le type d'enregistrement à lire, choisi dans la liste ou passé en expression.
- Document Name : le nom, c'est-à-dire l'identifiant, du document à récupérer.
Get many documents
document.getAllCe que tu vois dans n8n
Notes & cas d'usage
Liste les documents d'un type au lieu d'en chercher un par son nom. Ici, aucun paramètre n'est obligatoire : c'est l'opération à dégainer quand tu explores une instance.
Paramètres clés
- DocType Name or ID : le type à lister, avec
Customercomme placeholder. - Return All : coché, n8n enchaîne les pages de l'API jusqu'au dernier document ; décoché, il s'arrête à Limit.
- Limit : le nombre maximal de documents renvoyés quand Return All est décoché.
- Field Names or IDs : la liste des champs à renvoyer, séparés par des virgules, par exemple
name,country, plutôt que toutes les colonnes. - Filters : des propriétés personnalisées ajoutées une à une pour restreindre la liste.
Update a document
document.updateCe que tu vois dans n8n
Notes & cas d'usage
Modifie un enregistrement existant sur place. Seules les propriétés listées bougent, donc la mise à jour partielle est le cas normal, pas l'exception.
Paramètres clés
- DocType Name or ID : le type de l'enregistrement à modifier.
- Document Name : le nom, c'est-à-dire l'identifiant, du document concerné.
- Properties : les champs à écraser, ajoutés avec Add Property. Laisse la collection vide et rien ne change.
Besoin d'aide pour automatiser ERPNext avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.
