E-arvete saatmiseks oma rakendusest liidestud sertifitseeritud ligipääsupunkti ehk Access Point’i API-ga: POST-id arve andmed, operaator valideerib need Euroopa standardi vastu, toimetab arve Peppol’i võrgu kaudu saaja operaatorini ja annab staatuse sulle tagasi. Sul ei ole vaja endal operaatoriks hakata, AS4-transporti käitada ega võrgu siseelu tundma õppida – just selleks ligipääsupunkt olemas ongi. Vaja on kolme asja: saaja elektroonilist aadressi, valideerimist läbivaid arveandmeid ja teenusepakkujat, kelle API sinu tehnoloogiaga sobib.
Mis on e-arve tehniliselt?
E-arve on struktureeritud XML-dokument, mis vastab Euroopa standardile EN 16931; kõige levinum profiil on Peppol BIS Billing 3.0 ehk sama standardi rakendus. E-kirja külge pandud PDF ei ole e-arve – masin ei saa seda ilma pilditustuvastuseta raamatupidamisse postitada. Enamik ligipääsupunktide API-sid võtab vastu UBL XML-i, osa ka JSON-i, millest XML genereeritakse.
Kuidas kohaletoimetamine käib?
Võrk töötab nelja nurga mudelil: sinu süsteem → sinu ligipääsupunkt → saaja ligipääsupunkt → saaja tarkvara. Saajat adresseerib Peppol’i ID kujul `{skeem}:{tunnus}` – Eesti ettevõttel näiteks `0191:` + äriregistri kood. Kas saaja on võrgus ja mis dokumenditüüpe ta vastu võtab, on avalik info: kontrolli Peppol Directory’st või teenusepakkuja otsingu-otspunktist enne saatmist. Mudel on nagu e-post, ainult sertifitseeritud operaatorite ja päriselt midagi tähendava kättetoimetamiskviitungiga.
Milline integratsioon välja näeb?
Tüüpiline voog on neli sammu. Otsi saaja Peppol’i ID. POST-i arve API-sse: hea teenusepakkuja valideerib sünkroonselt ja tagastab struktureeritud vead, nii et katkine arve kukub läbi sinu testides, mitte kolm päeva hiljem. Jälgi kohaletoimetamist veebihaagi ehk webhook’i või staatuse-otspunkti kaudu, sest transport on asünkroonne. Ja tee kõik enne läbi liivakastis: dokumenteeritud API puhul on esimene testdokument ühe tööpäevaga realistlik ootus.
Mida teenusepakkuja valikul kontrollida?
Neli asja eristavad pakkujaid: sertifitseeritud ligipääsupunkti staatus (akrediteering on operaatoril, mitte sinul), sünkroonne valideerimine arusaadavate veateadetega, saaja otsing API-s endas ning liivakast eraldi võtmetega. Kui võtad arveid ka vastu, lisa nimekirja veebihaagid sissetulevatele dokumentidele. Millal e-arve kohustuslik on, sõltub riigist. Balti pildi leiad meie ülevaadetest Eesti kohta ning Läti ja Leedu kohta.
Loe ka: English
Viimati kontrollitud:
Kas e-arvete saatmiseks oma rakendusest on vaja Peppol’i sertifikaati?
Ei. Sertifikaat kuulub ligipääsupunkti operaatorile. Sinu rakendus kutsub välja operaatori API-t, operaator tegeleb AS4-transpordi, valideerimise ja võrgu liikmelisusega.
Millist formaati e-arve API vastu võtab?
Enamik võtab vastu UBL XML-i, mis vastab EN 16931 / Peppol BIS Billing 3.0 standardile; osa võtab vastu ka JSON-i, millest XML genereeritakse. PDF ei ole e-arve.
Kuidas adresseerida e-arve saajat?
Peppol’i ID kaudu kujul `{skeem}:{tunnus}`, näiteks `0191:` + äriregistri kood Eesti ettevõtete puhul. Kas saaja on võrgus kättesaadav, on avalik info Peppol Directory’s.
Kui kaua võtab aega e-arvete API integratsioon?
Dokumenteeritud REST API ja liivakasti korral on esimese testdokumendi saatmine ühe tööpäeva jooksul realistlik ootus; tootmisvalmidus sõltub sinu arveandmete kvaliteedist.