Webhooks Certyneo : automatiser le bilan comptable en ERP

Kada se dokument elektronski potpiše preko Certyneo, šta se dešava dalje u vašem računovodstvenom lancu? Za većinu preduzeća, odgovor je još uvek često: ništa automatsko. Saradnik ručno preuzima potpisanu PDF datoteku, šalje je e-poštom revizoru, koji je ponovno unosi u svoj softver za upravljanje. Ovaj fragmentirani proces generiše greške, kašnjenja i gubitak pracljivosti koji je neusklađen sa zahtevima pouzdanog računovodstvenog bilansa. Vebhukovi Certyneo precizno odgovaraju na ovaj problem: omogućavaju automatsko pokretanje radnji u vašim sistemima trećih strana — ERP, softver za računovodstvo, GED — čim se javi događaj potpisivanja. Ovaj članak vam detaljno objašnjava kako konfigurirati i koristiti ove vebhukove da biste ufluidificirali vaš računovodstveni ciklus od kraja do kraja.

Šta je vebhuk i zašto je bitan za računovodstvo

Princip vebhuka objašnjen jednostavno

Vebhuk je mehanizam HTTP obaveštenja u realnom vremenu: umesto da redovno pitati API "je li nešto promenjeno?" (pristup pozvan polling), aplikacija koja emituje — ovde Certyneo — šalje HTTP POST zahtev na URL vašeg izbora čim se javi tačno određeni događaj. U računovodstvu, to znači da u trenutku kada se narudžbenica, ugovor sa dobavljačem ili belešku o troškovima elektronski potpiše, vaš ERP može biti trenutno obaviješten, bez ljudske intervencije.

Za razliku od jednostavnog izvoza CSV-a ili mesečnog izveštaja, vebhuk garantuje sinhronizaciju gotovo-u-realnom-vremenu podataka. Za revizora koji upravlja mesečnim ili tromesečnim zatvaranjima, ova granularnost je odlučujuća: dokazni dokumenti su dostupni u sistemu čim se potpisuju, a ne na kraju meseca tokom mukotrpnog naknađivanja.

Certyneo događaji koji pokretaju računovodstveni bilans

Certyneo otkriva nekoliko tipova događaja preko vebhukova, direktno iskoristivih u računovodstvenom kontekstu:

• `envelope.completed`: sve strane su potpisale dokument — ovo je glavni pokretač za ubacivanje dokaznog dokumenta u vaš ERP.
• `envelope.declined`: potpisnik je odbio — korisno za upozorenje računovodstvene službe o osporavanoj fakturi.
• `envelope.expired`: rok za potpisivanje je istekao — omogućava vam da pokrenete ponovnu proceduru i izbegnete rupe u računovodstvu.
• `signer.signed`: delimična potpis jedne strane — relevantan za ugovore sa više potpisnika (npr. komercialni najmoprodajni ugovor koji zahteva potpis vlasnika i zakupca).

Svaka JSON korisnost poslata od Certyneo sadrži suštinski metapodatke: identifikator dokumenta, kvalifikovani vremenske pečati, imena potpisnika, sigurnu URL adresu za preuzimanje potpisane PDF datoteke i revizijsku pismo. Ovi strukturirani podaci su direktno iskoristivi od strane ERP-a ili softvera za računovodstvo.

Korak po korak konfiguracija vebhukova Certyneo za ERP

Kreiranje i registrovanje vebhuk krajnje tačke

Konfiguracija vebhuka Certyneo se vrši iz nadzorne ploče, odeljka Postavke > Integracije > Vebhukovi. Evo ključnih koraka:

1. Definisanje URL adrese odredišta: ovo je krajnja tačka koju izlažu vaš ERP ili vaš middleware za integraciju (npr. namenska krajnja tačka u SAP, Sage, Cegid ili alat iPaaS kao n8n, Make ili Zapier).
2. Izbor događaja koji treba pratiti: za računovodstveni bilans, dajte prednost najmanje `envelope.completed` i `envelope.declined`.
3. Konfiguriranje HMAC tajnog ključa za potpisivanje: Certyneo potpisuje svaku korisnost sa tajnim ključem koji vi definišete. Vaša krajnja tačka mora proveriti ovaj potpis da bi garantovala autentičnost obaveštenja — korak bezbednosti koji nije pregovarajući.
4. Testiranje u modu simulacije: Certyneo omogućava slanje test korisnosti bez kreiranja pravog dokumenta. Proverite da li vaša krajnja tačka pravilno odgovara sa HTTP 200.

Mapiranje podataka korisnosti u vaš plan računa

Čim je krajnja tačka operativna, trebate mapirati polja korisnosti Certyneo na polja koja očekuje vaš ERP. Evo primera logike mapiranja za ugovor sa dobavljačem:

