Webhooks Certyneo: Gluaiseachán an bhilléad chuntasaíochta in ERP

Nuair a bhíonn doiciméad sínithe go leictreonach trí Certyneo, cad a tharlaíonn ina dhiaidh sin i do shlabhra cuntasaíochta? I gcás an chuid is mó d'fhiontair, is é an freagra fós ró-bhocht: gan fhíorchuid uathoibríoch ann. Íoslódálann comhoibrí an PDF sínithe go láimhdhírithe, a sheoladh trí r-phost chun an bainisteora cuntasaíochta, a athchuir ansin ina bhonneagar bainistíochta. Gineann an próiseas bhriste seo earráidí, moill agus cailliúint rian-fhaisnéise atá neamhchomhoiriúnach le riachtanais bhilléad chuntasaíochta iontaofa. Freagraíonn webhooks Certyneo go beacht don ghéarchéim seo: tugann siad deis duit gníomhartha a thosú go huathoibríoch i do chórais thríú páirtí — ERP, bogearraí cuntasaíochta, GED — is geal ar thuairim sinithe a tharlaíonn. Míníonn an alt seo go soiléir duit conas na webhooks seo a bhogearraigh agus a bhaint chun do thimthriall cuntasaíochta ó bharr go bun a gealadh.

Cad é webhook agus cén fáth go bhfuil sé riachtanach do chuntasaíochta

Prionsabal an webhook mínithe go simplí

Is meicníocht fógra HTTP i bhfíor-am atá i webhook: in ionad a iarraidh go rialta ar API "an bhfuil aon rud athraithe?" (cur chuige ar a dtugtar polling), is é an feidhmchlár arna scaoileadh — anseo Certyneo — a sheolann iarratas POST HTTP i dtreo URL de do rogha ar feadh rud ar leith a tharlaíonn. I gcuntasaíochta, ciallaíonn sé seo, ag an nóiméad cruinn inar síníonn ardaitheoir ordú, conradh soláthairt nó nóta costais go leictreonach, gur féidir le do ERP a bheith feasach an bheal ar bhealach tosaigh, gan idirghabháil daonna.

Seachas ní amháin easpórtáil CSV nó tuairisc mhíosúil, baineann an webhook leasuithe comhsheasmhachta gar-i bhfíor-am. Do bhainisteoirí cuntasaíochta atá ag bainistiú dhúnadh míosúil nó ráithiúil, tá an chomhghéilleadh bhreise seo ríthábhachtach: bíonn píosaí fíorite ar fáil sa bhonneagar láithreach ar a síniú iad, agus ní ar dheireadh an mhí in iomarcaíochta dhochosúil.

Imeachtaí Certyneo a spreagann billéad chuntasaíochta

Nochtann Certyneo roinnt cineálacha imeachtaí trí webhooks, go díreach inúsáidte i gcomhthéacs cuntasaíochta:

• `envelope.completed` : thug gach páirtí sínithe an doiciméad — is é seo an spreagadh príomha chun píosa fíoraistithe a chur i do ERP.
• `envelope.declined` : dhiúltaigh sínítheoir — is úsáideach chun an seirbhís chuntasaíochta a threorú faoi bhillín choigrithe.
• `envelope.expired` : tá an sprioc sínithe imithe thart — ceadaíonn sé do ghníomhaireacht a atosú agus folúain a sheachaint ar an gcuntasaíochta.
• `signer.signed` : síniú páirteach páirtí — ábhartha do chonarthaí iol-bhall sínithe (ex: bailéireacht thráchtála agus síniú an bhailléara agus an té a ghabhann).

Tá gach payload JSON seoladh trí Certyneo geal ar na meiteashonraí riachtanach: aitheantóir doiciméad, am cáilíochtúil, ainmneacha sínítheoirí, URL slán-dhíonta PDF sínithe agus an rian-chlabhdhússhonraí. Tá na sonraí struchtúrtha seo go díreach inúsáidte ag ERP nó bogearraí chuntasaíochta.

Cumraitheoireacht céim-ar-chéim na webhooks Certyneo do ERP

Cruthaigh agus cláruithe endpoint webhook

Cuirtear cumraitheoireacht webhook Certyneo i gcrích ó an tábla dóchais, Socruithe > Comhpháirtíochtaí > Webhooks. Seo na chéimeanna príomha:

