Peppol API integratsioon: liidesta tarkvaraplatvorm rahvusvahelise e-arvete võrgustikuga

Sissejuhatus

Alates 1. juulist 2025 on Eestis äriregistris e-arve vastuvõtjaks registreeritud ettevõtetel õigus nõuda oma müüjatelt e-arveid, sealhulgas ka rahvusvahelises Peppol-formaadis. See tähendab, et tarkvaraplatvormid, mis piiriülest Peppol e-arveldust ei toeta, ei suuda enam peagi klientide vajadusi täita.

Oma Peppol-ligipääsupunkti (Access Point) ehitamine on siiski mahukas ettevõtmine. See nõuab eraldi infrastruktuuri, auditeid ja pidevat vastavushaldust ning kuude pikkust arendusressurssi, mis läheb põhitoote arendamise arvelt.

Kiirem tee on Peppol API integreerimine läbi teenuspõhise ligipääsupunkti (API Access Point). See juhend selgitab, kuidas Peppol API integratsioon töötab, mida sinu arendajad tegema peavad ja mida teenusepakkuja valikul silmas pidada.

Mis on Peppol?

Peppol (Pan-European Public Procurement Online) on rahvusvaheline standard piiriüleseks elektrooniliseks dokumendivahetuseks. Tegemist on sertifitseeritud operaatorite ja ligipääsupunktide võrgustikuga, mis võimaldab ettevõtetel ja tarkvaraplatvormidel saata nõuetele vastavaid e-arveid üle riigipiiride ja erinevate süsteemide vahel, sõltumata sellest, millist raamatupidamistarkvara kumb osapool kasutab.

Algselt avaliku sektori hangete jaoks loodud Peppol on laienenud B2B e-arveldusele kogu Euroopas ja kaugemalgi. Täna kasutatakse seda aktiivselt Euroopa Liidus, Austraalias, Uus-Meremaal ja Singapuris.

Peppol Eestis

Alates 1. juulist 2025 on äriregistris e-arve vastuvõtjaks registreeritud ettevõtetel õigus nõuda müüjatelt e-arveid. Seadus eeldab, et e-arve on nõuetekohane, kui see vastab Euroopa e-arveldamise standardile EN 16931-1, kuid pooled võivad omavahel kokku leppida ka muu standardi kasutamises, näiteks Eesti e-arve standardis. Peppol BIS 3.0 vastab EN 16931-1 nõuetele ja on seega üks sobivatest formaatidest.

Tarkvaraplatvormide jaoks tähendab see, et ettevõtted, kes on end äriregistris e-arve vastuvõtjaks märkinud, võivad hakata e-arveid nõudma ka oma tarkvaratarnijatelt.

Kaks võimalust Peppol-võrgustikuga liitumiseks

Võimalus 1: sertifitseeritud Peppol-ligipääsupunktiks saamine

Iga ettevõte saab taotleda Peppol-sertifitseerimist. See tähendab:

• ametlikku sertifitseerimisprotsessi OpenPeppoliga
• võrguinfrastruktuuri ehitamist ja haldamist
• PKI-sertifikaatide haldust
• protokolliuuenduste jälgimist ja rakendamist
• pidevaid auditeid

Tarkvaratiimide jaoks on see märkimisväärne halduskoormus, mis võtab tavaliselt mitu kuud ja nõuab spetsiifilisi teadmisi.

Võimalus 2: Peppol API integratsioon (Access Point as a Service)

Alternatiiv on liidestuda sertifitseeritud ligipääsupunkti pakkujaga REST API kaudu. Integratsioon tehakse korra ja pakkuja haldab sertifitseeritud infrastruktuuri, vastavust ning protokolliuuendusi.

Peppol API integratsioon töötab praktikas nii:

• platvorm saadab API-päringu arve andmete ja saaja Peppol ID-ga
• pakkuja valideerib dokumendi
• pakkuja otsib saaja Peppol SMP kataloogist üles
• dokument edastatakse Peppol-võrgustiku kaudu
• platvorm saab kinnituse kohaletoimetamise kohta

Arendajate vaatenurgast on tegemist tavalise REST API päringuga. Sertifitseeritud infrastruktuur asub täielikult pakkuja poolel.

Mida Peppol API integratsioon tegelikult tähendab?

Tööpõhimõte

Peppol API integratsioon katab mõlemad suunad:

Saatmine (outbound): Platvorm edastab arve API lõpp-punktile. Pakkuja valideerib selle, otsib saaja võrgustikust üles ja toimetab dokumendi kohale. Vead tuvastatakse koheselt ning neist antakse märku.

Vastuvõtmine (inbound): API haldab sissetulevaid Peppol-dokumente ja teeb need platvormile kättesaadavaks, eraldi infrastruktuuri selleks vaja ei ole.

Olulised aspektid API dokumentatsioonis

Enne pakkujaga liitumist tasub kontrollida:

• OpenAPI vastavus — standardiseeritud spetsifikatsioon tähendab vähem kohandatud tööriistasid
• Sünkroonne valideerimine— vigadest teavitatakse koheselt, mitte hiljem
• Sisseehitatud SMP otsing — API kontrollib saaja olemasolu Peppol-võrgustikus ilma eraldiseisva integratsioonita
• Uuesti saatmise loogika — usaldusväärne kohaletoimetamine võrgutõrgete korral
• Arendajate portaal — pääsuandmete haldamiseks ja tehingulogide jälgimiseks

Mille tagab Access Point’i pakkuja?

Teenuspõhise ligipääsupunktiga integreerides ei pea tiim haldama:

