Webhooks Certyneo : avtomatizacija zaključnih računov v ERP-u

Ko je dokument elektronsko podpisan prek Certyneo, kaj se zgodi v vaši računovodski verigi? Za večino podjetij je odgovor še vedno premalo pogosto naslednji: nič avtomatskega. Delavec ročno preusmeri podpisan PDF, ga pošlje po e-pošti računovođi, ki ga nato ponovno vnese v svoj upravni sistem. Ta razdrobljenproces povzroča napake, zakasnitve in izgubo sledljivosti, ki je nezdružljiva s zahtevami zanesljivega zaključnega računa. Webhooks Certyneo so odgovor na to problematiko: omogočajo avtomatsko sproženje dejanj v vaših tretjih sistemih — ERP, računovodski programi, GED — takoj, ko se zgodi dogodek podpisovanja. Ta članek vam podrobno pojasnjuje, kako konfigurirati in uporabljati te webhooks za gladko računovodsko krogotečnost od začetka do konca.

Kaj je webhook in zakaj je bistven za računovodstvo

Princip webhooks razložen enostavno

Webhook je mehanizem obvestila HTTP v realnem času: namesto da redko sprašujete API »se je kaj spremenilo?« (pristop imenovan polling), je aplikacija, ki pošilja — v tem primeru Certyneo — tista, ki pošlje zahtevo HTTP POST na naslov po vaši izbiri, takoj ko se zgodi natančen dogodek. V računovodstvu to pomeni, da se v točnem trenutku, ko je naročilo za nakup, pogodba s ponudnikom ali poročilo o stroških elektronsko podpisano, lahko vaš ERP takoj obvestite, brez človeške intervencije.

V nasprotju s preprostim izvozom CSV ali mesečnim poročilom webhook zagotavlja sinhronizacijo skoraj v realnem času podatkov. Za računovođo, ki upravlja zaključke na mesečni ali četrtletni ravni, je ta granularnost odločilna: dokazni dokumenti so na voljo v sistemu takoj po podpisanju, ne pa ob koncu meseca pri napornemu lovljenju zamujenih podatkov.

Dogodki Certyneo, ki sprožijo zaključni račun

Certyneo preko webhooks izpostavlja več vrst dogodkov, ki so neposredno uporabljivi v računovodskem kontekstu:

• `envelope.completed` : vse strani so podpisale dokument — to je glavni sprožilec za vbrizgavanje dokaznega dokumenta v vaš ERP.
• `envelope.declined` : podpisnik je zavrnil — koristno je za obvestilo računovodskega oddelka o sporni fakturi.
• `envelope.expired` : rok za podpisovanje je presežen — omogoča ponovno sproži procedures in izognete se luknji v računovodstvu.
• `signer.signed` : delna podpis strani — je relevanten za pogodbe z več podpisniki (npr.: najemna pogodba, ki zahteva podpis najemnika in najemca).

Vsak JSON payload, ki ga pošlje Certyneo, vsebuje bistvene metapodatke: identifikator dokumenta, kvalificirani časovni žig, imena podpisnikov, varno URL naslov za prenos podpisanega PDF-ja in revizije sled. Ti strukturirani podatki so neposredno uporabljivi v ERP-u ali računovodskem programu.

Korak za korakom konfiguracija webhooks Certyneo za ERP

Ustvarjanje in registracija webhook endpoint-a

Konfiguracija webhooks Certyneo se izvede iz nadzorne plošče, razdelka Nastavitve > Integracije > Webhooks. Tu so ključni koraki:

1. Opredelite ciljni naslov URL : to je endpoint, ki ga izpostavlja vaš ERP ali vaš middleware za integracijo (npr.: namenski endpoint v SAP, Sage, Cegid ali orodju iPaaS kot je n8n, Make ali Zapier).
2. Izberite dogodke za poslušanje : za zaključni račun v prvi vrsti izberite `envelope.completed` in `envelope.declined`.
3. Konfigurira skrivnost podpisa HMAC : Certyneo podpiše vsak payload s skrivno ključem, ki ga vi določite. Vaš endpoint mora preveriti ta podpis, da zagotovite pristnost obvestil — korak varnosti, ki ga ni mogoče preskočiti.
4. Testiranje v načinu simulacije : Certyneo omogoča pošiljanje testnega payload-a brez izdelave pravega dokumenta. Preverite, da vaš endpoint pravilno odgovori s HTTP 200.

Preslikava podatkov payload-a na vaš računovodski načrt

Ko je endpoint operacijski, morate preslikati polja Certyneo payload-a na polja, ki jih pričakuje vaš ERP. Tu je primer preslikave logike za pogodbo s ponudnikom:

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