1. Sainmhínigh an URL sprioc : is é seo an endpoint nochta ag do ERP nó do dhíothú-idirdhealú comhtháthaithe (ex: endpoint faoi leith i SAP, Sage, Cegid nó uirlis iPaaS ar nós n8n, Make nó Zapier).
2. Roghnaigh na himeachtaí atá le éisteacht : do bhilléad chuntasaíochta, tabhairt i láthair ar a laghad `envelope.completed` agus `envelope.declined`.
3. Cumraigh an rúnda sínithe HMAC : síníonn Certyneo gach payload le heochar rúnda a bhailítear tú. Ní mór do do endpoint an síniú seo a fhíorú chun go bhfuil na fógra a bheidh urchomhaireamhach — céim slándála nach féidir a sheachaint.
4. Triail le modh inúsáidte : ligionn Certyneo duit payload tástála a sheoladh gan doiciméad fíor a chruthú. Fíoraigh go bhfuil do endpoint ag freagairt ar bhealach ceart le HTTP 200.

Mapáil na sonraí an payload i dtreo do phlean chuntasaíochta

Nuair a bhíonn an endpoint feidhmiúil, ní mór duit na réimsí payload Certyneo a mhapáil i dtreo na réimsí a bhíonn ag súil le do ERP. Seo sampla d'loighic mapála do chonradh soláthairt:

```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" } } ```

Tá réimse `metadata` saor do-chumraigh nuair a bhíonn an envelopeáil cruthaithe tríd an Certyneo API. Is é seo an eochair chun gach síniú a shaibhriú le na sonraí gréine riachtanach don chuntasaíochta uathoibríoch: uimhir chuntais, ionad costas, gealadh cuntasaíochta, agus mar sin de. Chun na féidearthachtaí comhtháthaithe teicniúla a dhoimhniú, féach ar an ionad cabhraí Certyneo atá dó-dhíriú a fhairsinge a bhaint do an doiciméadú iomlán API.

Bainistigh na diúltuithe agus na ceisteanna athráite go huathoibríoch

Féadfaidh webhook a theip má tá do endpoint as láthair go sealadach. Dála an fhíorvéarsa polasaí ath-scuab foirceannadach: i gcás easpa freagartha HTTP 2xx, athraithníonn an chóras an seoladh ag eatraimh fhás (5 nóiméad, 30 nóiméad, 2 uair an chloig, 24 uair an chloig) ar fhuinneog 72 uair an chloig. Taobh thall, marcálann an webhook i dtheip agus scaoileann fógra its an tábla dóchais.

Do chuntasaíochta, tá an dhúnmhaireachta seo ríthábhachtach: is féidir le píosa fíoraistithe nach bhfuair ann i do ERP imchosc a chur ar ar an bpróisiósáil. Dá bhrí sin, moltar an meicníocht webhook a thimpeallú le jab comhthátú laethúil a chuirimid san API Certyneo chun envelopes a liostaigh sínithe sa 24 uair an chloig is déanaí agus bheidh a bhfianaise ina bhonneagar chuntasaíochta.

Comhtháthú le príomh-ERP agus bogearraí chuntasaíochta

Nasc go nádúrtha le Cegid, Sage agus Pennylane

Bhíonn roinnt eagraíochtaí bogearraí chuntasaíochta i ngnáthúsáid sa Fhrainc ag tairiscint nascairí nó API REST comhoiriúnach le webhooks Certyneo. Seo na patrúin chomhtháthaithe is coitianta:

Cegid XRP Flex : nochtann API REST chun píosaí chuntasaíochta a chruthú agus comhaid a cheangal. Spreagann an webhook `envelope.completed` glaoch POST i dtreo Cegid API chun an iontráil a chruthú agus an PDF sínithe a cheangal mar fhíoraistí dhigiteach.

Sage 100cloud / Sage 50 : is é an cur chuige molúnach an cnuasach trí dhíothú-idirdhealú éadrom (script Python nó Node.js ar fhógraí serverless) a fhaigheann an webhook Certyneo, íoslódálann an doiciméad tríd an URL slán agus cuirtar i bhfillteán iompórtála uathoibríoch Sage.

Pennylane : réiteach fhliuch-nádúrtha ar a bhfuil API a ghilltear go díreach ag doiciméad le meiteashonraí chuntasaíochta. Tá an comhtháthú webhook-Pennylane go háirithe oiriúnach do chabinéid dheas-chuntais a chumasaíonn píosaí ó roinnt cliant — cás úsáide ar thugamar soilsiú ina rannóg scéimh.

