Prijímanie self-billing dokumentov: SMP capabilities a flow spracovania.
Ako dodávateľ prijímate self-billing faktúry od Vašich kupujúcich. Kupujúci vystaví faktúru vo Vašom mene a odošle ju cez sieť Peppol. Tento článok popisuje, akú registráciu potrebujete a ako prijaté dokumenty spracujete.
Self-billing faktúry sa doručujú rovnakým spôsobom ako bežné nákupné faktúry. PSB odošle webhook notifikáciu a dokument môžete stiahnuť cez PurchaseInvoice endpoint. Rozdiel je v registrácii a type dokumentu.
Flow prijatia:
389) cez PSBInvoiceReceived na Váš webhookNa prijímanie self-billing faktúr musí byť Vaša organizácia registrovaná v Peppol SMP. Aká registrácia je potrebná, závisí od variantu:
Ak ste už registrovaní na prijímanie bežných NLCIUS faktúr, nemusíte robiť nič navyše. Self-billing faktúry s InvoiceTypeCode 389 sa doručujú cez rovnaký profil. PSB automaticky rozpozná typ dokumentu.
Pre profil BIS Self-Billing 3.0 je potrebná samostatná registrácia. Tento profil má vlastný CustomizationID a ProfileID a vyžaduje špecifickú SMP konfiguráciu.
Nakonfigurujte self-billing capability cez Peppol config API:
PUT /api/v1/peppol/config HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}
Content-Type: application/json
{
"selfBilling": {
"state": "on"
}
}
Bez tejto registrácie Vás kupujúci používajúci profil BIS Self-Billing 3.0 nemôžu nájsť cez Peppol SMP lookup.
Použite rovnaký topic ako pre bežné nákupné faktúry:
{
"action": "https://mijn-systeem.nl/webhook/invoices#mijnSecretKey",
"topics": ["InvoiceReceived"]
}
Self-billing faktúry prichádzajú ako eventy InvoiceReceived. Od bežných faktúr ich odlíšite kontrolou InvoiceTypeCode v XML dokumente: 389 pre self-billing faktúru, 261 pre self-billing dobropis.
Dokument stiahnete rovnakým spôsobom ako bežnú nákupnú faktúru:
GET /api/v1/{partyId}/purchaseInvoice/{documentId}/download HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}
Voliteľne môžete cez targetDocumentTypeId vyžiadať dokument v inom formáte, ak to Váš systém vyžaduje.
Po stiahnutí môžete v XML dokumente skontrolovať, či ide o self-billing faktúru:
<!-- InvoiceTypeCode 389 = self-billing faktúra -->
<InvoiceTypeCode>389</InvoiceTypeCode>
<!-- InvoiceTypeCode 261 = self-billing dobropis -->
<InvoiceTypeCode>261</InvoiceTypeCode>
Pri self-billing faktúre je AccountingSupplierParty Vaša organizácia (dodávateľ), zatiaľ čo AccountingCustomerParty je kupujúci, ktorý faktúru vystavil.
Po prijatí môžete odoslať Invoice Response kupujúcemu na potvrdenie spracovania alebo zamietnutie faktúry. Flow je identický s bežnými faktúrami:
POST /api/v1/{partyId}/purchaseInvoice/{documentId}/response HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}
Content-Type: application/json
{
"status": "AP",
"clarificationCode": "NON",
"actionCode": "NOA"
}
Pozrite si Odoslanie Invoice Response pre kompletný prehľad stavových kódov a clarification codes.
Retenčné pravidlá pre self-billing dokumenty sú rovnaké ako pre bežné nákupné faktúry: 90 dní uchovávanie po prijatí, 7 dní po stiahnutí. Sťahujte dokumenty včas a ukladajte ich vo vlastnom systéme.
Nie, self-billing používa rovnaký topic ako bežné nákupné faktúry: InvoiceReceived. Self-billing rozlíšite v spracovaní čítaním InvoiceTypeCode v XML (389 pre faktúru, 261 pre dobropis).
Ak už prijímate nákupné faktúry NLCIUS, táto registrácia pokrýva aj NLCIUS self-billing s kódom 389 alebo 261. Pre BIS Self-Billing 3.0 je potrebná samostatná capability; nastavte selfBilling.state na on cez PUT /api/v1/peppol/config, inak Vás kupujúci pre tento profil v SMP nenájdu.
Použite GET /api/v1/{partyId}/purchaseInvoice/{documentId}/download ako pri každej nákupnej faktúre. S parametrom dopytu targetDocumentTypeId môžete požiadať o iný cieľový formát, ak to Váš back-end systém vyžaduje. Po stiahnutí skontrolujte v XML, ktorá strana je dodávateľ a ktorá kupujúci podľa AccountingSupplierParty a AccountingCustomerParty.
Či ako dodávateľ prijímate NLCIUS alebo BIS Self-Billing 3.0, závisí od toho, čo kupujúci odošle. Uistite sa, že máte správnu SMP registráciu pre varianty, ktoré Vaši kupujúci používajú. V prípade pochybností: registrujte sa pre obe.
Zobraziť API dokumentáciu