Sąskaitų faktūrų siuntimas ir gavimas per Peppol

Peppol yra Europos tinklas, skirtas struktūrizuotoms el. sąskaitoms faktūroms keistis tarp įmonių ir viešojo sektoriaus subjektų. Kiekviena sąskaita faktūra keliauja iš siuntėjo prieigos taško į gavėjo prieigos tašką. Nordlet suformuoja Peppol BIS Billing 3.0 formato sąskaitas faktūras bei kreditinius dokumentus ir siunčia bei gauna juos per jūsų įmonės prieigos taško paskyrą.

Peppol nustato taisykles, kaip prieigos taškai keičiasi dokumentais tarpusavyje, tačiau nenustato, kaip jūsų programinė įranga sąveikauja su jūsų prieigos tašku: kiekvienas tiekėjas turi savo API. Nordlet palaiko šiuos tiekėjus:

Tiekėjas	Siuntimas	Pristatymo būsena	Gavimas
Recommand	taip	per webhook ir pagal užklausą	taip
Storecove	taip	tik per webhook	taip
e-invoice.be	taip	per webhook ir pagal užklausą	taip

Net ir neturint prieigos taško, Nordlet vis tiek sukuria kiekvienos išrašytos sąskaitos faktūros ir kredito dokumento Peppol failą, kurį galite atsisiųsti ir perduoti kitu būdu; tokiu atveju dokumentai nesiunčiami ir negaunami automatiškai.

Ko jums reikia

• Paskyra pas vieną iš aukščiau nurodytų tiekėjų, per kurį jūsų įmonė užregistruota Peppol tinkle. Kiekvienas tiekėjas taiko paslaugų mokesčius; informacija pateikiama jų kainoraščiuose.
• Nordlet sistemoje nurodytas įmonės PVM mokėtojo kodas, registracijos numeris arba Peppol ID (Nustatymai → Įmonės → Peppol ID). Šiuos duomenis savo partnerio kortelėje taip pat turi turėti kiekvienas klientas, kuriam siunčiate dokumentus.

Prieigos taško prijungimas

Atidarykite Nustatymai → Atitiktis → ES → Peppol prieigos taškas, laukelyje Tiekėjas pasirinkite savo tiekėją, užpildykite atitinkamus laukus, kaip aprašyta žemiau, ir išsaugokite. Lauke API bazinis URL nieko neįrašykite, nebent tiekėjas nurodė kitą adresą. Išsaugojus puslapyje rodomas jūsų įmonės Webhook URL: https://api.nordlet.com/v1/peppol/webhooks/{provider}/{companyId}, kur {provider} yra recommand, storecove arba e-invoice-be, o {companyId} yra jūsų įmonės ID. Kiekviena Nordlet įmonė turi savo atskirą webhook URL.

Nordlet priima webhook užklausą tik tada, kai ji patvirtina, kad žinoma jūsų webhook paslaptis (webhook secret), todėl užklausos ne iš jūsų prieigos taško paskyros yra atmetamos. Nordlet su viešaisiais interneto adresais susisiekia tik kreipdamasi į jūsų prieigos tašką.

Recommand

1. Recommand sistemoje atidarykite savo įmonę ir nukopijuokite jos įmonės ID į lauką Paskyros ID prieigos taške.
2. Recommand sukurkite API raktą (API key) ir nukopijuokite raktą bei jo slaptažodį į laukus API raktas ir API paslaptis.
3. Sugalvokite ilgą atsitiktinį tekstą, kurį žinosite tik jūs ir Recommand, ir įveskite jį lauke Webhook paslaptis. Išsaugokite.
4. Recommand sistemoje sukurkite webhook savo įmonei, nurodydami Nordlet rodomą Webhook URL ir tą pačią webhook paslaptį.

Recommand pasirašo kiekvieną webhook užklausą šia paslaptimi.

Storecove

