web aplikacija za dostavu fatca xml datoteke aplikacija za... · propisani format naziva je...

APIS IT d.o.o. Upute za rad s WEB aplikacijom

FATCA- DOSTAVA XML DATOTEKE

Aplikacija: FATCA Verzija: 1.4 Datum: 03.05.2017.

ISPU – Informacijski sustav Porezne uprave

WEB aplikacija za dostavu FATCA XML datoteke

KORISNIČKE UPUTE

Verzija 1.4




Sadržaj 1. SVRHA DOKUMENTA ................................................................................................... 4

2. UVODNE NAPOMENE ................................................................................................... 4

3. FUNKCIONALNOSTI WEB APLIKACIJE ........................................................................... 4

4. KORIŠTENJE WEB APLIKACIJE ..................................................................................... 5

4.1 TEHNIČKI PREDUVJETI ............................................................................................ 5

4.2 PRIJAVA KORISNIKA ............................................................................................... 5

4.3 ODABIR ŽELJENE FUNKCIONALNOSTI ........................................................................ 8

4.4 DOSTAVA FATCA XML DATOTEKE .............................................................................. 9

4.5 PREGLED DOSTAVLJENIH PODATAKA ....................................................................... 12

4.6 PREGLED DETALJA DOSTAVLJENE FATCA XML DATOTEKE I PREUZIMANJE NOTIFIKACIJA13

4.7 ODJAVA IZ APLIKACIJE ........................................................................................... 15

5. PODRŠKA U RADU ..................................................................................................... 16

MINISTARSTVO FINANCIJA – POREZNA UPRAVA 2




Povijest promjena Verzija Datum Sažetak Autor 1.0 28.04.2015. Inicijalna verzija APIS IT d.o.o. 1.1 29.05.2015. Ispravljen link za pristup aplikaciji u testnoj okolini. APIS IT d.o.o. 1.2 26.02.2016. Dodani ekrani za FI- pregled i preuzimanje notifikacija APIS IT d.o.o. 1.3 14.04.2017. Dodan link za pristup aplikaciji u produkcijskoj okolini APIS IT d.o.o. 1.4 03.05.2017. Dodani tehnički preduvjeti za rad s aplikacijom

(poglavlje 4.1) APIS IT d.o.o.





1. Svrha dokumenta Ove upute namijenjene su financijskim institucijama (korisnicima) za potrebe lakšeg snalaženja i korištenja WEB aplikacije izrađene u svrhu dostave FATCA XML datoteka odnosno izvještaja u Poreznu upravu, te uvide u rezultate dostave istih. 2. Uvodne napomene Pomoću WEB aplikacije svim će financijskim institucijama biti omogućena dostava FATCA XML datoteka te uvid u rezultate i preuzimanje notifikacija za dostavljene FATCA XML datoteke (izvještaje). Za potrebe spajanja na WEB aplikaciju, svaka financijska institucija prethodno mora dostaviti Poreznoj upravi Obrazac punomoć kojim ovlašćuje svog zaposlenika/e za rad s WEB aplikacijom. Na temelju zaprimljenog Obrasca punomoć financijskoj instituciji dodijeliti će se korisničko ime i inicijalna lozinka potrebna za rad s WEB aplikacijom. Korisničko ime je kreirano kombinacijom prvog slova imena + prezime (+broj - po potrebi). O dodijeljenim korisničkim imenima i inicijalnim lozinkama financijske institucije su pravovremeno obaviještene. Rad s WEB aplikacijom omogućen je u radne dane, od ponedjeljka do subote, u razdoblju od 7:00 do 22:00 sata. 3. Funkcionalnosti WEB aplikacije Ovlašteni zaposlenik financijske institucije putem WEB aplikacije može obavljati sljedeće aktivnosti:

dostava FATCA XML datoteka

pregled dostavljenih podataka

pregled notifikacija za dostavljene FATCA XML datoteke

preuzimanje pripadajućih uputa





4. Korištenje WEB aplikacije 4.1 Tehnički preduvjeti Za razmjenu podataka između korisnika sustava i Porezne uprave moraju biti zadovoljeni sljedeći mrežni preduvjeti: Vrsta mreže Internet

