Spustenie nových G2G validácií a napĺňanie potvrdení o odoslaní
Vážení integrační partneri,
dovoľujeme si vás informovať, že NASES dňa 17. augusta 2023 spustí nové synchrónne a asynchrónne vstupné validácie na UIR rozhraní v testovacom prostredí ÚPVS v súlade s informáciami dlhodobo uvedenými v integračnom manuáli G2G a release pláne.
Validácie budú po vyhodnotení následne postupne spustené v produkčnom prostredí od novembra 2023.
Zároveň si vás dovoľujeme informovať o spustení vypĺňania pôvodne nevypĺňaných atribútov v technickej správe potvrdenia o odoslaní podania.
V nasledujúcom texte uvádzame zoznam najvýznamnejších kontrol, ktoré môžu ovplyvniť komunikáciu integrovaných subjektov a ich pripojených informačných systémov od 17. augusta 2023:
- validácia spracovateľnosti podpísaného objektu v hlavnom objekte správy - Po nasadení validácie nebudú na ÚPVS prijímané správy, v ktorých hlavný objekt s class="FORM" bude obsahovať podpísaný objekt, ktorý nie je možné v centrálnej elektronickej podateľni otvoriť a získať podpísané dokumenty (službou CEP VrateniePodpisanychDat2) – týka sa všetkých Sk-Talk Class,
- kontrola uvedenia práve jedného odosielateľa a adresáta elektronickej správy a jeho existencie v IAM UPVS:
- v prípade správ s MessageContainer musí byť adresát uvedený v elemente „RecipientId“ a odosielateľ v „SenderId“ – týka sa správ EGOV_DOCUMENT, EGOV_APPLICATION, EGOV_NOTIFICATION, ED_DELIVERY_REPORT, ERROR,
- v prípade správ, ktoré neobsahujú MessageContainer, v sa adresát uvádza v elemente ChannelInfo a odosielateľ v ChannelInfoReply – týka sa správ ERROR, INFORMATION
(pozn.1.: pre správy v MessageContainer už časť týchto validácií je používaná dlhodobo),
- v ChannelInfo nesmie byť uvedených viacero položiek pre adresáta a v ChannelInfoReply nesmie byť uvedených viacero položiek pre odosielateľa – týka sa správ INFORMATION a ERROR bez MessageContainer, pri správach obsahujúcich MessageContainer sa už kontroluje dlhodobo,
- pozn.: upozorňujeme, že pre správy SKTalk v.3.0, obsahujúce MessageContainer by nemali byť súčasťou hlavičky SKTalk elementy „ChannelInfo“ a „ChannelInfoReply“, v prípade zhody hodnôt s údajmi v MessageContainer však správa validáciami prejde,
- kontrola existencie elektronického formulára uvedeného v PospId a PospVersion -týka sa správ EGOV_DOCUMENT a EGOV_APPLICATION, v neskoršom termíne budú validované aj ďalšie triedy správ,
- kontrola maximálne jedného výskytu elementu Object s atribútom Class=FORM v MessageContainer – týka sa všetkých Sk-Talk Class,
- kontrola, že všetky objekty v MessageContainer obsahujú objekty kódované v súlade s hodnotou v atribúte Encoding (napr. v prípade kódovania Base64 musí byť objekt dekódovateľný, v prípade kódovania XML musí obsahovať práve jeden koreňový element a musí sa jednať o dobre formované XML) – týka sa všetkých Sk-Talk Class,
- kontrola, že v MessageContainer sú iba prípustné hodnoty Object Class podľa zoznamu zverejneného na ÚPVS,
- kontrola tvaru UPVS URI identifikátora uvedeného v SenderId, RecipientId, ChannelInfo a ChannelInfoReply – hodnota musí byť UPVS URI (v tvare ako ho poskytujú napr. služby GetIdentity alebo GetEDeskInfo2) – týka sa správ EGOV_DOCUMENT, EGOV_APPLICATION, EGOV_NOTIFICATION, ED_DELIVERY_REPORT, ERROR, INFORMATION,
- kontrola validity (platnosti) definovaných MetadataItems voči XSD a ich prípustná početnosť výskytov, aktuálne:
EGOV_DOCUMENT: http://data.gov.sk/doc/eform/42156424.CUD_Postal_delivery_address.sk/1.0=[0..2],
EGOV_DOCUMENT a EGOV_APPLICATION http://schemas.gov.sk/core/Metadata/eform/posp/1.0=[0..1].
Voči iným MetadataItem sa kontrola nevykonáva. (zoznam MetadataItem je zverejnený v integračnom manuáli G2G prípadne na stránke s technickými informáciami o ÚPVS),
- validácia zhody SenderId a SubjectId - týka sa správ EGOV_APPLICATION - spustenie 14. septembra 2023.
Zároveň si vás dovoľujeme informovať, že od začiatku júna 2023 sa v správach POSTING_CONFIRMATION v XML štruktúre formulára potvrdenia o odoslaní uvádzajú informácie o názve odosielateľa (SenderName) a adresáta správy (RecipientName). V prípade právnických osôb bude zobrazené aj IČO (SenderBusinessID, RecipientBusinessID). Pôvodne boli tieto polia prázdne a preto sa nezobrazovali v správach. Pre identifikáciu osôb bol zobrazený iba URI identifikátor. Táto zmena zjednoduší čitateľnosť potvrdení o odoslaní podania pre koncového používateľa.
V tejto súvislosti boli aktualizovaný aj príslušný návod.