Jako kupující můžete přes PSB API vystavit a odeslat self-billing fakturu jménem Vašeho dodavatele. Tento článek krok za krokem popisuje, jak to udělat pro obě varianty: variantu NLCIUS a Peppol BIS Self-Billing 3.0.

Vždy nejprve zkontrolujte, zda dodavatel může přijmout požadovaný self-billing formát:

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

V odpovědi vyhledejte podporovaný profil. U NLCIUS je to standardní fakturační profil; u BIS Self-Billing 3.0 specifický self-billing profil.

Toto je nejjednodušší způsob odeslání self-billing faktury. Používáte stejný CustomizationID a ProfileID jako u běžné NLCIUS faktury, ale změníte InvoiceTypeCode na 389:

<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2">
  <CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:nen.nl:nlcius:v1.0</CustomizationID>
  <ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</ProfileID>
  <ID>SB-2026-001</ID>
  <IssueDate>2026-03-05</IssueDate>
  <InvoiceTypeCode>389</InvoiceTypeCode>
  <!-- AccountingSupplierParty = dodavatel (příjemce faktury) -->
  <AccountingSupplierParty>
    <Party>
      <EndpointID schemeID="0106">87654321</EndpointID>
      <PartyName><Name>Leverancier B.V.</Name></PartyName>
      ...
    </Party>
  </AccountingSupplierParty>
  <!-- AccountingCustomerParty = kupující (vystavitel faktury) -->
  <AccountingCustomerParty>
    <Party>
      <EndpointID schemeID="0106">12345678</EndpointID>
      <PartyName><Name>Koper B.V.</Name></PartyName>
      ...
    </Party>
  </AccountingCustomerParty>
  ...
</Invoice>

Dokument odešlete přes SalesInvoice endpoint:

POST /api/v1/{partyId}/salesInvoice/send HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}
Content-Type: application/xml
X-EConnect-DocumentId: {uuid}

PSB automaticky rozpozná InvoiceTypeCode 389 a nasměruje dokument jako self-billing fakturu dodavateli.

Tip: Pro self-billing dobropis použijte InvoiceTypeCode 261 místo 389.

U tohoto variantu používáte specifický self-billing profil s vlastními identifikátory:

<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2">
  <CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:selfbilling:3.0</CustomizationID>
  <ProfileID>urn:fdc:peppol.eu:2017:poacc:selfbilling:3.0</ProfileID>
  <ID>SB-2026-001</ID>
  <IssueDate>2026-03-05</IssueDate>
  <InvoiceTypeCode>389</InvoiceTypeCode>
  <AccountingSupplierParty>
    <Party>
      <EndpointID schemeID="0106">87654321</EndpointID>
      <PartyName><Name>Leverancier B.V.</Name></PartyName>
      ...
    </Party>
  </AccountingSupplierParty>
  <AccountingCustomerParty>
    <Party>
      <EndpointID schemeID="0106">12345678</EndpointID>
      <PartyName><Name>Koper B.V.</Name></PartyName>
      ...
    </Party>
  </AccountingCustomerParty>
  ...
</Invoice>

BIS Self-Billing dokumenty odešlete přes Generic endpoint:

POST /api/v1/{partyId}/generic/send HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}
Content-Type: application/xml
X-EConnect-DocumentId: {uuid}

PSB detekuje self-billing profil na základě CustomizationID a nasměruje dokument dodavateli, pokud je registrován pro profil BIS Self-Billing 3.0.

Pozor na rozdíl v rolích stran u self-billingu. To je častý zdroj nejasností:

AccountingSupplierParty je vždy dodavatel, i když fakturu vystavuje kupující. Kupující uvádí své údaje v AccountingCustomerParty.

Vždy používejte hlavičku X-EConnect-DocumentId k zabránění duplicitnímu odeslání. Pravidla jsou identická s běžnými fakturami: minimálně 6 znaků, nejlépe UUID, nikdy číslo faktury. Více v článku Idempotency.

Časté chyby u self-billingu:

Po odeslání obdržíte stejné webhook eventy jako u běžných faktur:

• InvoiceSent při úspěšném doručení
• InvoiceSentRetry při novém pokusu (max 8 retries)
• InvoiceSentError pokud doručení definitivně selhalo

Chcete dokument nejprve zvalidovat před odesláním? Použijte Validate API pro kontrolu self-billing faktury bez skutečného odeslání.