Synchroniser les paiements Falco / Horus dans Dolibarr

Vous facturez avec Falco, votre comptabilité est tenue dans Horus, et vous pilotez votre activité dans Dolibarr. Résultat : quand un client règle une facture, l'information vit dans Horus… mais votre Dolibarr, lui, continue d'afficher la facture comme impayée. Il faut alors ressaisir chaque paiement à la main — chronophage et source d'erreurs.

Bonne nouvelle : ce rapprochement peut être automatisé. Voici comment, et quels sont les pièges à connaître.

Falco ou Horus : où sont réellement les paiements ?

Premier point à clarifier, car il conditionne tout : Falco et Horus sont édités par la même société (Horus Software), mais ce sont deux API différentes.

• L'API Falco sert à l'e-invoicing : envoi et réception de factures sur le réseau Peppol. Elle expose le statut de livraison d'une facture, mais pas son règlement.
• L'API Horus est côté comptabilité : c'est elle qui connaît le statut de paiement, la date du dernier règlement et le montant encaissé.

Autrement dit : pour synchroniser des paiements, c'est l'API Horus qu'il faut interroger. (Pour envoyer vos factures Dolibarr vers Peppol, ce serait l'API Falco — un autre sujet.)

Ce que l'API Horus fournit, facture par facture

Sur les factures de vente ouvertes, Horus renvoie tout ce dont Dolibarr a besoin :

• Statut de paiement : non payé / partiellement payé / payé ;
• Date du dernier paiement — la vraie date d'encaissement ;
• Montant total et solde ouvert → le montant payé se déduit (total − solde) ;
• les paiements liés (donc les acomptes partiels sont chiffrés) ;
• le numéro de facture et la communication structurée, qui servent de clé de rapprochement.

Comment rapatrier ça proprement dans Dolibarr

Trois principes pour que la synchro soit fiable :

1. Apparier sans se tromper

Chaque paiement Horus doit être rattaché à la bonne facture Dolibarr — via le numéro de facture ou la communication structurée. C'est l'étape qui évite d'imputer un règlement sur la mauvaise pièce.

2. Valider avant d'écrire

Un règlement, ça s'écrit en comptabilité : mieux vaut un écran de validation qui affiche « voici les paiements à enregistrer » et vous laisse cocher, plutôt qu'une écriture automatique aveugle.

3. Rester idempotent (zéro doublon)

Le montant à enregistrer doit être calculé comme « payé côté Horus − déjà payé côté Dolibarr », plafonné au restant dû. Ainsi, relancer la synchro dix fois n'enregistre jamais deux fois le même paiement.

Questions fréquentes

À lire aussi : l'éco-contribution Recupel sur vos factures Dolibarr et l'écart de TVA sur les commandes fournisseurs.