Self-billing cez API

Self-billing end-to-end cez PSB API: dva varianty, registrácia a voľba medzi NLCIUS a BIS.

Self-billing (zelffakturácia) je proces, pri ktorom kupujúci vystaví faktúru v mene dodávateľa. Toto sa vyskytuje v odvetviach, kde kupujúci dokáže presnejšie vypočítať dodané služby ako dodávateľ, napríklad v personálnej agentúre alebo pri externých službách. PSB podporuje self-billing v dvoch variantoch, každý s vlastnými technickými charakteristikami.

Dva varianty

PSB ponúka dva spôsoby odosielania self-billing faktúr cez sieť Peppol:

1. NLCIUS / SI-UBL 2.0 (zjednodušený)

Pri tomto variante zmeníte iba InvoiceTypeCode vo Vašej existujúcej NLCIUS faktúre:

  • InvoiceTypeCode 389 pre self-billing faktúru
  • InvoiceTypeCode 261 pre self-billing dobropis

CustomizationID a ProfileID zostávajú identické s bežnou NLCIUS faktúrou. PSB automaticky rozpozná typ dokumentu na základe InvoiceTypeCode a správne nasmeruje dokument. Ak je dodávateľ už registrovaný na prijímanie bežných NLCIUS faktúr, nie je potrebná žiadna ďalšia registrácia.

Toto je najjednoduchší variant a je vhodný pre väčšinu holandských integrácií.

2. Peppol BIS Self-Billing 3.0

Toto je samostatný Peppol profil s vlastnými identifikátormi:

PoleHodnotaCustomizationIDurn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:selfbilling:3.0ProfileIDurn:fdc:peppol.eu:2017:poacc:selfbilling:01:1.0InvoiceTypeCode389 (faktúra) alebo 261 (dobropis)

Pri tomto variante musí byť dodávateľ samostatne registrovaný v Peppol SMP na prijímanie self-billing dokumentov. Kupujúci (odosielateľ) odosiela dokument cez Generic endpoint PSB.

Použite tento variant, ak dodávateľ výslovne podporuje profil BIS Self-Billing 3.0, alebo ak sa príjemca nachádza mimo Holandska a neprijíma NLCIUS.

Ktorý variant zvoliť?
SituáciaOdporúčanieHolandský dodávateľ, už registrovaný pre NLCIUSNLCIUS (variant 1)Medzinárodný dodávateľ alebo explicitná podpora BIS Self-BillingBIS Self-Billing 3.0 (variant 2)Neistota ohľadom capabilities dodávateľaSkontrolujte cez queryRecipientParty
Kontrola capabilities

Pred odoslaním self-billing faktúry skontrolujte, či dodávateľ môže prijať požadovaný typ dokumentu:

GET /api/v1/queryRecipientParty?identifier={schemeID}:{id} HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}

Odpoveď obsahuje podporované typy dokumentov dodávateľa. Skontrolujte, či je dostupný self-billing profil (BIS Self-Billing 3.0) alebo štandardný faktúrový profil (NLCIUS).

Odosielanie a prijímanie

Technické podrobnosti odosielania a prijímania self-billing faktúr sú v samostatných článkoch:

Praktické upozornenia
  • Pri self-billingu je kupujúci vystaviteľom a odosielateľom faktúry, zatiaľ čo dodávateľ je príjemcom. To je opak bežnej faktúry.
  • Na PDF verziách self-billing faktúr je povinný text "Factuur uitgereikt door afnemer".
  • UBL doručenie má vždy prednosť pred PDF. Pri neplatnom UBL sa prípadne priložené PDF spracuje ako fallback.
  • Element AccountingSupplierParty obsahuje údaje dodávateľa (ktorý faktúru "prijíma"), nie kupujúceho, ktorý faktúru vystavuje.
Často kladené otázky
Aký je rozdiel medzi variantom NLCIUS a BIS Self-Billing 3.0?

Pri NLCIUS meníte hlavne InvoiceTypeCode na 389 (faktúra) alebo 261 (dobropis); CustomizationID a ProfileID zostávajú rovnaké ako pri štandardnom NLCIUS. BIS Self-Billing 3.0 používa pevné hodnoty CustomizationID a ProfileID pre profil self-billing a vyžaduje, aby bol dodávateľ registrovaný v SMP pre tento profil; odosielanie prebieha cez Generic endpoint.

Ako si vyberiem správny variant?

Pre holandského dodávateľa, ktorý už prijíma NLCIUS, je NLCIUS variant zvyčajne najjednoduchší. BIS Self-Billing 3.0 zvoľte, ak dodávateľ výslovne podporuje tento profil alebo pôsobí medzinárodne bez NLCIUS. V prípade pochybností môžete použiť queryRecipientParty na overenie, aké typy dokumentov protistrana podporuje.

Na čo si dať pozor pri PDF a UBL v self-billing?

Preferovaná je UBL dodávka; pri neplatnom UBL môže priložený PDF slúžiť ako záložné riešenie. Na PDF verziách musí byť povinný text "Faktúra vystavená kupujúcim". V XML zostáva AccountingSupplierParty dodávateľom (príjemcom faktúry), aj keď dokument vytvára kupujúci.


PSB automaticky zabezpečí smerovanie a validáciu self-billing dokumentov. Technická implementácia sa líši podľa variantu, ale v oboch prípadoch odosielate dokument cez PSB API a dodávateľ ho prijíma cez svoju Peppol registráciu.

Otvoriť API referenciu