Self-billing přes API

Self-billing end-to-end přes PSB API: dva varianty, registrace a volba mezi NLCIUS a BIS.

Self-billing (zelffakturace) je proces, při kterém kupující vystaví fakturu jménem dodavatele. Toto se vyskytuje v odvětvích, kde kupující dokáže přesněji vypočítat dodané služby než dodavatel, například v personální agentuře nebo u externích služeb. PSB podporuje self-billing ve dvou variantách, každá s vlastními technickými charakteristikami.

Dva varianty

PSB nabízí dva způsoby odesílání self-billing faktur přes síť Peppol:

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

U tohoto variantu změníte pouze InvoiceTypeCode ve Vaší existující NLCIUS faktuře:

  • InvoiceTypeCode 389 pro self-billing fakturu
  • InvoiceTypeCode 261 pro self-billing dobropis

CustomizationID a ProfileID zůstávají identické s běžnou NLCIUS fakturou. PSB automaticky rozpozná typ dokumentu na základě InvoiceTypeCode a správně nasměruje dokument. Pokud je dodavatel již registrován pro přijímání běžných NLCIUS faktur, není potřeba žádná další registrace.

Toto je nejjednodušší varianta a je vhodná pro většinu nizozemských integrací.

2. Peppol BIS Self-Billing 3.0

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

PoleHodnotaCustomizationIDurn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:selfbilling:3.0ProfileIDurn:fdc:peppol.eu:2017:poacc:selfbilling:01:1.0InvoiceTypeCode389 (faktura) nebo 261 (dobropis)

U tohoto variantu musí být dodavatel samostatně registrován v Peppol SMP pro přijímání self-billing dokumentů. Kupující (odesílatel) odesílá dokument přes Generic endpoint PSB.

Použijte tuto variantu, pokud dodavatel výslovně podporuje profil BIS Self-Billing 3.0, nebo pokud se příjemce nachází mimo Nizozemsko a nepřijímá NLCIUS.

Kterou variantu zvolit?
SituaceDoporučeníNizozemský dodavatel, již registrován pro NLCIUSNLCIUS (varianta 1)Mezinárodní dodavatel nebo explicitní podpora BIS Self-BillingBIS Self-Billing 3.0 (varianta 2)Nejistota ohledně capabilities dodavateleZkontrolujte přes queryRecipientParty
Kontrola capabilities

Před odesláním self-billing faktury zkontrolujte, zda dodavatel může přijmout požadovaný typ dokumentu:

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

Odpověď obsahuje podporované typy dokumentů dodavatele. Zkontrolujte, zda je dostupný self-billing profil (BIS Self-Billing 3.0) nebo standardní fakturační profil (NLCIUS).

Odesílání a přijímání

Technické podrobnosti odesílání a přijímání self-billing faktur jsou v samostatných článcích:

Praktická upozornění
  • Při self-billingu je kupující vystavitelem a odesílatelem faktury, zatímco dodavatel je příjemcem. To je opak běžné faktury.
  • Na PDF verzích self-billing faktur je povinný text "Factuur uitgereikt door afnemer".
  • UBL doručení má vždy přednost před PDF. Při neplatném UBL se případné přiložené PDF zpracuje jako fallback.
  • Element AccountingSupplierParty obsahuje údaje dodavatele (který fakturu "přijímá"), ne kupujícího, který fakturu vystavuje.
Často kladené otázky
Jaký je rozdíl mezi variantou NLCIUS a BIS Self-Billing 3.0?

U NLCIUS měníte hlavně InvoiceTypeCode na 389 (faktura) nebo 261 (dobropis); CustomizationID a ProfileID zůstávají stejné jako u standardního NLCIUS. BIS Self-Billing 3.0 používá pevné hodnoty CustomizationID a ProfileID pro profil self-billing a vyžaduje, aby byl dodavatel registrován v SMP pro tento profil; odesílání probíhá přes Generic endpoint.

Jak si vyberu správnou variantu?

Pro nizozemského dodavatele, který již přijímá NLCIUS, je NLCIUS varianta obvykle nejjednodušší. BIS Self-Billing 3.0 zvolte, pokud dodavatel výslovně podporuje tento profil nebo působí mezinárodně bez NLCIUS. V případě pochybností můžete použít queryRecipientParty k ověření, jaké typy dokumentů protistrana podporuje.

Na co si dát pozor u PDF a UBL v self-billing?

Preferována je UBL dodávka; u neplatného UBL může přiložený PDF sloužit jako záložní řešení. Na PDF verzích musí být povinný text "Faktura vystavená kupujícím". V XML zůstává AccountingSupplierParty dodavatelem (příjemcem faktury), i když dokument vytváří kupující.


PSB automaticky zabezpečí směrování a validaci self-billing dokumentů. Technická implementace se liší podle varianty, ale v obou případech odesíláte dokument přes PSB API a dodavatel ho přijímá přes svou Peppol registraci.

Otevřít API referenci