REQUIREMENTS

Mercur
-----------------------------------------
Terminal Management System (TMS)
------------------------------------------
Terminal Management System centralna web orjentirana aplikacija koja se koristi za vođenje evidencije korisnika, prodajnih mjesta i terminala, te udaljeno konfiguriranje i podešavanje POS kasa. Na taj način TMS ima sve podatke za rekonstrukciju POS kase u slučaju kvara i gubitka podataka na POS kasi, bez potrebe za ručim podešavanjem POS kase.
Prilikom povezivanja sa TMS serverom, ukoliko ima novih podataka na serveru za dotičnu POS kasu, POS kasa preuzima podatke te sukladno njima ažurira lokalne podatke na POS kasi. Preporučena dinamika sinkronizacije je jednom dnevno kod zatvaranja dana.
TMS podržava više institucija, tj nadzor POS kasa za više trgovačkih društava, pri čemu svako društvo može imati više POS kasa. Trgovačka društva imaju ograičen pristup podacima samo za svoja prodajna mjesta i terminale.



4.2 Baza podataka TMS servera
TMS server vodi ažurne podatke o terminalima (POS kasa) te klijentima (trgovačko društvo, obrt).
4.2.1 Podaci o trgovačkom društvu (TD)
• ID trgovačkog društva – interni ID u TMS bazi
• Naziv trgovačkog društva
• OIB trgovačkog društva - OIB
• Adresa trgovačkog društva (napomena, ovo nije adresa poslovnog prostora!)
o Ulica
o KucniBroj
o KucniBrojDodatak
o BrojPoste
o Naselje
o Opcina
• Certifikat porezne uprave
• Status (aktivan, upozoren, privremeno blokiran, neaktivan)
• Korisničko ime administratora (ovlaštene osobe)
• Lozinka administratora (ovlaštene osobe)
4.2.2 Podaci o poslovnom prostoru
Svaki poslovni prostor je jedinstveno identificiran unutar jednog trgovačkog društva tvz. MIID i podaci su razmjenjeni sa FINA serverom. Vidi FINA specifikacije 2.2.2 Primjer poruke zahtjeva za podatke o poslovnom prostoru.
• ID trgovačkog društva kojem pripada poslovni prostor
• MIID poslovnog prostora - OznPoslProstora
• Naziv poslovnog prostora
• Adresa poslovnog prostora
o Ulica
o KucniBroj
o KucniBrojDodatak
o BrojPoste
o Naselje
o Opcina
• RadnoVrijeme
• DatumPocetkaPrimjene (dd.mm.gggg)
• Oznaka zatvaranja: Z- zatvoren, O- Otvoren
4.2.3 Podaci o terminalima
• TID - jedinstveniID terminala u TMS bazi
• TIID – jedinstvena oznaka terminala unutar poslovnog prostora
• MIID – oznaka pripadajućeg poslovnog prostora
• Sigurnosni master ključ
• ID pripadajućeg trgovačkog društva
• Podržani načini plaćanja
• Pripadajuća datoteka sa cjenikom
• Pripadajuća datoteka sa izgledom listića
• Pripadajuća datoteka sa blagajnicima
• Pripadajući certifikat porezne uprave – ID certifikata iz certificate store-a
4.2.4 Datoteka sa cjenikom
Datoteka sa podacima o proizvodima i uslgama kreira se ručno ili kroz web sučelje za krajnjeg korisnika, a sadrži slijedeće podatke o proizvodima i uslugama:
• Šifra proizvoda ili usluge
• Naziv proizvoda ili usluge
• Grupa proizvoda ili usluga (ukoliko je organizirano u menijima)
• Jedinica mjere
• Cijena sa porezom
• Porezna stopa
Naziv datoteke:TID_cjenik.dat
Datoteka je u CSV formatu sa delimiterom ; između polja, a za novi slog CRLF. Prvi red treba sadržavati nazive stupaca.
• Grupa;sifra;naziv;jed_mjere;cijena;stopa_PDV;stopa_PNP;stopa_ostalo_PNL;PDV_free;marza;stopa_marza
• Torte;K001;Torta eliksir 22cm;kom;100.00;25.00;3.00;;NO;;;
• Torte;K002;Torta schwartzwald 22cm;kom;200.00;25.00;3.00;;NO;;;
• Kolači;K003;Štrudla od jabuke;kom;15.00;25.00;3.00;;NO;;;
• Kolači;K004;Štrudla od višanja;kom;10.00;25.00;3.00;;NO;;;
• Sokovi;K005;Voda Jana;kom;7.25;10.00;3.00;;NO;;;

