Prijatie self-billing faktúry cez API

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.

Ako prichádzajú self-billing faktúry?

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:

  1. Kupujúci odošle self-billing faktúru (InvoiceTypeCode 389) cez PSB
  2. Sieť Peppol nasmeruje dokument na Váš Access Point
  3. PSB odošle event InvoiceReceived na Váš webhook
  4. Stiahnete a spracujete dokument
SMP registrácia

Na 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:

Variant NLCIUS

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.

BIS Self-Billing 3.0

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.

Konfigurácia webhooku

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.

Stiahnutie a spracovanie dokumentu

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.

Rozpoznanie self-billing faktúry

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.

Odoslanie Invoice Response

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.

Retencia

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.

Často kladené otázky
Potrebujem samostatné webhoky pre self-billing?

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ú SMP registráciu potrebujem pre NLCIUS oproti BIS Self-Billing 3.0?

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.

Ako stiahnem prijatú self-billing faktúru a môžem zmeniť formát?

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