Spustenie nových G2G validácií vo FIX prostredí (druhá etapa)
Vážení integrační partneri,
dovoľujeme si vás informovať, že v súlade s integračným manuálom modulu G2G a release plánom NASES v testovacom prostredí ÚPVS pripravil druhú fázu nových vstupných validácií pri prijímaní správ do ÚPVS.
Nové validácie uvedené nižšie sú spustené v testovacom FIX prostredí ÚPVS od 14.12.2023.
Ich spustenie v produkčnom prostredí ÚPVS sa predpokladá v 2. kvartáli 2024.
Zároveň si vás dovoľujeme informovať aj o posune nasadenia prvej fázy validácií uvedených v ozname z augusta 2023 v produkčnom prostredí ÚPVS z novembra 2023 na február 2024. V testovacom prostredí boli tieto validácie spustené v súlade s oznamom v auguste a septembri 2023.
Informácie o plánovanom spustení týchto validácií sú zverejnené od októbra 2021 v Release pláne nasadzovaných zmien a taktiež sú uvedené v integračnom manuáli G2G zverejnenom na Partner framework portáli.
V prípade nevyhovenia validáciám sa budú v prípade synchrónnych validácií pri volaní služby UIR vracať chybové kódy. V prípade asynchrónnych validácií bude zaslaná chybová správa s popisom danej chyby. Vysvetlenie jednotlivých chybových hlášok nájdete v zozname chybových kódov na Partner framework portáli.
Zoznam nových validácií spúšťaných vo FIX prostredí v decembri 2023:
Validácia štruktúry hlavného formulára podania / rozhodnutia / notifikácie / technickej správy v objekte s class="FORM" - asynchrónne validácie spustené vo FIX prostredí 14.12.2023
- formulár musí byť zaregistrovaný v MEF,
- štruktúra musí byť valídna voči XSD elektronického formulára (aktuálne nastavená kontrola pre EGOV_APPLICATION, v budúcnosti sa predpokladá aj pre ďalšie Sk-Talk Class),
- validácia súladu použitého formulára určeného pre danú Sk-Talk triedu (čiastočne synchrónna validácia, ak sa jedná o štruktúru priamo v Body elemente, teda nie v MessageContaineri) - zoznam povolených formulárov pre jednotlivé Sk-Talk Class je zverejnený v dokumentácii Schémy správ Sk-Talk (Sk-Talk3 Zoznam Class).
- formulár musí byť účinný (platný) - to znamená, že nesmie mať ukončený dátum platnosti a účinnosti (poznámka: validácia vyžadujúca účinnosť formulára bude vo FIX prostredí spustená v januári 2024 vzhľadom na prebiehajúce testovania)
Príklady chybových kódov asynchrónnych validácií, ktoré sa po spustení validácií môžu zaslať vo forme správy triedy ERROR:
- 03501006 - Chyba obsahu správy - nevalidné XML formulára v hlavnom objekte
- 03501007 - Chyba obsahu správy - formulár nespĺňa požadované náležitosti
Obsah "body" časti Sk-Talk sa môže skladať len z definovaných štruktúr – synchrónna validácia v súlade s integračnými manuálmi modulov UPVS - spustené vo FIX prostredí 14.12.2023:
- MessageContainer,
- elektronický formulár,
- alebo štruktúra eflcm (v prípade správ zasielaných do modulu MEF),
- zároveň v správe môže byť MetadataContainer (v súčasnosti v prípade EGOV_DOCUMENT, EGOV_APPLICATION, EGOV_NOTIFICATION)
Validácia prípustných hodnôt Class v elementoch Object MessageContainer -a špecificky pre EGOV_APPLICATION a EGOV_DOCUMENT – synchrónna validácia - konkrétne povolené hodnoty Object Class pre jednotlivé Sk-Talk Class v súlade s integračnými manuálmi modulov UPVS – spustené vo FIX prostredí 14.12.2023
(Poznámka: jedná sa o detailizáciu validácie spustenej už v auguste 2023)
Aktuálne nastavenie:
- EGOV_APPLICATION má povolené FORM, ATTACHMENT, PAYMENT_ORDER, FORWARD,
- EGOV_DOCUMENT má povolené FORM, ATTACHMENT, PAYMENT_ORDER, PAYMENT_ORDER_UPDATE
Príklady chybových kódov synchrónnych validácií, ktoré sa môžu vrátiť pri volaní UIR Receive po spustení validácií:
- 03100151 - Neúspešná validácia existencie prípustného obsahu v elemente Body v SkTalk.
Sumár prvej fázy nových validácií nasadených vo FIX prostredí od augusta 2023 v zmysle oznamu z augusta 2023, ktorých spustenie v produkčnom prostredí sa predpokladá vo februári 2024
- Validácia spracovateľnosti podpísaného objektu v hlavnom objekte správy - na ÚPVS nie sú prijímané správy, v ktorých hlavný objekt s class="FORM" obsahuje 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, - spustené vo FIX prostredí v auguste 2023
- Kontrola uvedenia práve jedného odosielateľa a adresáta elektronickej správy a jeho existencie v IAM UPVS - spustené vo FIX prostredí v auguste 2023:
- 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, 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, - spustené vo FIX prostredí v auguste 2023
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, - spustené vo FIX prostredí v auguste 2023
- 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, - spustené vo FIX prostredí v auguste 2023
- Kontrola, že v MessageContainer sú iba prípustné hodnoty Object Class podľa zoznamu zverejneného na ÚPVS, - spustené vo FIX prostredí v auguste 2023
- 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, - spustené vo FIX prostredí v auguste 2023
- 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, - spustené vo FIX prostredí v auguste 2023
- Kontrola validity (platnosti) definovaných MetadataItems voči XSD a ich prípustná početnosť výskytov, - spustené vo FIX prostredí v auguste 2023.
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].
Validácia bola doplnená o ďalšie MetadataItem v 4. kvartáli 2023 v súlade so zverejnenou dokumentáciou MetadataContainer a MetadataItem na stránke s technickými informáciami o ÚPVS.
- Validácia zhody SenderId a SubjectId - týka sa správ EGOV_APPLICATION - spustené vo FIX prostredí 14. septembra 2023.