Webhooks Certyneo : automatiser le bilan comptable en ERP

Wanneer een document elektronisch via Certyneo wordt ondertekend, wat gebeurt er vervolgens in uw boekhoudkundige keten? Voor de meeste bedrijven is het antwoord helaas nog steeds: niets geautomatiseerd. Een medewerker downloadt handmatig de ondertekende PDF, stuurt deze per e-mail naar de boekhouder, die het vervolgens opnieuw invoert in zijn beheersoftware. Dit gefragmenteerde proces leidt tot fouten, vertragingen en verlies van traceerbaarheid die onverenigbaar zijn met de vereisten van een betrouwbare boekhoudkundige balans. Webhooks van Certyneo beantwoorden precies aan deze problematiek: ze stellen u in staat automatisch acties in uw derdesystemen uit te voeren — ERP, boekhoudingsoftware, DMS — zodra een ondertekeningsgebeurtenis plaatsvindt. Dit artikel legt in detail uit hoe u deze webhooks configureert en gebruikt om uw boekhoudkundige cyclus van begin tot eind soepel te laten verlopen.

Wat is een webhook en waarom is het essentieel voor boekhouden

Het webhookprincipe eenvoudig uitgelegd

Een webhook is een real-time HTTP-meldingsmechanisme: in plaats van regelmatig aan een API te vragen "is er iets veranderd?" (zogenaamde polling-benadering), stuurt de verzendende toepassing — hier Certyneo — een HTTP POST-verzoek naar een URL van uw keuze zodra een bepaalde gebeurtenis plaatsvindt. In boekhouden betekent dit dat op het moment waarop een inkooporder, leverancierscontract of onkostendeclaratie elektronisch wordt ondertekend, uw ERP onmiddellijk kan worden genotificeerd, zonder menselijk ingrijpen.

In tegenstelling tot eenvoudige CSV-export of maandelijks overzicht garandeert de webhook bijna realtime gegevenssynchronisatie. Voor een boekhouder die maandelijkse of driemaandelijkse sluitingen beheerd, is deze granulariteit doorslaggevend: bewijsstukken zijn beschikbaar in het systeem zodra zij worden ondertekend, en niet aan het einde van de maand bij moeizame inhaalwerkzaamheden.

De Certyneo-gebeurtenissen die een boekhoudkundige balans activeren

Certyneo stelt verschillende soorten gebeurtenissen beschikbaar via webhooks, direct bruikbaar in een boekhoudkundige context:

• `envelope.completed`: alle partijen hebben het document ondertekend — dit is de primaire trigger om een bewijsstuk in uw ERP in te voegen.
• `envelope.declined`: een ondertekenaar heeft geweigerd — nuttig om het boekhoudkantoor te waarschuwen voor een betwiste factuur.
• `envelope.expired`: de ondertekeningstermijn is verstreken — maakt het mogelijk een procedure opnieuw in te stellen en gaten in de administratie te vermijden.
• `signer.signed`: gedeeltelijke ondertekening door een partij — relevant voor contracten met meerdere ondertekenaars (bijv. commercieel pand dat ondertekening van verpachter en pachter vereist).

Elke JSON-payload die door Certyneo wordt verzonden, bevat essentiële metagegevens: document-ID, gekwalificeerde tijdstempel, namen van ondertekenaars, beveiligde download-URL van ondertekende PDF en audittrail. Deze gestructureerde gegevens kunnen rechtstreeks door een ERP of boekhoudingsoftware worden gebruikt.

Stap-voor-stap configuratie van Certyneo-webhooks voor een ERP

Een webhook-eindpunt maken en registreren

Het configureren van een Certyneo-webhook vindt plaats vanuit het dashboard, sectie Instellingen > Integraties > Webhooks. Hier zijn de sleutelstappen:

