Arvete saatmine ja vastuvõtmine Peppol kaudu

Peppol on Euroopa võrgustik struktureeritud e-arvete vahetamiseks ettevõtete ja avalik-õiguslike asutuste vahel. Iga arve liigub saatja pöörduspunktist vastuvõtja pöörduspunktini. Nordlet koostab Peppol BIS Billing 3.0 standardile vastavaid arveid ja kreeditarveid ning saadab ja võtab neid vastu teie ettevõtte oma pöörduspunkti konto kaudu.

Peppol kehtestab reeglid selle kohta, kuidas pöörduspunktid omavahel dokumente vahetavad, kuid mitte selle kohta, kuidas teie tarkvara teie pöörduspunktiga suhtleb – igal teenusepakkujal on oma API. Nordlet toetab järgmisi teenusepakkujaid:

Teenusepakkuja	Saadab	Edastusolek	Võtab vastu
Recommand	jah	veebikonksu (webhook) kaudu ja nõudmisel	jah
Storecove	jah	ainult veebikonksu (webhook) kaudu	jah
e-invoice.be	jah	veebikonksu (webhook) kaudu ja nõudmisel	jah

Pöörduspunkti puudumisel koostab Nordlet siiski iga väljastatud arve ja kreeditarve Peppoli faili, et saaksite selle alla laadida ja muul viisil edastada; sel juhul dokumente ei saadeta ega võeta vastu.

Mida on vaja

• Konto mõne ülaltoodud teenusepakkuja juures, kus teie ettevõte on Peppoliga registreeritud. Iga teenusepakkuja võtab oma teenuse eest tasu, lisateavet leiate nende hinnakirjast.
• Nordletis ettevõtte käibemaksukohuslase registreerimisnumber (KMKR), registrikood või Peppoli tunnus (Konto → Ettevõtted → Peppoli tunnus). See peab olema märgitud ka iga kliendi partnerkaardile, kellele te arveid saadate.

Pöörduspunkti ühendamine

Avage Konto → Nõuete täitmine → EL → Peppoli pöörduspunkt, valige väljal Teenusepakkuja oma teenusepakkuja, täitke selle teenusepakkuja väljad allpool kirjeldatud viisil ja salvestage. Jätke väli API baasaadress (API base URL) tühjaks, välja arvatud juhul, kui teenusepakkuja andis teile teistsuguse aadressi. Pärast salvestamist kuvatakse lehel teie ettevõtte veebikonksu aadress (Webhook URL): https://api.nordlet.com/v1/peppol/webhooks/{provider}/{companyId}, kus {provider} on recommand, storecove või e-invoice-be ja {companyId} on teie ettevõtte ID. Igal Nordleti ettevõttel on oma veebikonksu aadress.

Nordlet võtab veebikonksu päringu vastu ainult siis, kui see tõendab teadmist teie veebikonksu salajasest võtmest (webhook secret), mistõttu lükatakse tagasi päringud, mis ei pärine teie pöörduspunkti kontolt. Nordlet võtab teie pöörduspunktiga ühendust ainult avalike internetiaadresside kaudu.

Recommand

1. Avage Recommandis oma ettevõte ja kopeerige selle ettevõtte ID (company ID) välja Konto ID pöörduspunktis (Account ID at the access point).
2. Looge Recommandis API-võti (API key) ning kopeerige võti ja selle salajane võti väljadele API-võti (API key) ja API salajane võti (API secret).
3. Mõelge välja pikk juhuslik tekst, mida teate ainult teie ja Recommand, ning sisestage see väljale Veebikonksu salajane võti (Webhook secret). Salvestage.
4. Looge Recommandis oma ettevõtte jaoks veebikonks (webhook), kasutades Nordletis kuvatud veebikonksu aadressi ja sama veebikonksu salajast võtit.

Recommand allkirjastab iga veebikonksu päringu selle salajase võtmega.

Storecove

