Une affaire Zoho CRM contient souvent des informations indispensables au devis : référence chantier, centre de coûts, interlocuteur opérationnel, conditions particulières ou numéro de dossier. Pourtant, lors de la création du devis dans Zoho Books, ces données ne suivent pas toujours automatiquement. L’administration doit les rechercher et les ressaisir.
Une fonction personnalisée Zoho Books peut combler ce manque. Elle récupère une valeur dans l’affaire CRM associée, l’écrit dans le champ correspondant du devis Books, puis s’exécute au moyen d’un workflow. L’objectif est précis : faire circuler une information métier utile sans automatiser aveuglément tout le processus de vente.
Ce guide complète nos articles sur l’automatisation de la facturation après une vente et sur le choix du bon circuit de devis entre Zoho CRM et Zoho Books. Ici, nous nous concentrons uniquement sur le transfert d’un champ métier vers une transaction Books existante.
Le problème : le contexte commercial s’arrête avant le devis
Prenons une PME qui réalise des interventions techniques. Le commercial renseigne dans l’affaire CRM une « Référence chantier » communiquée par le client. Cette référence doit apparaître sur le devis Books pour que le client puisse identifier le projet et pour que l’équipe administrative puisse rapprocher les documents.
Sans automatisation, l’utilisateur qui prépare le devis doit ouvrir l’affaire, copier la valeur, revenir dans Books et la coller dans le bon champ. Cette manipulation paraît anodine, mais elle devient fragile lorsque plusieurs devis sont créés chaque semaine ou lorsque plusieurs références se ressemblent.
Quels champs peut-on transmettre de CRM vers Books ?
Le modèle convient surtout aux informations portées par l’affaire et nécessaires au document commercial. Par exemple :
- une référence de chantier, de commande ou de dossier ;
- un centre de coûts ou un code analytique ;
- le nom du chef de projet ou de l’interlocuteur opérationnel ;
- une consigne de livraison ou d’exécution ;
- une condition commerciale validée ;
- une référence de campagne ou de contrat.
La valeur cible doit disposer d’un emplacement cohérent dans Zoho Books, généralement un champ personnalisé du devis. Évitez d’utiliser une zone libre générique pour plusieurs informations sans rapport : une donnée structurée reste plus facile à contrôler, afficher dans un modèle PDF et exploiter dans un rapport.
Comment fonctionne l’automatisation officielle Zoho ?
Zoho présente officiellement un scénario dans lequel une fonction personnalisée récupère une valeur d’une affaire CRM liée et l’ajoute au devis Zoho Books. La procédure repose sur trois éléments : une fonction personnalisée dans Books, une connexion nommée zbooks et une règle de workflow qui déclenche la fonction.
La procédure officielle Zoho Books fournit le principe et renvoie vers le script de départ. Celui-ci doit être adapté aux noms API de vos champs, à votre organisation et à vos règles de gestion ; il ne faut pas le copier directement en production sans test.
Le workflow ne crée pas la gouvernance à votre place. Il automatise une règle qui doit d’abord être claire : quelle valeur fait foi, quand doit-elle être transférée et peut-elle encore changer ?
Principe de mise en œuvre
Préparer les deux applications avant de créer la fonction
Commencez par documenter le trajet exact de la donnée. Pour chaque champ, notez son libellé visible, son nom API, son type, sa source de vérité et le moment où il devient définitif.
| Contrôle | Zoho CRM | Zoho Books |
|---|---|---|
| Emplacement | Module Affaires | Champ personnalisé du devis |
| Type | Texte, nombre, date ou liste | Type compatible |
| Identifiant | Nom API exact du champ | Nom API exact du champ personnalisé |
| Source de vérité | Valeur validée par le commercial | Copie utilisée sur la transaction |
| Déclenchement | Affaire liée au devis | Création ou modification du devis |
Vérifiez également que l’intégration CRM–Books est active et que le devis Books est correctement associé à l’affaire. La documentation de l’intégration Zoho Books dans CRM rappelle que les transactions Zoho Finance appartiennent à Books, même lorsqu’elles sont créées ou consultées depuis CRM.
Cette distinction est importante : la fonction doit enrichir le devis Zoho Books, pas un devis du module CRM natif. Ces deux familles de transactions ne se synchronisent pas entre elles.
Configurer le transfert en sept étapes
- Créer le champ source dans l’affaire CRM. Définissez son type, son caractère obligatoire éventuel et la personne autorisée à le modifier.
- Créer le champ cible dans les devis Zoho Books. Utilisez un type compatible et prévoyez son affichage dans le modèle PDF si le client doit le voir.
- Relever les noms API. Ne vous fiez pas aux seuls libellés visibles : la fonction utilise les identifiants techniques des champs.
- Créer ou vérifier la connexion
zbooks. Accordez uniquement les autorisations nécessaires à la lecture de l’affaire et à la mise à jour du devis. - Ajouter la fonction personnalisée dans Zoho Books. Partez du modèle officiel, puis adaptez les identifiants d’organisation, modules et champs.
- Créer la règle de workflow. Déclenchez-la au moment pertinent, par exemple lors de la création du devis ou lorsque le champ cible est vide.
- Tester puis activer progressivement. Contrôlez le résultat dans CRM, dans Books et sur le PDF avant d’élargir le périmètre.
Éviter les boucles et les écrasements indésirables
Décidez ce qui se passe si la valeur CRM change après la création du devis. Trois politiques sont possibles : mettre systématiquement le devis à jour, compléter uniquement un champ vide ou figer la valeur après validation. Pour les documents déjà envoyés, la troisième option est souvent la plus prudente.
Ajoutez des garde-fous dans le workflow : vérifier que l’affaire est bien associée, que la valeur source n’est pas vide, que le devis n’est pas annulé et que le champ cible peut encore être modifié. Si la fonction peut se redéclencher après sa propre mise à jour, prévoyez un critère empêchant une boucle.
La checklist de test avant la production
- un devis lié à une affaire dont le champ source est correctement rempli ;
- un devis sans affaire associée ;
- une affaire dont le champ source est vide ;
- une valeur comportant accents, apostrophes ou caractères longs ;
- une modification du champ CRM après la création du devis ;
- un devis déjà envoyé, accepté ou converti ;
- un utilisateur sans les droits requis ;
- une erreur de connexion ou un nom API incorrect.
Consultez les journaux du workflow après chaque scénario. Un statut technique de réussite ne suffit pas : ouvrez ensuite le devis et vérifiez la valeur enregistrée, son rendu PDF et l’absence de modification collatérale.
Quand utiliser un simple mappage plutôt qu’une fonction ?
Si le champ appartient à un module déjà synchronisé nativement, par exemple une information client ou article, commencez par examiner les possibilités de mappage standard. Une fonction devient pertinente lorsque la donnée vient spécifiquement de l’affaire, que le transfert dépend d’une condition ou qu’une transformation est nécessaire.
Gardez la solution la plus simple qui répond au besoin. Un mappage natif est plus facile à maintenir ; une fonction offre davantage de contrôle, mais elle doit être documentée, testée et surveillée.
Un petit transfert qui sécurise tout le passage vente–finance
Faire suivre automatiquement une référence de l’affaire au devis évite une ressaisie, mais surtout une rupture de contexte entre le commercial et l’administration. Le devis conserve l’information qui explique à quel projet, chantier ou contrat il se rapporte.
Commencez par un seul champ à forte valeur opérationnelle. Validez le trajet complet, documentez les responsabilités, puis étendez la fonction uniquement si les autres données obéissent à la même logique.