Do theamaí atá ag measúnú réitigh dhifriúil sula nglacann siad ar Certyneo, soláthraíonn an comparáid na réiteach sínithe leictreonach dearcadh soiléir ar na cumas comhtháthaithe de gach ardán.

Úsáid iPaaS ar nós Make nó n8n do dhaoine neamh-fhorbairteoirí

Mura bhfuil foireann theicniúil dírithe fúithu, is léiriú éasca iad ardáin uathoibrithe gan-cód/íseal-cód (Make, n8n, Zapier). Is simplí an prionsabal:

1. Cruthaigh scéim le trigger webhook ar Make nó n8n — an URL ginte a fheidhmiú mar endpoint Certyneo.
2. Cumraigh na gníomhartha seo a leanas: íoslódáil an doiciméad sínithe, parsáil na meiteashonraí, cur chuig Google Drive / SharePoint, líne a chruthú i dtábla a rianú, fógra Slack don bhainisteoira chuntasaíochta.
3. Go roghnach, spreag glaoch API i dtreo do bhogearraí chuntasaíochta chun an iontráil a chruthú.

Tugann an cur chuige seo leibhéal ard uathoibrithe a bhaint i níos lú ná lá amháin, gan líne amháin cóid a scríobh. Tá sé go háirithe infheidhme do TPE/PME nó do bhainisteoirí cuntasaíochta is mian leo bailiú píosaí a uathoibriú dá gcliaint gan fhorbóir a dhíol.

Leanaslínte maithe don tsláinte agus don taifead do webhooks chuntasaíochta

Fíorú na síní HMAC agus a shábháil ar na endpoints

I gcomhthéacs cuntasaíochta, tá iontaoibh na sonraí a bhfuarthas trí webhook ríthábhachtach. Dá bhféadfadh ionsaitheoir droch-imeachtaí `envelope.completed` a chur isteach, d'fhéadfadh sé do chuntasaíochta a bhréagriomh. Cuireann trí bheart slándála fúithi:

• Fíorú HMAC-SHA256 : áirítear le gach iarratas Certyneo ceanntásc `X-Certyneo-Signature`. Ní mór do do endpoint an síniú seo a athchomhairliú le do heochar rúnda agus a chur i gcomparáid — diúltaigh aon iarratas nach bhfuil an síniú ar fhonn orthu.
• Bailíochtú an scéim JSON : roimh aon dheasú, bailíochtaigh an struchtúr agus na cineálacha an payload a fuarthas. Réimse `montant_ht` ar luach `null` nó diúltach ní mór a thosú fógra, nach iontráil chuntasaíochta earráideach.
• Logáil imréite: coinnigh gach payload a fuarthas i logadh ama-ord agus nach féidir a athrú le haghaidh ar a laghad 10 mbliana, i gcomhréir le hoibleagáidí caomhnaithe na bpíosaí chuntasaíochta (alt L123-22 den Chód Tráchtála).

Rian-fhaisnéis agus rian-riachtain do an bainisteora chuntasaíochta

Is é an t-ábhar ba bhreá le cur chuige webhook an rian-iontasc iomlán a ghineann sé. Táirgíonn Certyneo i gcás gach doiciméad sínithe rian-riachtain (audit trail) i gcomhréir le riachtanais eIDAS, idir an horadstampáilí cáilíochtúil, seoltaí IP na sínítheoirí agus na teastas a úsáidtear.

I mbaint an rian-riachtain seo le payload webhook, is féidir le do ERP níos mó ná an píosa fíoraistithe a stóráil, ar an gcumhachtaí fíoraithneachta dlíthiúil. Do bhainisteoirí cuntasaíochta nó comhdhuine dearbhuithe, simplifíonn an dhá shreatha seo — doiciméad + cruthúnas — na fíoraithne go mór agus faireann nó athbhreithniú. An sínithe leictreonach i ngeilleagar a leabaidh na leibhéalta sínithe agus ar fhíoraithne iad i gcoitinní gréine éagsúla.

Chun an toradh ar a infheidhm a ríomh sula dtosaíonn tú, an áireamhán ROI Certyneo a ligeann duit an spréacharnach agus na gearrthéarmaí costas a thuar go beacht dar le do dhóthain doiciméad sínithe.

Creat dlí infheidhme do webhooks agus chuntasaíochta dhigiteach

Coimeádann na webhooks sínithe leictreonaí Certyneo a uathoibriú sa shlabhra chuntasaíochta i gcreat reachtraigh soiléir is gá a bhainistiú.