1. De doel-URL definiëren: dit is het eindpunt dat door uw ERP of uw integratieplatform wordt blootgesteld (bijv. een specifiek eindpunt in SAP, Sage, Cegid of een iPaaS-tool zoals n8n, Make of Zapier).
2. De gebeurtenissen selecteren waarnaar u wilt luisteren: voor een boekhoudkundige balans selecteert u minimaal `envelope.completed` en `envelope.declined`.
3. Het HMAC-ondertekeningsgeheim configureren: Certyneo ondertekent elke payload met een geheime sleutel die u definieert. Uw eindpunt moet deze handtekening verifiëren om de authenticiteit van meldingen te garanderen — een onmisbare veiligheidsstap.
4. Testen in simulatiemodus: Certyneo stelt u in staat een testpayload te verzenden zonder een echt document aan te maken. Controleer of uw eindpunt correct met HTTP 200 reageert.

De payloadgegevens toewijzen aan uw rekeningschema

Zodra het eindpunt operationeel is, moet u de Certyneo-payloadvelden toewijzen aan de velden die uw ERP verwacht. Hier is een voorbeeld van een toewijzingslogica voor een leverancierscontract:

```json { "event": "envelope.completed", "envelope_id": "env_01HX...", "completed_at": "2026-05-26T14:32:00Z", "document_url": "https://app.certyneo.com/documents/signed/...", "metadata": { "type": "contrat_fournisseur", "montant_ht": 12500, "compte_comptable": "607", "fournisseur_id": "F-2891" } } ```

Het veld `metadata` kan vrij worden geconfigureerd bij het maken van de envelope via de Certyneo-API. Dit is de sleutel voor het verrijken van elke ondertekening met zakelijke gegevens die nodig zijn voor automatische boeking: rekeningnummer, kostenplaats, boekjaar, enz. Voor meer informatie over integratieperspectieven raadpleegt u het Certyneo-helpcentrum dat de volledige API-documentatie bevat.

Afwijzingen beheren en automatische herinzendingen

Een webhook kan mislukken als uw eindpunt tijdelijk niet beschikbaar is. Certyneo implementeert een beleid voor exponentiële pogingen: in geval van geen HTTP 2xx-reactie probeert het systeem de verzending opnieuw in met toenemende intervallen (5 min, 30 min, 2 uur, 24 uur) over een periode van 72 uur. Daarna wordt de webhook als mislukt gemarkeerd en een waarschuwing in het dashboard verhoogd.

Voor boekhouden is deze veerkracht cruciaal: een niet ontvangen bewijsstuk in de ERP kan tot boekhoudkundige verschillen leiden. Het wordt daarom aanbevolen het webhookmechanisme aan te vullen met een dagelijkse afstemmingstaak die de Certyneo-API bevraagt om de afgelopen 24 uur voltooide enveloppen op te sommen en hun aanwezigheid in het boekhoudkundige systeem te verifiëren.

Integratie met populaire ERP- en boekhoudingssoftware

Native verbinding met Cegid, Sage en Pennylane

Verschillende uitgeverijen van populaire boekhoudingssoftware in Frankrijk bieden connectoren of REST-API's aan die compatibel zijn met Certyneo-webhooks. Hier zijn de meest voorkomende integratiepatronen:

Cegid XRP Flex: stelt een REST-API beschikbaar waarmee u boekhoudkundige stukken kunt aanmaken en bestanden kunt bijvoegen. De webhook `envelope.completed` triggert een POST-aanroep naar de Cegid-API om de invoer aan te maken en de ondertekende PDF als digitaal bewijsstuk bij te voegen.

Sage 100cloud / Sage 50: de aanbevolen benadering gaat via een lichtgewicht middleware (Python of Node.js-script gehost als serverless) die de Certyneo-webhook ontvangt, het document via de beveiligde URL downloadt en in de automatische importmap van Sage plaatst.

Pennylane: cloud-native oplossing waarvan de API rechtstreeks documenten accepteert met hun boekhoudkundige metagegevens. De integratie van Pennylane-webhook is bijzonder geschikt voor boekhoudkantoren die stukken van meerdere klanten centraliseren — een use case die we in het scénario's gedeelte uitwerken.

