Prérequis

Avant de commencer, assurez-vous d'avoir :

• Un compte Zoho Books actif
• Les droits administrateur sur Zoho Books
• Un compte Billabex créé

Etapes de connexion

Etape 1 : accédez aux connexions

1. Connectez-vous à votre compte Billabex
2. Cliquez sur Paramètres dans la barre de navigation
3. Sélectionnez Connexions
   
4. Cliquez sur Ajouter une connexion
5. Dans la carte Zoho Books, sélectionnez la région
   

Où trouver la région de mon compte Zoho Books ?
Dans Zoho Books, regardez le domaine utilisé à la fin de l'url. Par exemple, si l'url se termine par .eu (https://books.zoho.eu/), sélectionnez Europe.
Plus d'informations : https://www.zoho.com/books/api/v3/introduction/#multidc

Etape 2 : autorisez la connexion OAuth2

1. Acceptez la demande d'agrément Billabex
2. Vous êtes redirigé vers Zoho
3. Connectez-vous à votre compte Zoho si nécessaire
4. Sélectionnez votre organisation (si vous en avez plusieurs)
5. Cliquez sur Confirmer l'organisation pour autoriser l'accès

Plusieurs organisations ?
Si vous gérez plusieurs organisations dans Zoho Books, vous devrez créer une connexion séparée pour chaque organisation.

Etape 3 (optionnelle) : exclure certains comptes

Si vous ne souhaitez pas synchroniser certains clients :

1. A l'étape Configuration
2. Ajoutez les ID des comptes Zoho Books à exclure, séparés par une virgule
3. Ces comptes ne seront jamais synchronisés

Où trouver l'ID d'un compte Zoho Books ?
Dans Zoho Books, accédez à la fiche client. L'ID apparaît dans l'URL : https://books.zoho.eu/app/.../contacts/679274000000061007?

Cas d'usage :

• Clients VIP gérés manuellement
• Comptes internes de votre entreprise
• Clients avec certaines modes de paiements tels que le prélèvement automatique

Etape 4 : lancez la première synchronisation

1. Cliquez sur Activer la connexion
2. La synchronisation des données est lancée

La première synchronisation prend 5-10 minutes selon le volume.

Etape 5 : vérifiez la synchronisation

1. Accédez au module Comptes
2. Vérifiez que le logo Zoho Books apparaisse bien à côté du nom du compte
3. Consultez quelques données du compte telles que les factures, avoirs, informations, etc.
4. Assurez-vous que les contacts sont bien importés

Tout est synchronisé ? Votre connexion Zoho Books est active !

Synchronisation continue

À partir de maintenant :

• Toute nouvelle facture créée dans Zoho Books apparaît dans Billabex (1 fois par jour)
• Les paiements reçus mettent à jour automatiquement le statut des factures
• Les modifications de contact persons sont synchronisées
• Les nouveaux clients sont ajoutés automatiquement

Aucune action de votre part n'est nécessaire.

Exclure un compte après connexion

Si vous souhaitez exclure un client spécifique :

1. Accédez au module Comptes
   
2. Cliquez sur le compte à exclure
   
3. Cliquez sur Options > Gérer la connexion
4. Cliquez sur Exclure
   

• Les nouvelles factures de ce client ne seront plus synchronisées
• Les factures déjà synchronisées restent dans Billabex
• Le compte reste visible mais inactif pour la synchronisation

Pensez à mettre en pause les relances ou supprimer le compte si vous ne souhaitez plus que ce client soit relancé.

Déconnecter Zoho Books

Pour arrêter complètement la synchronisation des données :

1. Paramètres > Connexions
2. Cliquez sur la connexion que vous souhaitez supprimer
3. Options > Supprimer

Les données déjà synchronisées restent dans Billabex mais ne seront plus mises à jou