Identyfikatory Peppol: kody schematów, formaty i jak je sprawdzić

Identyfikator uczestnika Peppol to adres organizacji w sieci Peppol. Składa się z czterocyfrowego kodu schematu z listy ISO 6523 International Code Designator oraz numeru organizacji w tym schemacie, rozdzielonych dwukropkiem — na przykład 0208:0123456789 dla belgijskiego numeru przedsiębiorstwa lub 0204:991-12345-67 dla niemieckiego Leitweg-ID. Pełna postać dodaje metaschemat iso6523-actorid-upis::. Kody schematów publikuje OpenPeppol w Peppol Code Lists; zasady tworzenia i porównywania identyfikatorów zawiera Policy for use of Identifiers.

Jak wygląda identyfikator Peppol

Każdy identyfikator uczestnika ma trzy części: metaschemat, kod schematu ISO 6523 i wartość.

iso6523-actorid-upis::0208:0308357159
│                      │    └─ wartość: numer organizacji w tym schemacie
│                      └─ schemat: 0208 = belgijski numer przedsiębiorstwa
└─ metaschemat (jedyny używany w sieci Peppol)

Zasady ustala Policy for use of Identifiers 4.4.0. Wartość może zawierać litery, cyfry, minus, kropkę, podkreślenie i tyldę i może mieć do 130 znaków, nie licząc schematu. W wartościach identyfikatorów uczestników nie rozróżnia się wielkości liter — 0088:abc i 0088:ABC adresują tego samego uczestnika — i zwykle zapisuje się je małymi literami. Kod schematu musi występować na bieżącej liście kodów i nie może być wycofany (deprecated) ani usunięty; schematu z datą usunięcia nie można używać w sieci po tej dacie.

Ten sam kod pojawia się na fakturze dwukrotnie. Jako identyfikator uczestnika kieruje komunikat przez sieć; wewnątrz dokumentu Peppol BIS Billing 3.0 jest adresem elektronicznym sprzedawcy (BT-34) i nabywcy (BT-49), przenoszonym w cbc:EndpointID z obowiązkowym atrybutem schemeID:

<cac:AccountingCustomerParty>
  <cac:Party>
    <cbc:EndpointID schemeID="0208">0308357159</cbc:EndpointID>
    ...

Odbierający punkt dostępowy zwykle oczekuje, że EndpointID nabywcy będzie zgodny z identyfikatorem uczestnika, do którego zaadresowano komunikat. Identyfikatory stron w innych miejscach faktury (cac:PartyIdentification) mogą używać tych samych kodów ICD, ale nie wpływają na routing.

Najczęstsze kody schematów według kraju

Lista schematów identyfikatorów uczestników w Peppol Code Lists v9.7 (wydanej 2 lipca 2026 r.) zawiera 105 wierszy. Kody poniżej 1000 to prawdziwe ICD ISO 6523; kody z zakresu 99xx zostały przydzielone przez Peppol, zanim istniał ICD, i są to głównie krajowe numery VAT. Tam, gdzie kraj ma oba, krajowy Peppol Authority zwykle zaleca ICD — Belgia na przykład wymaga 0208, a 9925 traktuje jako opcjonalny.

Formaty wartości w tabeli pochodzą z opisów na liście kodów i z rejestrów krajowych; dokładna reguła walidacji schematu (cyfry kontrolne, prefiksy) należy do instytucji wydającej, a dostawca usług odrzuci błędnie sformułowaną wartość przy rejestracji. Belgijskie numery przedsiębiorstw są tego dobrym przykładem: nowe rejestracje od września 2023 r. zaczynają się od 1, a nie od 0, więc oprogramowanie nie może zakładać wiodącego zera.

Który identyfikator zarejestrować — i na który wysyłać

Należy zarejestrować identyfikator wymagany przez krajowy Peppol Authority, a inne dodawać tylko wtedy, gdy potrzebuje ich kontrahent. Jedna organizacja może mieć kilka identyfikatorów uczestnika, ale każdy identyfikator może być zarejestrowany tylko w jednym SMP naraz; przejście do innego dostawcy usług oznacza migrację rejestracji.

Przy wysyłaniu należy używać identyfikatora, pod którym odbiorca jest faktycznie zarejestrowany. W Belgii jest to domyślnie numer przedsiębiorstwa — FAQ FPS radzi dostawcom, by nie pytali klientów o Peppol ID, lecz adresowali na 0208: plus numer przedsiębiorstwa i pozwolili oprogramowaniu stosować strategię „Peppol first”. W Niemczech organ publiczny jest adresowany przez swój Leitweg-ID, który sam udostępnia, natomiast niemiecka firma wymieniająca faktury B2B jest częściej zarejestrowana pod numerem VAT (9930). GLN lub DUNS przydaje się tylko wtedy, gdy odbiorca go zarejestrował.

