Sending and receiving invoices with Peppol

Peppol er evrópska netkerfið til að skipta út rafrænum reikningum með stöðluðu sniði á milli fyrirtækja og opinberra aðila. Hver reikningur ferðast frá aðgangspunkt sendanda til aðgangspunkts móttakanda. Nordlet útbýr Peppol BIS Billing 3.0 reikninga og kreditreikninga, og sendir þá og tekur við þeim í gegnum aðgangspunktareikning fyrirtækisins þíns.

Peppol setur reglurnar um hvernig aðgangspunktar skiptast á skkjölum hver við annan, en ekki hvernig hugbúnaðurinn þinn á samskipti við þinn eigin aðgangspunkt: sérhver veitandi er með sína eigin API. Nordlet vinnur með eftirfarandi veitendum:

Veitandi	Sendir	Afhendingarstaða	Tekur við
Recommand	já	með vefkrók (webhook) og á beiðni	já
Storecove	já	aðeins með vefkrók (webhook)	já
e-invoice.be	já	með vefkrók (webhook) og á beiðni	já

Án aðgangspunkts útbýr Nordlet samt sem áður Peppol-skrá fyrir hvern útgefinn reikning og kreditreikning til að þú getir halað henni niður og komið henni á framfæri á annan hátt; kerfið sendir né tekur á móti neinu sjálfkrafa.

Hvað þig vantar

• Reikning hjá einum af veitendunum hér að ofan, þar sem fyrirtækið þitt er skráð á Peppol í gegnum þá þjónustu. Hver veitandi innheimtir gjald fyrir sína þjónustu; sjá verðskrá hjá viðkomandi.
• Í Nordlet, virðisaukaskattsnúmer eða kennitala fyrirtækisins, eða Peppol-kenni þess (Account → Companies → Peppol ID). Hver viðskiptavinur sem þú sendir á þarf einnig að vera með eitthvað af þessu á viðskiptamannaspjaldinu sínu.

Að tengja aðgangspunktinn þinn

Opnaðu Account → Compliance → EU → Peppol access point, veldu veituna þína í Provider, fylltu út reitina fyrir þann veitanda eins og lýst er hér að neðan og vistaðu. Skildu eftir auðan reitinn API base URL nema veitandinn þinn hafi gefið þér upp annað vistfang. Eftir vistun birtir síðan vefkróksslóðina (Webhook URL) fyrirtækisins þíns: https://api.nordlet.com/v1/peppol/webhooks/{provider}/{companyId}, þar sem {provider} er recommand, storecove eða e-invoice-be og {companyId} er auðkenni fyrirtækisins þíns. Hvert Nordlet-fyrirtæki er með sína eigin vefkróksslóð.

Nordlet samþykkir aðeins vefkrókskall ef það sýnir fram á að það þekki leynilykil vefkróksins þíns (webhook secret), þannig að köll sem koma ekki frá aðgangspunktareikningnum þínum eru hafnað. Nordlet hefur aðeins samband við opinber vefvistföng þegar það kallar í aðgangspunktinn þinn.

Recommand

1. Í Recommand skaltu opna fyrirtækið þitt og afrita company ID þess í Account ID at the access point.
2. Í Recommand skaltu útbúa API-lykil (API key) og afrita lykilinn og leynilykil hans í API key og API secret.
3. Búðu tillangan af handahófi valinn texta sem aðeins þú og Recommand þekkið, og sláðu hann inn í Webhook secret. Vistaðu.
4. Í Recommand skaltu búa til vefkrók (webhook) fyrir fyrirtækið þitt með vefkróksslóðinni sem Nordlet sýnir og sama vefkróksleynilyklinum.

Recommand undirritar hvert vefkrókskall með þeim leynilykli.

Storecove

1. Í Storecove skaltu búa til lögaðila (legal entity) fyrir fyrirtækið þitt, stilltan til að senda og taka á móti, og afrita auðkenni hans í Account ID at the access point.
2. Í Storecove, undir API Keys, skaltu búa til API-lykil og afrita hann í API key. Skildu eftir auðan reitinn API secret.
3. Búðu tillangan texta af handahófi og sláðu hann inn í Webhook secret. Vistaðu.
4. Í Storecove skaltu setja upp ýtivefkrók (push webhook) með vefkróksslóðinni sem Nordlet sýnir, varinn með HTTP Basic auðkenningu: hvaða notendarnafn sem er, og vefkróksleynilykilinn sem lykilorð.

Storecove er ekki með kall fyrir stöðu sendrs skjals, þannig að með Storecove kemur afhendingarstaðan eingöngu frá vefkróki þess og reikningssíðan er ekki með hnappinn Check Peppol status. Sandkassareikningur (sandbox) frá Storecove sendir á Peppol-prófunarkerfinu; framleiðslu-API-lyklar fást frá þjónustuveri Storecove.

e-invoice.be

