Sonraí and fáltais a sheoladh agus a fháil le Peppol

Is é Peppol an líonra Eorpach chun ríomhshonrasc struchtúrtha a mhalartú idir gnólachtaí agus comhlachtaí poiblí. Taistealaíonn gach sonrasc ó phointe rochtana an tseoltóra go pointe rochtana an ghlacadóra. Cruthaíonn Nordlet sonrasc agus nótaí creidmheasa de réir chaighdeán Peppol BIS Billing 3.0, agus seolann agus faigheann sé iad trí chuntas phointe rochtana do chuideachta féin.

Leagann Peppol síos na rialacha maidir le conas a mhalartaíonn pointí rochtana doiciméid eatarthu féin, ach ní shainíonn sé conas a chumarsáideann do bhogearraí le do phointe rochtana féin: tá a API féin ag gach soláthraí. Oibríonn Nordlet leis na soláthraithe seo a leanas:

Soláthraí	Seolann sé	Stádas seachadta	Faigheann sé
Recommand	seolann	trí webhook agus ar éileamh	faigheann
Storecove	seolann	trí webhook amháin	faigheann
e-invoice.be	seolann	trí webhook agus ar éileamh	faigheann

Mura bhfuil pointe rochtana ann, gintear comhad Peppol gach sonrasc eisithe agus nóta creidmheasa fós le híoslódáil agus le cur ar aghaidh ar bhealach eile; ní sheolann ná ní fhaigheann sé aon rud.

An méid atá de dhíth ort

• Cuntas le duine de na soláthraithe thuas, agus d'fhiontar cláraithe ar Peppol tríd. Gearrann gach soláthraí táille ar a sheirbhís; féach ar a liosta praghsanna féin.
• I Nordlet, uimhir CBL na cuideachta nó an uimhir chlárúcháin, nó a ID Peppol (Cuntas → Cuideachtaí → ID Peppol). Ní mór ceann díobh seo a bheith ag gach custaiméir a seolann tú chuige freisin, ar a chárta comhpháirtí.

Do phointe rochtana a nascadh

Oscail Cuntas → Comhlíonadh → AE → Pointe rochtana Peppol, roghnaigh do sholáthraí faoi Soláthraí, líon isteach na réimsí don soláthraí sin mar a thuairiscítear thíos agus sábháil. Fág URL bonn API bándearg mura dtug seoladh difriúil duit do sholáthraí. Tar éis duit é a shábháil, taispeánann an leathanach URL an webhook do chuideachta: https://api.nordlet.com/v1/peppol/webhooks/{provider}/{companyId}, áitarb é {provider} ná recommand, storecove nó e-invoice-be agus is é {companyId} ID do chuideachta. Tá a URL webhook féin ag gach cuideachta Nordlet.

Glacann Nordlet le glao webhook ach amháin nuair a chruthúnaíonn sé go bhfuil rúnchód do webhook ar eolas aige, agus diúltaítear dá réir do ghlao nach dtagann ó chuntas do phointe rochtana. Ní théann Nordlet i dteagmháil le seoltaí idirlín poiblí ach amháin nuair a ghlaonn sé ar do phointe rochtana.

Recommand

1. In Recommand, oscail do chuideachta agus cóipeáil a ID cuideachta isteach i ID an chuntais ag an phointe rochtana.
2. In Recommand, cruthaigh eochair API agus cóipeáil an eochair agus a rúndiamhair isteach in Eochair API agus Rúndiamhair API.
3. Cum téacs fada randach nach mbeidh ar eolas ach agatsa agus ag Recommand, agus cuir isteach é i Rúndiamhair an webhook. Sábháil.
4. In Recommand, cruthaigh webhook do do chuideachta leis an URL webhook a thaispeánann Nordlet agus an rúndiamhair webhook céanna.

Síníonn Recommand gach glao webhook leis an rúndiamhair sin.

Storecove

