Rēķinu nosūtīšana un saņemšana, izmantojot Peppol

Peppol ir Eiropas tīkls strukturētu e-rēķinu apmaiņai starp uzņēmumiem un valsts iestādēm. Katrs rēķins ceļo no nosūtītāja piekļuves punkta uz saņēmēja piekļuves punktu. Nordlet ģenerē Peppol BIS Billing 3.0 rēķinus un kredītrēķinus, kā arī nosūta un saņem tos, izmantojot jūsu uzņēmuma piekļuves punkta kontu.

Peppol nosaka noteikumus tam, kā piekļuves punkti apmainās ar dokumentiem, bet nenosaka, kā jūsu programmatūra sazinās ar jūsu piekļuves punktu, jo katram pakalpojumu sniedzējam ir sava API. Nordlet darbojas ar šādiem pakalpojumu sniedzējiem:

Pakalpojumu sniedzējs	Nosūta	Piegādes statuss	Saņem
Recommand	jā	ar tīmekļa āķa (webhook) un pieprasījuma starpniecību	jā
Storecove	jā	tikai ar tīmekļa āķa (webhook) starpniecību	jā
e-invoice.be	jā	ar tīmekļa āķa (webhook) un pieprasījuma starpniecību	jā

Bez piekļuves punkta Nordlet joprojām sagatavo katra izrakstītā rēķina un kredītrēķina Peppol failu, lai jūs varētu to lejupielādēt un nosūtīt citā veidā, tomēr tas neveic dokumentu nosūtīšanu vai saņemšanu.

Kas jums ir nepieciešams

• Konts pie viena no iepriekš minētajiem pakalpojumu sniedzējiem, kurā reģistrēts jūsu uzņēmums. Katrs pakalpojumu sniedzējs piemēro maksu par saviem pakalpojumiem, skatiet attiecīgo cenu lapu.
• Nordlet sistēmā norādīts uzņēmuma PVN maksātāja numurs, reģistrācijas numurs vai Peppol ID (Konti -> Uzņēmumi -> Peppol ID). Šiem datiem, partnera kartītē, jābūt norādītiem arī katram klientam, kuram sūtāt rēķinus.

Piekļuves punkta savienošana

Atveriet sadaļu Konti -> Atbilstība -> ES -> Peppol piekļuves punkts, laukā Pakalpojumu sniedzējs izvēlieties savu pakalpojumu sniedzēju, aizpildiet attiecīgos laukus, kā aprakstīts turpmāk, un saglabājiet izmaiņas. Atstājiet lauku API bāzes URL (API base URL) tukšu, ja vien pakalpojumu sniedzējs nav norādījis citu adresi. Pēc saglabāšanas lapā būs redzams jūsu uzņēmuma Tīmekļa āķa URL (Webhook URL): https://api.nordlet.com/v1/peppol/webhooks/{provider}/{companyId}, kur {provider} ir recommand, storecove vai e-invoice-be, bet {companyId} ir jūsu uzņēmuma ID. Katram Nordlet uzņēmumam ir savs tīmekļa āķa URL.

Nordlet apstiprina tīmekļa āķa (webhook) izsaukumu tikai tad, ja tas apliecina piekļuvi jūsu tīmekļa āķa slepenajai atslēgai (webhook secret), tāpēc izsaukumi no citiem avotiem tiek noraidīti. Nordlet sazinās ar publiskā interneta adresēm tikai tad, kad tas izsauc jūsu piekļuves punktu.

Recommand

1. Recommand platformā atveriet sava uzņēmuma informāciju un nokopējiet uzņēmuma ID (company ID) uz lauku Konta ID piekļuves punktā (Account ID at the access point).
2. Recommand izveidojiet API atslēgu (API key) un nokopējiet to kopā ar tās slepeno atslēgu uz laukiem API atslēga (API key) un API slepenā atslēga (API secret).
3. Izdomājiet garu nejaušu tekstu, kas būs zināms tikai jums un Recommand, un ievadiet to laukā Tīmekļa āķa slepenā atslēga (Webhook secret). Saglabājiet.
4. Recommand izveidojiet uzņēmumam tīmekļa āķi (webhook), norādot Nordlet norādīto tīmekļa āķa URL un to pašu tīmekļa āķa slepeno atslēgu.

Recommand paraksta katru tīmekļa āķa izsaukumu ar šo slepeno atslēgu.

Storecove