Rialachán eIDAS n°910/2014 (agus a athbhreithniú eIDAS 2.0) : leagann an rialachán Eorpach ar aitheantúchán leictreonach agus seirbhísí iontaoibhe an fhíoraithneacht dlíthiúil na síní leictreonacha. Leagann an t-alt 25 nach féidir a dhiúltú a bheith a bheidh ag feidhmiú nó i gcruth leictreonach amháin. Bhonnann síní cáilíochtúil (QES) ar bharántúnas iontaoibhe i gcomhionann le síniú scríofa. I gcomhair píosaí chuntasaíochta, braitheann leibhéal an tsínithe oiriúnach ar nádúr an doiciméad: is féidir le billín simplí athair ar síniú ard-bhartha (AES), agus gur riachtanach síniú cáilíochtúil do chonarthaí creidimh-bhréathnú nó gníomhaireacht notaraithe leictreonach.

Cód sibhialta, arthaigil 1366 agus 1367 : leagann an t-alt 1366 an scríobh leictreonach ar fáil mar fhíoraithne ar chomhionann le scríobh ar thacaí páipéir, ar choinníoll go bhféadfaidh sé a bheidh dóchúil an duine ón ionad sé eolas agus go bhfuil sé bunuithe agus buan-fhaisnéisí i ndócha a ghealadh go bhfuil a bhfíoraithne. Sainmhíníonn an t-alt 1367 sínithe leictreonach mar úsáid ar dhóigh-oibriú iontaoibh ar agus atá socraithe leis an gníomhaireacht ar bhaineann sé. An webhook Certyneo, ag soláthar an rian-riachtain le gach doiciméad sínithe, gealadh ar an réachtú seo ar aitheantúchán agus ar bhfíoraithne.

Alt L123-22 an Chód Tráchtála : ní mór na doiciméad chuntasaíochta agus na píosaí fíoraistithe a bhí ar fáil ar feadh deich mbliana. Ní mór na doiciméad a fuarthas trí webhook agus stóráilte i ERP a bheidh faoi dhóchas caomhnaithe comhoiriúnach, lena n-áirítear imréadh agus léirthuisceana ar fhad na bhformáidí (PDF/A molúnach de ISO 19005).

RGPD n°2016/679 : tá na payloads webhook ina bhfuil sonraí pearsantúla (ainmneacha sínítheoirí, seoltaí r-phost, ama-thomhaiseanna a bhainean le daoine). Is ionad is scoir d'fhaisnéis nó co-ionad de réir na mód conarthaí le Certyneo. Ní mór an DPA (Data Processing Agreement) a fhormáil. Ní mór na sonraí a sheoladh a bhí ag an ní-gheal do bhunúsacht chuntasaíochta.

Treoir NIS2 (2022/2555) : i gcomhair fhiontair a bhí ar bharr-leagain NIS2 (oibreoirí seirbhísí riachtanacha, eintiteas tábhachtach), is beart slándála líonra dligheanta an tsláinte na comhéifeachtaí API agus webhooks. Cuireann an fíorú HMAC, an criptchlabhdhússhonraí TLS 1.3 ar a laghad agus an logáil ar rochtain i gcrích.

Caighdeán ETSI EN 319 132 : sainmhíníonn an fhormáid XAdES do síní leictreonacha ard-bhartha. Gealadh an síní a tháirg Certyneo na caighdeán ETSI seo, agus a ráthaigh a chomhpháirt-oibriu le chórais dhabhaithe a raibh fíoraithne bhártha a chomhaontú riachtanach (RGS) Francach.

Scéimh úsáide chríochúla

Scéim 1: caibinéid dheas-chuntais a bhainistiú 40 dossier chliaint

Bhainistíonn caibinéid dheas-chuntais (deich gcollaborator nó mar sin) na litreacha an gealadh, mandáidí SEPA agus cuntas bliantúil 40 gnó chliaint. Roimh an chomhtháthú na webhooks Certyneo, ghlac gach doiciméad sínithe ag bainisteoira dossier go láimhdhírithe, athainmníochán de réir na coinbhinsiúnach ainmniucháin, agus ansin leag ina fhillteán cliant an bogearraí táirgthe chuntasaíochta. Bhí an próiseas seo ag ionadaíocht thart 15 go 20 nóiméad de gach doiciméad, is é sin roinnt uair an chloig sa tseachtain in am dúnadh.