1. Storecove sistemoje sukurkite savo įmonės juridinį subjektą (legal entity), nustatydami, kad jis gali siųsti ir gauti dokumentus, ir nukopijuokite jo ID į lauką Paskyros ID prieigos taške.
2. Storecove skiltyje API raktai sukurkite API raktą ir nukopijuokite jį į lauką API raktas. Lauką API paslaptis palikite tuščią.
3. Sugalvokite ilgą atsitiktinį tekstą ir įveskite jį lauke Webhook paslaptis. Išsaugokite.
4. Storecove nustatykite tiesioginį (push) webhook su Nordlet rodomu Webhook URL, apsaugotu HTTP Basic autentifikavimu: bet koks vartotojo vardas ir webhook paslaptis kaip slaptažodis.

Storecove neturi užklausos funkcijos išsiųsto dokumento būsenai patikrinti, todėl naudojant Storecove pristatymo būsena gaunama tik per webhook, o sąskaitos faktūros puslapyje nėra mygtuko Tikrinti Peppol būseną. Storecove smėlio dėžutės (sandbox) paskyra siunčia dokumentus į Peppol testinį tinklą; gamybinius API raktus suteikia Storecove palaikymo komanda.

e-invoice.be

1. e-invoice.be programėlėje, skiltyje API nustatymai, nukopijuokite savo įmonės API raktą į lauką API raktas. Laukus Paskyros ID prieigos taške ir API paslaptis palikite tuščius. Išsaugokite.
2. Sukurkite webhook naudodamiesi e-invoice.be API (POST https://api.e-invoice.be/api/webhooks/), nurodydami Nordlet rodomą Webhook URL ir įvykius document.received, document.sent bei document.sent.failed.
3. Nukopijuokite reikšmę secret, kurią API grąžina naujam webhook, į lauką Webhook paslaptis Nordlet sistemoje ir vėl išsaugokite.

e-invoice.be pasirašo kiekvieną webhook užklausą šia paslaptimi. e-invoice.be smėlio dėžutės įmonė dokumentus, kuriuos reikėtų siųsti, siunčia el. paštu, o ne per Peppol tinklą.

Sąskaitos faktūros siuntimas

1. Išrašykite sąskaitą faktūrą arba kreditinį dokumentą.
2. Patikrinkite, ar partnerio kortelėje nurodytas kliento Peppol ID, PVM mokėtojo kodas arba registracijos numeris.
3. Sąskaitos faktūros puslapyje, skiltyje Pristatymas, spustelėkite Siųsti per Peppol ir patvirtinkite. Pristatymo skiltis rodoma dar neapmokėtoms išrašytoms sąskaitoms faktūroms, o mygtukas matomas tik tada, kai prijungtas prieigos taškas.

Nordlet suformuoja Peppol failą ir perduoda jį jūsų prieigos taškui. Po to sąskaitos faktūros puslapyje rodoma Peppol pristatymas skiltis:

Būsena	Reikšmė
pending	Perduota prieigos taškui; kliento prieigos taškas dar nepatvirtino gavimo
delivered	Kliento prieigos taškas patvirtino sąskaitos faktūros gavimą
rejected	Klientas atmetė sąskaitą faktūrą; priežastis rodoma po būsena
failed	Nepavyko pristatyti sąskaitos faktūros; priežastis rodoma po būsena, jei prieigos taškas ją pateikia

Būsena atsinaujina automatiškai, kai prieigos taškas praneša apie pasikeitimą per savo webhook. Mygtukas Tikrinti Peppol būseną iškart kreipiasi į Recommand arba e-invoice.be dėl esamos būsenos; naudojant e-invoice.be taip pat nuskaitomas kliento atsakymas į sąskaitą faktūrą, o atmetimas (atsako kodas RE) rodomas kaip atmestas. Atmestą arba nepristatytą sąskaitą faktūrą galima siųsti pakartotinai pašalinus priežastį. Kai prieigos taškas iš karto atmeta sąskaitą faktūrą, pavyzdžiui, dėl to, kad klientas nėra užregistruotas Peppol tinkle, Nordlet parodyta priežastis, o pati sąskaita lieka neišsiųsta.

Viršutiniame sąskaitos faktūros puslapio ekrano naršymo lauke esantis mygtukas Peppol XML leidžia atsisiųsti tą patį Peppol failą jo neišsiunčiant.

Vykdant tiekimą ES viduje, kaip reikalauja Peppol taisyklės, išrašymo data nurodoma kaip prekių tiekimo data, o kliento šalis – kaip tiekimo šalis.

Sąskaitų faktūrų gavimas

Kai prieigos taškas praneša apie gautą dokumentą per webhook, Nordlet atsisiunčia Peppol failą iš prieigos taško. Jūsų įmonės gautos sąskaitos faktūros ir kreditiniai dokumentai pasirodo skiltyje Pirkimai → Dokumentų nuskaitymas, pažymėti kaip gauti per Peppol pagal siuntėjo Peppol ID. Nordlet pati nuskaito Peppol failą, todėl gavimui nenaudojami dokumentų atpažinimo kreditai.

1. Atidarykite gautą dokumentą.
2. Patikrinkite tiekėją, datas ir eilutes; pasirinkite tiekėją iš savo partnerių sąrašo arba sukurkite naują.
3. Spustelėkite Išsaugoti juodraštį. Nordlet sukuria pirkimo sąskaitos faktūros juodraštį arba pirkimo kredito dokumento juodraštį gautam kredito dokumentui, pridedant originalų Peppol failą. Užregistruokite jį kaip bet kurią kitą pirkimo sąskaitą faktūrą.

Nordlet pirkimo sąskaitos faktūros eilutės negali būti neigiamos. Nuolaidos ir mokesčiai visam dokumentui bei neigiamos eilutės yra paskirstomi eilutėms pagal tą patį PVM tarifą. Suma, kurios negali priskirti jokia atitinkamo PVM tarifo eilutė (pavyzdžiui, grąžinta prekė, kurios PVM tarifui sąskaitoje nėra kitų eilučių), rodoma antroje lentelėje: Kredito dokumento eilutės gautai sąskaitai faktūrai arba Sąskaitos faktūros eilutės gautam kreditiniam dokumentui. Šios eilutės išsaugomos kaip antras dokumentas tam pačiam tiekėjui: pirkimo kredito dokumentas, susietas su nauja sąskaita, numeriu "-CR", arba pirkimo sąskaita faktūra numeriu "-INV". Sudėjus abu dokumentus gaunamos bendros gauto dokumento sumos.

Kliento registracijos Peppol tinkle patikrinimas

Užklausa POST /v1/peppol/participants/lookup su parametru partnerId arba participantId (":") teiraujasi Peppol tinkle, ar gavėjas yra registruotas ir kokius dokumentus jis priima. Ši funkcija veikia ir be prieigos taško.

Tas pats per API

Užduotis	Kvietimas (Call)
Prijungti prieigos tašką	POST /v1/declarations/configs/update su laukais system: "peppol" ir config, kuriame nurodyta provider (recommand, storecove arba e-invoice-be), accountId, apiKey, apiSecret, webhookSecret bei pasirinktinai apiBaseUrl
Gauti prieigos taško webhook	POST /v1/peppol/webhooks/{provider}/{companyId}, iškviečiamas prieigos taško
Atsisiųsti Peppol failą	POST /v1/sales/invoices/peppol-xml
Siųsti	POST /v1/sales/invoices/peppol-send (422, jei nėra prieigos taško)
Nuskaityti pristatymo būseną	POST /v1/sales/invoices/peppol-status (422, naudojant Storecove); sąskaitose faktūrose perduodami laukai peppolMessageId, peppolStatus, peppolDetail, peppolSentAt, peppolCheckedAt
Rasti gautus dokumentus	POST /v1/capture/documents/list; gauti dokumentai turi reikšmes provider: "peppol" ir senderId
Paversti dokumentą pirkimo sąskaita faktūra	POST /v1/capture/documents/confirm, su parametru oppositeLines antrajam dokumentui

Webhook įvykiai: sale_invoice.peppol_sent, sale_invoice.peppol_delivered, sale_invoice.peppol_rejected, sale_invoice.peppol_failed ir document_capture.peppol_received. Informaciją apie klaidas, idempotentiškumą ir webhook rasite skyriuje API konvencijos.