Evidencia cudzincov - portál Príručka používateľa verzia 2.0.0
-1/25-
Obsah Úvod ............................................................................ 3
1.
Definície a skratky ............................................................. 3
1.1.
Požiadavky pred spustením elektronických služieb Evidencie cudzincov .................................................. 4
2.
Hardvérové požiadavky ..................................................... 4 Softvérové požiadavky ...................................................... 4 Podporované prehliadače ................................................. 4
2.1. 2.2. 2.3.
Všeobecná administrácia .......................................... 5
3.
Spustenie portálu .............................................................. 5 Prihlásenie sa do Evidencie cudzincov ........................... 5 Úvodná stránka Evidencie cudzincov .............................. 6 Odhlásenie z elektronických služieb ................................ 6
3.1. 3.2. 3.3. 3.4.
4.
Podpis dokumentu ..................................................... 7
5.
Elektronická schránka ............................................. 11
6.
Zápis do knihy ubytovaných ................................... 13 Manuálny zápis cudzinca do knihy ubytovaných .......... 13 Import knihy ubytovaných zo súboru ............................ 16
6.1. 6.2. 6.2.1. 6.2.2.
Vstupné XML ......................................................................................... 17 Náhľad vstupného XML súboru ........................................................... 18
7.
Výmaz z knihy ubytovaných .................................... 21
8.
Chybové stavy .......................................................... 22 8.1. 8.2. 8.3.
Neúspešný import .xml ................................................... 22 Nedostupná elektronická služba .................................... 24 Podpisovanie bolo zrušené............................................. 24
-2/25-
1. Úvod Predkladaný dokument obsahuje popis činností práce osôb z ubytovacieho zariadenia, ktoré evidujú krátkodobý pobyt cudzincov na území Slovenskej republiky.
1.1. Definície a skratky V tejto kapitole je uvedený popis skratiek používaných v rámci predkladaného dokumentu. Skratka
Popis
BOK
Osobné identifikačné číslo pre vytvorenie zaručeného elektronického podpisu
DD.MM.YYYY HH:MM
DD – deň, MM – mesiac, YYYY – rok, HH – hodina, MM - minúta
EPO
Evidencia právnických osôb
FO
Fyzická osoba
IS
Informačný systém
ODI BA
Okresný dopravný inšpektorát Bratislava
PO
Právnická osoba
RFO
Register fyzických osôb
ZEP
Zaručený elektronický podpis
ZEP PIN
Osobné identifikačné číslo pre vytvorenie zaručeného elektronického podpisu
WS
Webservis
-3/25-
2. Požiadavky pred spustením elektronických služieb Evidencie cudzincov 2.1. Hardvérové požiadavky
Počítač s pripojením na internet Čítačka čipových kariet s nainštalovaným ovládačom
2.2. Softvérové požiadavky
Pre spustenie elektronických služieb v sekcii Evidencia cudzincov je potrebný v internetový prehliadač V elektronických službách, kde sa vyžaduje použitie zaručeného elektronického podpisu (ZEP) je potrebné nainštalovať aplikáciu D.Signer/XAdES a DViewer
2.3. Podporované prehliadače Prehliadače, ktoré umožnia prístup k informáciám poskytované portálom. Internet Explorer 7.0+ Mozzila Firefox 3.6.+ Opera 10+ Google Chrome 8+
-4/25-
3. Všeobecná administrácia Informácie uvedené v tejto časti sú určené všetkým požívateľom elektronických služieb Evidencia cudzincov. Kapitola vysvetľuje základné princípy a ovládacie prvky aplikácie. Predpokladá sa znalosť práce: s prehliadačom internetu, so základnými štandardnými ovládacími prvkami používanými v programoch bežiacich pod systémom MS Windows.
3.1. Spustenie portálu 1. Používateľ zadá do internetového prehliadača platnú adresu https://portal.minv.sk/ pre prístup k elektronickým službám Evidencia cudzincov. 2. Používateľ z menu Evidencia cudzincov spustí elektronickú službu, prostredníctvom, ktorej chce realizovať požadovaný úkon.
3.2. Prihlásenie sa do Evidencie cudzincov Služby budú aktívne na zadávanie až keď bude používateľ prihlásený do systému. Vpravo hore je potrebné stlačiť linku Prihlásiť sa a vyplniť prihlasovací formulár, prihlasovacie údaje ID používateľa a Heslo a potvrdiť tlačidlom Prihlásenie.
Obrázok č. 1 Prihlasovací formulár
Po zadaní nesprávneho mena a hesla systém oznámi chybovým hlásením: Prihlásenie zlyhalo. Zadajte platné ID užívateľa a heslo.
-5/25-
3.3. Úvodná stránka Evidencie cudzincov Zadaním správneho ID používateľa a hesla sa prihlásite sa dostanete sa na úvodnú stránku prostredia. Po úspešnom prihlásení systém zobrazí na ľavej strane v menu dve služby. Na pravej strane sa zobrazuje už formulár na zadávanie zvolenej elektronickej služby. Zápis do knihy ubytovaných Výmaz z knihy ubytovaných
Obrázok č. 2 Úvodná stránka Elektronické služby – Evidencia cudzincov
Vpravo hore je linka na bezpečné odhlásenie používateľa. Odhlásiť sa V spodnej časti je prístup k technickému prevádzkovateľovi: Odbor prevádzky informačných systémov, kam môžete nahlásiť prípadné problémy so službami. Správca obsahu: Ministerstvo vnútra SR, email
3.4. Odhlásenie z elektronických služieb Na korektné ohlásenie z prostredia stlačte linku Odhlásiť sa vpravo hore. Pre opakované prihlásenie stlačte linku Prihlásiť sa a zadajte korektné ID používateľa a heslo.
-6/25-
4. Podpis dokumentu Používateľ vloží eID doklad do čítačky čipových kariet správnou stranou t.j. s čipom umiestneným na prednej strane dokladu a smerom hore, aby sa čip dotýkal snímacieho zariadenia. Systém vyčíta údaje z dokladu a zobrazí sa okno na zadanie prístupového (BOK) kódu. Nasleduje vyplnenie formulára služby. Po vyplnený formulára služby sa zobrazí obrazovka podpisovača s dátami, ktoré zadal. Používateľ si skontroluje údaje a stlačí tlačidlo Podpísať.
Systém zobrazí obrazovku Výber certifikátu, kde si používateľ vyberie kvalifikovaný certifikát (ACA) zo zoznamu a stlačí tlačidlo OK.
-7/25-
Systém zobrazí obrazovku Vytvorenie ZEP, kde používateľ zadá svoj ZEP PIN pre vytvorenie zaručeného elektronického podpisu a stlačí tlačidlo OK.
-8/25-
Systém zobrazí obrazovku podpisovača v stave Dokument bol podpísaný.
Používateľ stlačí tlačidlo OK. Používateľovi sa zobrazí obrazovka s oznamom Žiadosť bola úspešne odoslaná.
-9/25-
-10/25-
5. Elektronická schránka
-11/25-
<processResponse xmlns="http://www.egov.sk/mvsr/ECU/datatypes/Zapis/Ext/ImportKPInOutSoZepUI.1.0.x sd">
<Meno>Fedor Testovač1972-1212<StatnaPrislusnostText>UkrajinaCD589Test<ECU WSCommonKratkodobyPobyt>2015-03-012015-03318Liečebný pobyt30242 d313230361CV471T est<MiestoUdeleniaViza>MV471Test Krátkodobé víza C<MiestoPobytu>Miesto Pobytu<StatText>Ukrajina<Spo lucestujuceDieta><Meno>EwaTestovacia2005-051330252d3132 3036-11<StatnaPrislusnostText>Ukrajina Obr. príklad xml súboru importovanej osoby
-12/25-
6. Zápis do knihy ubytovaných Služba Zápis do knihy ubytovaných umožňuje vybratým osobám z príslušného ubytovacieho zariadenia zapísanie cudzincov na krátkodobý pobyt. Zápis je možné vykonať manuálne alebo importom z xml. súboru.
6.1. Manuálny zápis cudzinca do knihy ubytovaných Elektronická služba slúži na manuálne zapísanie cudzincov a ich spolucestujúce deti v ubytovacích zariadeniach na území SR. 1) Používateľ zvolí v menu Manuálny zápis cudzinca do knihy ubytovaných a potvrdí tlačidlom Pokračovať.
2) Používateľ vyberie hotel zo zoznamu hotelov a potvrdí tlačidlom Pokračovať.
3) Používateľ vyplní údaje o cudzincovi:
-13/25-
1)
-14/25-
Povinné položky sú označené hviezdičkou *. Musí byť vyplnený práve jeden údaj "Účel cesty" alebo "Účel cesty - voľným textom". Ak ide o cudzinca, ktorého štátna príslušnosť patrí do krajín bezvízovej dohody, tak sa sekcia „Vízum/Doklad povolenia na pobyt“ nezobrazí. 4) Po vyplnení všetkých povinných údajov, používateľ stlačí tlačidlo Pridať. 5) Používateľovi sa zobrazí obrazovka so základnými údajmi cudzinca.
-15/25-
6) Ak používateľ klikne na prázdny štvorček vedľa mena cudzina zobrazia sa mu možnosti Upraviť a Odobrať.
7) Používateľ môže záznam o cudzincovi zmeniť stlačením tlačidla Upraviť. 8) Používateľ môže záznam o cudzincovi úplne odobrať stlačením Odobrať. 9) Používateľ môže pridať nového cudzinca stlačením tlačidla Ďalší cudzinec. 10) Používateľ sa môže vrátiť na úvodnú obrazovku Výber hotela/ubytovacieho zariadenia, stlačením tlačidla << Späť. 11) Používateľ pre pokračovanie a odoslanie údajov stlačí tlačidlo Odoslať >> a podpíše dokument podľa kapitoly (Podpis dokumentu).
6.2. Import knihy ubytovaných zo súboru Elektronická služba slúži na importovanie knihy ubytovaných cudzincov v ubytovacích zariadeniach na území SR.
-16/25-
2)
1) Používateľ zvolí v menu Import knihy ubytovaných zo súboru a potvrdí tlačidlom Pokračovať.
2) Používateľ vyberie súbor a potvrdí tlačidlom Odoslať.
3) Používateľ pre pokračovanie a odoslanie údajov stlačí tlačidlo Odoslať >> a podpíše dokument podľa kapitoly (Podpis dokumentu).
6.2.1.
Vstupné XML
Vstupný XML súbor musí byť kódovaný v UTF-8. V podkapitole je vysvetlený význam jednotlivých parametrov.
<EZ>údaje o zapisovateľovi pobytu proces ID dátum pobytu od dátum pobytu do účel pobytu identifikátor zariadenia
- krátkodobý pobyt
- krátkodobá osoba <EI>externý identifikátor cudzinca -17/25-
<STASNAR>štát narodenia dátum narodenia <MR>miesto narodenia priezvisko <ME>meno <STASPAR>štátna príslušnosť - pobyt v domovskom štáte <MP>miesto pobytu <STASIAR>štát pobytu - doklady/víza číslo cestovného dokladu číslo víz <MU>miesto udelenia víza typ víza - spolucestujúce deti <EI>externý identifikátor cudzinca <ME>meno priezvisko dátum narodenia <STASPAR>štátna príslušnosť
6.2.2.
Náhľad vstupného XML súboru
Náhľad vstupného XML súboru obsahuje cudzinca s vízovou povinnosťou a so spolucestujúcim dieťaťom. Ak bude používateľ vytvárať cudzinca bez vízovej povinnosti, tak nevyplní parametre CV, MU a TVITVEK v sekcii víz. Ak bude používateľ vytvárať cudzinca s vízovou povinnosťou, tak musí vyplniť parametre CV, MU a TVITVEK v sekcii víz. Pri zadaní viacerých cudzincoch sa skopíruje od
po a vloží sa pod . Pri zadaní viacerých spolucestujúcich detí sa skopíruje od
po a vloží sa pod .
-18/25-
Ak cudzinec bude bez spolucestujúcich detí, tak sa časť od
po vymaže. AK bude chcieť používateľ zadať taký účel pobytu, ktorý nie je v číselníku, tak musí nahradiť parameter
parametrom a napísať doň účel pobytu textom. účel pobytu text <EZ>GENERATOR 12345 2016-01-01 2016-01-01 85 1 <EI>EID123 <STASNAR>UKR 1980-01-01 <MR>Kyjev Jano <ME>Jano <STASPAR>UKR <MP>Kyjev <STASIAR>UKR D123 V123 <MU>Kyjev DoPP <EI>EID123_1 <ME>Jano Jano 2010-01-01 <STASPAR>UKR
-19/25-
Za účelom správneho vyplnenia údajov v xml súbore uvádzame tabuľku účelov pobytov a typov víz. Tabuľka č.1 Kód pobytu (parameter )
Účel pobytu
84
Liečebný pobyt
85
Obchodný pobyt
86
Kultúrny pobyt
87
Pobyt v rodine
88
Pozvanie
89
Oficiálne, politické dôvody
90
Profesionálny pobyt
91
Športová súťaž
92
Školenie
93
Turistika a tranzit
94
Tranzit
95
Pracovné dôvody
96
Iný pracovný dôvod
97
Ostatné
Tabuľka č.2 Kód víza
Názov víza
Externý kód víza (parameter )
11
Letiskové tranzitné vízum (A vízum)
AV
12
Jednotné vízum (C vízum)
CV
13
Vízum s obmedzenou platnosťou LTV vízum)
14
Národné dlhodobé vízum (D vízum)
DV
15
Doklad o pobyte (Povalenie na pobyt)
DoPP
16
Cestovný doklad
CD
územnou LTV
-20/25-
7. Výmaz z knihy ubytovaných Elektronická služba slúži na vymazanie cudzincov a ich spolucestujúce deti v ubytovacích zariadeniach na území SR. 3)
1) Používateľ vyplní povinné údaje.
2) Používateľ pre pokračovanie a odoslanie údajov stlačí tlačidlo Odoslať >> a podpíše dokument podľa kapitoly (Podpis dokumentu).
-21/25-
8. Chybové stavy 8.1. Neúspešný import .xml
Obr. Keď vstupné XML nie je kódované v UTF-8.
Obr. Ukážka chyby vstupného XML
-22/25-
Obr. Ukážka chyby vstupného XML.
Obr. Ukážka neočakávanej chyby schránky
Obr. Ukážka neočakávanej chyby D.Signer/XAdWS
-23/25-
Obr. Ukážka neočakávanej chyby D.Signer/XAdWS na portáli
8.2. Nedostupná elektronická služba
8.3. Podpisovanie bolo zrušené
-24/25-
-25/25-