1. Storecove platformā izveidojiet savam uzņēmumam juridisko personu (legal entity) ar atļautu sūtīšanas un saņemšanas funkciju un nokopējiet tās ID uz lauku Konta ID piekļuves punktā (Account ID at the access point).
2. Storecove sadaļā API atslēgas (API Keys) izveidojiet API atslēgu un nokopējiet to uz lauku API atslēga (API key). Atstājiet lauku API slepenā atslēga (API secret) tukšu.
3. Izdomājiet garu nejaušu tekstu un ievadiet to laukā Tīmekļa āķa slepenā atslēga (Webhook secret). Saglabājiet.
4. Storecove iestatiet push tīmekļa āķi, izmantojot Nordlet norādīto tīmekļa āķa URL, kas aizsargāts ar HTTP Basic autentifikāciju: jebkāds lietotājvārds un tīmekļa āķa slepenā atslēga kā parole.

Storecove nepiedāvā funkciju nosūtītā dokumenta statusa pieprasīšanai, tāpēc piegādes statuss tiek saņemts tikai ar tīmekļa āķa starpniecību, un rēķina lapā nav pogas Pārbaudīt Peppol statusu (Check Peppol status). Storecove smilškastes (sandbox) konts nosūta dokumentus Peppol testa tīklā; produkcijas API atslēgas var saņemt no Storecove atbalsta dienesta.

e-invoice.be