Potrebni otvoreni TCP portovi Test: 443 Produkcija: 448

Sva komunikacija s poslužiteljem Porezne uprave je zaštićena jednosmjernom TLS autentikacijom, u slučaju produkcijske okoline X.509 poslužiteljskim certifikatom ovjerenim od strane internacionalnog potpisnika VeriSign/Symantec (vlasnik certifikata je APIS IT d.o.o.).

Zaštita na transportnom sloju HTTPS - obavezno korištenje TLS kriptografskog protokola (podržane su sve inačice) uz ECDHE (EECDH) protokol za razmjenu ključeva

Podržani preglednici su IE 8+, Chrome 36+, Mozilla Firefox 31+.

4.2 Prijava korisnika Aplikacija je dostupna u dvije posve odvojene okoline: testna i produkcijska. Testna okolina služi isključivo za testiranje i svi podaci poslani u toj okolini smatraju se testnima. Korisnik mora obratiti pažnju koristi li aplikaciju u testnoj ili produkcijskoj okolini. Aplikacija će u testnom okruženju imati napomenu da je riječ o testu. Aplikaciji se pristupa preko sljedeće URL adrese u testnoj okolini: https://www1-test.apis-it.hr/fatcaWeb/home Aplikaciji se pristupa preko sljedeće URL adrese u produkcijskoj okolini: https://www3.apis-it.hr:448/fatcaWeb/home


https://www1-test.apis-it.hr/fatcaWeb/home

https://www3.apis-it.hr:448/fatcaWeb/home




Na sučelju za prijavu korisnika, korisnik aplikacije treba pravilno upisati svoje podatke (korisničko ime i lozinku) te odabrati akciju Prijava:

Nakon prve prijave na sustav, potrebno je promijeniti inicijalnu lozinku.





Potrebno je u odgovarajuća polja upisati staru lozinku te dva puta novu i odabrati akciju Promjena. Pravila za kreiranje lozinke: dužina lozinke: minimalno 8 znakova, maksimalno 15 znakova

