Nordlet

← Dokumenti / Gwidi

Tibgħat u tirċievi fatturi permezz ta' Peppol

Qabbad l-access point ta' Peppol tal-kumpanija tiegħek (Recommand, Storecove jew e-invoice.be) ma' Nordlet, ibgħat fatturi u credit notes permezz ta' Peppol, segwi l-kunsinna tagħhom, u biddel e-invoices li tirċievi f'fatturi tax-xiri.

Peppol hija n-netwerk Ewropew għall-iskambju ta' e-invoices strutturati bejn in-negozji u l-korpi pubbliċi. Kull fattura tivvjaġġa mill-access point ta' min jibgħat għal dak ta' min irċievi. Nordlet tibni fatturi u credit notes skont l-istandard Peppol BIS Billing 3.0, u tibgħathom u tirċievihom permezz tal-kont tal-access point tal-kumpanija tiegħek.

Peppol tistabbilixxi r-regoli dwar kif l-access points jiskambjaw id-dokumenti bejniethom, iżda mhux dwar kif is-software tiegħek jikkomunika mal-access point tiegħek: kull provider għandu l-API tiegħu. Nordlet jaħdem ma' dawn il-providers:

Provider Jibgħat Status tal-kunsinna Jirċievi
Recommand Iva permezz ta' webhook u fuq talba Iva
Storecove Iva permezz ta' webhook biss Iva
e-invoice.be Iva permezz ta' webhook u fuq talba Iva

Mingħajr access point, Nordlet xorta waħda tibni l-fajl Peppol ta' kull fattura u credit note maħruġa sabiex tkun tista' tniżżlu u tgħaddih b'mod ieħor; f'dan il-każ ma tibgħat jew tirċievi xejn hi stess.

X'inhu meħtieġ

  • Kont ma' wieħed mill-providers imsemmija hawn fuq, bil-kumpanija tiegħek irreġistrata fuq Peppol permezz tiegħu. Kull provider jiċċarġja għas-servizz tiegħu; ara l-lista tal-prezzijiet tiegħu stess.
  • F'Nordlet, in-numru tal-VAT jew in-numru tar-reġistrazzjoni tal-kumpanija, jew il-Peppol ID tagħha (Kont → Kumpaniji → Peppol ID). Kull klijent li tibgħatlu jrid ikollu wkoll wieħed minn dawn fuq il-karta tal-partner tiegħu.

Kif qabbad l-access point tiegħek

Iftaħ Kont → Konformità → UE → Peppol access point, agħżel il-provider tiegħek taħt Provider, imla oqsma għal dak il-provider kif deskritt hawn taħt u ssalva. Ħalli l-qasam API base URL vojt dment li l-provider ma takkombax indirizz differenti. Wara li ssalva, il-paġna turi l-Webhook URL tal-kumpanija tiegħek: https://api.nordlet.com/v1/peppol/webhooks/{provider}/{companyId}, fejn {provider} huwa recommand, storecove jew e-invoice-be u {companyId} huwa l-ID tal-kumpanija tiegħek. Kull kumpanija f'Nordlet għandha l-Webhook URL tagħha stess.

Nordlet taċċetta sejħa ta' webhook biss meta tkun tista' tipprova li taf is-sigriet tal-webhook tiegħek, u għalhekk sejħa li ma tiġix mill-kont tal-access point tiegħek tiġi rrifjutata. Nordlet tikkuntattja biss indirizzi pubbliċi tal-internet meta ċċempel l-access point tiegħek.

Recommand

  1. F'Recommand, iftaħ il-kumpanija tiegħek u kkopja l-company ID tagħha fil-qasam Account ID at the access point.
  2. F'Recommand, oħloq API key u kkopja ċ-ċavetta u s-sigriet tagħha fl-oqsma API key u API secret.
  3. Ivvinta test twil u każwali li int u Recommand biss tkunu tafu, u daħħlu f'Webhook secret. Isselezzjona ssalva.
  4. F'Recommand, oħloq webhook għall-kumpanija tiegħek bil-Webhook URL li turi Nordlet u bl-istess sigriet tal-webhook.