```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 slobodno konfigurabilan pri kreiranju omotača preko API Certyneo. Ovo je ključ da obogatite svaki potpis podacima potrebnim za automatsku računovodstvenu obračun: broj računa, centar troškova, računovodstveni period, itd. Da biste dublje istražili mogućnosti tehnničke integracije, konsultujte Certyneo centar za pomoć koji katalogizuje celu API dokumentaciju.

Upravljanje odbijanjima i automatskim ponovnim pokušajima

Vebhuk može da ne uspe ako je vaša krajnja tačka privremeno nedostupna. Certyneo implementira politiku pokušaja sa eksponencijalnim povećanjem: ako nema HTTP 2xx odgovora, sistem ponovo pokušava na rastućim intervalima (5 min, 30 min, 2 h, 24 h) u prozoru od 72 sata. Nakon toga, vebhuk je označen kao neuspešan i upozorenje se prenosi na nadzornu ploču.

Za računovodstvo, ova otpornost je ključna: dokazni dokument koji nije primljen u ERP može stvoriti disparitet u bilansu. Stoga se preporučuje da se vebhuk mehanizam dopuni sa dnevnim poslom usaglašavanja koji upućuje API Certyneo uputu da nabroji omotače dovršene u poslednjih 24 sata i proveriti njihovu prisutnost u računovodstvenom sistemu.

Integracija sa glavnim ERP-ima i softverom za računovodstvo

Nativna konekcija sa Cegid, Sage i Pennylane

Nekoliko izdavača softvera za računovodstvo popularne u Francuskoj nudi konektore ili REST API-je kompatibilne sa vebhucima Certyneo. Evo najčešćih obrazaca integracije:

Cegid XRP Flex: izlaže REST API koji dozvoljava kreiranje računovodstvenih dokumenata i priklapanje datoteka. Vebhuk `envelope.completed` pokreće POST poziv ka Cegid API-ju da kreira unos i priloži potpisanu PDF datoteku kao digitalni dokaz.

Sage 100cloud / Sage 50: preporučeni pristup ide kroz laganog middlewarea (Python ili Node.js skriptu hostovanu bez servera) koji prima vebhuk Certyneo, preuzima dokument preko bezbedne URL adrese i odlaže ga u folder za automatski import Sage-a.

Pennylane: rešenje u oblaku koje je urođeno, čiji API direktno prima dokumente kao priloge sa njihovim računovodstvenim metapodacima. Integracija vebhuk-Pennylane je posebno pogodno za kabinete revizora koji centralizuju dokumente više klijentata — primer primene koji detaljno razmatramo u odeljku scenarija.

Za timove koji procenjuju različita rešenja pre nego što migriraju na Certyneo, poređenje rešenja za elektronski potpis nudi detaljni pregled mogućnosti integracije po platformi.

Korišćenje iPaaS-a kao Make ili n8n za one bez razvoja

Ako vaša organizacija nema namenske tehničke timove, platforme za automatizaciju bez koda/sa malo koda (Make, n8n, Zapier) predstavljaju efikasnu alternativu. Princip je jednostavan:

1. Kreirajte scenario sa vebhuk okidačem na Make ili n8n — generisana URL adresa služi kao Certyneo krajnja tačka.
2. Konfigurirajte sledeće radnje: preuzimanje potpisane dokumente, parsiranje metapodataka, slanje na Google Drive / SharePoint, kreiranje reda u tabeli praćenja, obaveštenje Slack-om odgovornom za računovodstvo.
3. Po želji, pokreni API poziv vašem softver za računovodstvo da kreirate unos.

Ovaj pristup omogućava postizanje visokog nivoa automatizacije za manje od jednog dana, bez pisanja jednog reda koda. Posebno je relevantan za male/srednje preduzeće ili revizore koji žele da automatizuju prikupljanje dokaza za svoje klijente bez mobilizovanja razvijača.

Najbolje prakse bezbednosti i revizije za računovodstvene vebhukove

Verifikacija HMAC potpisa i bezbednost krajnjih tačaka

U računovodstvenom kontekstu, pouzdanost podataka primljenih preko vebhuka je kritična. Napadač koji bi uspeo da ubaci false `envelope.completed` događaje mogao bi da ošteti vašu računovodstvo. Tri mere bezbednosti su obavezne:

• Verifikacija HMAC-SHA256: svaki zahtev Certyneo uključuje `X-Certyneo-Signature` zaglavlje. Vaša krajnja tačka mora ponovno izračunati potpis sa vašim tajnim ključem i upoređivanjem — odbijite svaki zahtev čiji se potpis ne slaže.
• Validacija JSON šeme: pre bilo kakve obrade, proverite strukturu i tipove primljene korisnosti. Polje `montant_ht` sa vrednostima `null` ili negativnom mora pokrenuti upozorenje, ne računovodstveni unos sa greško.
• Nepromenjivoj registrovanje: čuvajte svaki primljeni teret u vremenskom žigu registrovanju koji se ne može menjati najmanje 10 godina, u skladu sa obavezama čuvanja računovodstvenih dokumenata (član L123-22 Trgovačkog zakonika).

Pracljivost i revizijski trag za revizora

Jedna od glavnih prednosti vebhuk pristupa je end-to-end pracljivost koju generiše. Certyneo proizvodi za svaki potpisani dokument revizijski trag (audit trail) u skladu sa zahtevima eIDAS, uključujući kvalifikovane vremenski pečate, IP adrese potpisnika i korišćene sertifikate.

Povezujući ovaj revizijski trag sa vebhuk korisnostima, vaš ERP može da čuva ne samo dokazni dokument već i dokaz njegove pravne valjanosti. Za revizora sa računima ili revizora, ovaj dvoslojni pristup — dokument + dokaz — značajno pojednostavljuje provere tokom revizije ili pregleda. Elektronski potpis u preduzeću detaljno opisuje nivoe potpisa i njihovu dokaznu vrednost u različitim poslovnim kontekstima.

Za izračunavanje povratka na ulaganje ove automatizacije pre nego što počnete, Certyneo ROI kalkulator vam omogućava da precizno procenite dobitke u vremenu i troškovima prema vašoj količini potpisanih dokumenata.

Zakonski okvir primenljiv na vebhukove i digitalnu računovodstvo

Automatizacija računovodstvenog lanca preko vebhukova za elektronski potpis uključena je u specifičan regulatorni okvir koji treba da se savladuje.

Uredba eIDAS br. 910/2014 (i njena revizija eIDAS 2.0): evropska uredba o elektronskoj identifikaciji i uslugama poverenja uspostavljuje pravnu vrednost elektronskih potpisa. Članak 25 propisuje da se elektronski potpis ne može odbiti samo zato što je u elektronskom obliku. Kvalifikovani potpisi (QES) uživaju pretpostavku pouzdanosti ekvivalentnu ručnom potpisu. Za računovodstvene dokumente, odgovarajući nivo potpisa zavisi od karaktera dokumenta: jednostavna faktura može koristiti napredni potpis (AES), dok ugovor o operativnom leasingu ili elektronski notarski dokument zahteva kvalifikovani potpis.

Građanski zakonik, članci 1366 i 1367: članak 1366 priznaje elektronski dokument kao dokaz na isti način kao papirni dokument, pod uslovom da osoba od koje potiče može biti pravilno identifikovana i da je uspostavljeno i čuvano na način koji garantuje integritet. Članak 1367 definiše elektronski potpis kao upotrebu pouzdanog postupka identifikacije koji garantuje vezu sa aktom kojem se prilaže. Certyneo vebhuk, prenosečem revizijski trag sa svakim potpisanim dokumentom, zadovoljava ovaj zahtev za identifikaciju i integritet.

Članak L123-22 Trgovačkog zakonika: računovodstveni dokumenti i dokazni materijali moraju biti čuvani deset godina. Dokumenti primljeni preko vebhuka i uskladišteni u ERP-u moraju biti predmeti politike čuvanja u skladu, uključujući nepromenjivost i dugoročnu čitljivost formata (PDF/A preporučuje ISO 19005 standard).

GDPR br. 2016/679: vebhuk korisnosti sadrže lične podatke (imena potpisnika, e-mail adrese, vremenski žigovi vezani na pojedince). Vaša krajnja tačka i vaš ERP su primaocu ovih podataka — odgovorni ste za obrada ili su odgovorne sa modalitetima ugovora sa Certyneo. DPA (sporazum o obradi podataka) mora biti formalizovan. Preneseni podaci moraju biti minimizovani na strogo potrebne za računovodstvenu svrhu.

Direktiva NIS2 (2022/2555): za preduzeća koja ulaze u NIS2 perimetar (operatori osnovnih usluga, važne subjekte), bezbednost API interfejsa i vebhukova predstavlja obaveznu meru bezbednosti mreže. HMAC verifikacija, TLS 1.3 šifrovanje minimum i registovanje pristupa su obavezni.

Norma ETSI EN 319 132: definiše XAdES format za napredne elektronske potpise. Potpisi proizvedeni od Certyneo poštuju ove ETSI standarde, garantujući njihovu interoperabilnost sa sistemima arhiviranja sa dokaznom vrednošću u skladu sa francuskim opštim referentnom okvirom bezbednosti (RGS).

Konkretni scenariji upotrebe

Scenario 1: kabinet revizije koji upravlja 40 klijentskih dosijea

Kabinet za ekspertsku računovodstvu sa deset saradnika upravlja pismima od narušavanja, mandatima SEPA i godišnjim računima za 40 klijentskih društva. Pre integracije Certyneo vebhukova, svaki potpisani dokument je ručno pronalažen od strane upravnika dosijea, preimenovan prema konvenciji imena, a zatim deponovan u folder klijenta softvera za proizvodnju računovodstva. Ovaj proces je zahtevao oko 15 do 20 minuta po dokumentu, što je nekoliko sati svake nedelje u periodu zatvaranja.

Posle konfiguracije vebhuka `envelope.completed` povezanog sa njihovim alatom GED preko Make, kabinet je automatizovao ceo ovaj lanac: čim se potpiše, potpisana PDF datoteka se automatski sortira u odgovarajući folder klijenta sa pravim imenom datoteke, obaveštenje se šalje odgovorniku upravniku, a red se pravi u tabeli praćenja primljenih dokaza. Procenjeni vremenski dobitak je oko 70 do 80% na ovoj zadaci, što je oko 6 do 8 sati vraćeno u sedmici u periodu bilansa — cifra je usklađena sa benchmarkima koje je objavilo Udruženje računovodstvenih stručnjaka u svojim izveštajima o digitalnoj transformaciji kabineta.

Scenario 2: mala industrijska preduzeća sa Sage ERP-om i 300 ugovora sa dobavljačima godišnje

Mala industrijska preduzeća potpisuje oko 300 ugovora sa dobavljačima godišnje (akvizicije okvira, ugovore, ugovore o poverljivosti). Svaki potpisani ugovor mora biti priložen kartici dobavljača u Sage 100cloud i arhiviran kao dokaz obaveze. Bez automatizacije, odeljenje nabavke je slalo potpisane ugovore putem e-pošte odeljenju računovodstva sa prosečnim kašnjenjem od 3 do 5 radnih dana.

Posle raspodele Node.js middlewarea koji prima vebhukove Certyneo i poziva Sage API, kašnjenje dodele je palo na nekoliko sekundi. Vanbilansne obaveze se sada contabiliziraju u realnom vremenu, što je omogućilo poboljšanje pouzdanosti međustanja prikazane DAF-u. Projekat je realizovan za manje od dve nedelje od strane internog razvojnog inženjera, oslanjajući se na dokumentaciju vebhuka iz Certyneo centra za pomoć.

Scenario 3: grupa društva koja upravlja složenim intercompany tokovima

Grupa sa deset podružnica koristi Certyneo za potpisivanje svojih sporazuma o likvidnosti između firmi i ugovora o unutargrupa uslugama. Konsolidirano računovodstvo zahteva da se svaki potpisani sporazum istovremeno registruje u sistemu filijale koja ga emituje i filijale koja ga prima, sa istim identifikatorom dokumenta da bi se olakšalo otpis recipročnih tokova.

Konfigurisanjem jedinstvenog vebhuka koji obaveštava krajnje tačke dve relevantne filijale (identifikovane preko metapodataka omotača), grupa je eliminisala disparitete konsolidacije koji su vezani na nedostajuće ili slabo referencirane dokumente. Rok za konsolidovano zatvaranje smanjen je za prosečno 2 dana, što predstavlja značajan dobitak za grupu finansijske direkcije koja se zatvara tromesečno. Timovi koji razmišljaju o migraciji sa drugog rešenja mogu konsultovati Certyneo vodiče za migraciju da procene tehničku izvodljivost.

Zaključak

Certyneo vebhukovi predstavljaju moćan mehanizam automatizacije za bilo koji učesnik koji želi da integruje elektronski potpis u srce svog računovodstvenog procesa. Eliminacijom ručnih koraka između potpisivanja dokumenta i njegovog registrovanja u ERP-u ili softver za računovodstvo, smanjuju kašnjenja, greške unoša i rizike od nedostajućih dokumenata tokom bilansa ili revizije. Bilo da je reč o kabinetu ekspertske računovodstva, maloj ili srednjoj preduzeću ili grupi sa više entiteta, konfiguracija vebhuka je pristupačna — sa ili bez razvojnog inženjera — i povratak na ulaganje se meri već u prve dve nedelje upotrebe.

Za više informacija, konsultujte Certyneo centar za pomoć da pristupite kompletnoj dokumentaciji API-ja i vebhukova. Spremni da automatizujete svoj računovodstveni bilans? Kreirajte svoj Certyneo nalog besplatno i povežite svoje prve potpisane dokumente sa ERP-om još danas.