1. Looge Storecoves oma ettevõttele juriidiline üksus (legal entity), mis on seadistatud saatma ja vastu võtma, ning kopeerige selle ID välja Konto ID pöörduspunktis (Account ID at the access point).
2. Looge Storecoves jaotises API-võtmed (API Keys) API-võti ja kopeerige see väljale API-võti (API key). Jätke väli API salajane võti (API secret) tühjaks.
3. Mõelge välja pikk juhuslik tekst ja sisestage see väljale Veebikonksu salajane võti (Webhook secret). Salvestage.
4. Seadistage Storecoves tõukepõhine veebikonks (push webhook) Nordletis kuvatud veebikonksu aadressiga, mis on kaitstud HTTP Basic-autentimisega: kasutajanimeks sobib ükskõik kes ja parooliks veebikonksu salajane võti.

Storecoves puudub saadetud dokumendi oleku päring, mistõttu saadakse Storecove'i puhul edastusolek ainult selle veebikonksu kaudu ja arve lehel puudub nupp Kontrolli Peppoli olekut (Check Peppol status). Storecove'i liivakastikonto (sandbox) saadab andmeid Peppoli testvõrgustikus; tootmiskeskkonna API-võtmed saate Storecove'i klienditoelt.

e-invoice.be

1. Kopeerige e-invoice.be rakenduse jaotises API seaded (API Settings) oma ettevõtte API-võti (API key) välja API-võti (API key). Jätke väljad Konto ID pöörduspunktis (Account ID at the access point) ja API salajane võti (API secret) tühjaks. Salvestage.
2. Looge e-invoice.be API kaudu veebikonks (POST https://api.e-invoice.be/api/webhooks/), kasutades Nordletis kuvatud veebikonksu aadressi ja sündmusi document.received, document.sent ning document.sent.failed.
3. Kopeerige API poolt uue veebikonksu jaoks tagastatud secret Nordletis väljale Veebikonksu salajane võti (Webhook secret) ja salvestage uuesti.

e-invoice.be allkirjastab iga veebikonksu päringu selle salajase võtmega. e-invoice.be liivakastiettevõte saadab dokumendid Peppoli kaudu saatmise asemel e-posti teel.

Arve saatmine

1. Väljastage arve või kreeditarve.
2. Kontrollige, kas kliendi partnerkaardil on Peppoli tunnus, käibemaksukohuslase registreerimisnumber või registrikood.
3. Klõpsake arve lehel jaotises Edastamine (Delivery) nupul Saada Peppoli kaudu (Send via Peppol) ja kinnitage toiming. Jaotist Edastamine kuvatakse seni tasumata väljastatud arvetel ja nupp kuvatakse ainult siis, kui pöörduspunkt on ühendatud.

Nordlet koostab Peppoli faili ja edastab selle teie pöörduspunktile. Seejärel kuvatakse arve lehel jaotis Peppoli edastamine (Peppol delivery):

Olek	Tähendus
pending	Antud üle pöörduspunktile; kliendi pöörduspunkt ei ole seda veel kinnitanud
delivered	Kliendi pöörduspunkt kinnitas arve kättesaamist
rejected	Klient keeldus arvest; põhjus kuvatakse oleku all
failed	Arvet ei õnnestunud edastada; põhjus kuvatakse oleku all, kui pöörduspunkt on selle esitanud

Olek uueneb automaatselt, kui pöörduspunkt annab veebikonksu kaudu muutusest teada. Kontrolli Peppoli olekut (Check Peppol status) pärib Recommandilt või e-invoice.be-lt koheselt praeguse oleku; e-invoice.be puhul loeb see ka kliendi vastuse arvele ning keeldumise korral (vastusekood RE) kuvatakse olekuna rejected (tagasi lükatud). Tagasi lükatud või ebaõnnestunud arvet saab pärast vea parandamist uuesti saata. Kui pöörduspunkt lükkab arve otse tagasi, näiteks põhjusel, et klient ei ole Peppoliga registreeritud, kuvab Nordlet põhjuse ja arve jääb saatmata.

Arve lehe ülaosas olev nupp Peppol XML laadib alla sama Peppoli faili seda saatmata.

Euroopa Liidu sisese tarne puhul on Peppoli reeglite kohaselt tarnekuupäevaks arve kuupäev ja tarneriigiks kliendi riik.

Arvete vastuvõtmine

Kui pöörduspunkt annab veebikonksu kaudu teada saabunud dokumendist, laadib Nordlet Peppoli faili pöörduspunktist alla. Teie ettevõtte vastuvõetud arved ja kreeditarved ilmuvad jaotisesse Ostud → Dokumentide haldus (Purchases → Document capture) ning on märgistatud Peppoli kaudu saatja Peppoli tunnuselt saadetuiks. Nordlet loeb Peppoli faili ise, mistõttu vastuvõtmine ei kasuta dokumendituvastuse mahte.

1. Avage saabunud dokument.
2. Kontrollige tarnijat, kuupäevi ja ridu; valige tarnija oma partnerite hulgast või looge see.
3. Klõpsake nupul Salvesta mustandina (Save draft). Nordlet loob algse Peppoli faili lisamisega ostuarve mustandi või saabunud kreeditarve korral ostukreeditarve mustandi. Registreerige see nagu iga teinegi ostuarve.

Nordleti ostuarve read ei saa olla negatiivsed. Kogu dokumendi allahindlused ja lisatasud ning negatiivsed read jaotatakse sama käibemaksumääraga ridude vahel. Summat, mida ükski vastava käibemaksumääraga rida kanda ei saa (näiteks tagastatud kaup käibemaksumääraga, millel arvel muid ridu pole), kuvatakse teises tabelis: saabunud arve puhul jaotises Kreeditarve read (Credit note lines) või saabunud kreeditarve puhul jaotises Arve read (Invoice lines). Need read salvestatakse sama tarnija jaoks teise dokumendina: ostukreeditarve uue arve vastu numbriga "-CR" või ostuarve numbriga "-INV". Mõlemad dokumendid kokku katavad saabunud dokumendi kogusummad.

Kliendi Peppoli-registreeringu kontrollimine

Päring POST /v1/peppol/participants/lookup koos parameetriga partnerId või participantId (":") küsib Peppoli võrgustikult, kas vastuvõtja on registreeritud ja milliseid dokumente ta aktsepteerib. See toimib ka ilma pöörduspunktita.

Sama toimingu tegemine API kaudu

Ülesanne	Päring
Pöörduspunkti ühendamine	POST /v1/declarations/configs/update parameetritega system: "peppol" ja config, mis sisaldab väärtusi provider (recommand, storecove või e-invoice-be), accountId, apiKey, apiSecret, webhookSecret ning valikulist apiBaseUrl
Pöörduspunkti veebikonksu vastuvõtmine	POST /v1/peppol/webhooks/{provider}/{companyId}, mida kutsub pöörduspunkt
Peppoli faili allalaadimine	POST /v1/sales/invoices/peppol-xml
Saatmine	POST /v1/sales/invoices/peppol-send (tagastab pöörduspunkti puudumisel veakoodi 422)
Edastusoleku lugemine	POST /v1/sales/invoices/peppol-status (Storecove'i korral tagastab veakoodi 422); arved sisaldavad välju peppolMessageId, peppolStatus, peppolDetail, peppolSentAt, peppolCheckedAt
Vastuvõetud dokumentide leidmine	POST /v1/capture/documents/list; vastuvõetud dokumentidel on provider: "peppol" ja senderId
Dokumendi muutmine ostuarveks	POST /v1/capture/documents/confirm koos väljaga oppositeLines teise dokumendi jaoks

Veebikonksu sündmused: sale_invoice.peppol_sent, sale_invoice.peppol_delivered, sale_invoice.peppol_rejected, sale_invoice.peppol_failed ja document_capture.peppol_received. Vigade, identsuspäringute (idempotency) ja veebikonksude kohta lugege lehelt API konventsioonid.