Narzędzie identyfikatora Peppol: zbuduj ID uczestnika i sprawdź w Directory

Identyfikator uczestnika Peppol to kod schematu z listy ISO 6523, dwukropek i wartość nadawana w tym schemacie, na przykład 0208:0417497106 dla belgijskiego numeru przedsiębiorstwa. Narzędzie powyżej składa identyfikator z tych dwóch części, normalizuje go i wyszukuje w Peppol Directory. Trafienie oznacza, że uczestnik opublikował wizytówkę (business card); brak trafienia nie dowodzi, że uczestnik jest nieosiągalny.

Jak zbudowany jest identyfikator uczestnika

Każdy identyfikator ma tę samą postać: <schemat>:<wartość>, przenoszoną w ramach metaschematu iso6523-actorid-upis. Polityka OpenPeppol Policy for use of Identifiers stanowi, że identyfikator uczestnika składa się z „An Identifier Scheme” oraz „The value provided by this Identifier Scheme”, że schemat musi pochodzić z normatywnej listy kodów Peppol oraz że „All Participant Identifier values have to be treated case insensitive”. W praktyce wartość zapisuje się bez spacji i znaków interpunkcyjnych, małymi literami tam, gdzie występują litery.

1. Należy wybrać schemat, którego kraj odbiorcy używa w sieci. Belgia oczekuje numeru przedsiębiorstwa (0208); Niemcy używają Leitweg-ID (0204) dla podmiotów publicznych i numeru VAT (9930) dla firm; Francja używa SIRET (0009) lub SIREN (0002).
2. Wartość należy przyjąć dokładnie tak, jak zapisuje ją rejestr wydający: belgijski numer ma 10 cyfr (do dawnej 9-cyfrowej postaci dodaje się wiodące zero), SIRET ma 14 cyfr, wartość niemieckiego schematu VAT zawiera prefiks DE.
3. Obie części łączy się dwukropkiem. W fakturze UBL ta sama para pojawia się jako <cbc:EndpointID schemeID="0208">0417497106</cbc:EndpointID>.

Najczęstsze schematy

Poniższe wiersze pochodzą z listy kodów schematów identyfikatorów uczestników Peppol w wersji 9.7 (2 lipca 2026 r.); dla schematów opartych na numerze VAT, których struktury lista nie precyzuje, kolumna wartości pokazuje krajowy format numeru VAT. Wierszy oznaczonych na liście jako wycofane (deprecated) nie wolno używać w nowych dokumentach; wierszy z datą usunięcia nie można używać po tej dacie w ogóle.

Pełna lista znajduje się na stronie list kodów OpenPeppol; tło opisano na stronie identyfikatory Peppol.

Wyszukiwanie identyfikatora w Peppol Directory

Peppol Directory to indeks wyszukiwania wizytówek, które dostawcy usług publikują przez swoje SMP dla obsługiwanych uczestników. Można w nim szukać po nazwie, kraju lub dokładnym identyfikatorze, a to samo wyszukiwanie jest dostępne jako REST API pod /search/1.0/json, gdzie parametr participant „Searches for exact matches in the Peppol participant identifier field (the identifier scheme must be part of the value)”. Zapytanie ma więc postać iso6523-actorid-upis::0208:0417497106, a nie samego numeru.

Wynik pokazuje nazwę podmiotu, kraj i dodatkowe identyfikatory z jego wizytówki, a nie typy dokumentów, które może odbierać; ta informacja znajduje się w SMP.

Co oznacza „nie znaleziono”

„Nie znaleziono” oznacza, że w Directory nie ma wizytówki dla tego identyfikatora. Nie oznacza, że uczestnika nie ma w sieci. Publikacja w Directory jest wykonywana przez dostawcę SMP i jest niezależna od rejestracji punktu końcowego w SML; uczestnik może być w pełni osiągalny, a mimo to nieobecny w Directory, a Directory może pozostawać w tyle za niedawną rejestracją. Zanim uznają Państwo, że klient nie może odbierać, warto wypróbować drugi schemat używany w jego kraju, sprawdzić brakujące wiodące zero i zapytać, który identyfikator zarejestrował jego dostawca.

Jak KRONENWERK to obsługuje

OBSŁUGIWANE Z OGRANICZENIAMI KRONENWERK wysyła i odbiera przez Peppol za pośrednictwem akredytowanego dostawcy punktu dostępowego (Storecove), gdy firma zostanie podłączona w Ustawienia → Dostarczanie. Przed wysłaniem belgijskiej faktury KRONENWERK wyprowadza identyfikator odbiorcy z danych na karcie klienta: akceptuje postać ISO (0208:0417497106), postać dostawcy lub sam belgijski numer VAT, który przekształca na schemat numeru przedsiębiorstwa 0208 wymagany przez Belgię. Następnie pyta punkt dostępowy, czy ten uczestnik może odbierać; klient, którego nie można rozwiązać, jest zgłaszany jako nieosiągalny, nigdy nie jest dostarczany „gdziekolwiek”. Schematy mapowane przez KRONENWERK to te z tabeli dla BE, FR, NL, DE i PL. Ograniczenie: wyszukiwanie zależy od tego, czy połączenie z dostawcą jest skonfigurowane i osiągalne, a sam KRONENWERK nie jest punktem dostępowym Peppol. Szczegóły na stronach wysyłanie i odbieranie przez Peppol, przegląd Peppol oraz belgijski obowiązek e-fakturowania.