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ů: capability selfbilling je na on. Pokud chybí, síť fakturu odmítne hláškou "Účastník dokument nepřijímá". 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.
  • Tato API trasa jde přes PSB. Platforma eConnect self-billing nepodporuje a není to v plánu.
  • Na PDF verzích self-billing faktur je povinné nizozemské znění « Factuur uitgereikt door afnemer » (faktura vystavená kupujícím).
  • 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 (capability selfbilling na on); 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