Top Banner
REPUBLIKA HRVATSKA Ministarstvo financija Porezna uprava Tehnička specifikacija sučelja za razmjenu poruka nadzora Internet casina TS1 Oznaka dokumenta: TS1 Verzija: 1.0 Datum: 27.03.2015.
43

Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

Sep 29, 2020

Download

Documents

dariahiddleston
Welcome message from author
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Page 1: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

REPUBLIKA HRVATSKA Ministarstvo financija Porezna uprava

Tehnička specifikacija sučelja za razmjenu poruka nadzora Internet casina

TS1

Oznaka dokumenta: TS1 Verzija: 1.0 Datum: 27.03.2015.

Page 2: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

Sadržaj

1 Uvodni dio ........................................................................................................................... 4

1.1 Svrha dokumenta ............................................................................................................ 4

1.2 Pravni okvir ..................................................................................................................... 4

1.3 Poslovni kontekst i cilj dokumenta ................................................................................... 4

1.4 Pojmovnik i imenik skraćenica ........................................................................................ 5

1.5 Normativne reference ...................................................................................................... 5

1.6 IT arhitektura sustava ...................................................................................................... 6

2 Financijski nadzor Internet casina ....................................................................................... 8

2.1 Administrativni nadzor Internet casina ........................................................................... 10

2.2 Izvještajni nadzor Internet casina .................................................................................. 12

3 Razmjena podataka .......................................................................................................... 13

3.1 Zaglavlje transakcija ..................................................................................................... 14

3.2 Transakcije nadzora ...................................................................................................... 15

3.3 Transakcije za administrativni nadzor Internet casina ................................................... 16 3.3.1 Aktivacija/promjena statusa/deaktivacija casina .................................................. 16 3.3.2 Aktivacija/promjena statusa/deaktivacija jackpota ............................................... 17 3.3.3 Aktivacija/promjena statusa/deaktivacija igre ...................................................... 19

3.4 Transakcije za izvještajni nadzor Internet casina ........................................................... 21 3.4.1 Izvještaj casina o igrama na automatima (slot) .................................................... 21 3.4.2 Izvještaj casina o igrama na stolovima (table) ..................................................... 23 3.4.3 Izvještaj casina o turniru (tournament) ................................................................. 26 3.4.4 Izvještaj po i-kontu priređivača (samo za Internet casino) ................................... 28 3.4.5 Konačni mjesečni obračun .................................................................................. 31

3.5 Odgovor servisa Ministarstva financija .......................................................................... 34 3.5.1 Šifarnik grešaka .................................................................................................. 35

3.6 Ispravak prethodno poslanih transakcija ....................................................................... 36 3.6.1 Ispravak ispravka ................................................................................................ 36 3.6.2 Poništavanje (brisanje) prethodno poslanih transakcija ....................................... 37 3.6.3 Poništavanje poništene transakcije ..................................................................... 38 3.6.4 Ispravak poništenja (brisanja) .............................................................................. 38

4 Sigurnost sustava nadzora ................................................................................................ 39

4.1 Integritet podataka ........................................................................................................ 39

4.2 Dostupnost .................................................................................................................... 39

4.3 Autentičnost .................................................................................................................. 39

4.4 Neporecivost ................................................................................................................. 39

5 Pregled tehnoloških preduvjeta spajanju na CIS Porezne uprave ...................................... 40

5.1 Produkcijska okolina ..................................................................................................... 40

5.2 Testna okolina............................................................................................................... 40

6 Podrška u radu .................................................................................................................. 41

TS1 v1.0 2/43

Page 3: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

7 Dodatak ............................................................................................................................. 42

8 Prilozi ................................................................................................................................ 43

TS1 v1.0 3/43

Page 4: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

1 Uvodni dio

1.1 Svrha dokumenta

Ovim dokumentom Ministarstvo Financija, Porezna uprava definira tehnološke preduvjete spajanja sustava priređivača Internet casina na svoj informacijski sustav radi uvida poreznog nadzora u administrativne i izvještajne transakcije priređivača Internet casina.

1.2 Pravni okvir

Dokument je dio cjelokupne dokumentacije kojom Porezna uprava ispunjava svoju obavezu iz članka 3. stavka 2. Pravilnika o priređivanju igara na sreću u casinima putem interaktivnih prodajnih kanala on-line igranja (NN 78/10), donesenog temeljem članka 35. stavka 2. Zakona o igrama na sreću (Narodne novine, br. 87/2009, 35/2013, 158/2013, 41/2014 i 143/2014).

Ovlaštenje Ministarstva financija za nadzor nad provedbom Zakona o igrama na sreću proizlazi neposredno iz članka 70. stavka 1. Zakona o igrama na sreću.

1.3 Poslovni kontekst i cilj dokumenta

Način kojim Ministarstvo financija, Porezna uprava nadzire sukladnost Internet casina sa zakonskim propisima opisan je kroz sljedeće dokumente:

• Upute za priređivače Internet casina - U1 • Upute za certificiranje sustava Internet casina - U2 • Upute za pripremu nadzora Internet casina - U3 • Upute za provođenje neposrednog nadzora Internet casina - U4 • Tehnička specifikacija sučelja za razmjenu poruka nadzora Internet casina - TS1 (ovaj

dokument) • Tehnička specifikacija provjere osobnih podataka

Cilj ovog dokumenta je definirati sučelje za razmjenu poruka između priređivača Internet casina i sustava za nadzor Internet casina Ministarstva financija (CIS).

TS1 v1.0 4/43

Page 5: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

1.4 Pojmovnik i imenik skraćenica

Oznake, skraćenice i pojmovi koji se koriste u ovom dokumentu imaju značenje definirano u Zakonu o igrama na sreću, Pravilniku o priređivanju igara na sreću u casinima putem interaktivnih kanala on-line igranja i Uputama za priređivače Internet casina.

Pojam Opis

Transakcija Riječ transakcija ima isto značenje kao i riječ „poruka“ (u kontekstu razmjene)

Izvještaj Predstavlja izvještajne poruke, odnosno izvještajne transakcije. Nema značenje standardnog izvještaja za korisnički uvid, već predstavlja skup izvještajnih podatka temeljem kojih se mogu izraditi korisnički izvještaji.

CIS Centralni informacijski sustav Porezne uprave Ministarstva financija

1.5 Normativne reference

Tablica sadrži pregled tehnologija koje se koriste prilikom razmjene poruka:

Naziv Opis / Obrazloženje Normativna referenca

SOAP Komunikacijski protokol baziran na XML-u. Sustav koristi verziju 1.1

http://www.w3.org/TR/2000/NOTE-SOAP-20000508/

HTTP Odabrani aplikativni protokol. Verzija 1.1

http://tools.ietf.org/html/rfc7233

SSL Minimalna verzija v3, min AES_256 enkripcija; uspostavlja se obostranim rukovanjem.

http://tools.ietf.org/html/rfc6101

TLS Dozvoljene verzije: 1.0, 1.1, 1.2 http://tools.ietf.org/html/rfc2246

http://tools.ietf.org/html/rfc4346

http://tools.ietf.org/html/rfc5246

WSDL Dokument se može preuzeti na adresi:

Verzija: 1.1

