Zoho Books

Ce que ca fait

Zoho Books envoie les evenements de facturation en temps reel vers DURUM.ai.

Evenement Zoho Books	Type dans DURUM.ai	Quand
Facture payee (Invoice Paid)	Paiement	Le client paie une facture
Facture en retard (Invoice Overdue)	Paiement du	La facture depasse la date d'echeance

Configuration etape par etape

1. Connectez-vous a votre compte Zoho Books
2. Cliquez sur l'icone Engrenage (en haut a droite) pour acceder aux Settings
3. Dans la section Integrations, cliquez sur Webhooks (ou dans Automation selon votre version)
4. Cliquez sur + New Webhook

Webhook pour les factures payees :

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, selectionnez : quand le statut de la facture passe a Paid
11. Ajoutez les champs a 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. Creez un deuxieme webhook : DURUM - Payment Due
14. Meme URL :

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

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

Comment tester

1. Creez une facture de test dans Zoho Books
2. Marquez-la comme payee
3. Attendez 30 secondes
4. Dans DURUM.ai, allez dans Logs Data
5. Verifiez qu'un evenement payment apparait
6. Supprimez la facture de test

Depannage Zoho Books

Probleme	Solution
Payload vide dans les logs	Verifiez que les champs sont bien configures dans le webhook Zoho Books
client_key=unknown	Assurez-vous que ?client_key=VOTRE_CLE est present dans l'URL
Evenement en quarantaine	L'agence doit mapper la source. Contactez votre gestionnaire.

WARNING

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

---