PFR & Middleware
Sertifikati, procesori fiskalnih računa & middleware
CALCULUS12 KORISNIČKO UPUTSTVO
Sertifikati, procesori fiskalnih računa & middleware
CALCULUS12 KORISNIČKO UPUTSTVO
Prvi korak eFiskalizacije je instalacija opštih RCA i ICA sertifikata za bezbednosnu karticu (BE). Ovi sertifikati se instaliraju nezavisno od toga da li koristite Pametnu (Poresku) karticu ili softverski sertifikat za registraciju poslovnog prostora. RCA i ICA sertifikati su za sve korisnike isti i preuzimaju se sa sajta Poreske uprave:
Da biste instalirali RCA sertifikat, pratite sledeće korake:
a) Izaberite Local Machine.
b) Na sledećem prozoru odaberite Place all certificates in the following store i kliknite na Browse.
c) Izaberite Trusted Root Certification Authorities.
Da biste instalirali ICA sertifikat, pratite sledeće korake:
a) Izaberite Local Machine.
b) Na sledećem prozoru odaberite Place all certificates in the following store i kliknite na Browse.
c) Izaberite Intermediate Certification Authorities.
Posle instalacije opštih sertifikata prelazite na instaliranje softverskog lokalnog procesora fiskalnih računa LPFR. Lokalni procesor fiskalnih računa (LPFR) uvek se instalira na lokaciji izdavanja računa
Preduslovi i tehnički zahtevi za instaliranje softverskog LPFR-a:
U najvećem broju slučajeva dovoljan je jedan LPFR po poslovnom objektu, ali ostaje mogućnost i da svaki ESIR ima svoj LPFR. Važno je da znate da u slučaju da koristite samo jedan LPFR za prodajni objekat sa više Calculus Kasa, računar na kome je instaliran LPFR mora biti stalno aktivan da bi radile ostale Calculus Kase.
eFiskalizator 2022 je razvijen za 32-bit ili 64-bit Windows OS 7 (SP1 6.1.7601), Windows 8.1 ( (Upd.1) 6.3.9600; 6.2.9200; 6.3.9200), Windows 10 (od 10.0.10240 do (21H2) 10.0.19044); Windows 11 ( (2021) 10.0.22000).
Pored navedenog operativnog sistema, preduslov za funkcionisanje jeste i povezan čitač pametnih kartica, u koji je potrebno staviti Bezbedonosni element BE, odnosno karticu dobijenu od Poreske Uprave za konkretno prodajno mesto.
Ukoliko je eFiskalizator 2022 instaliran na drugom računaru u odnosu na računar na kome se izvršava ESIR Calculus Kasa ver.950/2022.A, potrebno je obezbediti lokalnu mrežnu konekciju između navedena dva računara. U slučaju instalacije na isti računar na kome je instaliran i ESIR Calculus Kasa ver.950/2022.A, koristi se lokalni mrežni interfejs (localhost).
Nakon pokretanja aplikacije, pojavljuje se ikonica na liniji poslova u delu za notifikacije Windows operativnog programa, gde je vizuelno prikazan status u kome se program nalazi (zeleno svetlo ako je LPFR u potpuno operativnom stanju, žuto ako postoje određena upozorenja koja zahtevaju pažnju korisnika ili crveno ukoliko postoji neki problem koji je potrebno otkloniti za normalno funkcionisanje programa, vidi sliku).
Prva stavka provere prilikom Inicijalizacije odnosi se na potrebu da na računaru budu instalirani sertifikati Poreske uprave za uspostavljanje sigurne konekcije između programa eFiskalizator 2022 i servera Poreske uprave.
Program će prvo proveriti da li su instalirani svi potrebni sertifikati Poreske uprave. Ukoliko sertifikati nisu instalirani na računaru, eFiskalizator će pokušati automatski da instalira potrebne sertifikate. Neophodno je da program bude pokrenut u administratorskom režimu rada.
Ukoliko program ne uspe da automatski instalira potrebne sertifikate obavestiće korisnika da nisu zadovoljeni potrebni uslovi i uputiće korisnika da ručno instalira potrebne sertifikate.
Po uspešnoj instalaciji i proveri sertfikata korisnik će biti obavešten da je prva stavka uspešno završena, vidi sliku.
Druga stavka provere prilikom Inicijalizacije odnosi se na potrebu da na računaru bude priključen čitač pametnih kartica i u njega ubačen bezbednosni element (kartica poreske uprave) za to prodajno mesto.
Program prvenstveno detektuje da li je prisutan čitač kartica a potom da li je ubačen bezbednosni element. Ukoliko bilo koji od ovih uslova nije zadovoljen korisniku se prikazuje adekvatna poruka. Ukoliko bilo koji od ovih uslova nije zadovoljen korisniku se prikazuje adekvatna poruka.
Ukoliko su čitač i kartica prisutni program pristupa očitavanju sertifikata sa kartice i podešavanju atributa prodajnog mesta na osnovu očitanih informacija. Ukoliko je u pitanju prvo pokretanje programa korisniku će biti prikazan dijalog za unos PIN-a za aktivaciju kartice, vidi sliku.
Treća stavka provere prilikom Inicijalizacije odnosi se na licencu za korišćenje programa. Prvenstveno se putem Internet konekcije sa servisa proizvođača povlači aktuelna licenca. Za licenciranje se koriste informacije očitane sa Bezbednosnog Elementa, Konkretno Poreski Identifikacioni Broj (PIB) i Jedinstveni Identifikator (JID). Na osnovu tih informacija korisniku se izdaje licencni kod koji se sastoji od 4 polja po 5 karaktera.
Ukoliko Internet veza nije dostupna proverava se prisustvo licence u lokalnom skladištu. Ukoliko je licenca istekla korisnik se usmerava na ručni unos licence, vidi sliku.
Četvrta stavka prilikom Inicijalizacije odnosi se na podizanje servisa za fiskalizaciju. Program prvo proverava da li je servis već podignut. Ukoliko jeste program sam sebi šalje statusni upit i ukoliko dobije uspešan odgovor potvrđuje stavku.
Ukoliko servis nije podignut program podiže servis ili na inicijalnom portu (8058) ili na portu koji je ranije konfigurisan. Ukoliko se servis uspešno podigne, program sam sebi šalje statusni upit i ukoliko dobije uspešan odgovor potvrđuje stavku, vidi sliku.
Peta stavka prilikom Inicijalizacije odnosi se na preuzimanje i proveru LPFR konfiguracije.
Da bi eFiskalizator 2022 radio u punom kapacitetu potrebno je da ima konfiguraciju osnovnih atributa potrebnih za povezivanje na servise Poreske uprave, potom za upravljanje poreskim stopama kao i za proveru podešavanja vremena. Potrebne informacije stižu putem Interneta sa servisa Poreske uprave u obliku komandi koje se izvršavaju u programu i beleže se informacije u lokalnom skladištu, vidi sliku.
Šesta stavka prilikom Inicijalizacije odnosi se na sinhronizaciju programa sa pouzdanim izvorom vremena.
eFiskalizator 2022 na ključnim tačkama i u redovnim intervalima proverava sinhronizovanost vremena.
Odstupanje od 1 do 3 minuta - servis pouzdanog vremena dostupan
Ukoliko program detektuje da postoji odstupanje računarskog vremena na kome radi eFiskalizator 2022 od pouzdanog vremena sa Interneta od jednog do tri minuta sistem će iskazati upozorenje korisniku, preneti sistem u narandžasti status, prikazati očitano vreme sa Interneta i sugerisati korisniku da podesi vreme na računaru i potom pokrene ponovno izvršavanje provere (vidi sliku).
Tek nakon uspešno završenih svih koraka inicijalizacije, LPFR prelazi iz statusa nije inicijalizovan (sivo, vidi sliku):
eFiskalizator 2022 omogućuje praćenje statusa putem ikonice na sistemskoj liniji (System Tray) delu linije poslova (Slika 73), kao i na glavnom statusnom prozoru aplikacije, kad se isti otvori.
Mogući statusi su:
Zamena BE dovodi do ponovnog iščitavanja svih podataka iz sertifikata poreskog obveznika sa ubačene BE, kao i brisanja memorisanog PIN-a.
Po zameni BE, LPFR će proći ponovo proceduru inicijalizacije, bez potrebe za intervencijom od strane korisnika, osim ukoliko bude detektovan problem tokom ponovne inicijalizacije sa novim BE.
LPFR eFiskalizator 2022 obezbeđuje standardni REST API interfejs putem koga ESIR Calculus Kasa ver.950/2022.A komunicira. Interfejs je realizovan u potpunosti prema tehničkom uputstvu, a prema definisanom protokolu od strane Poreske Uprave. Puna URL adresa se može videti na statusnom prozoru (vidi sliku).
ESIR Calculus Kasa ver.950/2022.A može inicirati očitavanje statusa i pratećih podataka putem pokretanja status komande, pri čemu će odgovor biti vraćen u formatu definisanom u tehničkom uputstvu PU. Pored standardnih kodova statusa, biće vraćeni i dodatni kodovi, definisani u poglavlju Greške i upozorenja.
LPFR fiskalizuje račune u lokalu, bez potrebe za aktivnom Internet konekcijom. Fiskalizovani račun se pre vraćanja odgovora ESIR-u Calculus Kasa ver.950/2022.A smešta u lokalnu bazu podataka, odakle kasnije sledi iščitavanje, udaljeno ili lokalno.
LPFR prati status kartice i čitača i u slučaju detektovanja vađenja kartice prelazi u status greške, i vraća neki od kodova grešaka, u zavisnosti od konkretnog problema. Ukoliko se LPFR nalazi u nekom od statusa greške, odmah će odbiti zahtev za fiskalizacijom. Takođe, u slučaju neuspešnog potpisivanja od strane BE, LPFR će odbiti zatev Calculus Kase i vratiti odgovarajući kod greške, u skladu sa tehničkim uputstvom PU.
ESIR Calculus Kasa ver.950/2022.A može kreirati sledeće tipove računa: Promet, Kopija, Obukai Predračun. U budućim verzijama planira se i kreiranje tip računa Avans. Po iniciranju zahteva od strane Calculus Kase, izvršiće se inicijalna provera strukture i prosleđenih vrednosti za kreiranje računa (obavezna polja, dužina i provera tipa podataka).
Biće izvršena i dodatna provera datuma i vremena, tako da trenutno vreme ne sme biti manje od vremena kreiranja prethodnog fiskalnog računa, potom provera da RequestId nije već obrađen. Na kraju, biće proveren raspoloživi prostor na fizičkom memorijskom medijumu (tvrdi disk računara) i u slučaju nedostatka prostora zahtev za kreiranjem računa će biti odbijen.
Zatim će biti obračunate poreske stope za svaku stavku računa, u skladu sa prosleđenim labelama za svaki artikal i vrednostima poreskih stopa dobijenim od PU. Zaokruživanje dobijenih iznosa se vrši na 4 decimale metodom HalfRoundUp. Ukoliko je BE dostupan, kao i PIN u internoj memoriji, sledi digitalno potpisivanje računa sa trenutnim datumom i vremenom. Jednom potpisan račun se šifrira AES-256 algoritmom, uz upotrebu jednokratno generisanog ključa, potom se ključ šifrira javnim ključem PU očitanim iz digitalnog sertifikata sa BE.
Potom se tako zaštićeni račun i ključ spremaju u paket za iščitavanje koji se čuva u lokalnoj, integrisanoj bazi podataka. Ni jedan paket neće biti obrisan iz baze ukoliko nije dobijena potvrda o iščitavanju. Nakon uspešnog čuvanja u bazi podataka L-PFR kreira žurnal fajl i generiše URL za proveru ispravnosti (verifikaciju) računa. Potom čuva spremljen odgovor uz zahtev u bazi podataka i šalje fiskalizovane podatke u Calculus Kasu, u sklopu odogovora na zahtev za fisklaizaciju računa.
Ceo proces fiskalizacije jednog računa traje približno 0,5 sekundi. Imajući u vidu da eFiskalizator 2022 podržava istovremeni prijem i obradu više zahteva, usko grlo predstavlja samo potpisivanje računa koje vrši BE. Sve ostale obrade zavise pre svega od performansi računara na kome se LPFR izvršava. Možemo zaključiti da ovako realizovan LPFR nikako ne ugrožava rad i performanse Calculus Kase.
U slučaju da Calculus Kasa ne dobije odgovor u predviđenom roku, potrebno je proveriti status fiskalizacije računa kako ne bi došlo do duple fiskalizacije računa. Provera statusa se vrši pozivom rute api/v3/invoices/*requestId*. Upravo zbog ove provere je poželjno slati jedinstveni RequestId kao deo HTTP zaglavlja prilikom svakog zahteva za fiskalizacijom računa.
Preporučeni tok komunikacije između Calculus Kase i LPFRa je:
1. Calculus Kasa poziva POST /api/v3/invoices rutu, sa JSON zahtevom za fiskalizacijom računa i jedinstvenim RequestId u HTTP Header
2. LPFR odgovara sa:
2.1. 200 OK, JSON response, sa fiskalizovanim računom
2.2. 200 OK, sa JSON Error model, greška za konkretno polje zahteva
2.3. 400 Bad Request, sa konkretnim kodom greške
2.4. Ne odgovara u vremenu podešenom na strani Calculus Kase kao connection ili HTTP request timeout
2.4.1. Calculus Kasa poziva GET /api/v3/invoices/*requestId*
2.4.2. LPFR odgovara sa:
2.4.2.1. 200 OK, JSON response, račun fiskalizovan
2.4.2.2. 200 OK, prazan odgovor - fiskalizacija računa nije uspela!
2.4.2.3. 200 OK, "4005" - Fiskalizacija računa u toku
2.4.2.3.1. Calculus Kasa ponavlja korak 2.4.1, dok ne dobije odgovor kao u koraku 2.4.2.1 ili 2.4.2.2
2.4.2.3.2. Calculus Kasa ne želi više da čeka na odgovor i:
2.4.2.3.2.1. Poziva POST /api/v3/restart rutu
2.4.2.3.2.2. Čeka N sekundi, i poziva GET /api/v3/attentionrutu sve dok ne dobije 200 OK, potom ide dalje
2.4.2.3.2.3. Poziva POST api/v3/pin rutu
2.4.2.3.2.4. Ponavlja korak 2.4.1. i dobija konačni status fiskalizacije računa, kao u koraku 2.4.2.1. ili 2.4.2.2.
2.4.2.3.2.5. Calculus Kasa štampa račun ili odbacuje račun, u zavisnosti od odgovora
LPFR generiše žurnal u skladu sa tehničkim uputstvom. Na sledećoj slici dat je primer generisanog žurnala, vidi sliku.
LFPR generiše i jedinstveni verifikacioni URL, kao i njegovu grafičku reprezentaciju u formi QR koda, u koji ugrađuje sve neophodne parametre i na način definisan u Tehničkoj dokumentaciji.
Primer generisanog URLa:
https://sandbox.suf.purs.gov.rs/v/?vl=A1BTTk5ON...
Primer generisanog QR koda, vidi sliku.
Pored standardnih API ruta, eFiskalizator 2022 nudi i dodatne usluge putem sledećih ruta:
1. Ruta GET / api / v3 / lpfr-status, vraća status samog LPFRa, broj neposlatih/nepotvrđenih računa i datum isticanja licence
2. Ruta POST / api / v3 / restart restartuje LPFR aplikaciju i može se koristiti u slučaju problema sa karticom (greška 2220) ili drugih problema u komunikaciji sa LPFR-om
3. Ruta GET api / v3 / card vraća podatke sa BE o poreskom obvezniku
4. Dnevna statistika o prometu (YYYY-MM-DD) dostupna do 7 dana unazad, kroz rute:
4.1. GET / api / v3 / stats odgovor je 200 OK i JSON sa ukupnim prometom i refundacijom, po svakoj od poreskih stopa i svakom od načina plaćanja za tekući dan
4.2. GET / api / v3 / stats / {date} Datum u YYYY-MM-DD formatu (primer: 2021-12-28) Odgovor je 200 OK ako je datum validan i JSON sa ukupnim prometom i refundacijom, po svakoj od poreskih stopa i svakom od načina plaćanja za tekući dan ili 400 Bad Request za nevalidan datum
5. Ako Calculus Kasa želi da koristi statistiku prodaje po smenama, iz menija Podešavanja potrebno je aktivirati opciju Rad u smenama, posle čega sledeće rute postaju aktivne:
5.1. Statistika prometa za tekuću smenu GET / api / v3 / shift
Odgovor je 200 OK i JSON sa ukupnim prometom i refundacijom, po svakoj od poreskih stopa i svakom od načina plaćanja za tekuću smenu
5.2. Statistika prometa za smenu GET / api / v3 / shift / {id}
Odgovor je 200 OK i JSON sa ukupnim prometom i refundacijom, po svakoj od poreskih stopa i svakom od načina plaćanja za odabranu smenu ili 400 Bad Request za nevalidan ID smene
5.3. Kraj smene i početak nove smene POST / api / v3 / shift
Odgovor je 200 OK i JSON sa ukupnim prometom i refundacijom, po svakoj od poreskih stopa i svakom od načina plaćanja za upravo zatvorenu smenu
LPFR eFiskalizator 2022 komunicira sa veb servisima Sistema za upravljanje fiskalizacijom SUF u skladu sa tehničkim vodičem PU. Na početku očitava Api URL iz sertifikata snimljenog u BE. Isti sertifikat se koristi za uspostavljanje TSL sigurne konekcije ka SUF veb servisima. Potom se putem rute api/v3/sdc/token zahteva autorizacioni token. Sva dalja komunikacija se autorizuje uz pomoć dobijenog tokena.
Odmah nakon dobijanja tokena poziva se ruta /api/v3/sdc/commands putem koje se zahtevaju komande sa osnovnim komunikacionim parametrima, adresom NTP servera kao i poreske stope. Tek nakon dobijanja navedenih komandi, LPFR može preći u operativno stanje i primati dalje zahteve za fiskalizacijom.
Na svakih više od 5 minuta poziva se ruta /api/v3/sdc/audit-proof, putem koje se šalje ARP generisan od strane BE. Takođe se šalju i neposlati a fiskalizovani računi na rutu /api/v3/sdc/audit. Ista ruta se poziva i odmah pošto se izvrši fiskalizacija svakog računa.
Komanda PoA (Proof of Audit), kao i druge komande, može stići od PU kao odgovor na svaki od poziva ka SUF veb servisu. Prilikom stizanja komande, ista se bez odlaganja izvršava na BE, i u slučaju potvrdnog odgovora paketi sa uspešno poslatim računima se označavaju kao iščitani, nakon čega je dozvoljeno njihovo brisanje iz lokalne baze podataka. Komande se obrađuju isključivo u pristiglom redosledu. Nakon uspešnog izvršavanja svake od komandi, šalje se potvrda putem SUF veb servisa.
Na svakih 5 minuta LPFR poziva i /api/v3/sdc/notify rutu, čime obaveštava SUF veb servise o svom aktivnom statusu.
Osim standardnih grešaka definisanih u tehničkom vodiču, eFiskalizator 2022 vraća i sledeće greške i upozorenja do kojih može doći u svakodnevnom radu:
Šifra |
Opis |
Tip |
3000 |
Nepoznata greška
|
Greška |
3001 |
Potrebna reinicijalizacija
|
Greška |
3002 |
Sertifikat istekao
|
Greška |
3003 |
Iščitavanje nije završeno više od 5 dana
|
Greška |
3004 |
Razlika između NTP vremena i lokalnog vremena veća od 3 minuta
|
Greška |
3005 |
Vreme nije sinhronizovano duže od 48 sati
|
Greška |
3006 |
Datum izdavanja računa mlađi od poslednjeg već fiskalizovanog računa
|
Greška |
3007 |
RequiestId je već registrovan
|
Greška |
3008 |
Licenca istekla
|
Greška |
3009 |
Ne postoji poreska stopa za poslati datum računa
|
Greška |
3010 |
Na lokalnom skladištu ima manje od 100mb slobodno
|
Greška |
4000 |
Iščitavanje nije završeno više od 3 dana, manje od 5 dana
|
Upozorenje |
4001 |
Razlika programskog vremena u odnosu na NTP vreme veća od 1 minuta, manje od 3 minuta
|
Upozorenje |
4002 |
Sertifikat ističe za manje od 30 dana
|
Upozorenje |
4003 |
Licenca ističe za manje od 7 dana
|
Upozorenje |
4004 |
TaxCore API nije dostupan
|
Upozorenje |
4005 |
Fiskalizacija računa u toku
|
Upozorenje |
4006 |
Neuspešno kreiran audit paket |
Upozorenje |
eFiskalizator 2022, kao komercijalno rešenje za LPFR, poseduje mehanizam licenciranja opisan u ovom poglavlju.
Licence se izdaju za svaku instalaciju LPFR-a u formatu jedinstvenog koda dužine 20 karaktera. Licence mogu važiti 1 mesec, 3 meseca, 6 meseci ili godinu dana. Prilikom prve instalacije i ubacivanja bezbedonosnog elementa, LPFR će poslati podatke: PIB i JID do licencnog servera, nakon čega će automatski biti generisana probna licenca sa probnim periodom važenja.
Nakon toga, potrebno je da se kupi licenca za naredni vremenski period.
Nakon instalacije neophodno je da korisnik pošalje e-poštu na adresu podrska@calculus.rs sa sledećim podacima:
Uputstvo za instalaciju i integraciju sa Calculus Kasom ver.950/2022.A
Pokrenite Setup.exe i pratite dalja uputstva ispisana u prozoru instalacije. Nakon instalacije FoxCreek-CP softvera, aplikaciju pokrenuti putem ikonice na desktopu.
Otvorite START meni u Windows operativnom sistemu, i potražite FoxCreek CP aplikaciju. Pokrenite je kao administrator, vidi sliku.
Pre svakog pokretanja LPFR-a, potrebno je da unesete PIN za Vaš bezbednosni element.
U predviđeno polje unesite vaš PIN za pristup Bezbednosnom elementu. Nakon toga pritisnite dugme Napred, ili ENTER na tastaturi, vidi sliku.
FoxCreek SDC podržava sve vrste čitača Iso7816 smart kartica, bilo u standardnom (full-size) format, ili drugom formatu podržanom od strane vašeg operativnog sistema. Aplikacija održava stalnu komunikaciju sa smart karticom, i po potrebi očitava podatke kao što su sertifikat privrednog subjekta, TaxCore ključ za šifrovanje podataka i druge podatke neophodne za fiskalizaciju računa i komunikaciju sa Sistemom za upravljanje fiskalizacijom (SUF).
Nije moguće fiskalizovati račune preko LPFR-a bez prethodno očitanog bezbednosnog elementa i verifikovanog PIN koda.
Putem konfiguracionog panela, podešavamo sve neophodne parametre za funkcionisanje komponenti (mikroservisa) potrebnih za rad LPFR-a i komunikaciju sa Calculus Kasom i SUF-om, vidi sliku.
Ukoliko je potrebno da LPFR bude dostupan programu Calculus Kasa koji je instaliran na lokalnom računaru, za IP adresu koristite localhost, a port 7788 možete zameniti ukoliko je već zauzet. Ukoliko želite da LPFR bude dostupan aplikacijama u lokalnoj mreži, unesite ručno IP adresu vašeg računara (npr. 192.168.1.3), vidi sliku.
Da biste omogućili instalaciju ažuriranja, izaberite folder na vašem računaru, gde će komponente (servisi) biti otpakovane i instalirane. Da biste završili sa podešavanjima, pritisnite Snimi, vidi sliku.
LPFR se može ažurirati u bilo kom momentu preko FoxCreek-CP aplikacije. Nove verzije, dodatke i drugo, preuzimate klikom na dugme AŽURIRAJ SOFTVER, (vidi sliku).
Izaberite komponentu koju ažurirate ili instalirate, vidi sliku.
Izaberite verziju softvera i pritisnite dalje, vidi sliku.
Uspešno ste instalirali novu verziju, vidi sliku.
Da bi LPFR postao funkcionalan i vidljiv aplikacijama u lokalnoj mreži, neophodno je pokrenuti FoxCreek LPFR web i windows servise, pritiskom na dugme Pokreni LPFR (Connect SDC), Pokreni Server (Notifikacije) i Pokreni Audit (servis za komunikaciju sa SUF-om). Za fiskalizaciju računa, nije potrebna stalna internet veza, vidi sliku
LPFR za potpisivanje svih računa, koristi isključivo bezbednosni element, i putem APDU komandi preuzima podatke kao što su brojač, digitalni potpis, sertifikat, serijski broj, PIB, javni ključ i sve što je neophodno za fiskalizaciju računa i skladištenje šifrovanih datoteka spremnih za dalje očitavanje.
Slanje Audit dataoteka (očitavanje), sinhronizacija sata, izvršavanje komandi, dnevnih izveštaja sa nuliranjem, može se izvršiti u bilo kojem momentu tokom radnog dana. Putem adminstrativnog panela, dobijamo pristup setu LPFR komandi koje se mogu izvršiti.
Komande se izvršavaju asinhrono, tako da ne ometaju fiskalizaciju novih računa. LPFR nema ograničenja u broju računa koje može fiskalizovati i skladištiti bez internet konekcije, i to zavisi isključivo od kapaciteta računara i operativnog sistema korisnika.
LPFR čuva sve podatke o fiskalizovanim računima na lokalnom disku (hard disk, USB, flash memorija itd), i može im se pristupiti i nakon gubitka napajanja električnom energijom.
Preuzimanje informacije o verziji softvera može se izvršiti u Administrativnom panelu, klikom na dugme Informacije o verziji. Takođe se može videti i u statusu LPFR web servisa. Nakon uspešnog preuzimanja podataka iz LPFR servisa, verzija i naziv softvera će biti prikazan u desnom delu prozora, vidi sliku.
Sve dodatne informacije o operacijama koje se asinhrono izvršavaju od strane LPFR-a, kao što je slanje Audit paketa, kao i Proof of Audit zahteva, prikazuju se na ekranu korisnika putem sistemskih notifikacija. Ovaj način prikazivanja poruka, kompatibilan je sa svim Microsoft Windows operativnim sistemima, bez ikakve dodatne konfiguracije od strane korisnika.
LPFR putem Sistema za upravljanje fiskalizacijom, prilikom prvog pokretanja LPFR-a sa novom smart Poreskom karticom, preuzima token za pristup SUF-u, a zatim komande za konfigurisanje, poreske grupe i druge podatke za svaki novi bezbednosni element koristeći sertifikat preuzet iz BE za identifikaciju. Preuzimanje i izvršavanje komandi, kao i slanje odgovora se vrši automatski, periodično, a moguće je izvršiti i ručno preuzimanje putem administrativnog panela, vidi sliku.
Obaveza svakog poreskog obaveznika je da sinhronizuje datum i vreme lokalnog sistema sa NTP serverom, na svakih 48 sati. Ova operacija se izvršava asinhrono, pritiskom na dugme Sync clock. Nakon uspešnog izvršavanja komade, vreme će biti ažurirano, vidi sliku.
U slučaju da je potrebno ručno pokrenuti isporuku Audit fajlova na SUF, to je moguće uraditi pritiskom na dugme Start audit. Nakon uspešno izvršene komande, LPFR će vratiti podatke o svim Audit fajlovima koji još uvek nisu isporučeni na SUF, a zatim će se pokušati ponovno slanje. Ova akcija je asinhrona, i rezultat će biti prikazan na ekranu korisnika nakon dobijanja odgovora SUF-a, vidi sliku.
Da bismo učitali komande i druge neophodne podatke za rad ili konfigurisanje LPFR-a, potrebno je pritisnuti dugme Execute from USB. Na ovaj način, LPFR-u će biti poslat signal da pretrazi prenosivi disk (usb memoriju) za komandama za aktivni bezbednosni element, vidi sliku.
Da bismo proverili da li ima neizvršenih komandi na portalu SUF-a, potrebno je pritisnuti dugme Notify commands. Ukoliko su prethodno svi Audit fajlovi poslati u SUF, komanda za nuliranje prometa automatski će se izvršiti nakon odgovora SUF-a, vidi sliku.
Slanje zahteva za nuliranje tekućeg prometa, može se započeti pritiskom na dugme Proof of Audit. Na ovaj način LPFR-u se šalje signal da je neophodno poslati podatke o prometu na SUF. Ova operacija obuhvata ukupan promet do momenta izvršavanja ove komande, vidi sliku.
Virtualne procesore fiskalnih računa (VPFR), se nalazi u mreži Poreske uprave. Podrazumeva se da VPFR koji se nalazi na serverima Poreske uprave (i besplatan je za korišćenje), poreski obveznici mogu koristiti samostalno samo prilikom online prodaje.
Bezbednosni element za VPFR predstavlja fajl (sa sertifikatom) koji se dobija preko portala Poreske uprave i koji je jedinstven za svaki VPFR.
Fajl sa sertifikatom se može koristiti isključivo za "online" trgovinu obzirom da je ova delatnost oslobođenja obaveze da poseduje LPFR.
U maloprodaji obveznik fiskalizacije ima mogućnost korišćenja VPFR koji se nalazi na serverima Poreske uprave, ali samo uz obavezno korišćenje minimalno jednog LPFR po prodajnom objektu. Dakle, svaki obveznik je obavezan da u svakom od svojih prodajnih objekata ima bar jedan elektronski fiskalni uređaj koji koristi lokalni procesor fiskalnih računa, i da obezbedi njihov kontinuirani rad koji će omogućiti izdavanje fiskalnih računa čak i u slučaju prekida internet veze (podrazumeva se stalna internet veza u svim objektima).
POS2SDC je Middleware namenjen integraciji POS aplikacije CALCULUS KASA ver.950/2022.A i Procesora Fiskalnih Računa (PFR). PFR može biti lokalni ili virtualni. Program POS2SDC iz serije rešenja M.R.S. - MetaLINE RETAIL Solutions razvila je METADATA d.o.o. (info@metadata.rs). Lokalni PFR može biti hardverski ili softverski. Electronski fiskalni uređaj (EFU) se sastoji iz jednog elektronskog sistema za izdavanje računa (ESIR), jednog procesora fiskalnih računa (PFR) i bezbednosnog elementa (BE) - sve povezano u jedan elektronski sistem.
ESIR Calculus Kasa se sastoji iz POS aplikacije KASA i middleware aplikacije POS2SDC.
POS2SDC program je middleware ( međuprogram) - između:
POS2SDC je razvijen za 32-bit ili 64-bit Windows OS (7, 8.1, 10, 11, ...).
Operativni sistem Windows |
Verzija |
Windows 11 (2021) |
10.0.22000 |
Windows 10 (20H2) |
10.0.19042 |
Windows 8.1 (Upd.1) |
6.3.9600 |
Windows 7 |
SP1 6.1.7601 |
Procesor: Celeron, Pentium, DualCore, QuadCore
Memorija: 2 GB or higher (4 GB preporučeno)
Tvrdi disk: 1,0 GB slobdnog prostora
Grafička kartica: rezolucija minimum 1024 x 768, minimum 256 boja
Preporučuje se besprekidno napajanje UPS (eng. Uninterrupted Power Supply) i hlađenje što boljeg kvaliteta.
Preuzmite autorizovani instalacioni fajl POS2SDC_SETUP_r10.EXE klikom na link u e-pošti koju ste dobili od Calculusa doo.
Neautorizovanu instalaciju POS2SDC preuzmite klikom na link:
POS2SDC_SETUP_r10.EXE.
Najnoviji upgrade POS2SDC kao autoraspakivajuću arhivu preuzmite sa linka:
POS2SDC_SE.exe.
Instalaciona procedura zahteva pristup sistemskim folderima Windows-a, tako da instalaciju možete pokrenuti samo sa nalogom koji ima dodeljena administratorska prava. Ako Vaš nalog nema administratorska prava, na OS Windows Server-u 2003, instalaciju možete pokrenuti sa "Run as ...", a na Visti, Windows Server-u 2008 i Windows-u 7, 8, 10 i 11 operativnim sistemima će sam ponuditi da pokrenete instalaciju sa drugim korisničkim nalogom ili ga možete pokrenuti sa "Run as administrator".
Ukoliko je vaš PC povezan na internet, provera licence je automatizovana putem web servisa. Ukoliko Vaša interna politika sigurnosti mreže, ne dozvoljava izlazak van VPN-a, kopirajte dobijeni Licence file u C:\POS2SDC\ApplData.
TIP LICENCE
Pretplatna licenca je kompletno funkcionalna licenca ograničenog trajanja od 12 meseci. Važi za rad u produkcionom okruženju (SUF Produkcija). Licenca uključuje sve minor verzije (10.x.xxx), i podršku trećeg nivoa (pristup najvišem nivou informacija o softveru) putem e-pošte. Ova licenca je komecijalna, i nakon isteka perioda važenja, može se obnoviti.
ISTEK LICENCE
Licence UVEK ističe u Ponedeljak u 23:59:59, tj. kada startujete program sledećeg jutra, neće raditi. Ukoliko licenca ističe Utorak, Sreda, Četvrtak, pomera se unazad na ponedeljak. Ukoliko licenca ističe u Petak, Subota, Nedelja, pomera se unapred na ponedeljak.
C:\POS2SDC (u Registry bazi:
+---ApplData
| POS2SDC.ini (User Settings)
| 100205629_R5YQ7M3W.lic (license file TIN_SERNUM) ukoliko je neophodno.
+---DataBase
| | POS2SDC.mlf (u Registry bazi: DB_Fullname)
| +---ArchiveDB
| | POS2SDC.mlf.2021-11-12
| +---BackupDB
| | POS2SDC.mlf.2021-11-12
| +---ClearDB
| POS2SDC.mlf
| +---Certificate
+---ExchData (u Registry bazi: Exchange_Root)
| +---Archive za original fatoteke
| +---Export za exportovane datoteke
| +---SDC_Inp podaci koji se šalju ka PFR
| +---SDC_Out podaci koje vraća PFR
+---Logs
| POS2SDC_log.txt (opšti log)
| Started_log.txt (vreme kada je POS2SDC start / stop)
+---Others
| +---Commands
| Archive_DB.cmd (za arhiviranje bazePOS2SDC.mlf)
| CopyClear_DB.cmd (za oporavak baze POS2SDC.mlf)
| Delete_ERR.cmd (brisanje datoteka sa greškama /SDC_OUT)
| Midas.cmd (za aktiviranje MIDAS komponente)
| +---Scripts
| Archive_DB.vbs (Script za arhiviranje POS2SDC.mlf)
| CopyClear_DB.vbs (Script za oporavak baze POS2SDC.mlf)
| POS2SDC_Win32.reg (Win32 registry)
| POS2SDC_Win64.reg (Win64 registry)
| +---UserDocumentation
+---RunTime
| POS2SDC.exe (Izvršni program)
+---TempDir
+---Utility_SA
| TeamViewer-QS.exe (freeware za udaljenu podršku)
| 7ZIP.exe (freeware za ZIP/UNZIP)
Pre pokretanja POS2SDC programa, OBAVEZNO prvo pokrenite odabrani L-PFR. Obratite pažnju na boju ikonice, (vidi sliku).
U interaktivnom načinu rada definišete radno okruženje (virtuelno ili lokalno), kao i izbor sertifikata sa kojim želite da radite. Takođe je namenjen za ručno testiranje računa, za analizu odgovora od PFR, i pripremu zahteva za izmenama u Vašoj POS aplikaciji.
U ovom način rada možete generisati primere sa ili bez Calculus Kase, praveći različite kombinacije, testirati različite tipove računa. U interaktivnom načinu rada možete testirati oba okruženja (virtuelni ili lokalni PFR).
Uvek kada pokrenete program Calculus Kasa, u pozadini se (kao servis) automatski pokreće program POS2SDC u "skrivenom" (listening) načinu rada u modu SUF Produkcija.
"Skriveni" način rada kada program POS2SDC osluškuje (eng. listening) sa komandne linije možete ručno pokrenuti unosom sledeće komande za rad sa virtuelnim procesorom fiskalnih računa (V-PFR):
RUN POS2SDC.EXE softcode PAK
"Skriveni" način rada kada program POS2SDC osluškuje (eng. listening) sa komandne linije možete ručno pokrenuti unosom sledeće komande za rad sa virtuelnim procesorom fiskalnih računa (V-PFR):
RUN POS2SDC.EXE softcode PAK JID (sertifikata)
Prilikom rada ESIR Calculus Kase preko Remote Desktop Connections (RDC), POS2SDC i LPFR instaliraju na lokalni računar. Na udaljenom računaru potrebno je da se u inicijalni fajl pop97.ini koriguju putanje, kao u primeru koji sledi:
To=\\tsclient\c\pos2sdc\exchdata\sdc_inp\
From=\\tsclient\c\pos2sdc\exchdata\sdc_out\
Arh=\\tsclient\c\pos2sdc\exchdata\archive\
Kod prijave na POS2SDC podrazumevana lozinka za interaktivan način rada je "login". Ukoliko radite sa lokalnim procesorom fiskalnih računa (L-PFR) posle logovanja unesite PIN kod (sastoji se uvek od 4 cifre). Ukoliko radite sa virtuelnim procesorom fiskalnih računa (V-PFR) unesite PAK kod (koji uvek sadrži 6 slova).
Calculus pravilo: Svako ponovno pokretanje programa Calculus Kasa ili programa POS2SDC, zahteva ponovni unos PAK/PIN koda. Ukoliko kasir zaboravi PAK/PIN kod, dalji rad sa Calculus Kasom nije moguć. Iz tog razloga rukujte sa njima pažljivo. Ukoliko "izgubite" PAK/PIN, morate podneti novi zahtev da dodelu sertifikata po standardnoj proceduri, vidi sliku:
Sa leve strane prozora nalazi se glavni meni aplikacije. POS2SDC omogućava rad Calculus Kase sa virtuelnim (V-PFR) i lokalnim (L-PFR) procesorima fiskalnih računa. U interaktivnom načinu rada, možete podesiti radno okruženje u zavisnosti od izabranog LPR (lokalnog ili virtuelnog), vidi sliku:
Klikom na dugme "4. Util" otvarate meni koji omogućava da izvršite promene lozinki, vidi sliku:
Prilikom pokretanja programa Calculus Kasa automatski se izvršava niz komandi od kojih se OBAVZNO izvrašava komanda "Proveri PAK" ili "Proveri PIN". Pored ove provere automatski se proverava komanda o porezima, komanda za PFR i provera poslovnog prostora.
Komanda o Porezima - SUF Produkcija
Komanda GET-TAXGROUPS,0 - sa parametrom 0 izveštaj sadrži poreske labele označene ćiriličnim slovoma.
zahtev |
odgovor |
CMD_Tax.CSV |
CMD_Tax_resp.txt |
GET-TAXGROUPS,0 |
1,А,0.00,0,"није у ПДВ",1,2021-11-01T01:00:00 1,Г,0.00,0,"Без ПДВ",4,2021-11-01T01:00:00 1,Ђ,20.00,0,"О-ПДВ",2,2021-11-01T01:00:00 1,Е,10.00,0,"П-ПДВ",3,2021-11-01T01:00:00 |
Gr. |
Lab. |
PDV |
Kat. |
Naziv kat. |
Red. |
Datum |
1 |
А |
0 |
TaxOnNet |
Није у ПДВ |
1 |
2021-11-01T01:00:00 |
1 |
Г |
0 |
TaxOnNet |
Без ПДВ |
4 |
2021-11-01T01:00:00 |
1 |
Ђ |
20 |
TaxOnNet |
О-ПДВ |
2 |
2021-11-01T01:00:00 |
1 |
Е |
10 |
TaxOnNet |
П-ПДВ |
3 |
2021-11-01T01:00:00 |
Zahtev |
Odgovor |
CMD_Tax.CSV |
CMD_Tax_resp.txt |
GET-TAXGROUPS,0 |
1,01,0.00,0,"није у ПДВ",1,2021-11-01T01:00:00 1,04,0.00,0,"Без ПДВ",4,2021-11-01T01:00:00 1,06,20.00,0,"О-ПДВ",2,2021-11-01T01:00:00 1,07,10.00,0,"П-ПДВ",3,2021-11-01T01:00:00 |
Gr. |
Lab. |
PDV |
Kat. |
Naziv kat. |
Red. |
Datum |
1 |
01 |
0 |
TaxOnNet |
Није у ПДВ |
1 |
2021-11-01T01:00:00 |
1 |
04 |
0 |
TaxOnNet |
Без ПДВ |
4 |
2021-11-01T01:00:00 |
1 |
06 |
20 |
TaxOnNet |
О-ПДВ |
2 |
2021-11-01T01:00:00 |
1 |
07 |
10 |
TaxOnNet |
П-ПДВ |
3 |
2021-11-01T01:00:00 |
zahtev |
odgovor |
CMD_GET-PFR.CSV |
CMD_GET-PFR_resp.txt PIB,SerBroj sertifikata,LPFR,okruženje |
GET-PFR, |
100205629,DWE2VRZL,99-3010-Dt1Ov1o0,DEV 100205629,DWE2VRZL,99-3010-Dt1Ov1o0,PROD |
zahtev |
odgovor |
CMD_GET-BUNIT.CSV |
CMD_GET-BUNIT_resp.txt PIB, NazivFIrme,Poslovni Prostor, Opština, Adresa PP |
GET-BUNIT, |
"100205629","Metadata d.o.o.","1034507-radnja #1", "Нови Београд","Bul. A. Čarnojevića 104" |
zahtev |
odgovor |
CMD_HELLO-PFR.CSV |
CMD_HELLO-PFR_resp.txt Status, DateTime |
HELLO-PFR, |
ACTIVE/AKTIVAN,2021-10-29T18:03:37+02:00 |
zahtev |
odgovor |
CMD_Hello- Pos2Sdc.CSV |
CMD_Hello-Pos2Sdc_resp.txt Status,DataTime |
HELLO-POS2SDC |
ACTIVE/AKTIVAN,2021-10-29T18:03:37+02:00 |
Komanda,
|
Odgovor |
GET-TAXGROUPS, |
Labele svih grupa poreza (arhivskih, tekućih, budućih)
|
GET-PFR, |
100205629,DWE2VRZL,99-3010-Dt1Ov1o0,DEV
|
GET-BUNIT, |
"100205629","Metadata d.o.o.","1034507- Test radnja #1", "Нови Београд", "Bul. A. Čarnojevića 104",
|
REPRINT, |
Možete ponovo odštampati račun "ext-filename", u slučaju "gužvanja" ili nestanka papira (samo u toku dana), pre zatvaranja programa Kasa.
Napomena: ovo možete koristite samo za reprint računa koji u sebi imaju klauzulu: CustomizedExport,xxx odnosno koji su automatski odštampani. |
HELLO-PFR, |
ACTIVE/AKTIVAN,2021-10-29T18:03:37+02:00
|
HELLO-POS2SDC, |
ACTIVE/AKTIVAN,2021-10-29T18:03:37+02:00
|
GET-LAST,ext-filename |
Zahtev za ponovni odgovor na već poslati zahtev, u slučaju nestanka struje i sl. Dobijate kao odgovor: _basic, _vurl a ako je moguće i _journal i _qrcode.gif
Napomena: za račune izdate u minimum zadnjih 7 dana.
|
GET-ENV |
Vraća SUF okruženje u JSON formatu. File: LM3MKTVB_environment.json za Helpdesk, samo u slučaju rešavanja problema. |
GET-STATUS |
Vraća SUF status u JSON formatu. File: LM3MKTVB_status.json za Helpdesk, samo u slučaju rešavanja problema. |
STOP-POS2SDC, |
Prekida rad programa, da bi novim pozivom pokrenuo rad sa drugim sertifikatom CERT (card, pfx). |
Komanda,parametar |
Opis |
X-REPORT, 2021-12-01 |
Ukupna prodaja (total_amount) u danu, grupisana po RequestBy,SignedBy,TT |
SALE-REPORT,2021-12-01 |
prodaja u danu, grupisana po RequestBy,SignedBy,TT, poreskoj stopi |
TAX-REPORT,2021-12-01 |
Porezi u danu, grupisana po po RequestBy,Signedby,TT, poreskoj stopi |
PAY-REPORT,2021-12-01 |
Plaćanja u danu, grupisana po RequestBy,SignedBy,TT, tipu plaćanja |
INV-REPORT,2021-12-01 |
Lista računa u toku dana, sortirana po RequestBy,SignedBy, count1,count2,TT,iznos |
Komanda,parametar |
Opis |
X-REPORT, 2021-121 |
Ukupna prodaja (total_amount) u mesecu, grupisana po RequestBy,SignedBy,TT |
SALE-REPORT,2021-12 |
prodaja u mesecu, grupisana po RequestBy,SignedBy,TT, poreskoj stopi |
TAX-REPORT,2021-12 |
Porezi u mesecu, grupisana po po RequestBy,Signedby,TT, poreskoj stopi |
PAY-REPORT,2021-12 |
Plaćanja u mesecu, grupisana po RequestBy,SignedBy,TT, tipu plaćanja |
INV-REPORT,2021-12 |
Lista računa u toku meseca, sortirana po RequestBy,SignedBy, count1,count2,TT,iznos |