http://www.w3.org/TR/wsdl

PKI CA na koji se sustav oslanja je FINA RDC.

UTF-8 Odabrani način zapisa kodnih točaka u Unicode standardu.

http://tools.ietf.org/html/rfc3629

Korištenje nabrojanih standarda osigurava neovisnost sustava o izabranoj tehnologiji implementatora sustava prilikom postizanja predmetne interoperabilnosti.

Svi vremenski podaci koji se navode u porukama moraju biti izraženi u lokalnom vremenu, koje je usklađeno sa službenim vremenom u RH (preporučeni format: 'yyyy-MM-ddTHH:mm:ss.SSS').

TS1 v1.0 5/43

Page 6: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

1.6 IT arhitektura sustava

Sustav je zamišljen kao „jednosmjerno razmjenjivanje“ poruka uz sinkronu paradigmu. Pri tome pod jednosmjernim podrazumijevamo činjenicu da je izvor poruke uvijek priređivač igre na sreću, dok CIS Porezne uprave Republike Hrvatske na pristiglu poruku vraća poruku o statusu zaprimljenog.

Stoga je i topologija sustava, dana donjom slikom, vrlo jednostavna:

Dijagram toka razmjene također je vrlo jednostavan:

Page 7: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

Njega raščlanjujemo na sljedeći način:

0. Priređivač igre na sreću uočava događaj poslovno zanimljiv Poreznoj upravi Republike Hrvatske.

1. Priređivač igre na sreću za uočeni događaj kreira, poslovnim pravilima propisanu, poruku i šalje ju, na način propisan ovim dokumentom, na CIS Porezne uprave Republike Hrvatske.

2. CIS Porezne uprave zaprima poruku: a. sprema ju u sustav praćenja, b. potvrđuje da njezin sadržaj formalno zadovoljava propisanu XML shemu, c. potvrđuje sukladnost sadržaja poruke s propisanim poslovnim pravilima.

3. Ovisno o ishodima koraka (2b) i (2c), CIS Porezne uprave Republike Hrvatske vraća poruku o uspješnosti zaprimanja i obrade poruke.

Kako se ovom specifikacijom ni na koji način ne želi ulaziti u interne procese priređivača, korak koji je označen brojem 0 niti nije obuhvaćen slikom dijagrama toka.

Također, radi jednostavnosti, dijagram toka zanemaruje tehnološke detalje vezane za kreiranje i (eventualno) terminiranje SSL-a, autorizaciju korisnika koji pristupa i slično, koji su pobliže opisani u drugim poglavljima.

TS1 v1.0 7/43

Page 8: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

2 Financijski nadzor Internet casina

Financijski nadzor priređivača igara na sreću u Internet casinima temelji se na nadzoru relevantnih transakcija koje se događaju u informacijskom sustavu priređivača. Relevantne transakcije sa strane Ministarstva financija su one transakcije koje prate tijek novca i na temelju kojih se može izračunati i provjeriti porezna obveza priređivača te usporediti s poreznom obvezom koju on prijavljuje Ministarstvu financija. Relevantne transakcije obuhvaćaju uplatu sredstava na i-konto igrača, isplatu sredstava s i-konta igrača, uplatu sredstava u igru te isplatu sredstava iz igre. Uplate igrača u igru su istovremeno i isplate s i-konta, dok su isplate dobitaka iz igre ujedno i uplate na i-konto igrača. Uplate na i-konto su također i uplate novčanih sredstava koja dolaze iz sustava priređivača i pružatelja usluga plaćanja, tj. sustava elektroničkog, Internet plaćanja.

Nadzor nad relevantnim transakcijama, odnosno nadzor tijeka novca, Ministarstvo financija provodi direktnim nadzorom u sustavu priređivača te je taj proces opisan u zasebnom dokumentu (Upute za provođenje neposrednog nadzora Internet casina – U4) i nije predmetom ove specifikacije.

Osim nadzora koji obuhvaća tijek novca, Ministarstvo financija također provodi administrativni i izvještajni nadzor kroz razmjenu poruka (transakcija) nadzora između sustava priređivača i sustava Ministarstva financija.

TS1 v1.0 8/43

Page 9: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

Razmjena poruka administrativnog i izvještajnog nadzora detaljno je opisana ovom specifikacijom, a obuhvaća:

1. Transakcije za administrativni nadzor Internet casina:

• Aktivaciju / promjenu podataka / deaktivaciju casina,

• Aktivaciju / promjenu podataka / deaktivaciju igre (slot, table, turnir),

• Aktivaciju / promjenu podataka / deaktivaciju jackpota.

2. Transakcije za izvještajni nadzor Internet casina:

• Dnevni izvještaj casina o igrama na automatima (slot) u casinu,

• Dnevni izvještaj casina o igrama na stolovima (table) u casinu,

• Izvještaj casina o turniru (tournament),

• Dnevni izvještaj o stanju i-konta casina (samo za Internet casino),

• Konačni mjesečni obračun casina.

TS1 v1.0 9/43

Page 10: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

2.1 Administrativni nadzor Internet casina

Administrativni nadzor Internet casina obuhvaća praćenje aktivnosti Internet casina, igara i jacpota, koje obuhvaćaju registraciju (aktivaciju), deaktivaciju te promjene ostalih podataka.

Prilikom početka rada Internet casina potrebno je Ministarstvu financija prijaviti Internet casino, igre u casinu te jackpote koje je u casinu moguće osvojiti. Također, ako se tijekom vremena dodaju nove igre ili jackpoti u Internet casino ili se postojeće igre i jackpoti ukidaju, tada je potrebno takve događaje prijaviti u Ministarstvo financija.

Transakcije kojima se obavlja aktivacija, promjena statusa i deaktivacija casina, jackpota i igara su:

• StatusCasina za aktivaciju /promjenu podataka / deaktivaciju casina,

• StausJackpota za aktivaciju / promjenu podataka / deaktivaciju jackpota,

• StatusIgre za aktivaciju / promjenu podataka / deaktivaciju igre (slot, table, turnir).

