Peppol Testbed — Povinné testovanie pred akreditáciou

Čo je Peppol Testbed

Peppol Testbed je online testovací platforma, ktorú prevádzkuje OpenPeppol. Slúži na overenie, že váš Access Point (digitálny poštár) správne implementuje všetky technické požiadavky Peppol siete — od transportného protokolu AS4 až po správnu štruktúru dokumentov podľa Peppol BIS.

Testbed je dostupný na adrese peppol.org/tools-support/testbed/ a prístup k nemu získate po registrácii. Existuje v dvoch prostrediach:

• Testovací (ACC) — pre vývoj a ladenie, kde môžete testovať opakovane bez obmedzení.
• Produkčný testbed — pre záverečné testy pred akreditáciou, kde sa generuje oficiálny report.

Úspešné absolvovanie testov na Peppol Testbed je povinnou podmienkou pre získanie akreditácie od Peppol Authority. Na Slovensku to znamená, že bez platného Testbed reportu Finančná správa SR vašu žiadosť o akreditáciu neakceptuje.

Čo sa testuje

Testbed overuje tri hlavné oblasti funkčnosti vášho Access Pointu:

AS4 konektivita

Prvá sada testov overuje, či váš Access Point správne implementuje Peppol AS4 Profile. Konkrétne sa testuje:

• Nadviazanie spojenia — či váš AP dokáže prijať príchodzí AS4 požiadavok a nadviazať šifrované spojenie.
• Vzájomná TLS autentifikácia — či sa obe strany správne autentifikujú certifikátmi.
• Podpisovanie správ — či sú odchádzajúce správy podpísané platným Peppol PKI certifikátom.
• Potvrdenie prijatia — či váš AP odosiela korektné AS4 receipt správy po prijatí dokumentu.
• Spracovanie chýb — či váš AP správne reaguje na neplatné správy (odmietne ich a vráti chybovú hlášku).

Odosielanie dokumentov

Druhá sada testov overuje schopnosť vášho Access Pointu odosielať dokumenty do Peppol siete:

• Vytvorenie AS4 obálky — správny formát SOAP správy vrátane hlavičiek a príloh.
• Adresovanie — správne použitie Peppol ID odosielateľa a príjemcu.
• SMP/SML lookup — či váš AP dokáže vyhľadať príjemcu cez adresárové služby.
• Doručenie testovacieho dokumentu — odoslanie reálneho UBL dokumentu na testovací Access Point.

Prijímanie dokumentov

Tretia sada testov overuje schopnosť prijímať a spracovávať dokumenty:

• Príjem AS4 správy — váš AP musí byť dostupný na verejnej URL adrese a prijať prichádzajúcu správu.
• Validácia dokumentu — overenie, či prijatý dokument spĺňa Peppol BIS špecifikáciu.
• Uloženie a spracovanie — dokument musí byť správne rozparsovaný a uložený.
• Spätné potvrdenie — odoslanie AS4 receipt správy odosielateľovi.

Postup testovania krok za krokom

1. Príprava prostredia

Pred spustením testov musíte mať pripravené:

• Funkčný Access Point dostupný na verejnej IP adrese s platným HTTPS certifikátom.
• Testovací Peppol PKI certifikát — žiadosť podáte cez Peppol Service Desk so súhlasom PA SK (Finančnej správy).
• Registráciu v testovacom SMP — váš testovací účastník musí byť zaregistrovaný v testovacom prostredí SMP/SML.
• Prihlasovacie údaje do Testbed — získate po registrácii na peppol.org.

2. Konfigurácia Testbed

Po prihlásení do Testbed nakonfigurujete:

• Endpoint URL vášho Access Pointu (adresa, na ktorej prijímate správy).
• Peppol Participant ID vášho testovacieho účastníka.
• Podporované typy dokumentov (typicky Peppol BIS Billing 3.0).

3. Spustenie testov

Testy sa spúšťajú postupne — najprv konektivita, potom odosielanie a nakoniec prijímanie. Každý test má jasný výsledok: úspech (passed) alebo zlyhanie (failed) s popisom chyby.

4. Ladenie a opakované testovanie

V testovacom prostredí môžete testy opakovať neobmedzene. Po každom zlyhaní analyzujte chybovú hlášku, opravte problém a spustite test znova. Tento cyklus je normálny — väčšina poskytovateľov neprejde všetkými testami na prvý pokus.

5. Záverečný test a generovanie reportu

Keď všetky testy úspešne prejdú, spustíte záverečnú testovaciu sériu, ktorá vygeneruje oficiálny Testbed report. Tento PDF dokument priložíte k žiadosti o akreditáciu.

Časté problémy a ich riešenie

Na základe skúseností poskytovateľov v iných krajinách sú najčastejšie problémy pri testovaní:

Chyba certifikátu

Symptóm: Test zlyhá s hláškou o neplatnom alebo nedôveryhodnom certifikáte.

Riešenie: Overte, že používate testovací Peppol PKI certifikát (nie produkčný) a že je správne nainštalovaný v keystorom vášho AS4 softvéru. Skontrolujte aj platnosť komerčného HTTPS certifikátu na vašom serveri.

Nesprávny formát SOAP hlavičiek

Symptóm: AS4 konektivita zlyhá, hoci TLS funguje správne.

Riešenie: Porovnajte SOAP hlavičky vašich správ s príkladmi v Peppol AS4 Profile špecifikácii. Najčastejšia chyba je nesprávny namespace, chýbajúci MessageId alebo zlý formát časovej pečiatky.

Timeout pri prijímaní

Symptóm: Test odosielania na váš AP zlyhá s timeoutom.

Riešenie: Overte, že váš Access Point je dostupný z internetu na správnom porte. Skontrolujte firewallové pravidlá, NAT konfiguráciu a DNS záznamy. Testbed sa pripája z konkrétnych IP adries — uistite sa, že nie sú blokované.

Validačná chyba dokumentu

Symptóm: Dokument sa odošle úspešne, ale príjemca ho odmietne ako nevalidný.

Riešenie: Použite Peppol validačný nástroj na overenie vášho UBL dokumentu oproti BIS v3 schématronom. Najčastejšie chyby sú chýbajúce povinné polia, nesprávne kódy (napríklad mena alebo typ DPH) a nekonzistentné sumy.

Problémy s discovery

Symptóm: Váš AP nenájde testovacieho príjemcu v SML/SMP.

Riešenie: Overte, že váš AP je nakonfigurovaný na testovacie SML prostredie (nie produkčné). Skontrolujte, či je testovací príjemca zaregistrovaný v testovacom SMP a či DNS resolving funguje správne.

Koľko času testovanie zaberie

Časová náročnosť testovania závisí od pripravenosti vášho riešenia. Orientačne:

• Príprava prostredia a certifikátov: 1 – 2 týždne (závisí od rýchlosti vydania testovacieho certifikátu)
• Prvé testovanie a ladenie: 2 – 4 týždne (pri skúsenom tíme menej)
• Záverečné testy a report: 1 – 2 dni

Celkovo treba počítať s 1 až 2 mesiacmi od momentu, keď máte funkčný Access Point, po získanie Testbed reportu. Preto odporúčame začať s testovaním čo najskôr a nenechávať ho na poslednú chvíľu.