Polje `metadata` je prosto nastavljivo pri ustvarjanju ovoja prek Certyneo API. To je ključ za obogatitev vsake podpisa z poslovnimi podatki, potrebnimi za avtomatsko računovodsko knjiženje: številka računa, stroškovnega mesta, poslovnega leta itd. Za poglobljeno razumevanje možnosti tehnične integracije si oglejte Certyneo pomoč center, ki vsebuje celotno API dokumentacijo.

Upravljanje zavrnitev in avtomatskih ponovnih poskusov

Webhook lahko odpove, če je vaš endpoint privremeno nedostopen. Certyneo izvaja politiko eksponentnega poskusa : v primeru odsotnosti HTTP 2xx odgovora sistem ponovni poskus pri naraščajočih intervalih (5 min, 30 min, 2 h, 24 h) v obdobju 72 ur. Po tem je webhook označen za napako in opozorilo se prikaže v nadzorni plošči.

Za računovodstvo je ta odpornost ključna: dokazni dokument, ki ga ne sprejmete v ERP, lahko povzroči neskladje v računovodski bilanci. Zato je priporočljivo, da webhook dopolnite z dnevnim usklajevalnim opravilom, ki poizveduje Certyneo API za seznam čeprav zaključenih ovoj v zadnjih 24 urah in preveri njihovo prisotnost v računovodskem sistemu.

Integracija z glavnimi ERP in računovodskimi programi

Domačo povezavo s Cegid, Sage in Pennylane

Več izdajateljev priljubljenih računovodskih programskih rešitev v Franciji ponuja priključke ali REST API-je, kompatibilne s webhooks Certyneo. Tu so najpogostejši vzorci integracije:

Cegid XRP Flex : izpostavlja REST API, ki omogoča ustvarjanje računovodskih postavk in pripenjanje datotek. Webhook `envelope.completed` sproži poziv POST na API Cegid za ustvarjanje vnosa in pripenjanje podpisanega PDF-ja kot digitalne dokazila.

Sage 100cloud / Sage 50 : priporočljiv pristop poteka preko lahnega middleware-ja (Python ali Node.js script gostovan v serverless) ki prejme webhook Certyneo, preusmeri dokument prek varnega URL naslova in ga odloži v avtomatic-import mapo Sage.

Pennylane : rešitev, ki je izvirno v oblaku in katere API neposredno sprejme dokumente s svojo računovodsko metapodaci. Integracija webhook-Pennylane je posebej primerna za pisarne računovodij, ki centralizirajo dokumente več strank — primer uporabe, ki ga podrobnostiabamo v razdelku scenariji.

Za ekipe, ki ocenjujejo različne rešitve pred prenosom v Certyneo, primerjava rešitev elektronskega podpisa ponuja podroben pregled zmogljivosti integracije po platformi.

Uporaba iPaaS-a kot Make ali n8n za ne-razvijalce

Če vaša organizacija nima dediciranega tehničnega tima, so platforme za avtomatizacijo brez kode/nizke kode (Make, n8n, Zapier) učinkovita alternativa. Princip je preprost:

1. Ustvarite scenarij z trigger webhooks na Make ali n8n — generirani URL služi kot Certyneo endpoint.
2. Konfigurira naslednje dejanja: preusmeri podpisanega dokumenta, razčleni metapodatke, pošlji v Google Drive / SharePoint, ustvari vrstico v tabelo sledi, pošlji obvestilo Slack odgovornemu za računovodstvo.
3. Po izbiri sproži poziv API na vaš računovodski program za ustvarjanje vnosa.

Ta pristop omogoča doseganje visoke ravni avtomatizacije v manj kot enem dnevu brez pisanja kode. Je posebej primerna za mikro in majhna podjetja ali za računovode, ki želijo avtomatizirati zbiranje dokumentov za svoje stranke brez angažiranja razvijalca.

Najboljše prakse za varnost in revizijo webhooks računovodskih

Preverjanje HMAC podpisov in varnost endpoint-ov

V računovodskem kontekstu je zanesljivost podatkov prejete preko webhooks ključna. Napadalec, ki bi uspel vnesti napačne dogodke `envelope.completed`, bi lahko pokvaril vašo računovodstvo. Tri varnostne ukrepe je treba izvesti:

