L'intégration Zoho permet à Eventmaker de générer des factures à partir des informations collectées lors de l'inscription et de les transmettre à votre organisation Zoho.
Cette documentation décrit les étapes nécessaires pour connecter votre compte Zoho à Eventmaker et configurer la facturation sur votre événement.
Si votre organisation Zoho utilise encore l'édition Global, consultez également la documentation Migrer Zoho Invoice / Zoho Books vers l'édition France.
1. Activer la facturation dans Eventmaker
La fonctionnalité Paiement > Facturation (Zoho) doit être activée sur votre événement.
Une fois la fonctionnalité activée, les paramètres de connexion à Zoho sont disponibles dans :
Événement > Intégrations > Paiement / Zoho
L'intégration utilise le protocole OAuth 2.0 pour autoriser Eventmaker à accéder à votre organisation Zoho.
Vous devrez pour cela :
créer une application dans la console développeur Zoho ;
récupérer son Client ID et son Client Secret ;
les renseigner dans Eventmaker ;
autoriser Eventmaker à accéder à votre organisation Zoho.
2. Utiliser le même compte et le même navigateur
⚠️ Important
Lors de la configuration, assurez-vous :
d'être connecté au compte Zoho correspondant à l'organisation que vous souhaitez utiliser pour l'événement ;
d'utiliser le même navigateur pour Zoho et Eventmaker.
Cela permet à Zoho d'associer correctement l'autorisation générée à votre organisation.
3. Créer une application dans Zoho API Console
Rendez-vous dans la console développeur Zoho :
Connectez-vous avec le compte Zoho qui sera utilisé pour la facturation.
Cliquez sur Add Client puis sélectionnez :
Server-based Applications
Paramètres de l'application
Renseignez les informations suivantes :
Client Name
Eventmaker
Homepage URL
https://app.eventmaker.io
Authorized Redirect URL
https://app.eventmaker.io/receive_zoho_grant_token
Puis cliquez sur CREATE.
4. Récupérer le Client ID et le Client Secret
Une fois l'application créée, ouvrez-la dans la console Zoho puis rendez-vous dans la section :
Client Secret
Vous y trouverez :
le Client ID ;
le Client Secret.
Copiez ces deux informations.
5. Configurer la connexion dans Eventmaker
Retournez dans le back-office Eventmaker, dans les paramètres de l'intégration Zoho.
Renseignez :
Client ID
Client Secret
avec les valeurs récupérées dans Zoho.
6. Activer l'option Multi-DC
Dans la configuration de votre application Zoho, rendez-vous dans :
Settings
Activez l'option :
Multi-DC
Cette option doit être activée avant de générer l'autorisation permettant à Eventmaker de se connecter à Zoho.
7. Vérifier votre organisation Zoho
Avant de finaliser la connexion, vérifiez qu'une organisation de facturation est bien configurée dans Zoho.
Vous pouvez notamment y configurer :
les informations de votre entreprise ;
votre logo ;
les coordonnées affichées sur les factures ;
votre modèle de facture ;
les paramètres de numérotation et de facturation propres à votre organisation.
Ces éléments sont gérés directement depuis Zoho Invoice ou Zoho Books, selon la solution utilisée par votre organisation.
La personnalisation graphique et les paramètres comptables des factures sont gérés dans Zoho et non dans Eventmaker.
💡 Si votre organisation utilise encore l'édition Global de Zoho, consultez la documentation Migrer Zoho Invoice / Zoho Books vers l'édition France.
8. Autoriser Eventmaker à accéder à Zoho
Une fois le Client ID et le Client Secret enregistrés dans Eventmaker, cliquez sur :
Générer un nouveau token
Vous êtes redirigé vers Zoho.
Zoho vous demande alors d'autoriser Eventmaker à accéder aux données nécessaires à la facturation.
Cliquez sur Accept / Accepter.
Vous êtes ensuite automatiquement redirigé vers Eventmaker.
Enregistrez les modifications dans Eventmaker.
La connexion entre votre événement Eventmaker et votre organisation Zoho est maintenant configurée.
9. Vérifier la région Zoho
⚠️ La région utilisée pour la connexion dépend de votre compte Zoho.
Selon votre organisation, Zoho peut notamment utiliser un domaine en :
.com.eu
Lorsque vous générez le token, vérifiez que la région configurée dans Eventmaker correspond bien à celle utilisée par votre compte Zoho.
10. Ajouter la facturation au processus d'inscription
Une fois l'intégration Zoho configurée, rendez-vous dans le processus d'inscription de la catégorie concernée.
Ajoutez le bloc :
Facturation Zoho
⚠️ Le bloc Facturation Zoho ne peut être ajouté que si un bloc Paiement est également présent dans le processus d'inscription de la catégorie.
11. Configurer le mapping des informations envoyées à Zoho
Le bloc Facturation Zoho permet de définir quelles informations collectées dans Eventmaker doivent être envoyées à Zoho pour créer le client et la facture.
Les champs peuvent être renseignés à l'aide de la syntaxe Liquid afin de récupérer automatiquement les informations du participant.
Voici un exemple de configuration :
Champ | Valeur Eventmaker |
Nom du client dans Zoho |
|
Email où envoyer la facture |
|
Zoho order number | Optionnel |
Adresse de facturation |
|
Ville |
|
État / Province |
|
Code postal |
|
Pays |
|
Fax |
|
Type de client (entreprise / particulier) |
|
Numéro de TVA |
|
Numéro SIRET |
|
Mapping Eventmaker
Le mapping doit être adapté aux informations effectivement collectées dans votre formulaire d'inscription.
Pour le SIRET, Eventmaker réutilise la donnée Business identification number présente sur la fiche participant et la transmet via :
{{ guest.company_id_number }}
Pour le pays, utilisez :
{{ guest.country_name }}
afin de transmettre le nom complet du pays, par exemple France.
Les champs Type de client, Numéro de TVA et Numéro SIRET sont notamment utilisés dans le cadre des contrôles appliqués par Zoho pour la facturation électronique en France et doivent donc être demandé à vos participants.
12. Facturation électronique en France
Si votre organisation utilise Zoho dans le cadre de la facturation électronique en France, certaines informations supplémentaires doivent être prises en compte dans la configuration Eventmaker.
Par défaut, Eventmaker transmet le type de client :
Individual
Il n'est donc pas nécessaire d'ajouter un champ Type de client dans votre formulaire pour les inscriptions qui doivent être traitées comme des particuliers.
Pour les clients professionnels français devant être identifiés comme Business, le type de client doit en revanche être collecté lors de l'inscription et mappé vers le champ :
Type de client (entreprise / particulier)
Eventmaker transmet la valeur Business lorsque :
le participant est identifié comme
Business;son pays est la France ;
le pays de facturation configuré sur l'événement est également la France.
Pour ces clients, certaines informations d'identification doivent également être correctement transmises à Zoho, notamment :
Type de client (entreprise / particulier)
le SIRET, via
{{ guest.company_id_number }};le numéro de TVA, lorsqu'il est applicable, via
{{ guest.vat_number }};le pays, via
{{ guest.country_name }};une adresse de facturation complète.
Lors de la configuration du formulaire d'inscription sur Eventmaker vous devez demander les champs cités ci-dessus à vos participants.
Si une information requise est manquante ou incorrecte, Zoho peut empêcher la finalisation de la facture. La facture reste alors au statut Draft et ne reçoit pas de numéro définitif.
Le message d'erreur retourné par Zoho est affiché dans Eventmaker, notamment depuis la fiche participant et le panier concerné.
Après correction des informations, utilisez l'action :
Retry sending invoice
Cette action relance le reste du processus de facturation :
finalisation de la facture ;
enregistrement du paiement si nécessaire ;
demande d'envoi de la facture par email depuis Zoho.
Pour aller plus loin
La configuration de la facturation électronique elle-même est réalisée directement dans Zoho.
Activer et configurer la facturation électronique dans Zoho : consultez la documentation officielle Zoho sur l'E-Invoicing.
Migrer Zoho Invoice / Zoho Books vers l'édition France : consultez notre documentation dédiée à la migration.
Vous pouvez également consulter la documentation officielle Zoho sur la migration vers l'édition France.Utiliser Zoho France sans B2Brouter : consultez la documentation dédiée si votre entreprise utilise une autre plateforme agréée pour la transmission de ses factures électroniques.
13. Tester la configuration
Avant d'ouvrir les inscriptions, nous recommandons de réaliser une inscription de test avec paiement et facturation.
Vérifiez notamment que :
le participant est correctement créé ou retrouvé dans Zoho ;
les informations du participant sont correctement transmises ;
l'adresse de facturation et les informations fiscales attendues sont présentes ;
la facture est créée dans la bonne organisation Zoho ;
le montant de la facture est correct ;
le modèle de facture attendu est utilisé.
Si vous facturez des entreprises françaises, réalisez également un test avec un participant de type Business afin de vérifier la transmission du SIRET, du numéro de TVA, du pays et des autres informations attendues.
Une fois ces tests validés, la configuration Zoho de votre événement est terminée.
En résumé
Pour connecter Zoho à Eventmaker :
activez Paiement > Facturation (Zoho) dans Eventmaker ;
créez une application Server-based dans Zoho API Console ;
utilisez l'URL de redirection Eventmaker ;
récupérez le Client ID et le Client Secret ;
activez Multi-DC ;
renseignez les identifiants dans Eventmaker ;
cliquez sur Générer un nouveau token et autorisez Eventmaker dans Zoho ;
ajoutez le bloc Facturation Zoho dans le processus d'inscription ;
configurez le mapping des informations ;
si vous facturez des entreprises françaises, configurez les informations nécessaires à leur identification ;
réalisez une inscription de test avant l'ouverture de l'événement.