Voor teams die verschillende oplossingen evalueren voordat zij naar Certyneo migreren, biedt de vergelijking van elektronische handtekeningoplossingen een gedetailleerd overzicht van integratiecapaciteiten per platform.

No-code/low-code iPaaS zoals Make of n8n gebruiken

Als uw organisatie geen speciaal technisch team heeft, vormen no-code/low-code automatiseringsplatformen (Make, n8n, Zapier) een effectief alternatief. Het principe is eenvoudig:

1. Maak een scenario aan met een webhooktrigger op Make of n8n — de gegenereerde URL dient als Certyneo-eindpunt.
2. Configureer de volgende acties: download van het ondertekende document, parsing van metagegevens, verzending naar Google Drive / SharePoint, aanmaken van een rij in een volgingsblad, Slack-melding aan de boekhoudverantwoordelijke.
3. Optioneel triggert u een API-aanroep naar uw boekhoudingssoftware om de invoer aan te maken.

Deze benadering maakt het mogelijk een hoog automatiseringsniveau in minder dan een dag te bereiken, zonder een enkele regel code te schrijven. Het is bijzonder geschikt voor MKB's of voor boekhoudkantoren die de documentverzameling voor hun klanten willen automatiseren zonder een ontwikkelaar in te schakelen.

Aanbevolen werkwijzen voor veiligheid en controle op webhooks voor boekhouden

HMAC-handtekening verificatie en beveiliging van eindpunten

In een boekhoudkundige context is de betrouwbaarheid van gegevens via webhook van cruciaal belang. Een aanvaller die erin zou slagen valse `envelope.completed`-gebeurtenissen in te voegen, zou uw administratie kunnen beschadigen. Drie veiligheidsmaatregelen zijn essentieel:

• HMAC-SHA256-verificatie: elk Certyneo-verzoek bevat een header `X-Certyneo-Signature`. Uw eindpunt moet de handtekening met uw geheime sleutel opnieuw berekenen en vergelijken — wijzig elk verzoek waarvan de handtekening niet overeenkomt.
• JSON-schemavalidatie: valideer voorafgaand aan verwerking de structuur en typen van de ontvangen payload. Een veld `montant_ht` met waarde `null` of negatief moet een waarschuwing activeren, niet een foutieve boekhoudkundige invoer.
• Onveranderbare journalering: bewaar elke ontvangen payload in een gedateerde, niet-wijzigbare logboek voor minstens 10 jaar, in overeenstemming met verplichtingen voor het bewaren van boekhoudkundige stukken (artikel L123-22 van de Handelscodex).

Traceerbaarheid en audittrail voor de boekhouder

Een van de belangrijkste voordelen van de webhookbenadering is de end-to-end traceerbaarheid die zij genereert. Certyneo produceert voor elk ondertekend document een audittrail die voldoet aan eIDAS-vereisten, inclusief gekwalificeerde tijdstempel, IP-adressen van ondertekenaars en gebruikte certificaten.

Door deze audittrail aan de webhookpayload te koppelen, kan uw ERP niet alleen het bewijsstuk opslaan maar ook het bewijs van de juridische geldigheid ervan. Voor een registeraccountant of boekhouder vereenvoudigt deze dubbele laag — document + bewijs — de verificaties tijdens een controle of herziening aanzienlijk. Het elektronisch handtekenen in ondernemingen gaat in op ondertekeningsniveaus en hun bewijskracht in verschillende zakelijke contexten.

Om de return on investment van deze automatisering voordat u begint te berekenen, stelt de Certyneo ROI-calculator u in staat de tijd- en kostenbesparingen nauwkeurig in te schatten op basis van uw volume ondertekende documenten.

Toepasselijk wettelijk kader voor webhooks en digitale boekhouden

De automatisering van de boekhoudkundige keten via elektronische handtekeningwebhooks valt onder een bepaald regelgevingskader dat moet worden beheerst.