Belgijskie zasady dla uczestników i niemieckie zasady B2G opisano w hubie Belgia i na stronie XRechnung; mechanikę sieci na stronie czym jest Peppol.

Jak sprawdzić identyfikator

Dwa wyszukiwania odpowiadają na dwa różne pytania.

1. Czy ta organizacja jest w Peppol i pod jakim identyfikatorem? Należy przeszukać Peppol Directory (directory.peppol.eu) po nazwie, adresie, identyfikatorze lub słowie kluczowym. Każde trafienie to „wizytówka” (business card) opublikowana przez SMP uczestnika z jego identyfikatorami i typami dokumentów, które akceptuje; wyniki można wyeksportować jako XML, JSON lub CSV. Wpis w katalogu jest opcjonalny, więc jego brak nie dowodzi, że uczestnik jest nieosiągalny — ale dla Belgii FAQ FPS zaleca dokładnie to sprawdzenie, wyszukując 0208: plus numer przedsiębiorstwa.
2. Czy ten identyfikator może odebrać ten typ dokumentu? To wyszukiwanie SML/SMP, które punkt dostępowy wykonuje przed wysłaniem: identyfikator jest rozwiązywany przez DNS do jego SMP, a SMP wymienia obsługiwane typy dokumentów, identyfikatory procesów i odbierający punkt końcowy. Dostawcy usług udostępniają to jako „participant lookup” lub „capability check” w swoich interfejsach i API.

Żadne z tych wyszukiwań nie mówi, czy organizacja może wysyłać; sieć publikuje wyłącznie możliwości odbioru. Narzędzie identyfikatora Peppol na tej stronie pomaga poprawnie sformułować identyfikator, zanim zaczną go Państwo wyszukiwać.

Częste błędy

• Używanie wycofanego lub usuniętego schematu — 9908 dla Norwegii, 9956 dla Belgii, 0037 dla Finlandii — które punkty dostępowe odbiorców odrzucają.
• Wpisywanie prefiksu VAT do schematu numeru przedsiębiorstwa (0208:BE0308357159) lub pomijanie go w schemacie VAT (9925:0308357159).
• Gubienie wiodącego zera, ponieważ arkusz kalkulacyjny zapisał numer przedsiębiorstwa jako liczbę.
• Ustawienie w EndpointID nabywcy innego schemeID niż ten, na który zaadresowano komunikat.
• Adresowanie niemieckiego podmiotu publicznego numerem VAT zamiast jego Leitweg-ID.

Jak KRONENWERK obsługuje identyfikatory Peppol

Dla belgijskiej firmy KRONENWERK wyprowadza identyfikator Peppol z numeru przedsiębiorstwa — schemat 0208 i dziesięć cyfr, belgijski domyślny — i zapisuje go z schemeID="0208" w EndpointID sprzedawcy i nabywcy faktury UBL Peppol BIS Billing 3.0, którą generuje i waliduje przy wystawieniu. Generowanie i walidacja są OBSŁUGIWANE. Przy przekazywaniu faktury do punktu dostępowego moduł dostarczania rozpoznaje identyfikatory zapisane w postaci ISO 6523 (0208:0417497106) lub jako sam numer krajowy dla krajów obsługiwanych przez produkt — belgijski numer VAT staje się numerem przedsiębiorstwa 0208, francuski numer swoim SIREN lub SIRET (0002/0009), holenderskie, niemieckie i polskie numery VAT swoimi schematami VAT (9944, 9930, 9945), Leitweg-ID schematem 0204 — a wszystko, czego nie może jednoznacznie zmapować, traktuje jako nieosiągalne, zamiast zgadywać. Rozwiązywanie identyfikatora w działającej sieci — wyszukiwanie SML/SMP i sprawdzenie w katalogu — odbywa się w punkcie dostępowym: KRONENWERK nie jest punktem dostępowym Peppol i wysyła oraz odbiera przez Peppol za pośrednictwem akredytowanego dostawcy punktu dostępowego (Storecove), gdy firma zostanie podłączona w Ustawienia → Dostarczanie, co jest OBSŁUGIWANE Z OGRANICZENIAMI. Programiści integrujący aplikację znajdą konwencje identyfikatorów na stronie integracja Peppol.