4.2.5 Pripadajuća datoteka sa izgledom listića
Datoteka definira izgled listića pojedinog prodajnog mjesta u skladu sa dogovorenim formatom:
• Logotip
• Organizacija podataka na listiću (fiksni i varijabilni podaci iz baze)
4.2.6 Podaci o prodavačima (blagajnicima)
• ID prodavača
• Lozinka
• TID terminala na kojem (kojima) radi prodavač
4.2.7 Crna lista i warning lista
Moguće je ručno ili putem batch datoteke učitati crnu listu ili warning listu, odnosno postaviti odgovarajuće statuse krajnjeg klijenta.
Statusom trgovačkog društva „upozoren“ kod otvaranja dana generira se poruka koja se ispisuje na ekranu (opcionalno i na listiću), npr: „Istekao je rok za plaćanje mjesečnog najma POS kase. Molimo platite račun“
Statusom trgovačkog društva (privremeno blokiran) kod otvaranja dana generira se poruka koja se ispisuje na ekranu (opcionalno i na listiću) npr: „Istekao je rok za plaćanje mjesečnog najma POS kase. Račun privremeno blokiran“ te se blokira rad POS kase.
4.2.8 Logovi sa podacima o komunikaciji sa terminalom
TMS bilježi svu komunikaciju sa terminalom, dolazne i odlazne poruke, statuse, nazive razmjenjenih datoteka i sl.
Također se bilježe sve aktivnosti na podacima za pojedinoprodajno mjesto.
TMS treba bilježiti za svaku konfiguracijsku datoteku kad aje uspješno učitana na terminal. Ukoliko je nakon tog vremena bilo izmjena parametara koji se nalaze u dotičnoj datoteci, postavlja se jedna ili više oznaka za učitavanje datoteke na POS termina.
4.3 Udaljena sinkronizacija parametara na POS kasi
Nakon što su unešeni svi potrebni podaci i konfigurirane sve datoteke iz poglavlja 4.2. na TMS serveru, te nakon javljana POS kase, TMS šalje na POS kasu datoteke, temeljem kojih POS kasa sinkronizira lokalne parametre.
Za ostvarivanje sinkronizacije na POS kasi je nužno ručno unijeti slijedeće podatke:
• TID – ID terminala
• Parametre konekcije na internet
• Pristupne podatke za TMS server
• Sigurnosni master ključ (opcionalno)
Redovnim dnevnim spajanjem POS kase, TMS šalje na kasu slijedeće podatke za sinkronizaciju POS kase, (moguća je parcijalna sinkronizacija, ovisno što je ažurirano na TMS serveru):
• Naziv prodajnog mjesta
• Adresa prodajnog mjesta
• Podržani načini plaćanja
• Pripadajuća datoteka sa podacima o proizvodima i uslugama
o Naziv proizvoda ili usluge
o Grupa proizvoda ili usluga
o Jedinica mjere
o Cijena
o Porezna stopa
• Pripadajuća datoteka sa izgledom listića (računa)
• Pripadajuća datoteka sa listom trgovaca i autentikacijskim parametrima
• Pripadajuća datoteka sa logotipom
• Pripadajući certifikat porezne uprave
• Poruka za trgovca (warning ili crna lista)

4.4 Komunikacija između POS kase i TMS-a
Svu komunikaciju inicira terminal.
4.4.1 Zahtjev terminala za ažuriranje podataka
Terminal šalje na server upit o raspoloživim novim konfiguracijskim datotekama.
Ukoliko na TMS-u postoji promjena unutar neke od datoteka, ili nekog od parametara, server na upit šalje odgovarajuće datoteke. Ukoliko nema ažuriraniih datotela, terminal odgovara odgovarajućom porukom.
->Update request
<-No update
4.4.2 Ažuriranje cjenika
Terminal ima mogućnost ažuriranja cjenika na terminalu. Nakon što je ažuriran cjenik terminal kod prvog zatvaranja dana šalje i ažurnu datoteku sa cjenikom. TMS treba prihvatiti datoteku i adresirati ju umjesto postojeće.
4.4.3 Upload izdanih računa
Treminal šalje datoteke sa izdanim računima tekućeg dana odnosno od zadnjeg zatvaranja računa. TMS smješta datoteke na file server u odgovarajući folder i indeksira ih prema slijedećim podacima
• ID trgovačkog društva
• Datum izdavanja računa
Poruke će se definirati kasnije obostrano između TMS i POS programera.
 