Verordening eIDAS nr. 910/2014 (en herziene eIDAS 2.0): de Europese verordening over elektronische identificatie en vertrouwensdiensten bepaalt de juridische waarde van elektronische handtekeningen. Artikel 25 bepaalt dat een elektronische handtekening niet alleen vanwege het feit dat zij in elektronische vorm wordt gepresenteerd, haar juridische gevolgen kan worden ontzegd. Gekwalificeerde handtekeningen (QES) genieten van een vermoedenswaardigheid van betrouwbaarheid equivalent aan handgeschreven handtekeningen. Voor boekhoudkundige stukken hangt het toepasselijke ondertekeningsniveau af van de aard van het document: een eenvoudige factuur kan gebruikmaken van een geavanceerde handtekening (AES), terwijl een financierings- of notariële elektronische akte een gekwalificeerde handtekening vereist.

Burgerlijk Wetboek, artikelen 1366 en 1367: artikel 1366 erkent het elektronische geschrift als bewijs op dezelfde manier als geschrift op papier, mits degene van wie het afkomstig is, behoorlijk kan worden geïdentificeerd en dit onder voorwaarden van aard is geweest om de integriteit ervan te waarborgen. Artikel 1367 definieert elektronische handtekening als het gebruik van een betrouwbare identificatieprocedure die de band met de akte waaraan deze is vastgehecht garandeert. De Certyneo-webhook garandeert, door de audittrail met elk ondertekend document door te geven, aan deze identificatie- en integriteitsvereiste.

Artikel L123-22 van de Handelscodex: boekhoudkundige documenten en bewijsstukken moeten tien jaar lang worden bewaard. Documenten die via webhook worden ontvangen en in een ERP worden opgeslagen, moeten daarom onderworpen zijn aan een conforme bewaringspolitiek, inclusief onveranderlijkheid en lange-termijn-leesbaarheid van formaten (PDF/A aanbevolen door ISO 19005-norm).

AVG nr. 2016/679: webhookpayloads bevatten persoonsgegevens (namen van ondertekenaars, e-mailadressen, aan individuen gekoppelde tijdstempels). Uw eindpunt en uw ERP zijn ontvangers van deze gegevens — u bent verwerkingsverantwoordelijke of medeverantwoordelijke afhankelijk van contractuele voorwaarden met Certyneo. De DPA (Data Processing Agreement) moet worden geformaliseerd. De verzonden gegevens moeten tot het strikte noodzakelijke voor het boekhoudkundig doel worden beperkt.

Richtlijn NIS2 (2022/2555): voor ondernemingen binnen het NIS2-bereik (exploitanten van essentiële diensten, grote entiteiten) vormt de veiligheid van API- en webhookinterfaces een verplichte netwerkbeveiligingsmaatregel. HMAC-verificatie, minimale TLS 1.3-versleuteling en logboekregistratie van toegang zijn verplicht.

Norm ETSI EN 319 132: definieert het XAdES-formaat voor geavanceerde elektronische handtekeningen. De handtekeningen die door Certyneo worden geproduceerd, voldoen aan deze ETSI-normen en garanderen hun interoperabiliteit met archiefoperingen met bewijskracht in overeenstemming met het Franse algemene beveiligingskader (RGS).

Concrete gebruiksscenario's

Scenario 1: een boekhoudkantoor dat 40 klantendossiers beheert

Een boekhoudkantoor van een tiental medewerkers beheert overdrachtsbriefen, SEPA-mandaten en jaarrekeningen van 40 vennootschappige klanten. Voordat webhooks van Certyneo werden geïntegreerd, werd elk ondertekend document handmatig door een dossiermedewerker opgehaald, hernoemd volgens een naamgevingsconventie en vervolgens in de klantmap van hun boekhoudkundige productiesoftware geplaatst. Dit proces nam ongeveer 15 tot 20 minuten per document in beslag, oftewel enkele uren per week in afsluitingsperioden.