• Preverjanje HMAC-SHA256 : vsaka zahteva Certyneo vsebuje glavo `X-Certyneo-Signature`. Vaš endpoint mora ponovno izračunati podpis s svojo skrivno ključem in primerjati — zavrnite vsako zahtevo, katere podpis se ne ujema.
• Validacija JSON sheme : preden katero koli obdelavo, potrdi strukturo in vrste prejete obremenitve. Polje `montant_ht` z vrednostjo `null` ali negativno bi moralo sprožiti opozorilo, ne pa nepravilnega računovodskega vnosa.
• Nespremenljivo dnevnik : ohranite vsak prejeti payload v datumski in nespremenljivi dnevnik vsaj 10 let, v skladu z obveznostmi hranjenja računovodskih dokumentov (članak L123-22 Trgovskega zakonika).

Sledljivost in revizijska sled za računovođo

Ena od glavnih prednosti webhooks pristopa je sledljivost od konca do konca, ki jo ustvari. Certyneo proizvede za vsak podpisan dokument revizijsko sled (audit trail), ki je skladna s zahtevami eIDAS, vključno s kvalificiranim časovnim žigom, IP naslovi podpisnikov in uporabljeni certifikati.

Z povezovanjem te revizijske sledi s Certyneo payload-om, vaš ERP ne more samo shraniti dokaznega dokumenta, temveč tudi dokaz njegove pravne veljavnosti. Za revirja ali računovođo je ta dvojna plast — dokument + dokaz — občutno poenostavi preverjanje med revizijo ali pregledom. Elektronski podpis v podjetju podrobno opisuje ravni podpisovanja in njihovo dokazno vrednost v različnih poslovnih kontekstih.

Za izračun donosnosti naložbe te avtomatizacije, preden se lotite, kalkulator ROI Certyneo vam omogoča natančno oceno prihrankov časa in stroškov glede na vaš obseg podpisanih dokumentov.

Pravni okvir za webhooks in digitalno računovodstvo

Avtomatizacija računovodske verige prek webhooks elektronskega podpisa se vpisuje v poseban regulativni okvir, ki ga je treba razumeti.

Uredba eIDAS št. 910/2014 (in njena revizija eIDAS 2.0) : evropska uredba o elektronski identifikaciji in storitvah zaupanja določa pravno veljavo elektronskih podpisov. Artikel 25 pravi, da se elektronskemu podpisu ne sme zavregniti pravni učinek le zato, ker je v elektronski obliki. Kvalificirani podpisi (QES) imajo domnevo zanesljivosti, enakovredno ročnemu podpisu. Za računovodske dokumente je primerna raven podpisa odvisna od vrste dokumenta: preprostega računa je mogoče podpisati s naprednim podpisom (AES), medtem ko pogodba o najemu ali elektronski notarski dejanjski dokument zahteva kvalificirani podpis.

Civilni zakonik, članski 1366 in 1367 : člen 1366 priznava elektronski dokument kot dokazilo na isti ravni kot dokument na papirnatih nosilcih, pod pogojem, da je mogoče primerno identificirati osebo, od katere izvira, in da je v pogojih vzpostavljen in ohranjen tako, da se zagotovi njegova celovitost. Člen 1367 definira elektronski podpis kot uporabo zanesljive postopke prepoznavanja, ki zagotavlja povezavo z dejanjem, h kateremu se veže. Webhook Certyneo, ki prenaša revizijsko sled z vsakim podpisanim dokumentom, izpolnjuje to zahtevo za prepoznavanje in celovitost.

Člen L123-22 Trgovskega zakonika : računovodski dokumenti in dokazni dokumenti morajo biti hranjeni 10 let. Dokumenti, prejeti prek webhooks in shranjeni v ERP-u, morajo biti zato skladni s politiko hrambe, vključno z nespremenljivostjo in dolgoročno čitljivostjo formatov (PDF/A priporočen s standardom ISO 19005).

GDPR št. 2016/679 : obremenitve webhooks vsebuje osebne podatke (imena podpisnikov, e-pošte, časovni žigi vezani na posameznike). Vaš endpoint in ERP so prejemniki teh podatkov — odgovorna ste za obdelavo ali soodgovorna glede na pogodene pogoje s Certyneo. DPA (dogovor o obdelavi podatkov) je treba formalizirati. Prenešeni podatki morajo biti omejeni na strogo potrebno za računovodski namen.

Direktiva NIS2 (2022/2555) : za podjetja v NIS2 obsegu (operaterji nujnih storitev, pomembne entitete) je varnost API in webhook vmesnikov obvezni ukrep varnosti omrežja. Preverjanje HMAC, šifriranje TLS 1.3 najmanj in dnevnik dostopov se nalagajo.

Standard ETSI EN 319 132 : definira XAdES format za napredne elektronske podpise. Podpisi, ki jih proizvede Certyneo, upoštevajo te standarde ETSI, ki zagotavljajo njihovo interoperabilnost s sistemi za hranjenje z dokazno vrednostjo, skladni s splošno varnostno direktivo (RGS) Francije.