4.5 Korisnička sučelja TMS servera
4.5.1 Administracijsko korisničko sučelje
Svi podaci iz prethodnog poglavlja unose se kroz administracijsko sučelje od strane HT-a ili ETRANET GRUPE sukladno poslovnoj proceduri prijave i upravljanja korisnicima. Osim unosa kroz web forme, moguć je bulk unos podataka putem XML ili XLS datoteka.
Moguć je i parcijalan unos podataka, npr: HT unosi podatke o krajnjem korisniku, a ETRANET GRUPA unosi podatke o temrinalima, prodajnim mjestima, proizvodima i uslugama.
Administrativno osoblje ima pristup slijedećim ekranima
4.5.1.1 Ekran sa evidencijom trgovačkih društava
Kroz GUI, administrator može pregledavati, ažurirati postojeće podatke te dodavati nova trgovačka društva, pripadajuća prodajna mjesta i terminale.
Dodavanje novih trgovačkih društava odvija se u slijedećim koracima
1) Unos osnovnih parametara o trgovačkom društvu (podaci iz poglavlja 4.2.1)
a. Odabirom datoteke sa X509 certifikatom, pripadajući certifikat se veže uz trgovačko društvo i nasljedno za sva prodajna mjesta trgovačkog društva i sve terminale
2) Unos pripadajućih prodajnih mjesta (4.2.2)
3) Unos pripadajućih terminala (4.2.3)
4) Kreiranje cjenika (4.2.4)
a. Cjenik se može kreirati kroz formu na ekranu ili učitavanjem xls datoteke odgovarajućeg formata
b. Editiranje cijenika se vrši kroz formu na ekranu
5) Učitavanje logotipa trgovačkog društva (opcionalno ukoliko trgovačko društvo želi ispisivati logotip na listiću)
a. Logotip će biti u odgovarajućem slikovnom formatu
6) Pridjeljivanje standardnog izgleda listića terminalu (TID)
a. Izgled listića definiran je odgovarajućom datotekom
b. Predviđeno je da će 90% trgovačkih društava imati isti izgled listića, osim drugačijeg logotipa
c. Za TD koja će imati drugačiji izgled listića, kreira se datoteka (vanjski proces) i učitava u TMS, te pridjeljuje terminalu (TID)
Trgovačka društva se mogu pretraživati po nazivu, TIDu podržanih terminala i sl.

4.5.1.2 Ekran za pregled izdanih računa
Budući da TMS arhivira izdane računa, račune je moguće pretraživati po
• Trgovačkom društvu
o Dodatni ključ pretraživanja je vremensko razdoblje
• Broju računa
• JIR-u
Rezultat pretraživanja je tablica sa osnovnim podacima o računima (datum, vrijeme, broj računa, JIR, ID trgovačkog društva) te opcijom za otvaranje pojedinog računa. Otvoreni račun (pdf čitač) se može ispisati.
Nije moguće brisanje ili prepravljanje računa.
4.5.2 Korisničko sučelje za krajnjeg korisnika
Korisnik (trgovačko društvo ili obrt) se prijavljuju na korisničko sučelje putem korisničkog imena i lozinke admimistratora društva. Korisnik može unositi ili ažurirati slijedeće podatke:
• Naziv(e) prodajnog(ih) mjesta i druge podatke
• Adresa(e) prodajnog(ih) mjesta
• Podržane načine plaćanja
• Podatke o proizvodima i uslugama (podaci iz poglavlja 3.1.3)
• Podatke o blagajnicima i njihove autentikacijske parametre (korisničko ime i lozinka)
• Učitati datoteku sa logotipom
• Učitati certifikat porezne uprave
TD ima pristup ekranu za dohvat svojih izdanih računa.