Falco / Horus-betalingen synchroniseren in Dolibarr

Q: Heb ik de Falco- of de Horus-API nodig voor betalingen?

De Horus-API. Falco en Horus zijn van dezelfde uitgever: de Falco-API verzorgt de Peppol-verzending, maar het is de Horus-API die de betaalstatus, de datum van de laatste betaling en het betaalde bedrag toont (deelbetalingen inbegrepen).

Q: Maakt de module dubbele betalingen aan?

Nee. De registratie is idempotent: de module boekt alleen het verschil tussen het in Horus betaalde bedrag en wat al in Dolibarr geregistreerd is, en bewaart de Horus-referentie op de factuur.

Q: Welke Horus-toegang is nodig?

Een OAuth2-verbinding met het Horus-dossier van de klant (leestoegang) en minimaal een Falco Easy-abonnement.

U factureert met Falco, uw boekhouding wordt gevoerd in Horus, en u beheert uw activiteit in Dolibarr. Gevolg: wanneer een klant een factuur betaalt, leeft die informatie in Horus… maar uw Dolibarr blijft de factuur als onbetaald tonen. Elke betaling handmatig overtypen — tijdrovend en foutgevoelig.

Goed nieuws: die afstemming kan geautomatiseerd worden. Zo doet u het, en dit zijn de valkuilen.

Falco of Horus: waar zitten de betalingen echt?

Eerst dit ophelderen, want alles hangt ervan af: Falco en Horus zijn producten van dezelfde uitgever (Horus Software), maar het zijn twee verschillende API's.

De Falco-API dient voor e-invoicing: facturen versturen en ontvangen via het Peppol-netwerk. Ze toont de afleverstatus van een factuur, niet de betaling.
De Horus-API zit aan de boekhoudkant: zij kent de betaalstatus, de datum van de laatste betaling en het geïnde bedrag.

Met andere woorden: om betalingen te synchroniseren moet u de Horus-API bevragen. (Om uw Dolibarr-facturen naar Peppol te sturen zou het de Falco-API zijn — een ander onderwerp.)

Wat de Horus-API per factuur levert

Voor openstaande verkoopfacturen geeft Horus alles wat Dolibarr nodig heeft:

Betaalstatus: onbetaald / gedeeltelijk betaald / betaald;
Datum van de laatste betaling — de echte inningsdatum;
Totaalbedrag en openstaand saldo → het betaalde bedrag volgt eruit (totaal − saldo);
de gekoppelde betalingen (deelbetalingen zijn dus becijferd);
het factuurnummer en de gestructureerde mededeling, als koppelingssleutel.

💡 In tegenstelling tot de Falco-API (status zonder bedrag of datum) laat Horus toe exacte betalingen te registreren, ook gedeeltelijke.

Hoe u dit netjes in Dolibarr binnenhaalt

Drie principes voor een betrouwbare synchronisatie:

1. Foutloos koppelen

Elke Horus-betaling moet aan de juiste Dolibarr-factuur hangen — via het factuurnummer of de gestructureerde mededeling. Deze stap voorkomt dat een betaling op het verkeerde document belandt.

2. Valideren vóór het schrijven

Een betaling is een boekhoudkundige verrichting: beter een validatiescherm dat toont « dit zijn de te registreren betalingen » en u laat aanvinken, dan een blinde automatische boeking.

3. Idempotent blijven (nul duplicaten)

Het te registreren bedrag = « betaald in Horus − al betaald in Dolibarr », begrensd op het openstaande saldo. Zo registreert de synchronisatie nooit twee keer dezelfde betaling, hoe vaak u ze ook draait.

De Qwimo-module « Paiements Falco & Horus »

Doet dit alles voor u: OAuth2-verbinding met het Horus-dossier, afstemmingsscherm, idempotente registratie van betalingen (echt bedrag en echte datum). Installatie in custom/, zonder de Dolibarr-kern te wijzigen.

Ontdek de module →

Veelgestelde vragen

Heb ik de Falco- of de Horus-API nodig voor betalingen?

De Horus-API. Falco (zelfde uitgever) verzorgt de Peppol-verzending; Horus toont status, datum en bedrag van de betalingen — deelbetalingen inbegrepen.

Maakt de module dubbele betalingen aan?

Nee: de registratie is idempotent (alleen het verschil wordt geboekt) en de Horus-referentie blijft op de factuur. Onbeperkt herhaalbaar zonder risico.

Welke Horus-toegang is nodig?

Een OAuth2-verbinding met het Horus-dossier van de klant (leestoegang) en minimaal een Falco Easy-abonnement.

Lees ook: de Recupel-bijdrage op uw Dolibarr-facturen en het btw-verschil op leveranciersbestellingen.