Intégration Zoho CRM n8nAutomatiser Zoho CRM avec n8n.

La fiche société apparaît dans Zoho CRM et le nœud renvoie son identifiant aux étapes suivantes.

• Account Name : le seul champ obligatoire, souvent {{ $json.company }} repris du formulaire ou du tableur qui a lancé l'exécution.
• Additional Fields : 17 champs optionnels, dont Industry, Phone, Website, Annual Revenue et un groupe Billing Address.

Le nom du compte sert de clé : une fiche qui le porte déjà est mise à jour, sinon Zoho CRM en crée une. Pas besoin d'une recherche en amont.

• Account Name : la valeur qui arbitre entre création et mise à jour, donc celle que ton outil source considère comme unique.
• Additional Fields : les mêmes 17 champs optionnels, écrits dans les deux cas.

Un champ, une suppression. Le nœud transmet la demande à Zoho CRM et passe le résultat à la suite du workflow.

• Account ID : l'identifiant du compte à supprimer, visible à la fin de l'URL de la fiche dans Zoho CRM, ou récupéré d'un nœud précédent avec {{ $json.id }}.

Il arrive qu'un workflow n'ait qu'un identifiant en main. Cette opération le retransforme en fiche société complète avant toute décision.

• Account ID : l'identifiant du compte à récupérer, la même valeur qu'à la fin de l'URL.

La liste des sociétés remonte en lot, page après page si tu le demandes.

• Return All : coché, n8n enchaîne toutes les pages de comptes ; décoché, Limit fixe combien de fiches reviennent.
• Options : Territory ID avec Include Child restreint l'export à un territoire et à ceux qui en dépendent, Approved ne garde que les fiches approuvées.

Corrections et enrichissement passent par là : la fiche garde son identifiant, seuls les champs listés changent. Rien d'autre n'est touché, donc une donnée saisie à la main par un commercial survit au passage.

• Account ID : le compte à modifier.
• Update Fields : 18 champs, dont Account Name lui-même, Employees, Annual Revenue et Website.

Côté personnes, cette fois. L'opération écrit une fiche contact dans Zoho CRM et retourne son identifiant.

