Ako Peppol cez SML, DNS NAPTR a SMP nájde správneho príjemcu: krok za krokom, vrátane bežných chybových správ.
Service Metadata Publisher (SMP) je adresár siete Peppol. Keď Access Point (AP) odosiela dokument, použije Participant Identifier príjemcu, aby -- prostredníctvom Service Metadata Locator (SML) a Domain Name System (DNS) -- zistil, v akom SMP je príjemca zaregistrovaný, akú URL koncového bodu volať a ktoré typy dokumentov sú podporované. Tento článok popisuje reťazec objavovania krok za krokom.
Peppol je otvorená sieť: neexistuje centrálna poštová schránka, ktorá by prijímala a distribuovala všetky dokumenty. Namiesto toho každý certifikovaný poskytovateľ služieb spravuje vlastný SMP s metadátami svojich zákazníkov -- ktoré dokumenty môžu prijímať, cez aký AP a akými certifikátmi podpisujú. Odosielajúci AP musí pred každým odoslaním zistiť, kam dokument doručiť, a na to využíva SMP príjemcu.
Špecifikácia SMP je štandardom Organization for the Advancement of Structured Information Standards (OASIS). eConnect je uvedený na zozname riešení kompatibilných s eDelivery SMP Európskej komisie s vlastnou implementáciou.
Každá organizácia v Peppol má aspoň jeden Participant Identifier, zložený zo scheme a value:
iso6523-actorid-upis::<scheme>:<value>
Scheme je kód zo zoznamu kódov Electronic Address Scheme (EAS) -- registra OpenPeppol národných a medzinárodných identifikačných systémov. Najčastejšie používané kódy EAS:
iso6523-actorid-upis::0106:54441587iso6523-actorid-upis::0190:00000001820029336000iso6523-actorid-upis::9944:NL851306469B01iso6523-actorid-upis::0208:0899965307iso6523-actorid-upis::0204:991-01234-56iso6523-actorid-upis::0192:745707327iso6523-actorid-upis::0235:100123456700003iso6523-actorid-upis::0088:1548079098355Úplný prehľad je k dispozícii na docs.peppol.eu/edelivery/codelists/ a v Peppol ID a identifikátory.
Odosielajúci AP odpovedá na tri otázky pre každý dokument:
Participant Identifier je zahashovaný MD5 a zakódovaný malými písmenami hexadecimálne. Hashovaná hodnota sa stane najľavejším štítkom domény SML, za ktorou nasleduje schéma Peppol a zóna SML. Pre produkciu:
B-<md5>.iso6523-actorid-upis.edelivery.tech.ec.europa.eu
Testovacie prostredie Peppol používa samostatnú zónu SML. Od marca 2026 sú pre produkciu aj test publikované výhradne záznamy NAPTR -- staré záznamy CNAME boli odstránené.
Odosielajúci AP vykoná DNS dopyt na vyššie uvedenú doménu, pre typ záznamu NAPTR (Naming Authority Pointer). NAPTR je povinný od 1. februára 2026. Odpoveď NAPTR obsahuje servisný štítok (Meta:SMP) a pole regexp odkazujúce na URL SMP príjemcu:
B-<md5>.iso6523-actorid-upis.edelivery.tech.ec.europa.eu
IN NAPTR 100 10 "U" "Meta:SMP" "!^.*$!https://smp.example.com/!" .
Výsledok: AP vie, na akej URL SMP je príjemca zaregistrovaný.
S URL SMP zostaví AP konkrétné URL metadát pre tohto účastníka:
GET https://smp.example.com/iso6523-actorid-upis%3A%3A0106%3A54441587
SMP vráti ServiceGroup v XML so všetkými podporovanými typmi dokumentov. Pre každý typ dokumentu môže AP požiadať o ServiceMetadata prostredníctvom druhého požiadavku:
GET https://smp.example.com/iso6523-actorid-upis%3A%3A0106%3A54441587/services/<DocumentTypeId>
Odpoveď obsahuje URL koncového bodu, transportný profil, proces a certifikát PKI prijímajúceho AP. S týmito informáciami C2 zaifróva a podpíše dokument, otvorí spojenie AS4 s C3 na nájdenom EndpointURI a doručí ho.
Následujúca end-to-end ilustrácia ukazuje, ako holandský Participant Identifier (číslo KvK) vedie ku konkrétnemu URL koncového bodu:
1. Odosielateľ chce poslať faktúru:
iso6523-actorid-upis::0106:54441587 (eConnect, EAS 0106 -- KvK)
2. AP odosielateľa vykoná lookup DNS NAPTR:
B-<md5>.iso6523-actorid-upis.edelivery.tech.ec.europa.eu
--> URL SMP: https://smp.econnect.eu/
3. AP odosielateľa sa dotazuje SMP:
GET https://smp.econnect.eu/iso6523-actorid-upis%3A%3A0106%3A54441587
--> ServiceGroup okrem iného s DocumentTypeId pre faktúru NLCIUS
4. AP odosielateľa sa dotazuje ServiceMetadata pre NLCIUS:
GET https://smp.econnect.eu/iso6523-actorid-upis%3A%3A0106%3A54441587/services/<NLCIUS-DocumentTypeId>
--> EndpointURI: https://ap.econnect.eu/as4
--> Certificate: <X.509 / certifikát PKI>
--> TransportProfile: peppol-transport-as4-v2_0
5. AP odosielateľa vytvorí SBDH s metadátami smerovania,
podpíše a odešle cez AS4 + TLS na EndpointURI.
Pri registrácii v SMP sú na organizáciu nakonfigurované capabilities pre každú rodinu dokumentov:
invoicesselfbillinginvoiceResponseorderOnlyorderAdvancedorderResponsepintProfilesmls / mlrKaždá capability má hodnotu on, off alebo inherited. Úplná sada capabilities určuje, ktoré typy dokumentov môže odosielajúci AP v SMP nájsť -- a teda pre čo je príjemca fakticky dostupný.
Lookup SMP sa vykonáva pri každom odosielaní. Pre škálovateľnosť a robustnosť používa eConnect SMP vlastnú cachovaciu vrstvu: lookups zostávajú dostupné -- aj keď externý SMP dočasne neodpovedá -- opětovným použitím cachovaných metádát v rámci doby platnosti. eConnect garantuje 99,99% dostupnosť SMP.
Dva podobne znejúce pojmy, ktoré sa v praxi často zamieňajú:
edelivery.tech.ec.europa.eu pre produkciu), v ktorej sú zverejnené všetky Participant Identifiers a ktorá odkazuje na správny SMP. Existuje jeden produkčný SML a jeden testovací; OpenPeppol preberá správu od Európskej komisie (prechod do konca augusta 2026).Analógia s DNS: SML je centrálny telefónny zoznam, ktorý odkazuje na správny regionálny adresár; SMP je ten adresár so skutočnými dátami.
Participant Identifier môže byť registrovaný iba v jednom SMP naraz -- inak by C2 nevedel, kam dokument odoslať. Pri zmene poskytovateľa platí migračný postup s migračným kľúčom: aktuálny SMP vygeneruje kľúč a nový SMP ho použije na bezprobémové prevzatie registrácie. Počas prechodu zostane organizácia dostupná; identifikátor sa nem ení, takže obchodní partneri nič nezaznamenaná.
Okrem strojovo čitateľného SMP existujú dve verejné portály pre ručné vyhľadávania:
No valid delivery options / PartyId not found, alebo naopak. Nepoužívajte Directory ako dôkaz, že niekto môže alebo nemôže prijímať.Pre spaholživú odpoveď na otázku môže tento prijmateľ prijímať, alebo nie je potrebné vykonávať skutočné vyhľadávanie SMP -- nespoláhať na zobrazenie v Directory. Dve verejné nástroje vykonávajú skutočné vyhľadávanie Peppol (rovnaké ako PSB eConnect):
Ak vyhľadávanie uspeje v jednom z týchto nástrojov, prijmateľ je dostupný; ak zlyhá (PartyId not found / žiadne možnosti doručenia), prijmateľ nie je pripojený pre daný typ dokumentu -- bez ohľadu na to, čo zobrazuje Peppol Directory. Programovo dáva queryRecipientParty PSB rovnaký, smerodajný výsledok.
V adresári Peppol Directory zobrazuje pole „additional information" názov registrujúceho poskytovateľa služieb -- pri registráciách cez PSB eConnect sa tu zobrazuje „eConnect". Ide o metadáta registrara SMP registrujúceho SP a nie sú súčasťou businessCard konfigurovateľnej per účastník. Polia konfigurovateľné per účastník sú spravované cez businessCard.names; pole „additional information" leží mimo tento rozsah, a preto nie je konfigurovateľné per účastník -- ani pre white-label partnerov registrujúcich sa cez endpoint PSB eConnect.
Pre zákazníkov, ktorí chcú programovo overiť, či je príjemca dostupný, ponúka Peppol Service Bus (PSB) eConnect endpoint queryRecipientParty, ktorý priamo dopytuje SMP a uvádza, cez aký kanál a formát je príjemca dostupný.
SMP not found / preklad NAPTR zlyháqueryRecipientPartyService not foundNo valid delivery optionsinvoices -- pozri oddiel nižšieCertificate expired / invalidEndpoint not reachablequeryRecipientParty timeoutPríjemca môže byť v Peppol dohľadateľný -- vyhľadávanie NAPTR aj dopyt SMP uspejú -- a napriek tomu nemôže prijímať faktúry. SMP totiž zverejňuje pre každý typ dokumentu zvláštnu capability. Prijímanie faktúr patrí pod invoices; vrátenie obchodného stavu (BIS Invoice Response 3.0) patrí pod oddelenú capability invoiceResponse. Ide o nezávislé registrácie.
Ak je príjemca na svojom ID Peppol zaregistrovaný výhradne pre Invoice Response transaction 3.0 (invoiceResponse nastavené na on, invoices na off), odosielajúci AP v SMP nenájde žiadny endpoint invoices. Neexistuje potom žiadna platná cesta doručenia faktúry a platforma eConnect pri odosielaní hlási No valid delivery options. Príjemca môže cez tento identifikátor odoslať Invoice Response, ale sám naň faktúru prijať nemôže.
Dôležité: nejde o chybu na strane eConnect ani odosielateľa -- ide o presné zobrazenie toho, čo príjemca zverejnil vo vlastnom SMP.
Dve riešenia:
invoices) zaregistrovaný. Organizácia môže registrovať viacero identifikátorov s vlastnými capabilities typov dokumentov na identifikátor.Pri pochybnostiach skontrolujte, ktoré typy dokumentov príjemca publikuje prostredníctvom Peppol Lookup Service alebo programovo cez queryRecipientParty.
Peppol Directory (directory.peppol.eu) je asynchrónny register, ktorý pravidelne načítava dáta z SMP. Môže zaostávať za skutočným stavom registrácie a je preto nespolahlivý pre overovanie dostupnosti. Peppol Lookup Service (lookup.peppol.org) dopytuje SMP priamo a zobrazuje aktuálny stav. Pre odstraňovanie problémov je Lookup Service smerodajný. Alternatívy, ktoré tiež priamo dopytujú SMP: test.peppolautoriteit.nl/discover a peppol.helger.com.
Príjemca môže byť uvedený v registri Peppol, ale zaregistrovaný výhradne pre Invoice Response (capability invoiceResponse), nie pre prijímanie faktúr (capability invoices). Neexistuje potom žiadna platná cesta doručenia faktúry. Skontrolujte cez queryRecipientParty alebo Peppol Lookup Service, ktoré capabilities sú aktívne, a kontaktujte príjemcu ohľadom alternatívneho spôsobu doručenia alebo iného Peppol ID.
Zmena v skutočnej registrácii SMP je účinná od nasledujúciho odoslania: odosielajúci AP SMP dopytuje vždy znova. Externé, neautoritatívne zobrazenia, ako je Peppol Directory (directory.peppol.eu) alebo peppolcheck.be, môžu ukazať zmenu neskôr kvôli vlastnej stratégii ukladania do medzipamäte a asynchrónnemu načítávaniu. Vnímajte rozdiel: nástroje, ktoré dopytujú SMP priamo -- ako test.peppolautoriteit.nl/discover a peppol.helger.com -- vždy zobrazujú aktuálny stav. Pre smerodajný stav je rozhodujúci Peppol Lookup Service alebo priamy dopyt SMP cez queryRecipientParty.
Áno. Organizácia môže registrovať viacero Participant Identifiers -- každý na inom schéme EAS (napr. KvK a IČ DPH). Na identifikátor možno nastaviť vlastné capabilities typov dokumentov. Ak je faktúra na jednom ID odmietnutá s No valid delivery options, oplatí sa preveriť, či má príjemca iné Peppol ID s aktivovanou capability invoices.
Viac o Peppol ID a identifikátoroch