Recommand tiffirma kull sejħa ta' webhook b'dak is-sigriet.

Storecove

  1. Fi Storecove, oħloq legal entity għall-kumpanija tiegħek, issettjata biex tibgħat u tirċievi, u kkopja l-ID tagħha fil-qasam Account ID at the access point.
  2. Fi Storecove, taħt API Keys, oħloq API key u kkopjaha f'API key. Ħalli l-qasam API secret vojt.
  3. Ivvinta test twil u każwali u daħħlu f'Webhook secret. Issalva.
  4. Fi Storecove, waqqaf push webhook bil-Webhook URL li turi Nordlet, protett b'awtentikazzjoni HTTP Basic: kwalunkwe isem ta' utent, u s-sigriet tal-webhook bħala l-password.

Storecove m'għandhiex sejħa għall-istatus ta' dokument mibgħut, u għalhekk ma' Storecove l-istatus tal-kunsinna jiġi biss mill-webhook tagħha u l-paġna tal-fattura m'għandhiex il-buttuna Check Peppol status. Kont sandbox ta' Storecove jibgħat fuq in-netwerk tat-test ta' Peppol; l-API keys tal-produzzjoni jinkisbu mis-sapport ta' Storecove.

e-invoice.be

  1. Fl-app ta' e-invoice.be, taħt API Settings, kkopja l-API key tal-kumpanija tiegħek f'API key. Ħalli l-oqsma Account ID at the access point u API secret vojta. Issalva.
  2. Oħloq webhook bl-API ta' e-invoice.be (POST https://api.e-invoice.be/api/webhooks/) bil-Webhook URL li turi Nordlet u bl-avvenimenti document.received, document.sent u document.sent.failed.
  3. Kkopja s-secret li rritornat l-API għall-webhook il-ġdid fil-qasam Webhook secret f'Nordlet u erġa' ssalva.

e-invoice.be tiffirma kull sejħa ta' webhook b'dak is-sigriet. Kumpanija sandbox f'e-invoice.be tibgħat id-dokumenti bl-email minflok ma tibgħathom permezz ta' Peppol.

Kif tibgħat fattura

  1. Oħroġ il-fattura jew il-credit note.
  2. Iċċekkja li l-klijent għandu Peppol ID, numru tal-VAT jew numru tar-reġistrazzjoni fuq il-karta tal-partner tiegħu.
  3. Fuq il-paġna tal-fattura, fit-taqsima Delivery, ikklikkja Send via Peppol u kkonferma. It-taqsima tal-kunsinna tintwera għal fatturi maħruġa li għadhom mhumiex imħallsa, u l-buttuna tidher biss meta l-access point ikun imqabbad.

Nordlet tibni l-fajl Peppol u tgħaddih lill-access point tiegħek. Il-paġna tal-fattura mbagħad turi taqsima Peppol delivery:

Status Tifsira
pending Għaddiet lill-access point; l-access point tal-klijent għadu ma kkonfermahiex
delivered L-access point tal-klijent ikkonferma li rċieva l-fattura
rejected Il-klijent irrifjuta l-fattura; ir-raġuni tintwera taħt l-istatus
failed Il-fattura ma setgħetx titwassal; ir-raġuni tintwera taħt l-istatus meta l-access point jagħti waħda

L-istatus jiġi aġġornat awtomatikament meta l-access point jirrapporta bidla permezz tal-webhook tiegħu. Il-buttuna Check Peppol status tistaqsi lil Recommand jew e-invoice.be għall-istatus kurrenti minnufih; ma' e-invoice.be taqra wkoll ir-risposta tal-fattura mill-klijent, u rifjut (kodiċi tar-risposta RE) jintwera bħala rejected. Fattura miċħuda jew falluta tista' terġa' tintbagħat wara li tikkoreġi l-kawża. Meta l-access point jirrifjuta fattura mill-ewwel, pereżempju minħabba li l-klijent mhuwiex irreġistrat fuq Peppol, Nordlet turi ir-raġuni u l-fattura tibqa' mhux mibgħuta.