Konkretni scenariji uporabe

Scenarij 1 : pisarni za svetovanje računovodstvu, ki upravlja 40 klientske datoteke

Pisarni s desetimi sodelavci upravlja s pismi o napotitvi, mandati SEPA in letnimi računi 40 družb — strank. Preden je integracija webhooks Certyneo, je bil vsak podpisani dokument ročno prejeti s strani vodje datoteke, ponovno imenovan glede na konvencijo poimenovanja, nato odložen v mapo stranke v računovodskem produkcijskem programu. Ta proces je predstavljal približno 15 do 20 minut za dokument, torej več ur na teden v obdobju zaključka.

Po konfiguraciji webhooks `envelope.completed` povezanega z njihovim GED orodjem prek Make je pisarna avtomatizirala celotno to verigo: takoj po podpisanju se podpisan PDF avtomatsko razvršči v ustrezno map stranke s pravim imenom datoteke, obvestilo se pošlje relevantnem vodje datoteke in vrstica je ustvarjena v tabeli sledi prejete pičk. Ocenjen časovni prihranek je približno 70 do 80% te naloge, torej približno 6 do 8 ur, pridobljenih tedensko v obdobju zaključka — figure skladna s primerjalno analizo, objavljeno v Redu računovodij v svojih poročilih o digitalni transformaciji pisarn.

Scenarij 2 : mikro proizvodno podjetje z ERP Sage in 300 pogodbe ponudniki letno

Mikro proizvodno podjetje podpiše približno 300 pogodb s ponudniki letno (naročila-okvirne, dodatki, sporazumi o zaupnosti). Vsak podpisan pogodba mora biti pritrjena k kartici ponudnika v Sage 100cloud in shranjena kot dokazni dokument o zavezi. Brez avtomatizacije je oddelek nabave poslal podpisane pogodbe po e-pošti računovodskemu oddelku s povprečno zakasnitve 3 do 5 delovnih dni.

Po uvedbi Node.js middleware-ja, ki prejima webhooks Certyneo in kliče API Sage, je zakasnitev pritrjevanja padla na nekaj sekund. Zaveze zunaj bilanc so zdaj računovodsko knjižene v realnem času, kar je izboljšalo zanesljivost vmesnih stanj predstavljenih vodji financ. Projekt je bil izpeljan v manj kot dveh tednih notranjega razvijalca z opiranjem na dokumentacijo webhook-a Certyneo Help Center.

Scenarij 3 : skupina podjetij, ki upravljaje kompleksne medsebojne tokove

Skupina, sestavljena iz deset podružnic, uporablja Certyneo za podpisovanje svojih dogovorov o zakladnici med podjetji in pogodb za intra-skupinske storitve. Konsolidacija računovodstva zahteva, da je vsak podpisani dogovor sočasno registriran v sistemu pošiljajoče podružnice in prejemnika, z enakim identifikatorjem dokumenta za lažje odpravo medsebojnih tokov.

Z konfiguracijo enega webhooks-a, ki sočasno obveščajo endpoint-e obeh vpletenih podružnic (identificiranih prek metapodatkov ovoja), je skupina odpravila neskladja konsolidacije, povezana z manjkajočimi ali nepravilno navedenim dokumenti. Čas zaključka konsolidacije je bil zmanjšan za povprečno 2 dni, kar predstavlja precejšnji dobitek za skupinsko finančno vodstvo, ki zaključuje četrtletno. Ekipe, ki razmišljajo o migraciji iz druge rešitve, lahko pregledajo vodnik za migracijo v Certyneo za oceno tehnične izvedljivosti.

Zaključek

Webhooks Certyneo predstavljajo močno avtomatizacijo za vsakega akterja, ki želi integracijo elektronskega podpisa v srce svojega računovodskega procesa. Črtanjem ročnih korakov med podpisanjem dokumenta in njegovim vnosom v ERP ali računovodski program zmanjšate zakasnitve, napake pri vnosu in tveganja manjkajočih dokumentov pri zaključnem računu ali reviziji. Ali je gre za pisarno za svetovanje računovodstvu, mikro podjetje ali skupino z več entitetami, je konfiguracija webhooks-a dostopna — z razvijalcem ali brez njega — in donosnost naložbe se meri že v prvih tednih uporabe.

Za več informacij si oglejte Certyneo Help Center za dostop do celotne dokumentacije API in webhooks. Pripravljeni avtomatizirati vaš zaključni račun? Ustvari svoj Certyneo račun brezplačno in povežite svoje prve podpisane dokumente z vašim ERP-om danes.