Zoho Books

Ce que ça fait

Zoho Books envoie les événements de facturation en temps réel vers DURUM.ai.

Événement Zoho Books	Type dans DURUM.ai	Quand
Facture payée (Invoice Paid)	Paiement	Le client paie une facture
Facture en retard (Invoice Overdue)	Paiement dû	La facture dépasse la date d'échéance

Configuration étape par étape

1. Connectez-vous à votre compte Zoho Books
2. Cliquez sur l'icône Engrenage (en haut à droite) pour accéder aux Settings
3. Dans la section Intégrations, cliquez sur Webhooks (ou dans Automation selon votre version)
4. Cliquez sur + New Webhook

Webhook pour les factures payées :

5. Nom : DURUM - Payment
6. Module : Invoice
7. URL :

   https://app.durum.ai/api/webhook/payment?client_key=VOTRE_CLE

8. HTTP Method : POST
9. Payload Format : JSON
10. Dans Trigger, sélectionnez : quand le statut de la facture passe à Paid
11. Ajoutez les champs à inclure dans le payload :
    • Invoice Number
    • Invoice Date
    • Total
    • Balance
    • Customer Name
    • Contact Email
12. Cliquez sur Save

Webhook pour les factures en retard :

13. Créez un deuxième webhook : DURUM - Payment Due
14. Même URL :

    https://app.durum.ai/api/webhook/payment?client_key=VOTRE_CLE

15. Trigger : quand le statut passe à Overdue
16. Sauvegardez

Comment tester

1. Créez une facture de test dans Zoho Books
2. Marquez-la comme payée
3. Attendez 30 secondes
4. Dans DURUM.ai, allez dans Logs Data
5. Vérifiez qu'un événement payment apparaît
6. Supprimez la facture de test

Dépannage Zoho Books

Problème	Solution
Payload vide dans les logs	Vérifiez que les champs sont bien configurés dans le webhook Zoho Books
client_key=unknown	Assurez-vous que ?client_key=VOTRE_CLE est présent dans l'URL
Événement en quarantaine	L'agence doit mapper la source. Contactez votre gestionnaire.

WARNING

Le paramètre ?client_key=VOTRE_CLE est obligatoire dans l'URL du webhook Zoho Books. Sans ce paramètre, DURUM.ai ne pourra pas associer le paiement à votre compte.

---