Self-billing przez API

Self-billing end-to-end przez PSB API: dwie warianty, rejestracja i wybór między NLCIUS a BIS.

Self-billing (samofakturowanie) to proces, w którym nabywca wystawia fakturę w imieniu dostawcy. Występuje to w sektorach, w których nabywca może dokładniej obliczyć wartość dostarczonych towarów lub usług, np. w branży pracy tymczasowej lub przy zleconych usługach. PSB obsługuje self-billing w dwóch wariantach, każdy z własnymi cechami technicznymi.

Dwa warianty

PSB oferuje dwa sposoby wysyłania faktur self-billing przez sieć Peppol:

1. NLCIUS / SI-UBL 2.0 (uproszczony)

W tym wariancie zmienia się jedynie InvoiceTypeCode w istniejącej fakturze NLCIUS:

  • InvoiceTypeCode 389 dla faktury self-billing
  • InvoiceTypeCode 261 dla noty kredytowej self-billing

CustomizationID i ProfileID pozostają identyczne jak w przypadku zwykłej faktury NLCIUS. PSB automatycznie rozpoznaje typ dokumentu na podstawie InvoiceTypeCode i prawidłowo kieruje dokument. Jeśli dostawca jest już zarejestrowany do odbioru zwykłych faktur NLCIUS, dodatkowa rejestracja nie jest wymagana.

To najprostszy wariant, odpowiedni dla większości holenderskich integracji.

2. Peppol BIS Self-Billing 3.0

Jest to oddzielny profil Peppol z własnymi identyfikatorami:

PoleWartośćCustomizationIDurn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:selfbilling:3.0ProfileIDurn:fdc:peppol.eu:2017:poacc:selfbilling:01:1.0InvoiceTypeCode389 (faktura) lub 261 (nota kredytowa)

W tym wariancie dostawca musi być oddzielnie zarejestrowany w Peppol SMP do odbioru dokumentów self-billing. Nabywca (nadawca) wysyła dokument przez endpoint Generic PSB.

Ten wariant należy stosować, gdy dostawca wyraźnie obsługuje profil BIS Self-Billing 3.0, lub gdy odbiorca znajduje się poza Holandią i nie akceptuje NLCIUS.

Który wariant wybrać?
SytuacjaZalecenieDostawca holenderski, już zarejestrowany dla NLCIUSNLCIUS (wariant 1)Dostawca międzynarodowy lub wyraźna obsługa BIS Self-BillingBIS Self-Billing 3.0 (wariant 2)Niepewność co do capabilities dostawcySprawdzenie za pomocą queryRecipientParty
Sprawdzanie capabilities

Przed wysłaniem faktury self-billing należy sprawdzić, czy dostawca może odebrać żądany typ dokumentu:

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

Odpowiedź zawiera obsługiwane typy dokumentów dostawcy. Należy sprawdzić, czy profil self-billing (BIS Self-Billing 3.0) lub standardowy profil faktur (NLCIUS) jest dostępny.

Wysyłanie i odbieranie

Szczegóły techniczne wysyłania i odbierania faktur self-billing opisano w oddzielnych artykułach:

Praktyczne uwagi
  • W self-billingu nabywca jest wystawcą i nadawcą faktury, a dostawca odbiorcą. Jest to odwrotność zwykłej faktury.
  • Na wersjach PDF faktur self-billing tekst "Faktura wystawiona przez nabywcę" jest obowiązkowy.
  • Dostarczanie w UBL jest zawsze preferowane nad PDF. W przypadku nieprawidłowego UBL ewentualnie załączony PDF jest używany jako fallback.
  • Element AccountingSupplierParty zawiera dane dostawcy (który "otrzymuje" fakturę), a nie nabywcy, który ją wystawia.
Często zadawane pytania
Jaka jest różnica między wariantem NLCIUS a BIS Self-Billing 3.0?

W przypadku NLCIUS zmienia się głównie InvoiceTypeCode na 389 (faktura) lub 261 (nota kredytowa); CustomizationID i ProfileID pozostają takie same jak w standardowym NLCIUS. BIS Self-Billing 3.0 używa stałych wartości CustomizationID i ProfileID dla profilu self-billing i wymaga, aby dostawca był zarejestrowany w SMP dla tego profilu; wysyłka odbywa się przez endpoint Generic.

Jak wybrać odpowiedni wariant?

Dla holenderskiego dostawcy, który już odbiera NLCIUS, wariant NLCIUS jest zwykle najprostszym rozwiązaniem. BIS Self-Billing 3.0 należy wybrać, jeśli dostawca wyraźnie obsługuje ten profil lub działa międzynarodowo bez NLCIUS. W razie wątpliwości można użyć queryRecipientParty, aby sprawdzić, jakie typy dokumentów obsługuje kontrahent.

Na co zwrócić uwagę przy PDF i UBL w self-billing?

Preferowana jest dostawa UBL; w przypadku nieprawidłowego UBL załączony PDF może służyć jako rozwiązanie awaryjne. Na wersjach PDF musi znajdować się obowiązkowy tekst "Faktura wystawiona przez nabywcę". W XML AccountingSupplierParty pozostaje dostawcą (odbiorcą faktury), nawet jeśli to nabywca sporządza dokument.


PSB automatycznie obsługuje routing i walidację dokumentów self-billing. Implementacja techniczna różni się w zależności od wariantu, ale w obu przypadkach dokument jest wysyłany przez PSB API, a dostawca odbiera go przez swoją rejestrację Peppol.

Otwórz referencję API