1. In Storecove, cruthaigh eintiteas dlíthiúil do do chuideachta, socraithe chun doiciméid a sheoladh agus a fháil, agus cóipeáil a ID isteach i ID an chuntais ag an phointe rochtana.
2. In Storecove, faoi Eochracha API, cruthaigh eochair API agus cóipeáil isteach in Eochair API í. Fág Rúndiamhair API bándearg.
3. Cum téacs fada randach agus cuir isteach é i Rúndiamhair an webhook. Sábháil.
4. In Storecove, socrú webhook brú le hURL an webhook a thaispeánann Nordlet, faoi chosaint le fíordheimniú Buneolais HTTP: ainm úsáidora ar bith, agus an rúndiamhair webhook mar an pasfhocal.

Níl aon ghlao ag Storecove le haghaidh stádas doiciméid sheolta, mar sin i gcás Storecove ní thagann an stádas seachadta ach óna webhook agus níl aon cnaipe Seiceáil stádas Peppol ar leathanach an tsonrasc. Seolann cuntas bosca aistir (sandbox) de chuid Storecove ar líonra tástála Peppol; faightear eochracha API táirgthe ó thacaíocht Storecove.

e-invoice.be

1. San aip e-invoice.be, faoi Socruithe API, cóipeáil eochair API do chuideachta isteach in Eochair API. Fág ID an chuntais ag an phointe rochtana agus Rúndiamhair API bándearg. Sábháil.
2. Cruthaigh webhook le API e-invoice.be (POST https://api.e-invoice.be/api/webhooks/) leis an URL webhook a thaispeánann Nordlet agus na himeachtaí document.received, document.sent agus document.sent.failed.
3. Cóipeáil an secret a qayríonn an API ar ais don webhook nua isteach i Rúndiamhair an webhook i Nordlet agus sábháil arís.

Síníonn e-invoice.be gach glao webhook leis an rúndiamhair sin. Seolann cuideachta bosca aistir ag e-invoice.be na doiciméid a sheolfadh sé trí ríomhphost in ionad iad a sheoladh thar Peppol.

Sonrasc a sheoladh

1. Eist an sonrasc nó an nóta creidmheasa.
2. Seiceáil go bhfuil ID Peppol, uimhir CBL nó uimhir chlárúcháin ag an gcustaiméir ar a chárta comhpháirtí.
3. Ar leathanach an tsonrasc, sa rannán Seachadadh, cliceáil Seol trí Peppol agus deimhnigh. Taispeántar an rannán Seachadta le haghaidh sonrasc eisithe nach bhfuil ictha go fóill, agus an cnaipe ach amháin nuair a bhíonn an pointe rochtana nasctha.

Gineann Nordlet an comhad Peppol agus tugann sé do do phointe rochtana é. Taispeánann leathanach an tsonrasc rannán Seachadadh Peppol ina dhiaidh sin:

Stádas	Brí
pending	Tugtha don phointe rochtana; níor dhearbhaigh pointe rochtana an chustaiméara é fós
delivered	Dearbhaigh pointe rochtana an chustaiméara gur theip air an sonrasc a fháil
rejected	Dhiúltaigh an custaiméir don sonrasc; taispeántar an fáth faoin stádas
failed	Níorbh fhéidir an sonrasc a sheachadadh; taispeántar an fáth faoin stádas nuair a thugann an pointe rochtana ceann

Nuashonraíonn an stádas go huathoibríoch nuair a thuairiscíonn an pointe rochtana athrú trí a webhook. Iarrann Seiceáil stádas Peppol an stádas reatha ar Recommand nó e-invoice.be láithreach; i gcás e-invoice.be léann sé freisin freagra sonrasc an chustaiméara, agus taispeántar diúltú (cód freagartha RE) mar dhiúltaಿತ. Is féidir sonrasc a diúltaíodh nó a theip air a sheoladh arís tar éis duit an chúis a cheartú. Nuair a dhiúltaíonn an pointe rochtana do shonrasc go hiomlán, mar shampla toisc nach bhfuil an custaiméir cláraithe ar Peppol, taispeánann Nordlet an chúis agus fanann an sonrasc neamhsheolta.

Íoslódálann an cnaipe XML Peppol ag barr leathanach an tsonrasc an comhad Peppol céanna gan é a sheoladh.

Iompraíonn soláthar laistigh den AE dáta an eisiúna mar dháta seachadta agus tír an chustaiméara mar thír seachadta, mar a éilíonn rialacha Peppol.

Sonrasc a fháil

Nuair a thuairiscíonn an pointe rochtana doiciméad a fuarthas trí a webhook, íoslódálann Nordlet comhad Peppol ón phointe rochtana. Taispeántar na sonrasc agus na nótaí creidmheasa a fhaigheann do chuideachta faoi Ceannacháin → Gabháil doiciméad, marcáilte mar a fuarthas thar Peppol ó ID Peppol an tseoltóra. Léann Nordlet an comhad Peppol é féin, mar sin ní úsáideann glacadh aon chreidmheasanna aitheantais doiciméad.

1. Oscail an doiciméad a fuarthas.
2. Seiceáil an soláthraí, na dátaí agus na línte; roghnaigh an soláthraí ó do chomhpháirtithe nó cruthaigh é.
3. Cliceáil Sábháil dréacht. Cruthaíonn Nordlet dréacht-sonrasc ceannaigh, nó dréacht-nóta creidmheasa ceannaigh le haghaidh nóta creidmheasa a fuarthas, leis an gcomhad bunúsach Peppol ceangailte. Cláraigh é mar a dhéanfá le haon sonrasc ceannaigh eile.

Ní féidir le línte sonrasc ceannaigh Nordlet a bheith diúltach. Roinntear lascainí agus muirir don doiciméad iomlán, agus línte diúltacha, thar na línte leis an ráta CBL céanna. Taispeántar méid nach féidir le haon líne dá ráta CBL a iompar, amhail earra a қайdhiú i ráta CBL nach bhfuil aon líne eile ag an sonrasc dó, i tábla dara: Línte nóta creidmheasa le haghaidh sonrasc a fuarthas, nó Línte sonrasc le haghaidh nóta creidmheasa a fuarthas. Sábháltar na línte sin mar dhoiciméad dara don soláthraí céanna: nóta creidmheasa ceannaigh in aghaidh an tsonrasc nua, uimhrithe "-CR", nó sonrasc ceannaigh uimhrithe "-INV". Cuireann an dá doiciméad le chéile le suim iomlán an doiciméid a fuarthas.

Seiceáil an bhfuil custaiméir ar Peppol

Iarrann POST /v1/peppol/participants/lookup le partnerId nó participantId (":") ar líonra Peppol an bhfuil an glacadóir cláraithe agus cén doiciméid a ghlacann sé. Oibríonn sé gan phointe rochtana.

An rud céanna a dhéanamh tríd an API

Tasc	Glao
Nasc an pointe rochtana	POST /v1/declarations/configs/update le system: "peppol" agus config ina bhfuil provider (recommand, storecove nó e-invoice-be), accountId, apiKey, apiSecret, webhookSecret agus apiBaseUrl roghnach
Glac le webhook an phointe rochtana	POST /v1/peppol/webhooks/{provider}/{companyId}, a ghlaonn an pointe rochtana
Íoslódáil an comhad Peppol	POST /v1/sales/invoices/peppol-xml
Seol	POST /v1/sales/invoices/peppol-send (422 gan pointe rochtana)
Léigh an stádas seachadta	POST /v1/sales/invoices/peppol-status (422 le Storecove); iompraíonn sonrasc peppolMessageId, peppolStatus, peppolDetail, peppolSentAt, peppolCheckedAt
Faigh doiciméid a fuarthas	POST /v1/capture/documents/list; tá provider: "peppol" agus senderId ag na cinn a fuarthas
Tiontaigh ceann ina sonrasc ceannaigh	POST /v1/capture/documents/confirm, le oppositeLines don dara doiciméad

Imeachtaí webhook: sale_invoice.peppol_sent, sale_invoice.peppol_delivered, sale_invoice.peppol_rejected, sale_invoice.peppol_failed agus document_capture.peppol_received. Féach ar Coinbhinsiúin API le haghaidh earráidí, neamh-athraitheacht (idempotency) agus webhook.