• Peppol-võrgustiku sertifikaate
• dokumendivalideerimise loogikat
• SMP/SML kataloogi päringuid
• protokolliversioonide uuendusi
• vastavusauditeid

Kõik see jääb pakkuja kanda ja integratsiooni saab hooldada iga arendaja, ilma eriteadmisteta.

Peamised Peppol API mõisted arendajatele

Dokumendiformaadid

Peppol kasutab peamise dokumendiformaadina UBL-i (Universal Business Language). Levinuim versioon on BIS 3.0, mis vastab Euroopa e-arvete standardile EN 16931-1. API pakkuja haldab formaadi nõuetele vastavust oma poolel ja pakub selget dokumentatsiooni oodatava päringu struktuuri kohta.

Peppol ID-d ja osalejate otsing

Igal Peppol-võrgustiku osalejalal on unikaalne identifikaator ehk Peppol ID, mis koosneb riigi koodist ja kohalikust ettevõtte registrikoodist.

Usaldusväärne Peppol API sisaldab sisseehitatud SMP (Service Metadata Publisher) otsingut. See võimaldab kontrollida, kas saaja on Peppol-võrgustikus registreeritud, enne arve saatmist, mis vähendab ebaõnnestunud toimetusi ja lihtsustab vigade tuvastamist.

Valideerimine

Peppol-dokumendid peavad enne kohaletoimetamist vastama formaadi- ja ärireeglite nõuetele. Hea Peppol API haldab valideerimist ja tagastab koheselt selged veateated, kui midagi ebaõnnestub.

Kellele Peppol API integratsioon sobib

ERP-süsteemide ja raamatupidamistarkvara pakkujad

ERP-idele ja raamatupidamisplatvormidele, mis teenindavad kliente Euroopa turgudel, muutub Peppol formaadi pakkumine üha oodatavamaks. API kaudu integreerimine võimaldab lisada nõuetele vastava Peppol e-arvelduse tootesse oma infrastruktuuri ehitamata.

Valdkonnapõhised SaaS-platvormid

Tehnoloogiaarendused valdkondades, kus liigub palju arveid, puutuvad Peppol-nõudega kokku üha sagedamini, eriti kui kliendid tegutsevad mitmes riigis. API integratsioon võimaldab Peppol-toe lisada ilma sellest eraldi suurt arendusprojekti tegemata.

Platvormid, mis otsivad paremat e-arvete lahendust

Hästi disainitud Peppol API kasutab standardiseeritud arhitektuuri, mis teeb e-arve operaatori vahetamise lihtsamaks. Olemasolevad töövood ei katke ja integratsiooni ei pea nullist uuesti ehitama.

Kui kaua võtab aega Peppol API integratsioon?

See sõltub platvormi arhitektuurist ja sellest, kui palju dokumendivalmistamise loogikat on juba olemas. Hästi dokumenteeritud OpenAPI-ga ühilduv tlahendus jõuab konto loomisest esimese testdokumendini kiiresti. Finbite’i API on loodud eesmärgiga, et esimese testdokumenti saatmine õnnestuks ühe tööpäevaga.

Mida küsida enne pakkuja valimist?

Enne liitumist tasub üle kontrollida:

• Kas pakkuja on sertifitseeritud Peppol-ligipääsupunkt või lihtsalt edasimüüja?
• Kas API toetab nii saatmist kui vastuvõtmist?
• Kas valideerimisveated tulevad sünkroonselt?
• Kas SMP osalejate otsing on sisse ehitatud?
• Kas on olemas arendajate portaal testimiseks ja pääsuandmete haldamiseks?
• Kuidas käsitletakse võrgutõrkeid ja uuesti saatmist?
• Milliseid dokumendiformaate ja Peppol-profiile toetatakse?
• Milline on tugi integreerimise ajal?

Finbite Peppol API

Finbite Peppol API on teenuspõhine ligipääsupunkt (Access Point as a Service), mis on mõeldud tarkvaratiimidele. See on OpenAPI-ga ühilduv REST API, mis haldab kogu Peppol-infrastruktuuri: sertifikaadid, vastavus ja protokolliuuendused.

Peamised võimekused:

• kahesuunaline vahetus (arved ja kreeditarved mõlemas suunas)
• sünkroonne valideerimine selgete veateadetega
• sisseehitatud SMP osalejate otsing
• automaatne uuesti saatmine ja puhverdamine võrgutõrgete ajal
• arendajate portaal pääsuandmete haldamiseks ja tehingulogide jaoks

Finbite on sertifitseeritud Peppol-operaator üle 15-aastase e-arvete kogemusega Baltikumis, keda usaldab üle 5000 ettevõtte arvehalduse automatiseerimiseks. Peppol API laiendab seda infrastruktuuri tarkvaraplatvormidele ja ERP-süsteemidele, mis soovivad lisada piiriülese e-arvelduse ilma oma ligipääsupunkti ehitamata.

API ligipääsuks ja tehniliseks dokumentatsiooniks: finbite.eu/peppol-api/

Kokkuvõte

Peppol API integratsioon on praktiline lahendus tarkvaraplatvormidele, mis peavad toetama piiriülest e-arveldust ilma sertifitseeritud ligipääsupunkti ise ehitamata. Integratsioon tehakse korra ja pakkuja haldab infrastruktuuri, vastavust ning võrgu hooldust.

Pakkujat valides tasub otsida OpenAPI vastavust, sünkroonset valideerimist, sisseehitatud SMP otsingut ja häid arendustööriistu.