1. Lietotnē e-invoice.be sadaļā API iestatījumi (API Settings) nokopējiet sava uzņēmuma API atslēgu uz lauku API atslēga (API key). Atstājiet tukšus laukus Konta ID piekļuves punktā (Account ID at the access point) un API slepenā atslēga (API secret). Saglabājiet.
2. Izmantojot e-invoice.be API (POST https://api.e-invoice.be/api/webhooks/), izveidojiet tīmekļa āķi ar Nordlet norādīto tīmekļa āķa URL un notikumiem document.received, document.sent un document.sent.failed.
3. Nokopējiet API atgriezto secret vērtību jaunajam tīmekļa āķim un ievadiet to Nordlet laukā Tīmekļa āķa slepenā atslēga (Webhook secret), pēc tam vēlreiz saglabājiet.

e-invoice.be paraksta katru tīmekļa āķa izsaukumu ar šo slepeno atslēgu. Smilškastes (sandbox) uzņēmums e-invoice.be sistēmā nosūta dokumentus pa e-pastu, nevis caur Peppol tīklu.

Rēķina nosūtīšana

1. Izrakstiet rēķinu vai kredītrēķinu.
2. Pārbaudiet, vai klienta partnera kartītē ir norādīts Peppol ID, PVN maksātāja numurs vai reģistrācijas numurs.
3. Rēķina lapas sadaļā Piegāde (Delivery) noklikšķiniet uz Sūtīt caur Peppol (Send via Peppol) un apstipriniet darbību. Sadaļa Piegāde tiek rādīta neapmaksātiem izrakstītajiem rēķiniem, savukārt poga parādās tikai tad, ja piekļuves punkts ir pievienots.

Nordlet sagatavo Peppol failu un nodod to jūsu piekļuves punktam. Pēc tam rēķina lapā parādās sadaļa Peppol piegāde (Peppol delivery):

Statuss	Nozīme
pending	Nodots piekļuves punktam; klienta piekļuves punkts to vēl nav apstiprinājis
delivered	Klienta piekļuves punkts ir apstiprinājis rēķina saņemšanu
rejected	Klients ir noraidījis rēķinu; iemesls ir norādīts zem statusa
failed	Rēķinu neizdevās piegādāt; iemesls ir norādīts zem statusa, ja piekļuves punkts to ir sniedzis

Statuss tiek atjaunināts automātiski, kad piekļuves punkts ziņo par izmaiņām, izmantojot savu tīmekļa āķi. Poga Pārbaudīt Peppol statusu (Check Peppol status) uzreiz pieprasa pašreizējo statusu no Recommand vai e-invoice.be; e-invoice.be gadījumā tā nolasa arī klienta atbildi uz rēķinu, un noraidījums (atbildes kods RE) tiek parādīts kā noraidīts. Noraidītu vai neizdevušos rēķinu var nosūtīt atkārtoti pēc kļūdas novēršanas. Ja piekļuves punkts uzreiz noraida rēķinu, piemēram, tāpēc, ka klients nav reģistrēts Peppol tīklā, Nordlet parāda iemeslu un rēķins paliek nenosūtīts.

Poga Peppol XML rēķina lapas augšdaļā ļauj lejupielādēt to pašu Peppol failu bez tā nosūtīšanas.

ES iek kopienas piegādēm par piegādes datumu tiek norādīts izrakstīšanas datums un par piegādes valsti - klienta valsts, kā to prasa Peppol noteikumi.

Rēķinu saņemšana

Kad piekļuves punkts, izmantojot tīmekļa āķi, ziņo par saņemtu dokumentu, Nordlet lejupielādē Peppol failu no piekļuves punkta. Saņemtie rēķini un kredītrēķini parādās sadaļā Pirkumi -> Dokumentu apstrāde (Purchases -> Document capture) un ir atzīmēti kā saņemti, izmantojot Peppol no nosūtītāja Peppol ID. Nordlet pats apstrādā Peppol failu, tāpēc saņemšanai netiekt tērēti dokumentu atpazīšanas kredīti.

1. Atveriet saņemto dokumentu.
2. Pārbaudiet piegādātāju, datumus un pozīcijas; izvēlieties piegādātāju no saviem partneriem vai izveidojiet jaunu.
3. Noklikšķiniet uz Saglabāt melnrakstu (Save draft). Nordlet izveido pirkuma rēķina melnrakstu vai pirkuma kredītrēķina melnrakstu saņemtam kredītrēķinam ar pievienotu oriģinālo Peppol failu. Reģistrējiet to tāpat kā jebkuru citu pirkuma rēķinu.

Nordlet pirkuma rēķinu pozīcijas nevar būt negatīvas. Atlaides un izmaksas visam dokumentam, kā arī negatīvas pozīcijas tiek sadalītas starp pozīcijām ar to pašu PVN likmi. Summa, ko nevar attiecināt ne uz vienu konkrētās PVN likmes pozīciju, piemēram, atgriezta prece ar tādu PVN likmi, kurai rēķinā nav citu pozīciju, tiek parādīta otrajā tabulā: Kredītrēķina pozīcijas (Credit note lines) saņemtam rēķinam vai Rēķina pozīcijas (Invoice lines) saņemtam kredītrēķinam. Šīs pozīcijas tiek saglabātas kā otrs dokuments tam pašam piegādātājam - pirkuma kredītrēķins attiecībā pret jauno rēķinu ar numuru "-CR" vai pirkuma rēķins ar numuru "-INV". Abi dokumenti kopā veido saņemtā dokumenta kopsummu.

Pārbaude, vai klientam ir Peppol

Pieprasījums POST /v1/peppol/participants/lookup ar partnerId vai participantId ("<shēma>:") vaicā Peppol tīklam, vai saņēmējs ir reģistrēts un kādus dokumentus tas pieņem. Šī funkcija darbojas arī bez piekļuves punkta.

To pašu darbību veikšana, izmantojot API

Uzdevums	Izsaukums
Piekļuves punkta savienošana	POST /v1/declarations/configs/update ar system: "peppol" un config, kas satur provider (recommand, storecove vai e-invoice-be), accountId, apiKey, apiSecret, webhookSecret un papildu apiBaseUrl
Piekļuves punkta tīmekļa āķa saņemšana	POST /v1/peppol/webhooks/{provider}/{companyId}, ko izsauc piekļuves punkts
Peppol faila lejupielāde	POST /v1/sales/invoices/peppol-xml
Nosūtīšana	POST /v1/sales/invoices/peppol-send (atgriež 422, ja nav piekļuves punkta)
Piegādes statusa nolasīšana	POST /v1/sales/invoices/peppol-status (atgriež 422 Storecove gadījumā); rēķini satur laukus peppolMessageId, peppolStatus, peppolDetail, peppolSentAt, peppolCheckedAt
Saņemto dokumentu meklēšana	POST /v1/capture/documents/list; saņemtajiem dokumentiem ir provider: "peppol" un senderId
Dokumenta pārvēršana par pirkuma rēķinu	POST /v1/capture/documents/confirm ar parametru oppositeLines otrajam dokumentam

Tīmekļa āķa notikumi: sale_invoice.peppol_sent, sale_invoice.peppol_delivered, sale_invoice.peppol_rejected, sale_invoice.peppol_failed un document_capture.peppol_received. Informāciju par kļūdām, idempotenci un tīmekļa āķiem skatiet sadaļā API vienošanās.