Tar éis cumraitheoireacht webhook `envelope.completed` ceangailte do a bhonneagar GED tríd Make, tá an caibinéid diomainte a gealadh an t-iomlán a seo: ar an síniú ar an bhfailli, tá an PDF sínithe ionradh i bhfillteán an cliant ar leith le an ceart ainm comhaid, fógra a shéoltar don bhainisteoira pádraigean, agus líne a dhéantar i dtábla a rianú na bpíosaí a fuarthas. Tá an spréacharnach am a gheal thart 70 go 80% ar an dtasc seo, is é sin thart 6 go 8 uair an chloig a fhilleadh sa tseachtain an am dúnadh — figiúr atá i gcomhréir leis na benchmarks foilsithe ag an Ordú na Bainisteorí Cuntasaíochta ina ghearrthéarmaí ar an dtrasformáid dhigiteach na caibinéid.

Scéim 2: PME a tionscal le ERP Sage agus 300 conarthaí soláthairt bliantúil

Síníonn PME sa ghéag tionscal thart 300 conarthaí soláthairt sa bhliain (orduithe-charmháin, athruithe, comhaontuithe rúnda). Ní mór gach conradh sínithe a bheith i gceangal le fiche soláthairt i Sage 100cloud agus a bhí ar fáil go mar fhíoraistí dhealrúnaiceach. Gan uathoibriú, ar an tseirbhís breise a ranna an soláthairt sínithe tríd an r-phost chuig an seirbhís chuntasaíochta le moill meánach 3 go 5 lá oibre.

Tar éis tomhas middleware Node.js a fhigheadh ar webhooks Certyneo agus ag glaoch ar Sage API, thit an moill cheangail i nóiméad ar bith. Anois tá na géasanna roimhe an bhilléad scríobh i bhfíor-am, rud ar thug an cumas ar fhear a bhainistiú na gcodanna idir-dhealrúnaiche atá ar fáil ar an DAF. Rinneadh an tionscnamh in níos lú ná dhá sheachtain ag forbóir inmheánach, ag baint úsáid as an doiciméadú webhook den ionad cabhraí Certyneo.

Scéim 3: grúpa gnó i bhainistiú na sruthaí idirmheánach casta

Cruthaíonn grúpa ó dhá fhillteán (deich n-aonáin bhreise) i úsáid Certyneo chun a choinbhinsiúin treasúra intercompany agus a chonarthaí a shonraítí idirghréine a shíniú. Soláthraíonn an dúnadh chuntasaíochta gur ní mór gach coinbhinsiún sínithe a bheith ag clárú go comhcheaptha i gcóras an aonaid gheal agus an aonaid ghlactha, ar an gceannóir doiciméad céanna chun an díscríobh a dhéanamh níos fhéidiúil.

I cumraitheoireacht webhook ar leith a fógra ar an chomh-endpoints an dá aonaid agus (aithnaithe tríd an meiteashonraí an envelopeáil), tá an grúpa diomainte a dhíscríobh na gcodanna dúnadh a bheith i gceangal le píosaí a bhí ó gheal nó mhícheart-thagairt. Bhí an moill dúnadh ar chonsolaíocht laghdaithe le 2 lá ar an meán, rud ar ionann ar phraghas mór do threorúchán airgeadais grúpa a dhúnadh go tríchéalach. Má tá foireann ag smaoineamh ar imscríobh ó bhunús eile ar féidir a dhéanamh, féach ar an treoir aistrithe chuig Certyneo chun an bhuan-inneach teicniúil a thúiscint.

Conclusion

Is leabhar cumhachtach do aon iompar is mian gur sínithe leictreonach a iompar i gcroílár a phróiseas chuntasaíochta na webhooks Certyneo. I géilleadh na chéimeanna láimhdhírithe idir sínithe an doiciméad agus a chlárú i ERP nó an bogearraí chuntasaíochta, laghdaíonn siad na moilleanna, na hearráidí iontráil agus na rioscaí píosaí a bhí ar oscailt nuair a bhí an dúnadh nó athbhreithniú. Cibé ar bhabhraí sé ar bhainisteoira cuntasaíochta, PME nó grúpa iol-ghnó, is féidir an cumraitheoireacht webhook a bhaint — fúithi nó gan fhorbóir — agus is féidir an toradh ar infheidhm ar toradh na chéad tseachtain úsáide.

Chun dul i ngleic níos faide, ionad cabhraí Certyneo a bhreithniú ar an doiciméadú iomlán API agus na webhooks. An bhfuil tú réidh d'uathoibriú a bhilléad chuntasaíochta? Cruthaigh do chuntas Certyneo in aisce agus ceangal do chéad dhocumenta sínithe i do ERP inniu.