lozinka mora sadržavati minimalno 4 (od kojih su barem 3 različita) znaka abecede (a-z, A-Z; nisu dozvoljeni naši znakovi), te barem 1 znak koji nije slovo (brojke 0-9; posebni znakovi: `~!@#$%^&*()_+-={}|[]\:";'<>?,./ )

u lozinki nije dozvoljeno koristi prazna mjesta (blank-ove)

u lozinki nije dozvoljeno ponavljati više od 2 ista znaka jedan za drugim

lozinka traje 90 dana od njene promjene nakon čega je istu potrebno promijeniti

vrijeme trajanja korisničkog računa je neograničeno

broj pokušaja prijave s pogrešnom zaporkom prije privremenog zaključavanja korisničkog računa je 5

trajanje privremenog zaključavanja korisničkog računa je 30 minuta





4.3 Odabir željene funkcionalnosti Nakon uspješne prijave u aplikaciju prikazuje se početno sučelje aplikacije s mogućnosti odabira željene funkcionalnosti:

Dostava FATCA XML datoteke

Pregled dostavljenih podataka

Opće upute

Korisnik odabire željenu funkcionalnost klikom na odabrani link.





4.4 Dostava FATCA XML datoteke Za dostavu FATCA XML datoteka, na pripadajućoj stranici aplikacije putem akcije Choose File odabrati FATCA XML datoteku koja mora biti u ZIP formatu:

NAPOMENE:

Naziv datoteke je propisan. Propisani format naziva je GIIN_gggg_redni broj u godini.zip, gdje je:

GIIN –> GIIN institucije za koju se dostavljaju podaci tj. kojoj pripada prijavljeni korisnik. gggg –> Godina na koju se odnose podaci u FATCA XML datoteci. Dozvoljeni raspon je od 2014.

godine do tekuće godine (uključujući tekuću). redni broj u godini –> Redni broj datoteke za određenu godinu. Redni broj kreće od 1 za svaku

godinu. .zip –> Dozvoljena ekstenzija datoteke.

Datoteka mora biti komprimirana ZIP metodom. Zaprimljena ZIP datoteka mora sadržavati jednu i samo jednu datoteku u XML formatu. Naziv XML datoteke je propisan. Propisani format naziva je GIIN_gggg_redni broj u godini.xml, gdje je:

GIIN –> GIIN institucije za koju se dostavljaju podaci tj. kojoj pripada prijavljeni korisnik. gggg –> Godina na koju se odnose podaci u FATCA XML datoteci. Dozvoljeni raspon je od 2014.

godine do tekuće godine (uključujući tekuću). redni broj u godini –> Redni broj datoteke za određenu godinu. Redni broj kreće od 1 za svaku

godinu. .xml –> Dozvoljena ekstenzija datoteke.

Primjer naziva ZIP datoteke koja se dostavlja:





Primjer naziva FATCA XML datoteke koja se dostavlja u ZIP datoteci:

Odabirom akcije Pošalji započinje slanje odabrane datoteke. Nakon što je datoteka uspješno spremljena, korisnik dobiva odgovarajuću poruku:

U slučaju da neko od poslovnih pravila nije zadovoljeno, sustav odgovarajućom porukom obavještava korisnika: a) Naziv datoteke već postoji u bazi ili nije zadovoljeno pravilo za redni broj datoteke:

Redni broj datoteke nije ispravan. b) Datoteka nije u ZIP formatu:

Neispravna ili korumpirana ZIP datoteka. c) Godina u nazivu datoteke nije ispravna (manja od 2014. ili veća od tekuće godine):

Godina u nazivu datoteke nije ispravna. d) Korisnik nije odabrao datoteku za slanje:

Datoteka nije odabrana. MINISTARSTVO FINANCIJA – POREZNA UPRAVA 10




e) Datoteku nije moguće raspakirati:

Neispravna ili korumpirana ZIP datoteka.

f) Datoteka nema ispravan naziv tj. nisu zadovoljena gore navedena pravila: Naziv ZIP datoteke nije ispravan.

g) Datoteka nije u XML formatu:

Naziv XML datoteke nije ispravan. h) Unutar ZIP arhive nalazi se više od jedne XML datoteke:

Unutar ZIP arhive smije biti samo jedna datoteka. i) XML datoteka nije u skladu sa XML shemom:

XML datoteka nije validna.

j) GIIN ne odgovara financijskoj instituciji za prijavljenog korisnika: GIIN iz naziva datoteke nije ispravan.





4.5 Pregled dostavljenih podataka Pregled dostavljenih podataka moguć je odabirom željene funkcionalnosti klikom na link „Pregled dostavljenih podataka“ na početnoj stranici.

Omogućen je uvid u listu svih uspješno poslanih FATCA XML datoteka financijske institucije.





4.6 Pregled detalja dostavljene FATCA XML datoteke i preuzimanje notifikacija Odabirom linka „Detalji“ na ekranu za pregled dostavljenih podataka, omogućen je detaljni pregled za svaku pojedinu dostavljenu FATCA XML datoteku.

Na ekranu za detaljni pregled omogućeno je preuzimanje dostavljene FATCA XML datoteke odabirom linka „Naziv datoteke“.

Osim ponovnog preuzimanja FATCA XML datoteke, omogućeno je i preuzimanje notifikacije za dostavljenu datoteku odabirom linka „Preuzmi“.





Za slučaj kada za dostavljenu FATCA XML datoteku nije dostavljena notifikacija, sustav odgovarajućom porukom obavještava korisnika.





4.7 Odjava iz aplikacije Nakon završetka upotrebe aplikacije korisnik se treba odjaviti u aplikaciji odabirom akcije Odjava koja se nalazi u donjem središnom dijelu svakog ekrana aplikacije.

Napomena: Pravilnim korištenjem funkcionalnosti „Odjava“ sprečavate mogućnost eventualne zloupotrebe Vaših korisničkih podataka.





5. Podrška u radu

U slučaju tehničkih problema i korištenja WEB aplikacije korisnici se mogu obratiti na email adresu [email protected]


mailto:[email protected]

web aplikacija za dostavu fatca xml datoteke aplikacija za... · propisani format naziva je...

Documents