1. Í e-invoice.be smáforritinu, undir API Settings, skaltu afrita API key fyrirtækisins þíns í API key. Skildu eftir auða reitina Account ID at the access point og API secret. Vistaðu.
2. Búðu til vefkrók með e-invoice.be API (POST https://api.e-invoice.be/api/webhooks/) með vefkróksslóðinni sem Nordlet sýnir og atburðunum document.received, document.sent og document.sent.failed.
3. Afritaðu secret-gildið sem API-ið skilar fyrir nýja vefkrókinn í Webhook secret í Nordlet og vistaðu aftur.

e-invoice.be undirritar hvert vefkrókskall með þeim leynilykli. Sandkassafyrirtæki í e-invoice.be sendir skjölin sem það myndi annars senda í tölvupósti í stað þess að senda þau í gegnum Peppol.

Að senda reikning

1. Útgefðu reikninginn eða kreditreikninginn.
2. Athugaðu hvort viðskiptavinurinn sé með Peppol-kenni, virðisaukaskattsnúmer eða kennitölu á viðskiptamannaspjaldinu sínu.
3. Á reikningssíðunni, í hlutanum Delivery, smelltu á Send via Peppol og staðfestu. Afhendingarhlutinn birtist fyrir útgefna reikninga sem eiga eftir að greiðast, og hnappurinn birtist aðeins þegar aðgangspunkturinn er tengdur.

Nordlet útbýr Peppol-skrána og afhendir hana aðgangspunktinum þínum. Reikningssíðan birtir þá Peppol delivery hluta:

Staða	Merking
pending	Afhent aðgangspunktinum; aðgangspunktur viðskiptavinarins hefur ekki staðfest móttöku enn
delivered	Aðgangspunktur viðskiptavinarins staðfesti móttöku reikningsins
rejected	Viðskiptavinurinn hafnaði reikningnum; ástæðan birtist fyrir neðan stöðuna
failed	Ekki tókst að afhenda reikninginn; ástæðan birtist fyrir neðan stöðuna þegar aðgangspunkturinn gefur hana upp

Staðan uppfærist sjálfkrafa þ amikor aðgangspunkturinn tilkynnir um breytingu í gegnum vefkrók sinn. Check Peppol status biður Recommand eða e-invoice.be um núverandi stöðu þegar í stað; hjá e-invoice.be les það einnig svör við reikningi frá viðskiptavini, og höfnun (svarmerki RE) birtist sem hafnað (rejected). Hægt er að senda hafnaðan eða mistekinn reikning aftur eftir að þú hefur lagað rót vandans. Þegar aðgangspunkturinn hafnar reikningi beint, til dæmis vegna þess að viðskiptavinurinn er ekki skráður á Peppol, sýnir Nordlet ástæðuna og reikningurinn verður eftir sem ósendingur.

Hnappurinn Peppol XML efst á reikningssíðunni halar niður sömu Peppol-skrá án þess að senda hana.

Viðskipti innan ESB bera útgáfudag sem afhendingardag og land viðskiptavinar sem afhendingarland, eins og Peppol-reglurnar krefjast.

Að taka við reikningum

Þegar aðgangspunkturinn tilkynnir um móttekið skjal í gegnum vefkrók sinn, halar Nordlet niður Peppol-skránni frá aðgangspunktinum. Reikningar og kreditreikningar sem fyrirtækið þitt tekur við birtast undir Purchases → Document capture, merktir sem mótteknir yfir Peppol frá Peppol-kenni sendanda. Nordlet les Peppol-skrána sjálft, þannig að móttakan notar enga einingar úr skjalagreiningu (document recognition credits).

1. Opnaðu móttekna skjalið.
2. Athugaðu birginn, dagsetningarnar og línurnar; veldu birginn úr samstarfsaðilum þínum eða búðu hann til.
3. Smelltu á Save draft. Nordlet býr til drög að innkaupareikningi, eða drög að innkaupakreditreikningi fyrir móttekinn kreditreikning, með upprunalegu Peppol-skránni viðhengdri. Skráðu hann eins og hvern annan innkaupareikning.

Línur í innkaupareikningum Nordlet mega ekki vera neikvæðar. Afslættir og gjöld fyrir allt skjalið, og neikvæðar línur, dreifast á línurnar með sömu vsk-almenningsprósentu. Upphæð sem engin lína með viðkomandi vsk-prósentu getur borið, svo sem skilað vara með vsk-prósentu sem engin önnur lína á reikningnum er með, birtist í annarri töflu: Credit note lines fyrir móttekinn reikning, eða Invoice lines fyrir móttekinn kreditreikning. Þessum línum er vistað sem öðru skjali fyrir sama birgi: innkaupakreditreikningur á móti nýja reikningnum, númeraður <document number>-CR, eða innkaupareikningur númeraður <document number>-INV. Skjölin tvö samanlagt passa við heildartölur móttekna skjalsins.

Að athuga hvort viðskiptavinur sé á Peppol

POST /v1/peppol/participants/lookup með partnerId eða participantId (":") spyr Peppol-netkerfið hvort móttakandinn sé skráður og hvaða skjöl hann samþykkir. Þetta virkar án aðgangspunkts.

Að gera hið sama í gegnum API

Verkefni	Kall
Tengja aðgangspunktinn	POST /v1/declarations/configs/update með system: "peppol" og config sem inniheldur provider (recommand, storecove eða e-invoice-be), accountId, apiKey, apiSecret, webhookSecret og valfrjálst apiBaseUrl
Taka við vefkróki aðgangspunktsins	POST /v1/peppol/webhooks/{provider}/{companyId}, kallað af aðgangspunktinum
Hala niður Peppol-skránni	POST /v1/sales/invoices/peppol-xml
Senda	POST /v1/sales/invoices/peppol-send (422 án aðgangspunkts)
Lesa afhendingarstöðuna	POST /v1/sales/invoices/peppol-status (422 með Storecove); reikningar bera peppolMessageId, peppolStatus, peppolDetail, peppolSentAt, peppolCheckedAt
Finna móttekinn skjöl	POST /v1/capture/documents/list; móttekin skjöl eru með provider: "peppol" og senderId
Breyta skjali í innkaupareikning	POST /v1/capture/documents/confirm, með oppositeLines fyrir seinna skjalið

Atburðir vefkróka (webhook events): sale_invoice.peppol_sent, sale_invoice.peppol_delivered, sale_invoice.peppol_rejected, sale_invoice.peppol_failed og document_capture.peppol_received. Sjá API-venjur varðandi villur, ítrunarþol (idempotency) og vefkróka.