Na configuratie van een `envelope.completed`-webhook verbonden met hun GED-tool via Make automatiseerde het kantoor dit hele proces: zodra het document wordt ondertekend, wordt de ondertekende PDF automatisch in de overeenkomstige klantmap geclassificeerd met de juiste bestandsnaam, ontvangt de desbetreffende dossiermedewerker een melding en wordt een rij in het volgingsblad voor ontvangen stukken aangemaakt. De geschatte besparing is ongeveer 70 tot 80% op deze taak, dus ongeveer 6 tot 8 uur per week in afsluitingsperioden — een cijfer dat aansluit bij benchmarks gepubliceerd door de Orde van Boekhoudkundige Deskundigen in haar rapporten over digitale transformatie van kantoren.

Scenario 2: een industrieel MKB met Sage ERP en 300 leverancierscontracten per jaar

Een industrieel MKB ondertekent ongeveer 300 leverancierscontracten per jaar (raamafspraken, aanpassingen, vertrouwelijkheidsovereenkomsten). Elk ondertekend contract moet aan een leveranciersdossier in Sage 100cloud worden gekoppeld en als verantwoordingsdocument voor een verplichting worden gearchiveerd. Zonder automatisering stuurde de aankoopafdeling ondertekende contracten per e-mail naar de boekhoudafdeling met een gemiddelde vertraging van 3 tot 5 werkdagen.

Na implementatie van een Node.js-middleware die Certyneo-webhooks ontvangt en de Sage-API aanroept, is de koppelingstijd tot enkele seconden teruggelopen. Verplichtingen buiten de balans worden nu in realtime geboekt, wat de betrouwbaarheid van tussentijdse situaties die aan de CFO worden gepresenteerd, heeft verbeterd. Het project werd in minder dan twee weken door een interne ontwikkelaar voltooid, met steun van de webhook-documentatie van het Certyneo-helpcentrum.

Scenario 3: een groep ondernemingen die complexe intercompany-stromen beheert

Een groep bestaande uit een tiental dochterondernemingen gebruikt Certyneo voor het ondertekenen van kasconventies tussen ondernemingen onderling en intra-groepsdienstenprestaties. Boekhoudkundige consolidatie vereist dat elke ondertekende overeenkomst tegelijk in het systeem van zowel de verzendende als de ontvangende dochteronderneming wordt geregistreerd, met dezelfde document-ID om eliminatie van wederkerige stromen te vergemakkelijken.

Door een unieke webhook te configureren die tegelijk de eindpunten van beide betrokken dochterondernemingen in kennis stelt (geïdentificeerd via de envelopmetagegevens), heeft de groep verschillen in consolidatie als gevolg van ontbrekende of verkeerd gereferentieerde stukken geëlimineerd. De consolidatieafsluitingstermijn is gemiddeld met 2 dagen verkort, wat een significante winst oplevert voor een groepsdirectie financiën die driemaandelijks afsluit. Teams die een migratie vanuit een ander systeem overwegen, kunnen het migratiehandleiding naar Certyneo raadplegen om de technische haalbaarheid te evalueren.

Conclusie

Certyneo-webhooks vormen een krachtig automatiseringshulpmiddel voor eenieder die elektronische handtekeningen in het hart van zijn boekhoudkundige proces wil integreren. Door stappen tussen het ondertekenen van een document en de registratie ervan in de ERP of boekhoudingssoftware uit te schakelen, verkorten zij doorlooptijden, verminderen zij invoerfouten en verkleinen zij risico's op ontbrekende stukken bij een balans of controle. Of het nu gaat om een boekhoudkantoor, een MKB of een multientitygroep, de webhookconfiguratie is toegankelijk — met of zonder ontwikkelaar — en de investeringsopbrengst laat zich al in de eerste weken van gebruik meten.

Ga naar het Certyneo-helpcentrum voor verdere informatie voor volledige API- en webhookdocumentatie. Klaar om uw boekhoudkundige balans te automatiseren? Maak gratis uw Certyneo-account aan en koppel vandaag nog uw eerste ondertekende documenten aan uw ERP.