• Last Name : le seul champ exigé par Zoho CRM ; vide, il bloque l'exécution du nœud.
• Additional Fields : 21 champs, dont Email (Primary), First Name, Title (la fonction occupée dans l'entreprise), Department et Mobile.

C'est l'email qui tranche. Si un contact porte déjà l'adresse, Zoho CRM met sa fiche à jour, sinon il en ouvre une nouvelle.

• Email (Primary) : rangé dans Additional Fields, il sert de clé de rapprochement pour l'upsert.
• Last Name : toujours obligatoire, même quand l'adresse existe déjà dans le CRM.

Demandes d'effacement et doublons résiduels finissent ici, une fiche par exécution.

• Contact ID : l'identifiant du contact à supprimer, lu le plus souvent dans une recherche précédente ou stocké à côté de la personne dans ta propre base.

Un identifiant en entrée, une fiche personne complète en sortie. Récupérer une seule fiche garde la suite du workflow honnête : ce qui circule ensuite est ce que Zoho CRM contient à l'instant, pas ce qu'un export gardait en mémoire.

• Contact ID : l'identifiant du contact à récupérer.

Des segments entiers du carnet d'adresses remontent d'un coup.

• Return All : activé pour une extraction complète, désactivé pour s'arrêter à Limit quand un échantillon suffit à tester la branche.
• Options : Fields limite la charge aux colonnes réellement utilisées, Sort By et Sort Order décident de l'ordre d'arrivée.

Même personne, nouvelles valeurs. L'identifiant ne bouge pas et seuls les champs listés sont réécrits, ce qui évite d'écraser le reste de la fiche au passage.

• Contact ID : le contact à modifier.
• Update Fields : 23 champs, dont Email (Primary), Phone, Title, Department et Last Name.

Une opportunité s'ouvre dans le pipeline. Deux champs sont obligatoires, dont l'étape : aucune affaire ne se retrouve sans place.

• Deal Name : le libellé que l'équipe commerciale lira dans la vue pipeline.
• Stage Name or ID : choisis une étape dans la liste que n8n charge, ou passe un identifiant par une expression.
• Additional Fields : Amount, Closing Date, Next Step et Probability, un pourcentage écrit en clair (12 pour 12 %).

Le rapprochement se joue sur le nom de l'affaire : une opportunité qui le porte déjà est mise à jour, sinon Zoho CRM en ouvre une nouvelle.

• Deal Name : il fait aussi office de clé, donc mieux vaut y coder une référence stable, un numéro de dossier par exemple.
• Stage Name or ID : exigé dans les deux cas, il faut donc fournir une étape même quand l'affaire existe déjà.

Les pipelines se polluent vite, par des tests comme par des erreurs. Cette opération retire une opportunité de Zoho CRM.

• Deal ID : l'identifiant de l'affaire à supprimer, conservé depuis le nœud qui l'a créée ou issu d'un Get Many précédent.

Lire une opportunité seule donne au workflow son état du jour, avant toute réécriture. C'est la parade quand plusieurs branches peuvent toucher la même affaire.

• Deal ID : l'identifiant de l'affaire à récupérer.

Le pipeline arrive sous forme de données, pas de capture d'écran.

• Return All : coché pour tout le pipeline ; décoché, Limit décide du nombre d'affaires renvoyées.
• Options : Sort By et Sort Order font remonter les plus récentes ou les plus grosses, Fields réduit chaque affaire aux colonnes utiles au rapport.

Changement d'étape, montant corrigé, date repoussée : tout cela passe par cette opération. L'affaire conserve son identifiant, donc son historique reste attaché.

• Deal ID : l'affaire à modifier.
• Update Fields : 12 champs, dont Stage Name or ID, Amount, Closing Date et Probability.

La facture se monte depuis le workflow, lignes de produits comprises.

• Subject : obligatoire, c'est l'intitulé de la facture, le seul champ que le nœud refuse de laisser vide.
• Products : une entrée par ligne, avec Product Name or ID, Quantity, Unit Price et Tax.
• Account Name or ID : rattache la facture à une société, aux côtés d'Invoice Date, Due Date et Status.

Zoho CRM compare les sujets : une facture qui porte déjà celui-ci est mise à jour, sinon un nouveau document est créé.

• Subject : clé de rapprochement et intitulé à la fois, donc une référence de commande vaut mieux qu'un libellé passe-partout.
• Products : les lignes sont écrites dans les deux cas, chacune avec ses Quantity, Unit Price et Total.

Les brouillons créés par erreur n'ont pas à être nettoyés à la main. Une seule facture part à chaque exécution, ce qui rend la branche facile à relire six mois plus tard.

• Invoice ID : l'identifiant de la facture à supprimer, renvoyé par l'opération qui l'a créée.

Un document, récupéré par son identifiant, dans l'état où Zoho CRM le conserve. Lire avant d'écrire évite qu'un workflow de facturation travaille sur une copie périmée.

• Invoice ID : l'identifiant de la facture à récupérer.

Les factures reviennent en liste, exactement ce dont une routine de relance a besoin.

• Return All : coché, n8n enchaîne les pages de factures ; décoché, Limit borne le lot pour garder un test léger.
• Options : Fields réduit chaque facture aux quelques colonnes utiles au rappel, Sort By et Sort Order font remonter les plus anciennes.

Statut et totaux bougent pendant la vie d'un document : c'est ici que le workflow les réécrit. La facture garde son identifiant, donc les liens déjà envoyés restent valables.

• Invoice ID : la facture à modifier.
• Update Fields : 19 champs, dont Status, Due Date, Invoice Number, Grand Total et la liste Products elle-même.

L'opération crée un prospect dans le module Lead et renvoie son identifiant, que les nœuds suivants réutilisent pour le modifier ou le supprimer.

• Company : l'entreprise du prospect, exigée par Zoho même pour un indépendant, le plus souvent remplie par une expression (une référence à la donnée qui entre dans le nœud) du type {{ $json.company }}.
• Last Name : le nom de famille, requis lui aussi ; laissé vide, il bloque l'exécution.
• Additional Fields : 23 champs facultatifs à ajouter un par un, dont Email, Phone, Lead Source et Lead Status.

Le rapprochement se fait sur l'adresse email : si un prospect la porte déjà, Zoho met à jour sa fiche, sinon il en crée une. Une seule opération, là où il faudrait sinon une recherche et un aiguillage.

• Company et Last Name : requis, comme pour une création simple.
• Email : rangé dans Additional Fields, c'est lui qui porte la correspondance. Une fiche existe avec cet email, elle est mise à jour ; sinon une nouvelle est créée.

Suppression sèche du prospect dans Zoho CRM. Le nœud ne demande aucune confirmation, donc le garde-fou se met en amont, dans le workflow.

• Lead ID : l'identifiant du prospect à supprimer, pas son nom ni son email. Il vient d'une étape Get Many placée avant, ou du nœud de création, par exemple {{ $json.id }}.

Récupérer un prospect donne ses valeurs actuelles, celles de la base, pas celles que le formulaire avait envoyées il y a trois semaines.

• Lead ID : l'identifiant du prospect à lire. Zoho le renvoie à la création, et il circule aussi dans la sortie d'une étape Get Many.

Cette opération liste les champs définis sur le module Lead, champs personnalisés compris. Elle répond à la question qui bloque la plupart des mappings : comment ce champ s'appelle-t-il vraiment côté API.

Aucun paramètre à remplir. Tu choisis l'opération, tu exécutes le nœud une fois, tu lis la sortie.

Un lot de prospects sort du nœud, un élément par fiche, prêt à être filtré, compté ou écrit ailleurs.

• Return All : activé, n8n enchaîne les pages de l'API jusqu'à la dernière fiche ; désactivé, Limit fixe le nombre maximal renvoyé.
• Approved et Converted : par défaut, seules les fiches approuvées reviennent, et les prospects convertis restent de côté.
• Sort By, Sort Order (ascendant ou descendant) et Fields pour alléger la sortie.

Modifier une fiche existante n'écrase que ce que tu ouvres dans la collection. Le reste du prospect ne bouge pas.

• Lead ID : l'identifiant du prospect à modifier, celui-là même que la création a renvoyé.
• Update Fields : 25 champs disponibles, dont Lead Status, Description, Phone et Custom Fields.

Un article entre dans le module Products, et les devis, bons de commande et commandes fournisseur peuvent ensuite le désigner par son nom ou son identifiant.

• Product Name : la seule valeur obligatoire.
• Additional Fields : 10 champs facultatifs, dont Unit Price, Quantity in Stock, Manufacturer, Product Category et Taxable.
• Commission Rate : un pourcentage saisi en nombre simple, 12 vaut douze pour cent.

Ici, c'est le nom du produit qui sert de clé. Zoho met à jour la fiche qui porte ce nom, et en crée une quand le catalogue ne la connaît pas encore.

• Product Name : requis, et utilisé pour la correspondance. Une fiche existe avec ce nom, elle est mise à jour ; sinon une nouvelle est créée.
• Additional Fields : le même jeu facultatif, pratique pour rafraîchir Unit Price ou Quantity in Stock à chaque passage.

Sortir un produit du catalogue se fait en une opération. Les documents qui le citent déjà gardent leur historique, mais plus rien de neuf ne pourra le référencer.

• Product ID : l'identifiant du produit à supprimer, pas son nom commercial. Une étape Get Many placée avant transforme le nom en identifiant.

Lire une fiche produit renvoie ses valeurs du moment, ce qui est exactement ce qu'il faut avant de chiffrer quoi que ce soit.

• Product ID : l'identifiant du produit à lire, repris d'un nœud précédent, souvent {{ $json.id }}.

Tout le catalogue ressort du nœud, un élément par produit, ce qui en fait le point de départ de n'importe quel export ou de n'importe quelle comparaison avec un autre outil.

• Return All : coché, le nœud enchaîne les pages de l'API pour tout ramener ; décoché, Limit pose le plafond.
• Fields : ne renvoie que les colonnes demandées, utile quand une fiche produit en compte des dizaines.
• Sort By, Sort Order et Territory ID resserrent encore le lot.

Corriger un produit existant ne touche qu'aux champs ouverts dans la collection. Les autres restent tels quels dans Zoho CRM.

• Product ID : l'identifiant du produit à modifier.
• Update Fields : 10 champs disponibles, dont Unit Price, Quantity in Stock, Quantity in Demand, Description et Product Active.

Émettre une commande fournisseur crée le document dans Zoho CRM, lignes déjà chiffrées, et renvoie la fiche obtenue.

• Subject : l'intitulé de la commande, seule valeur obligatoire.
• Vendor Name or ID : choisi dans la liste chargée depuis Zoho, ou fourni sous forme d'identifiant par une expression.
• Products : chaque ligne demande un Product Name or ID, une Quantity et un Unit Price ; Due Date, Terms and Conditions et Discount se règlent à côté.

C'est l'intitulé qui fait office de clé. Une commande déjà nommée ainsi est mise à jour, tout le reste devient une nouvelle commande fournisseur.

• Subject : requis, et porteur de la correspondance. Une commande existe avec cet intitulé, elle est mise à jour ; sinon une nouvelle est créée.
• Vendor Name or ID et les lignes Products se remplissent comme pour une création.

La commande fournisseur disparaît de Zoho CRM. L'opération sert quand un document n'aurait jamais dû exister, pas quand il est simplement terminé.

• Purchase Order ID : l'identifiant de la commande à supprimer, et pas son intitulé.

Charger une commande fournisseur renvoie ses lignes et ses totaux tels qu'ils sont dans Zoho CRM à cet instant.

• Purchase Order ID : l'identifiant de la commande à lire, renvoyé par la création ou repris d'un listing.

Les commandes fournisseur sortent en lot, ce qui permet d'avoir une vue des engagements sans exporter quoi que ce soit à la main.

• Return All : actif, toutes les pages de l'API sont parcourues ; inactif, Limit décide du nombre de commandes renvoyées.
• Sort By et Sort Order : les plus récentes d'abord avec un tri descendant sur une date.
• Fields : ne garde que les colonnes utiles au rapport.

Faire évoluer une commande déjà enregistrée, c'est le geste courant au fil de son cycle de vie.

• Purchase Order ID : l'identifiant de la commande à modifier.
• Update Fields : 20 champs disponibles, dont Status Name or ID, Tracking Number, Carrier, Due Date et Subject.

Le nœud dépose un devis dans le module Quotes de Zoho CRM et renvoie l'enregistrement créé, identifiant compris, que le nœud suivant récupère tel quel.

• Subject : le titre du devis, requis, souvent repris de l'item entrant avec {{ $json.subject }}.
• Additional Fields : la collection optionnelle qui porte Valid Till, Terms and Conditions et Quote Stage Name or ID.
• Products : une entrée par ligne de devis, avec Quantity, Unit Price et Total.

C'est le sujet qui tranche : un devis portant déjà ce Subject est mis à jour, sinon Zoho CRM en crée un. De quoi relancer deux fois le même workflow sans doubler les devis.

• Subject : requis, et c'est sur cette valeur que le rapprochement se fait.
• Additional Fields : la même collection optionnelle que pour la création, pour Sub Total, Grand Total ou Description.
• Products : Product Name or ID se choisit dans la liste, ou se remplit par une expression quand l'identifiant produit voyage avec l'item.

Un appel, un enregistrement de moins : le devis quitte le module Quotes pour de bon, ce qui appelle un garde-fou en amont plutôt qu’un retour en arrière. L’identifiant arrive le plus souvent d’une opération Get Many, ou du devis créé plus tôt dans le même passage.

• Quote ID : l'identifiant du devis à supprimer, pas son sujet, en général {{ $json.id }} récupéré à l'étape précédente.

Relire un devis champ par champ, c'est tout ce que fait cette opération. Elle sert quand le workflow n'a qu'un identifiant en main et lui manque le reste.

• Quote ID : l'identifiant du devis à récupérer ; Zoho CRM attend cet ID, un sujet ne fonctionne pas.

Les devis reviennent en liste, un item n8n par enregistrement. C'est le point de départ de toute branche d'export ou de reporting.

• Return All : activé, n8n enchaîne les pages de l'API Zoho CRM jusqu'au dernier devis ; désactivé, Limit fixe le nombre d'items ramenés.
• Sort By et Sort Order : le champ de tri, en ordre croissant (asc) ou décroissant (desc).
• Approved : actif par défaut, donc les devis en attente d'approbation restent dehors tant que tu ne le décoches pas.

Aucune création ici. Un devis existant est corrigé, et seules les valeurs placées dans Update Fields bougent.

• Quote ID : requis, l'enregistrement modifié.
• Quote Stage Name or ID : fait avancer le devis dans ses étapes, au choix dans la liste ou via une expression.
• Valid Till : la date au-delà de laquelle le devis ne vaut plus.
• Grand Total et Adjustment : le montant après taxes et remises, et la correction appliquée dessus.

La commande s'écrit dans Zoho CRM et se rattache à un compte. C'est l'étape qui suit d'habitude un devis accepté.

• Account Name or ID : requis, choisi dans la liste déroulante ou résolu par expression quand l'identifiant du compte arrive avec l'item.
• Subject : requis, le titre sous lequel la commande apparaît.
• Products : les lignes commandées, avec Quantity, Unit Price et Discount, où tu saisis 12 pour 12 %.
• Due Date : la date de paiement ou de livraison attendue.

Deux champs requis, comme à la création, avec une nuance qui compte : le sujet décide si Zoho CRM écrit une nouvelle commande ou rafraîchit celle qui porte déjà ce titre.

• Subject : requis, et clé de rapprochement.
• Account Name or ID : requis aussi, le compte auquel la commande appartient.
• Status Name or ID : le statut de la commande, pris dans la liste ou via une expression.
• Sales Order Number : le numéro de commande porté par l'enregistrement.

La suppression vise une commande précise et la sort du module. Sa place est en fin de branche, après un contrôle, jamais juste derrière une liste sans filtre. La commande se désigne par son identifiant, celui que renvoie la création ou une lecture précédente.

• Sales Order ID : l'identifiant de la commande à supprimer.

Pratique quand un identifiant de commande arrive d'un autre outil et que le workflow a besoin du contenu réel : le nœud va chercher la commande et transmet ses champs à la suite.

• Sales Order ID : l'identifiant de la commande à récupérer, souvent {{ $json.id }}.

Toutes les commandes, ou seulement les premières, selon une case cochée. Chaque enregistrement ressort en item séparé, prêt à être filtré ou additionné plus loin.

• Return All : coché, n8n demande les pages suivantes jusqu'à épuiser le module ; décoché, Limit pose le plafond.
• Territory ID : ne garde que les enregistrements d'un territoire, et Include Child limite la réponse à ses territoires enfants.
• Converted : inactif par défaut, active-le pour ne garder que les enregistrements convertis.

Une commande bouge. Le statut change, une date glisse, une commission est arbitrée. Cette opération inscrit ces valeurs sur l'enregistrement et laisse le reste intact.

• Sales Order ID : requis, l'enregistrement modifié.
• Status Name or ID : le nouveau statut de la commande.
• Due Date : la date revue.
• Sales Commission : la commission du commercial en pourcentage, 12 pour 12 %.

Les vendors, ce sont les fournisseurs côté Zoho CRM. L'opération en ajoute un et renvoie l'enregistrement, pour qu'un workflow d'achat continue sur sa lancée.

• Vendor Name : le seul champ requis.
• Email, Phone et Website : les coordonnées, toutes dans Additional Fields.
• Category : la catégorie sous laquelle le fournisseur est classé.

Le nom du fournisseur sert de clé : un fournisseur déjà enregistré sous ce nom exact est mis à jour, tout autre nom donne un nouvel enregistrement.

• Vendor Name : requis, et valeur sur laquelle porte le rapprochement.
• Address : la collection d'adresse, à remplir champ par champ.
• Currency : la devise rattachée au fournisseur.
• Custom Fields : tes champs Zoho CRM personnalisés, dans la même collection.

Un fournisseur part, sa fiche suit. Tu passes un identifiant, l'enregistrement quitte Zoho CRM, sans moyen de le récupérer depuis n8n.

• Vendor ID : l'identifiant du fournisseur à supprimer ; le nom du fournisseur ne convient pas ici, une étape de lecture le résout donc en amont.

Parfois le workflow ne dispose que d'un identifiant fournisseur. Le nœud le transforme en fiche complète, téléphone et catégorie inclus. Rien ne repart en écriture, donc elle se place sans risque au milieu d'une branche.

• Vendor ID : l'identifiant du fournisseur à récupérer, en général {{ $json.id }} issu d'un nœud précédent.

Tout l'annuaire fournisseurs tient dans un seul nœud, ensuite trié, filtré ou recopié ailleurs.

• Return All : parcourt la totalité des fournisseurs ; laissé décoché, Limit décide du nombre d'items rendus.
• Fields : les champs conservés dans la réponse, ce qui allège les gros passages.
• Sort By : le champ de tri, avec Sort Order réglé sur asc ou desc.

Les coordonnées vieillissent plus vite que le reste d'une fiche fournisseur. Tu passes l'identifiant et les valeurs qui ont changé, le reste ne bouge pas.

• Vendor ID : requis, le fournisseur modifié.
• Vendor Name : modifiable ici, contrairement à l'upsert où il sert de clé.
• Email et Phone : les coordonnées à rafraîchir en premier.
• Description : le texte libre sur le fournisseur.