Il-buttuna Peppol XML fil-quċċata tal-paġna tal-fattura tniżżel l-istess fajl Peppol mingħajr ma tibgħatu.

Provvista intra-Komunitarja (intra-EU supply) tista' ġġorr id-data tal-ħruġ bיid-data tal-kunsinna u l-pajjiż tal-klijent bħala l-pajjiż tal-kunsinna, kif jeħtieġu r-regoli ta' Peppol.

Kif tirċievi fatturi

Meta l-access point jirrapporta dokument irċevut permezz tal-webhook tiegħu, Nordlet tniżżel il-fajl Peppol mill-access point. Fatturi u credit notes li tirċievi l-kumpanija tiegħek jidhru taħt Xiri → Qbid tad-dokumenti, immarkati bħala li nstabu fuq Peppol mill-Peppol ID ta' min jibgħat. Nordlet taqra l-fajl Peppol hi stess, u għalhekk ir-riċeviment ma juża l-ebda kreditu tar-rikonoxximent tad-dokumenti.

  1. Iftaħ id-dokument irċevut.
  2. Iċċekkja l-fornitur, id-dati u l-linji; agħżel il-fornitur mill-partners tiegħek jew oħloqu.
  3. Ikklikkja Save draft. Nordlet toħloq abbozz ta' fattura tax-xiri, jew abbozz ta' credit note tax-xiri għal credit note irċevuta, bil-fajl Peppol oriġinali mehmuż. Irreġistrah bħal kull fattura tax-xiri oħra.

Il-linji tal-fatturi tax-xiri f'Nordlet ma jistgħux ikunu negattivi. Skontijiet u spejjeż għ id-dokument kollu, u linji negattivi, jitqassmu fuq il-linji bl-istess rata tal-VAT. Ammont li l-ebda linja bir-rata tal-VAT tagħha ma tista' tinġarr, bħal oġġett mibgħut lura b'rata tal-VAT li l-fattura m'għandhiex linja oħra għaliha, jintwera f'tieni tabella: Credit note lines għal fattura rċevuta, jew Invoice lines għal credit note irċevuta. Dawk il-linji jiġu ssejvjati bħala tieni dokument għall-istess fornitur: credit note tax-xiri kontra l-fattura l-ġdida, innumerata "-CR", jew fattura tax-xiri innumerata "-INV". Iż-żewġ dokumenti flimkien jagħtu t-totali tad-dokument irċevut.

Kif tiċċekkja jekk klijent huwiex fuq Peppol

POST /v1/peppol/participants/lookup b'partnerId jew participantId (":") tistaqsi lin-netwerk Peppol jekk min irċievi huwiex irreġistrat u liema dokumenti jaċċetta. Dan jaħdem mingħajr access point.

Kif tagħmel l-istess permezz tal-API

Kompitu Sejħa
Qabbad l-access point POST /v1/declarations/configs/update b'system: "peppol" u config li jkun fih provider (recommand, storecove jew e-invoice-be), accountId, apiKey, apiSecret, webhookSecret u apiBaseUrl fakultattiv
Irċievi l-webhook tal-access point POST /v1/peppol/webhooks/{provider}/{companyId}, imsejħa mill-access point
Niżżel il-fajl Peppol POST /v1/sales/invoices/peppol-xml
Ibgħat POST /v1/sales/invoices/peppol-send (422 mingħajr access point)
Aqra l-istatus tal-kunsinna POST /v1/sales/invoices/peppol-status (422 bi Storecove); il-fatturi jġorru peppolMessageId, peppolStatus, peppolDetail, peppolSentAt, peppolCheckedAt
Sib dokumenti rċevuti POST /v1/capture/documents/list; dawk irċevuti għandhom provider: "peppol" u senderId
Biddel dokument f'fattura tax-xiri POST /v1/capture/documents/confirm, b'oppositeLines għ it-tieni dokument

Avvenimenti tal-webhook: sale_invoice.peppol_sent, sale_invoice.peppol_delivered, sale_invoice.peppol_rejected, sale_invoice.peppol_failed u document_capture.peppol_received. Ara Konvenzjonijiet tal-API għal żbalji, idempotenza u webhooks.