Primjer registracije Internet casina koji ima četiri igre (Slot #X, Slot #Y, Table #Z, Turnir #W) te jedan jackpot (Jackpot #A) u kojem sudjeluju dvije igre (Slot #X i Slot #Y) prikazan je na slici u nastavku. U primjeru je također prikazano kako se jedna od igara zatvara (Turnir #W). Scenarij je sljedeći:

1. Informacijski sustav priređivača šalje u Ministarstvo financija transakciju StatusCasina sa šifrom, imenom i vrstom casina kojom se aktivira Internet casino. Ovu je transakciju nužno provesti prije bilo koje druge transakcije.

2. Informacijski sustav priređivača šalje u Ministarstvo financija transakciju StatusJackpota sa šifrom i nazivom jackpota kojom se aktivira Jackpot #A.

3. Informacijski sustav priređivača šalje u Ministarstvo financija transakciju StatusIgre s podacima kojom se aktivira Slot #X. Podaci u transakciji uključuju šifru, naziv i vrstu igre (slot) te informaciju o tome u kojem jackpotu igra sudjeluje.

4. Informacijski sustav priređivača šalje u Ministarstvo financija transakciju StatusIgre kojom se aktivira Slot #Y. Podaci u transakciji uključuju šifru, naziv i vrstu igre (slot) te informaciju o tome kojem jackpotu igra pripada.

5. Informacijski sustav priređivača šalje u Ministarstvo financija transakciju StatusIgre kojom se aktivira igra Table #Z. Podaci u transakciji uključuju šifru, naziv i vrstu igre (table).

6. Informacijski sustav priređivača šalje u Ministarstvo financija transakciju StatusIgre kojom se aktivira Turnir #W. Podaci u transakciji uključuju šifru, naziv i vrstu igre (turnir).

7. Završetkom turnira informacijski sustav priređivača šalje u Ministarstvo financija transakciju StatusIgre sa šifrom igre kojom se deaktivira Turnir #W.

TS1 v1.0 10/43

Page 11: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

TS1 v1.0 11/43

Page 12: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

2.2 Izvještajni nadzor Internet casina

Izvještajni nadzor Internet casina obuhvaća razmjenu izvještajnih transakcija.

U zadanim vremenskim intervalima informacijski sustav priređivača šalje kumulativne izvještaje u Ministarstvo financija. Jednom dnevno šalju se kumulativni izvještaji o igrama na automatima, igrama na stolovima i stanju i-konta priređivača (samo za Internet casino). Završetkom turnira šalje se izvještaj o turniru. Jednom mjesečno šalje se konačni mjesečni obračun casina.

Rok za slanje dnevnog, odnosno mjesečnog izvještaja je 01:00:00 sati po isteku perioda za koji se izvještaj šalje. Rok za slanje izvještaja o turniru je jedan sat nakon završetka turnira. Za svaki završeni turnir šalje se zaseban izvještaj.

U sadržaj dnevnih i mjesečnih izvještaja trebaju se uvrstiti sve one transakcije koje su završile u promatranom periodu (dan ili mjesec), bez obzira kada su započele. U slučaju da u promatranom periodu (dan ili mjesec) nije bilo završenih transakcija, također se šalje izvještaj te će on sadržavati samo obvezne podatke.

TS1 v1.0 12/43

Page 13: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

3 Razmjena podataka

Priređivač je dužan nakon svake relevantne transakcije u svojem informacijskom sustavu pripremiti tražene podatke o transakciji te je poslati u Ministarstvo financija. Transakcije se moraju slati onim redoslijedom kojim su nastali poslovni događaji u sustavu priređivača. Poslužitelj Ministarstva financija nakon svake primljene transakcije provjerava njenu formalnu valjanost i šalje odgovor priređivaču da je transakcija zaprimljena i valjana. Taj proces vrijedi za bilo koju generiranu transakciju priređivača. Ako zaprimljena transakcija nije formalno valjana, poslužitelj Ministarstva financija šalje poruku s odgovorom priređivaču s informacijom da je potreban ispravak zaprimljene transakcije. Nakon ispravka transakcije, cijeli se proces razmjene ponavlja samo za tu transakciju. Informacijski sustav priređivača ne treba niti u jednom trenutku zaustaviti svoj proces – transakcije se u Ministarstvo financija trebaju slati asinkrono i ne trebaju zaustavljati normalan poslovni proces priređivača.

Ovo poglavlje ima namjenu opisati podatkovne slogove i pravila koja je nužno poštovati u komunikaciji između priređivača igara na sreću u Internet casinima (u nastavku priređivač) i Ministarstva financija kako bi se omogućilo izvještavanje Ministarstva financija o radu priređivača.

Razmjena podataka odvijat će se putem mrežnih servisa (engl. web services) korištenjem XML poruka. Upravo takav način razmjene podataka nije ovisan ni o tehnologiji koju koriste priređivači ni o tehnologiji koju koristi Ministarstvo financija te omogućuje uniformnu komunikaciju između bilo kojeg priređivača i Ministarstva financija.

Sadržaj i struktura poruka definirani su XML shemama (Prilog 1: iCasina – WSDL i XSD datoteke za razmjenu podataka). U nastavku slijedi logički opis poruka.

TS1 v1.0 13/43

Page 14: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

3.1 Zaglavlje transakcija

Svaka transakcija opisana u nastavku ima zaglavlje koje je zajedničko za sve transakcije (izuzetak su transakcije Odgovor i ZaglavljeTransakcijaBrisanje).

Zaglavlje sadrži sistemske podatke o identifikatoru transakcije, OIB-u priređivača koji šalje transakciju te datumu i vremenu slanja transakcije.

OIB priređivača u zaglavlju transakcije mora odgovarati OIB-u priređivača koji šalje transakciju.

U slučaju slanja transakcije ispravka, zaglavlje mora sadržavati i podatke o povezanoj transakciji (detaljnije opisano u poglavlju 3.6 – Transakcija ispravka). Ovi podaci se ispunjavaju isključivo u slučaju slanja transakcije ispravka.

Priređivač je dužan osigurati jedinstvenost svake transakcije generiranjem jedinstvenog identifikatora transakcije (ID). Ministarstvo financija će za svaku zaprimljenu transakciju provjeravati jedinstvenost uzimajući u obzir kombinaciju ID-a zaprimljene transakcije i OIB-a priređivača.

U slučaju da priređivač pošalje transakciju koja sadrži ID ranije zaprimljene transakcije, takva transakcija, iako formalno ispravna i uspješno zaprimljena u Ministarstvu financija, provjerom prilikom integracije podataka će se odbaciti i neće biti spremljena. Priređivač o tome neće dobiti povratnu informaciju.

NAPOMENA: Da bi opisi transakcija bili što razumljiviji, zaglavlje je opisano samo na jednom mjestu i nije navedeno u opisu svake transakcije.

Zaglavlje

Naziv podatka Tip podatka Duljina Pojavnost/ obaveznost Opis

ID Guid 36 1 Identifikator transakcije. Guid.

OIB Numeric 11 1 OIB priređivača. DatumVrijeme DateTime 25 1 Datum i vrijeme slanja

transakcije. PovezanaTransakcija 0..1 Podaci o transakciji za koju

se šalje ispravak. ID Guid 36 1 Identifikator transakcije za

koju se šalje ispravak. DatumVrijeme DateTime 25 1 Datum i vrijeme slanja

transakcije za koju se šalje ispravak.

TS1 v1.0 14/43

Page 15: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

3.2 Transakcije nadzora

Transakcije nadzora podijeljene su u dvije grupe:

1. Transakcije za administrativni nadzor Internet casina,

2. Transakcije za izvještajni nadzor Internet casina.

Transakcije za administrativni nadzor Internet casina su:

• Aktivacija/promjena statusa/deaktivacija casina,

• Aktivacija/promjena statusa/deaktivacija igre (automat, stol, turnir),

• Aktivacija/promjena statusa/deaktivacija jackpota.

Transakcije za izvještajni nadzor Internet casina su:

• Dnevni izvještaj casina o igrama na automatima,

• Dnevni izvještaj casina o igrama na stolovima,

• Izvještaj casina o turniru,

• Dnevni izvještaj po i-kontu priređivača (casina) – samo za Internet casino,

• Konačni mjesečni obračun.

Odgovor servisa Ministarstva financija:

• Odgovor servisa.

Ispravci transakcija:

• Ispravak,

• Poništavanje.

TS1 v1.0 15/43

Page 16: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

3.3 Transakcije za administrativni nadzor Internet casina

Administrativne transakcije služe za aktiviranje, promjenu podataka i deaktiviranje casina, igre ili jackpota. Administrativne transakcije šalju se Ministarstvu financija u realnom vremenu, redoslijedom kako su nastali poslovni događaji u sustavu priređivača.

3.3.1 Aktivacija/promjena statusa/deaktivacija casina

Prije slanja bilo kakvih transakcija vezanih uz igru ili jackpot priređivač je dužan aktivirati casino slanjem transakcije StatusCasina u Ministarstvo financija kojom registrira casino. Pritom je dužan prijaviti jedinstvenu šifru casina, vrstu casina kao i njegov naziv. Uz casino, potrebno je prijaviti i podatke o priređivaču, njegov OIB i naziv. Statusom se opisuje datum i vrijeme te vrsta promjene koja se u podacima casina obavlja. Promjena može biti aktivacija, deaktivacija i promjena ostalih atributa. Prije aktivacije casina i nakon deaktivacije casina nikakve transakcije vezane uz igru i jackpot u casinu ne bi se smjele odvijati niti prijavljivati u Ministarstvo financija.

Priređivač je dužan osigurati jedinstveni identifikator casina, odnosno njegovu jedinstvenu šifru. Ministarstvo financija će provjeravati jedinstvenost uzimajući u obzir kombinaciju šifre casina i OIB-a priređivača.

Jednom deaktivirani casino moguće je naknadno ponovno aktivirati, koristeći njegovu postojeću jedinstvenu šifru, u suprotnome će se smatrati novim casinom.

StatusCasina

Naziv podatka Tip podatka Duljina Pojavnost/ obaveznost Opis

Casino 1 Podaci o casinu koji se aktivira, deaktivira ili kojem se mijenja status.

Sifra Text 64 1 Šifra casina koji se aktivira, deaktivira ili kojem se mijenja status.

Vrsta Enum 1 1 Vrsta casina: I – Internet casino, F – fizički casino.

Naziv Text 128 1 Naziv casina. Priredjivac 1 Podaci o priređivaču.

OIB Numeric 11 1 OIB priređivača.

Naziv Text 128 1 Naziv priređivača. Status 1 Status casina.

DatumVrijeme DateTime 25 1 Datum i vrijeme aktivacije,

promjene atributa ili deaktivacije casina.

Status Enum 1 1 Vrsta promjene statusa: A – aktivan, N – neaktivan, P – promjena ostalih atributa.

TS1 v1.0 16/43

Page 17: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

Slika 1: Schema poruke StatusCasina

3.3.2 Aktivacija/promjena statusa/deaktivacija jackpota

Transakcija StatusJackpota koristi se za aktivaciju jackpota, deaktivaciju jackpota i promjenu podataka o jackpotu. Svaki se jackpot treba aktivirati i prijaviti transakcijom StatusJackpota Ministarstvu financija prije nego što se može početi koristiti u igrama. Jedan jackpot se može registrirati u više casina. Jackpot se treba registrirati prije registracije igre koja je vezana uz taj jackpot. Prilikom registracije jackpota nužno je dostaviti podatke o samom jackpotu, casinima u kojima se jackpot nalazi i njegovom statusu.

Svaki jackpot mora imati jedinstvenu šifru pod kojom se prijavljuje Ministarstvu financija. Priređivač je dužan osigurati jedinstvenost šifre jackpota. Ministarstvo financija će provjeravati jedinstvenost uzimajući u obzir kombinaciju šifre jackpota i OIB-a priređivača.

Jackpot se može i deaktivirati nakon čega se više ne smije koristiti u igrama do njegove ponovne aktivacije. Prilikom ponovne aktivacije, potrebno je koristiti njegovu postojeću jedinstvenu šifru, u suprotnome će se smatrati novim jackpotom. Također, jackpotu se mogu mijenjati i ostali podaci poput naziva i casina kojima pripada.

TS1 v1.0 17/43

Page 18: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

StatusJackpota

Naziv podatka Tip podatka Duljina Pojavnost/ obaveznost Opis

Jackpot 1 Podaci o jackpotu koji se aktivira, deaktivira ili kojem se mijenja status.

Sifra Text 64 1 Šifra jackpota koji se aktivira, deaktivira ili kojem se mijenja status.

Naziv Text 128 1 Naziv jackpota. Casina 1 Podaci o casinima uz koje

je vezan jackpot. Casino 1..n Podaci o casinu u kojem se

nalazi jackpot. Sifra Text 64 1 Šifra casina u kojem se

nalazi jackpot. Status 1 Status jackpota. DatumVrijeme DateTime 25 1 Datum i vrijeme aktivacije,

promjene atributa ili deaktivacije jackpota.

Status Enum 1 1 Status jackpota: A – aktivan, N – neaktivan, P – promjena ostalih atributa.

Slika 2: Schema poruke StatusJackpota

TS1 v1.0 18/43

Page 19: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

3.3.3 Aktivacija/promjena statusa/deaktivacija igre

Transakcija StatusIgre koristi se za aktivaciju, promjenu statusa i deaktivaciju igre. Pod igrom se podrazumijeva igra na automatu, igra za stolom i turnir. Transakcija sadrži podatke o igri, casinu u kojem je igra registrirana, jackpotu u kojem sudjeluje i statusu.

Svaka se igra prije korištenja treba prijaviti u Ministarstvo financija i aktivirati. Igra se prijavljuje svojom jedinstvenom šifrom, vrstom i nazivom. U slučaju da igra ima svoj jackpot ili sudjeluje u jackpotu zajedno s drugim igrama tada je obavezan i dio podataka vezanih uz jackpot.

Priređivač je dužan osigurati jedinstveni identifikator igre, odnosno njezinu jedinstvenu šifru. Ministarstvo financija će provjeravati jedinstvenost uzimajući u obzir kombinaciju šifre igre i OIB-a priređivača.

Igre na automatima i stolovima moguće je ponovno aktivirati nakon deaktivacije, koristeći njihove postojeće jedinstvene šifre, u suprotnome će se smatrati novim igrama.

Turnire nakon deaktivacije nije moguće ponovno aktivirati. Ukoliko se želi ponovno aktivirati isti turnir on se mora prijaviti kao novi turnir te mu se mora dodijeliti nova jedinstvena šifra.

StatusIgre

Naziv podatka Tip podatka Duljina Pojavnost/ obaveznost Opis

Igra 1 Podaci o igri koja se aktivira, deaktivira ili joj se mijenja status.

Sifra Text 64 1 Šifra igre koja se aktivira, deaktivira ili kojoj se mijenja status.

Vrsta Enum 1 1 Vrsta igre: A – automat (slot), S – stol (table), T – turnir.

Naziv Text 128 1 Naziv igre. Casino 1 Podaci o casinu u kojem se

igra nalazi. Sifra Text 64 1 Šifra casina u kojem se igra

nalazi. Jackpotovi 0..1 Podaci o jackpotovima u

kojima igra sudjeluje. Jackpot 1..n Podaci o jackpotu u kojem

igra sudjeluje. Sifra Text 64 1 Šifra jackpota u kojem igra

sudjeluje. Status 1 Status igre. DatumVrijeme DateTime 25 1 Datum i vrijeme aktivacije,

promjene atributa ili deaktivacije igre.

Status Enum 1 1 Status igre: A – aktivna, N – neaktivna, P – promjena ostalih atributa.

TS1 v1.0 19/43

Page 20: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

Slika 3: Schema poruke StatusIgre

TS1 v1.0 20/43

Page 21: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

3.4 Transakcije za izvještajni nadzor Internet casina

Osim transakcija za administrativni nadzor koje se u Ministarstvo financija šalju u realnom vremenu, za nadzor su nužne i izvještajne transakcije koje su propisane zakonom i koje se trebaju slati u zadanim vremenskim intervalima.

3.4.1 Izvještaj casina o igrama na automatima (slot)

Izvještaj casina o igrama na automatima (slot) šalje se jednom dnevno. Rok za slanje izvještaja je 01:00:00 sati, za prethodni dan. Izvještaj obuhvaća sve igre koje spadaju u kategoriju igara na automatima (slot).

Izvještaj sadrži podatke o datumu za kojeg se izvještaj radi te datum i vrijeme izrade samog izvještaja. Za svaku se igru na automatima moraju dostaviti podaci o uplatama, isplatama, jackpot doprinosima i osvojenim jackpotima kao i razlici koja služi kao porezna osnovica.

IzvjestajAutomata

Naziv podatka Tip podatka Duljina Pojavnost/ obaveznost Opis

Izvjestaj 1 Podaci o dnevnom izvještaju.

DatumIzvjestaja Date 10 1 Datum za koji se šalje izvještaj.

DatumVrijeme DateTime 25 1 Datum i vrijeme izrade izvještaja.

Casino 1 Podaci o casinu za kojeg se šalje izvještaj.

Sifra Text 64 1 Šifra casina za kojeg se šalje izvještaj.

Igre 0..1 Ukupni podaci o svim igrama na automatima u casinu.

Igra 1..n Ukupni podaci o jednoj igri na automatu u casinu.

Sifra Text 64 1 Šifra igre za koju se prijavljuje izvještaj.

Obracun 1 Obračun po uplatama, isplatama i jackpotu.

Uplata Decimal 15.2 1 Ukupno uplaćeno novaca u igru.

Isplata Decimal 15.2 1 Ukupno isplaćeno novaca iz igre bez uključenih isplata jackpota.

JackpotAkumulacija

Decimal 15.2 1 Ukupan iznos akumulacije u jackpot iz igre.

JackpotIsplata Decimal 15.2 1 Ukupno isplaćeno novca iz jackpota.

Razlika Decimal 15.2 1 Izračunava se kao Uplata minus Isplata minus JackpotAkumulacija.

TS1 v1.0 21/43

Page 22: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

IzvjestajAutomata

Naziv podatka Tip podatka Duljina Pojavnost/ obaveznost Opis

Obracun 1 Ukupan obračun po uplatama, isplatama i jackpotu za sve igre na automatima u casinu.

Uplata Decimal 15.2 1 Ukupno uplaćeno novaca u sve igre na automatima za cijeli casino.

Isplata Decimal 15.2 1 Ukupno isplaćeno novaca iz svih igara na automatima za cijeli casino bez uključenih isplata jackpota.

JackpotAkumulacija Decimal 15.2 1 Ukupan iznos akumulacije u jackpot iz svih igara.

JackpotIsplata Decimal 15.2 1 Ukupno isplaćeno novca iz jackpota.

Razlika Decimal 15.2 1 Izračunava se kao Uplata minus Isplata minus JackpotAkumulacija.

Slika 4: Schema poruke IzvjestajAutomata

TS1 v1.0 22/43

Page 23: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

3.4.2 Izvještaj casina o igrama na stolovima (table)

Izvještaj casina o igrama na stolovima (casino igre i poker sobe) šalje se jednom dnevno. Rok za slanje izvještaja je 01:00:00 sati, za prethodni dan. Izvještaj obuhvaća sve igre koje spadaju u kategoriju casino igara na stolovima u kojima igrači igraju protiv casina ili jedni protiv drugih.

Izvještaj sadrži podatke o datumu za kojeg se izvještaj radi te datum i vrijeme izrade samog izvještaja. Za svaku se igru moraju dostaviti podaci o uplatama, isplatama, jackpot doprinosima i osvojenim jackpotima te razlikama koje je casino zadržao i koje služe za izračun porezne osnovice.

IzvjestajStolova

Naziv podatka Tip podatka Duljina Pojavnost/ obaveznost Opis

Izvjestaj Podaci o dnevnom izvještaju.

DatumIzvjestaja Date 10 1 Datum za koji se šalje izvještaj.

DatumVrijeme DateTime 25 1 Datum i vrijeme izrade izvještaja.

Casino 1 Podaci o casinu za kojeg se šalje izvještaj.

Sifra Text 64 1 Šifra casina za kojeg se šalje izvještaj.

Igre 0..1 Ukupni podaci o svim igrama na stolovima u casinu.

Igra 1..n Ukupni podaci o jednoj igri na stolu u casinu.

Sifra Text 64 1 Šifra igre za koju se prijavljuje izvještaj.

Obracun 1 Obračun po uplatama, isplatama, jackpotu i razlici.

Uplata Decimal 15.2 1 Ukupno uplaćeno novaca u igru.

Isplata Decimal 15.2 1 Ukupno isplaćeno novaca iz igre bez uključenih isplata jackpota.

JackpotAkumulacija

Decimal 15.2 0..1 Ukupan iznos akumulacije u jackpot iz igre u slučaju da je igra sudjelovala u jackpotu.

JackpotIsplata Decimal 15.2 0..1 Ukupno isplaćeno novca iz jackpota u slučaju da je igra sudjelovala u jackpotu.

Razlika Decimal 15.2 1 Razlika stola. Obracun 1 Ukupan obračun po

uplatama, isplatama, jackpotovima i razlici za sve igre na stolovima u casinu.

TS1 v1.0 23/43

Page 24: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

IzvjestajStolova

Naziv podatka Tip podatka Duljina Pojavnost/ obaveznost Opis

Uplata Decimal 15.2 1 Ukupno uplaćeno novaca u sve igre na stolovima za cijeli casino.

Isplata Decimal 15.2 1 Ukupno isplaćeno novaca iz svih igara na stolovima za cijeli casino bez uključenih isplata jackpota.

JackpotAkumulacija Decimal 15.2 0..1 Ukupan iznos akumulacije u jackpot iz svih igara u slučaju da su igre sudjelovale u jackpotu.

JackpotIsplata Decimal 15.2 0..1 Ukupno isplaćeno novca iz jackpota u slučaju da su igre sudjelovale u jackpotu.

Razlika Decimal 15.2 1 Ukupna razlika za sve igre na stolovima.

TS1 v1.0 24/43

Page 25: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

Slika 5: Schema poruke IzvjestajStolova

TS1 v1.0 25/43

Page 26: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

3.4.3 Izvještaj casina o turniru (tournament)

Turniri jesu igre na stolovima koje igrači igraju jedan protiv drugoga, a u kojima priređivač zaprima uplate od sudionika turnira i zadržava određeni postotak od svih uplata sudionika turnira (proviziju). Izvještaj casina o turniru šalje se završetkom turnira, a najkasnije jedan sat nakon završetka turnira.

Izvještaj sadrži podatke o datumu i vremenu izrade samog izvještaja, casinu u kojem se turnir odigrao, podatke o turniru te podatke o ukupnim uplatama (ukupnoj kotizaciji), isplatama (ukupnim dobicima) i proviziji koju je priređivač zadržao od turnira.

IzvjestajTurnira

Naziv podatka Tip podatka Duljina Pojavnost/ obaveznost Opis

Izvjestaj Podaci o dnevnom izvještaju.

DatumVrijeme DateTime 25 1 Datum i vrijeme izrade izvještaja.

Casino 1 Podaci o casinu za kojeg se šalje izvještaj.

Sifra Text 64 1 Šifra casina za kojeg se šalje izvještaj.

Igra 1 Podaci o turniru za kojeg se šalje izvještaj.

Sifra Text 64 1 Šifra turnira za kojeg se prijavljuje izvještaj.

Obracun 1 Obračun po uplatama, isplatama i proviziji.

Uplata Decimal 15.2 1 Ukupno uplaćeno novca u turnir.

Isplata Decimal 15.2 1 Ukupno isplaćeno novca iz turnira.

Provizija Decimal 15.2 1 Iznos provizije.

TS1 v1.0 26/43

Page 27: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

Slika 6: Schema poruke IzvjestajTurnira

TS1 v1.0 27/43

Page 28: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

3.4.4 Izvještaj po i-kontu priređivača (samo za Internet casino)

Izvještaj po i-kontu priređivača šalje se jednom dnevno, nakon slanja izvještaja o igrama na automatima, stolovima i turnirima. Rok za slanje izvještaja je 01:00:00 sati, za prethodni dan. Izvještaj obuhvaća sve transakcije koje su se odvijale po i-kontu priređivača na kojem igrači imaju pohranjena svoja sredstva za igru. Potrebno je prijaviti početno stanje i-konta na početku dana (u 00:00:00 sati), sve uplate i isplate s i-konta priređivača (uplate i isplate od igrača i prema igraču te uplate i isplate u igru i iz igre), kao i završno stanje i-konta priređivača na kraju dana (u 23:59:59 sati).

IzvjestajIkontaCasina

Naziv podatka Tip podatka Duljina Pojavnost/ obaveznost Opis

Izvjestaj Podaci o dnevnom izvještaju.

DatumIzvjestaja Date 10 1 Datum za koji se šalje izvještaj.

DatumVrijeme DateTime 25 1 Datum i vrijeme izrade izvještaja.

Casino 1 Podaci o casinu.

Sifra Text 64 1 Šifra casina za kojeg se šalje izvještaj.

Stanje 1 Stanje i-konta casina na dan.

PocetnoStanjeIkontaCasina

Decimal 15.2 1 Iznos na i-kontu casina na početku dana za kojeg se podnosi izvještaj (u 00:00:00).

IznosUplataNaIkonto Decimal 15.2 1 Ukupan iznos svih uplata koje su igrači uplatili u svoja i-konta tijekom izvještajnog dana.

IznosIsplataSIkonta Decimal 15.2 1 Ukupan iznos svih isplata koje su igrači isplatili s i-konta tijekom izvještajnog dana.

IznosUplataIgara Decimal 15.2 1 Ukupan iznos svih uplata s i-konta igrača u igre casina koje su igrači uplatili tijekom izvještajnog dana.

IznosIsplataIgara Decimal 15.2 1 Ukupan iznos svih isplata iz igara casina na i-konta igrača koje su igrači ostvarili tijekom izvještajnog dana.

TS1 v1.0 28/43

Page 29: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

IzvjestajIkontaCasina

Naziv podatka Tip podatka Duljina Pojavnost/ obaveznost Opis

IznosUplataOstalo Decimal 15.2 0..1 Ukupan iznos svih uplata s i-konta igrača na ostale vrste igara koje nisu dio fiskalnog modela nadzora Internet casina (npr. lutrijske igre, kladionice itd.).

IznosIsplataOstalo Decimal 15.2 0..1 Ukupan iznos svih isplata iz igara na i-konta igrača za ostale vrste igre koje nisu dio fiskalnog modela nadzora Internet casina (npr. lutrijske igre, kladionice itd.).

ZavrsnoStanjeIkontaCasina

Decimal 15.2 1 Iznos na i-kontu casina na kraju dana za kojeg se podnosi izvještaj (u 23:59:59).

TS1 v1.0 29/43

Page 30: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

Slika 7: Schema poruke IzvjestajIkontaCasina

TS1 v1.0 30/43

Page 31: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

3.4.5 Konačni mjesečni obračun

Konačni mjesečni obračun šalje se jednom mjesečno, nakon slanja svih dnevnih izvještaja i izvještaja o završenim turnirima. Rok za slanje izvještaja je 01:00:00 sati po isteku mjeseca, za prethodni mjesec.

Konačni mjesečni obračun služi za prijavu naknade koju priređivač treba platiti u državni proračun Republike Hrvatske. On obuhvaća sumarne podatke o igrama na automatima, igrama na stolovima i turnirima, kao i ukupnu naknadu koju priređivač treba uplatiti u državni proračun Republike Hrvatske.

MjesecniObracun

Naziv podatka Tip podatka Duljina Pojavnost/ obaveznost Opis

Izvjestaj Podaci o mjesečnom obračunu.

MjesecIzvjestaja Numeric 2 1 Mjesec za kojeg se šalje izvještaj.

GodinaIzvjestaja Numeric 4 1 Godina za koju se šalje izvještaj.

DatumVrijeme DateTime 25 1 Datum i vrijeme izrade izvještaja.

Casino 1 Podaci o casinu.

Sifra Text 64 1 Šifra casina za kojeg se šalje izvještaj.

IgreNaAutomatima 0..1 Ukupni mjesečni obračun po igrama na automatima.

Uplata Decimal 15.2 1 Ukupne uplate po igrama na automatima.

Isplata Decimal 15.2 1 Ukupne isplate po igrama na automatima (ne računajući jackpot dobitke).

JackpotAkumulacija Decimal 15.2 1 Ukupni iznos akumulacije u jackpot iz igara.

JackpotIsplata Decimal 15.2 1 Ukupni isplaćeni jackpoti po igrama na automatima.

Osnovica Decimal 15.2 1 Osnovica za obračun naknade (Uplata minus Isplata minus JackpotAkumulacija).

Naknada Decimal 15.2 1 Iznos naknade koji priređivač treba platiti.

IgreNaStolovima 0..1 Ukupni mjesečni obračun po igrama na stolovima.

Osnovica Decimal 15.2 1 Osnovica za obračun naknade jednaka je ukupnoj sumi svih razlika priređivača.

Naknada Decimal 15.2 1 Iznos naknade koji priređivač treba platiti.

Turniri 0..1

TS1 v1.0 31/43

Page 32: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

MjesecniObracun

Naziv podatka Tip podatka Duljina Pojavnost/ obaveznost Opis

Osnovica Decimal 15.2 1 Osnovica za obračun naknade jednaka je ukupnoj sumi svih provizija priređivača.

Naknada Decimal 15.2 1 Iznos naknade koji priređivač treba platiti.

Ukupno 1 Naknada Decimal 15.2 1 Iznos ukupne mjesečne

naknade koji priređivač treba platiti (zbroj svih naknada).

TS1 v1.0 32/43

Page 33: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

Slika 8: Schema poruke MjesecniObracun

TS1 v1.0 33/43

Page 34: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

3.5 Odgovor servisa Ministarstva financija

Na svaku zaprimljenu transakciju servis Ministarstva financija šalje odgovor priređivaču. Transakcija Odgovor sadrži ID transakcije za koju se šalje odgovor, datum i vrijeme slanja odgovora te status koji sadrži podatak o tome je li transakcija bila uspješno ili neuspješno zaprimljena.

Ako je zaprimljena transakcija bila formalno ispravna, priređivaču se šalje odgovor sa statusom U – uspješno zaprimljena.

Ako je zaprimljena transakcija bila formalno neispravna, priređivaču se šalje odgovor sa statusom N – neuspješno zaprimljena. Priređivač u tom slučaju treba ispraviti evidentirane greške te Ministarstvu financija poslati novu transakciju koja treba sadržavati novi ID.

Ukoliko priređivač iz nekog razloga nije zaprimio odgovor na poslanu transakciju, priređivač treba Ministarstvu financija ponovno poslati istu poruku s istim ID-em.

Odgovor

Naziv podatka Tip podatka Duljina Pojavnost/ obaveznost Opis

ID Guid 36 1 Identifikator zaprimljene transakcije. Guid.

DatumVrijeme DateTime 25 1 Datum i vrijeme slanja odgovora.

Status Enum 1 1 Status zaprimljene transakcije. Može biti: U – uspješno zaprimljena N – neuspješno zaprimljena

Greske 0..1 Podaci o greškama. Ovaj podatak postoji samo ako je status odgovora jednak N.

Greska 1..n Podaci o greški. Sifra String 16 1 Šifra greške.

Opis String 256 1 Opis greške.

Slika 9: Schema poruke Odgovor

TS1 v1.0 34/43

Page 35: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

3.5.1 Šifarnik grešaka

U tablici se nalazi popis mogućih grešaka s pripadajućim šiframa.

Šifra greške Opis greške

2 Neispravna po shemi

3 OIB iz poruke ne odgovara OIB-u na certifikatu

ili

Korisnik (OIB korisnika) nije autoriziran za pristup sustavu

4 Sustav nedostupan

000 Poruka greške koju generira pristupni sloj* * Šifra greške 000 predstavlja sve poruke koje nastanu krivom konfiguracijom pristupnog sloja.

TS1 v1.0 35/43

Page 36: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

3.6 Ispravak prethodno poslanih transakcija

Priređivači imaju mogućnost slanja ispravaka svih prethodno poslanih transakcija koje su uspješno bile zaprimljene u Ministarstvu financija. Rok za slanje ispravaka je 23:59:59 sati 20. dana u mjesecu, za prethodni mjesec (za sve vrste transakcija). Iznimno, dozvoljeno je slanje ispravaka nakon ovog roka u slučaju da je poreznim nadzorom utvrđena nepravilnost koju je potrebno ispraviti.

Transakcija ispravka je nova transakcija koja ima svoj jedinstveni ID i koja se veže na transakciju koja se želi ispraviti. Povezivanje se postiže ispunjavanjem elementa Povezana transakcija unutar Zaglavlja transakcije. Kao ID povezane transakcije priređivači trebaju navesti ID poruke koju žele ispraviti. Odgovornost je priređivača ispravno povezati ID transakcija prilikom ispravljanja. Ukoliko transakcija u Zaglavlju ne sadrži podatke o povezanoj transakciji, neće se smatrati ispravkom, nego novom transakcijom.

Sukladno tome, ako priređivač pošalje izvještajnu transakciju (osim Izvještaja casina o turniru), koja ne sadrži podatke o povezanoj transakciji, ali se odnosi na period za koji je izvještajna transakcija prethodno već zaprimljena, neće se smatrati ispravkom, nego duplom transakcijom te će se, iako formalno ispravna i uspješno zaprimljena u Ministarstvu financija, provjerom prilikom integracije podataka će se odbaciti i neće biti spremljena. Priređivač o tome neće dobiti povratnu informaciju.

Također, ako priređivač pošalje transakciju Izvještaj casina o turniru, koja ne sadrži podatke o povezanoj transakciji, ali sadrži šifru turnira za koji je takva transakcija već zaprimljena, neće se smatrati ispravkom, nego duplom transakcijom te će se, iako formalno ispravna i uspješno zaprimljena u Ministarstvu financija, provjerom prilikom integracije podataka će se odbaciti i neće biti spremljena. Priređivač o tome neće dobiti povratnu informaciju.

Osim ID-a povezane transakcije, potrebno je navesti datum i vrijeme slanja povezane transakcije.

3.6.1 Ispravak ispravka

Broj ispravaka koji se mogu poslati za neku transakciju nije ograničen. U slučaju slanja ponovnog ispravka, ID povezane transakcije mora biti jednak ID-u posljednje poslane transakcije, odnosno ID-u posljednje poslanog ispravka. Ukoliko priređivač prilikom slanja ponovnog ispravka u ID-u povezane transakcije navede ID transakcije koju je već bio ispravio, takva transakcija, iako formalno ispravna i uspješno zaprimljena u Ministarstvu financija, provjerom prilikom integracije podataka će se odbaciti i neće biti spremljena. Priređivač o tome neće dobiti povratnu informaciju.

Također, u slučaju da priređivač u ID-u povezane transakcije navede ID koji ne postoji u bazi Ministarstva financija, takva transakcija, iako formalno ispravna i uspješno zaprimljena u Ministarstvu financija, provjerom prilikom integracije podataka će se odbaciti i neće biti spremljena. Priređivač o tome neće dobiti povratnu informaciju.

TS1 v1.0 36/43

Page 37: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

3.6.2 Poništavanje (brisanje) prethodno poslanih transakcija

U slučaju da je priređivač greškom poslao transakciju koju nije trebao poslati, odnosno koja ne postoji u njegovom sustavu, takvu transakciju može poništiti, odnosno obrisati slanjem transakcije ZaglavljeTransakcijaBrisanje.

Ova transakcija sadrži elemente ranije definiranog Zaglavlja, s razlikom da je u ovom slučaju obvezna upotreba elementa Povezana transakcija kako bi se eksplicitno navela transakcija na koju se operacija poništavanja (brisanja) odnosi. Odgovornost je priređivača ispravno povezati ID transakcija prilikom poništavanja (brisanja). Ova transakcija se koristi za poništavanje, odnosno brisanje svih vrsta transakcija koje priređivač šalje Ministarstvu financija.

ZaglavljeTransakcijaBrisanje

Naziv podatka Tip podatka Duljina Pojavnost/ obaveznost Opis

ID Guid 36 1 Identifikator transakcije. Guid.

OIB Numeric 11 1 OIB priređivača. DatumVrijeme DateTime 25 1 Datum i vrijeme slanja

transakcije. PovezanaTransakcija 1 Podaci o transakciji koja se

želi poništiti (obrisati). ID Guid 36 1 Identifikator transakcije

koja se želi poništiti (obrisati).

DatumVrijeme DateTime 25 1 Datum i vrijeme slanja transakcije koja se želi poništiti (obrisati).

Slika 10: Schema poruke ZaglavljeTransakcijaBrisanje

TS1 v1.0 37/43

Page 38: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

3.6.3 Poništavanje poništene transakcije

Poništenje transakcije se ne može poništiti (vratiti u stanje prije brisanja). U slučaju da priređivač u ID-u povezane transakcije navede ID transakcije koja je bila poništena, takva transakcija, iako formalno ispravna i uspješno zaprimljena u Ministarstvu financija, provjerom prilikom integracije podataka će se odbaciti i neće biti spremljena. Priređivač o tome neće dobiti povratnu informaciju.

Ukoliko je priređivač greškom poništio transakciju, to može ispraviti jedino slanjem te transakcije kao nove, koja će imati uobičajeno Zaglavlje, novi ID i neće sadržavati ID povezane transakcije.

3.6.4 Ispravak poništenja (brisanja)

Nije dozvoljeno slanje ispravaka poništenih transakcija. U slučaju da priređivač u ID-u povezane transakcije navede ID transakcije koja je bila poništena, takva transakcija, iako formalno ispravna i uspješno zaprimljena u Ministarstvu financija, provjerom prilikom integracije podataka će se odbaciti i neće biti spremljena. Priređivač o tome neće dobiti povratnu informaciju.

TS1 v1.0 38/43

Page 39: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

4 Sigurnost sustava nadzora

4.1 Integritet podataka

Integritet podataka ne čuva se kroz tehnološke standarde i mogućnosti, već je predmet povjerenja i internih procedura stranaka u interakciji.

4.2 Dostupnost

Ministarstvo financija, Porezna uprava je odgovorna za osiguravanje dostupnosti CIS sustava.

4.3 Autentičnost

Priređivači Internet casina se autenticiraju kroz proces rukovanja (uspostava HTTPS-a). Proces rukovanja moguće je započeti isključivo korištenjem unaprijed prijavljenog PKI certifikata.

4.4 Neporecivost

Sustav ne zahtijeva neporecivost podataka (poslanih poruka). Eventualne nesuglasice riješit će Nadzor Porezne uprave.

TS1 v1.0 39/43

Page 40: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

5 Pregled tehnoloških preduvjeta spajanju na CIS Porezne uprave

Za uspostavu veze sa CIS Porezne uprave priređivači moraju nabaviti certifikate izdane od strane FINA RDC CA.

5.1 Produkcijska okolina

Certifikat

Certifikat mora biti registriran na ime

icasina{skraćenica_klijenta}.{internet_domena_klijenta}. Detalji vezani za certifikate opisani su u poglavlju 7. Dodatak.

URL usluge

Prihvat poruka administrativnog nadzora:

https://cis.porezna-uprava.hr:8443/iCasinaPromjenaStatusaService

Prihvat poruka izvještajnog nadzora:

https://cis.porezna-uprava.hr:8443/iCasinaIzvjestajiService

Poruke Poruke se oblikuju sukladno SOAP 1.1 standardu. Pri tome usluga u tijelu ovojnice očekuje poruku sukladnu shemi zadanoj u WSDL-u.

5.2 Testna okolina

Certifikat

Certifikat mora biti registriran na ime

icasina{skraćenica_klijenta}test.{internet_domena_klijenta}. Detalji vezani za certifikate opisani su u poglavlju 7. Dodatak.

URL usluge

Prihvat poruka administrativnog nadzora:

https://cistest.apis-it.hr:8443/iCasinaPromjenaStatusaServiceTest

Prihvat poruka izvještajnog nadzora:

https://cistest.apis-it.hr:8443/iCasinaIzvjestajiServiceTest

Poruke Poruke se oblikuju sukladno SOAP 1.1 standardu. Pri tome usluga u tijelu ovojnice očekuje poruku sukladnu shemi zadanoj u WSDL-u.

TS1 v1.0 40/43

Page 41: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

6 Podrška u radu

Upiti priređivača Internet casina vezano za pitanja pravne ili poslovne prirode dostavljaju se na email adresu Porezne uprave [email protected].

APIS IT pruža podršku priređivačima Internet casina vezano za tehničke specifikacije te tehničke probleme u povezivanju na CIS Porezne uprave putem email adrese [email protected]. Naslov maila treba sadržavati „iCasina“.

TS1 v1.0 41/43

Page 42: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

7 Dodatak

Kao davatelj usluge PKI-a odabrana je FINA registar digitalnih certifikata. Korisnički poslužitelji na testnoj i produkcijskoj okolini moraju imati izdan RDC certifikat od FINA-e koji će se koristiti pri uspostavi veze s provjerom poslužiteljskih certifikata CIS Porezne uprave i korisnika (dvostruko rukovanje).

Poslužiteljski certifikati koje koriste CIS pristupne točke imaju sljedeća skraćena imena:

1. Testna okolina: cistest.apis-it.hr 2. Produkcijska okolina: cis.porezna-uprava.hr

Puno ime se može saznati pretraživanjem FINA LDAP-a gdje bi se certifikati trebali nalaziti u grani „ou=POSLOVNI,ou=RDC,o=FINA,c=HR“ . Također, može ih se dohvatiti na FINA RDC stranicama.

Korisnik je zadužen, prema proceduri FINA RDC-a, zatražiti upis u registar (ukoliko već nije upisan) te zatražiti izdavanje certifikata. Budući da CIS Porezne uprave ima dvije okoline (testnu i produkcijsku), potrebna su i dva certifikata. Prije priključenja na CIS pristupnu točku korisnik mora dojaviti jasno ime (DN) certifikata Poreznoj upravi. Bez ovog koraka povezivanje neće biti moguće.

CIS Porezne uprave očekuje sljedeća imena korisničkih certifikata:**

1. Testna okolina: icasina{skraćenica_klijenta}test.{internet_domena_klijenta} 2. Produkcijska okolina: icasina{skraćenica_klijenta}.{internet_domena_klijenta}

Korisnički certifikati bi se također trebali nalaziti u grani „ou=POSLOVNI, ou=RDC, o=FINA, c=HR“.

Sve dodatne informacije o izdavanju certifikata možete dobiti na http://fina.hr/finadigicert.

**Napomena: Priređivači koji već posjeduju certifikate za priređivanje igara klađenja mogu koristiti postojeće certifikate i ne moraju tražiti izdavanje novih certifikata za priređivanje igara Internet casina.

TS1 v1.0 42/43

Page 43: Tehnička specifikacija sučelja za razmjenu poruka nadzora ... vijesti/TS1.pdf · REPUBLIKA HRVATSKA . Ministarstvo financija . Porezna uprava . Tehnička specifikacija sučelja

8 Prilozi

Prilog ovom dokumentu je datoteka „iCasina – WSDL i XSD datoteke za razmjenu poruka v1.0.zip“

TS1 v1.0 43/43