1. 🧩 Uvod
Raverus je open‑source projekt koji pruža modul za komunikaciju s CIS serverom Porezne uprave. CIS svakom računu dodjeljuje JIR – jedinstveni identifikator koji se mora ispisati na računu. Program radi u pozadini kao systray ikona i služi kao posrednik između POS sustava i Porezne uprave.
✅ Kratke upute za korisnike
⚠️ Problemi s fiskalizacijom računa (JIR / broj računa)
🔍 Kada provjeriti račun?
Nakon svakog fiskaliziranog računa provjerite:
- Je li JIR dobiven
- Je li JIR različit od prethodnog računa
❗ Ako JIR nedostaje ili je isti kao prethodni
U većini slučajeva problem se može ispraviti automatski: 👉 Odabir računa → Ponovljeni Ova opcija ponovno šalje račun na Poreznu upravu i ispravlja JIR.
🚫 Važno
- Ne brišite fiskalizirane račune.
- Ako “Ponovljeni” ispravi račun → nastavite raditi.
- Ako se problem ponavlja → kontaktirajte podršku.
🔳 QR kod
- Od 2021. račun mora sadržavati QR kod.
- Program ga generira automatski.
💡 Savjet: Povremeno skenirajte QR kod radi provjere fiskalizacije.
🛠️ Tehnička verzija (za podršku i napredne korisnike)
🔐 Certifikati (napredno)
📦 Što su .pfx i .p12 datoteke?
📦 .pfx datoteka
- Format: PKCS#12
- Sadrži: certifikat, privatni ključ, lanac certifikata
- Zaštićena lozinkom
- Najčešći format u Windows okruženju
📦 .p12 datoteka
- Također PKCS#12
- Identican sadržaj kao .pfx
- Češće korišten u Linux/Java okruženju
🔑 Razlika između .pfx i .p12
- Tehnički nema razlike
- Razlikuju se samo po ekstenziji
- Ako aplikacija traži .pfx, a imate .p12 → može se preimenovati
📁 Gdje instalirati certifikat?
✔️ Preporučeno:
👉 LocalMachine\My Certifikat je dostupan svim korisnicima i servisima.
❌ Izbjegavati:
- Desktop
- Download folder
- Slanje .pfx mailom bez enkripcije
- Držanje lozinke u .txt datotekama
⚙️ PowerShell – preporučeni način za uvoz i izvoz certifikata
PowerShell je pouzdaniji od MMC‑a jer:
- uvijek uvozi certifikat s exportable privatnim ključem
- izvoz je pouzdan
- radi i na serverima bez GUI‑ja
- izbjegava MMC bugove
- idealno za automatizaciju
🧰 PowerShell primjer – uvoz .p12 i izvoz u .pfx
💡 Savjet: Ako aplikacija ne vidi certifikat → privatni ključ nije exportable.
# Putanja do originalnog .p12 certifikata
$p12Path = "D:\Cert\FISKAL_CERT.p12"
# Lozinka za .p12 certifikat
$p12Password = ConvertTo-SecureString -String "Lozinka123" -Force -AsPlainText
# Uvoz certifikata u LocalMachine\My s exportable ključem
$cert = Import-PfxCertificate -FilePath $p12Path -CertStoreLocation "Cert:\LocalMachine\My" -Password $p12Password -Exportable
# Putanja za izvoz .pfx fajla
$pfxPath = "D:\Cert\FISKAL_EXPORT.pfx"
# Lozinka za novi .pfx fajl
$pfxPassword = ConvertTo-SecureString -String "Lozinka123" -Force -AsPlainText
# Izvoz certifikata u .pfx
Export-PfxCertificate -Cert $cert -FilePath $pfxPath -Password $pfxPassword💡 Savjet: Ako aplikacija ne vidi certifikat → privatni ključ nije exportable.
🧩 MMC postupak – uvoz i izvoz certifikata
📥 Uvoz certifikata (.p12 / .pfx)
- Win + R → mmc
- File → Add/Remove Snap‑in
- Certificates → Add
- Computer account → Local computer
- Personal → Certificates
- All Tasks → Import
- Obavezno označiti: ✔️ Mark this key as exportable
📤 Izvoz certifikata
- Personal → Certificates
- All Tasks → Export
- ✔️ Yes, export the private key
- ✔️ Include all certificates in the certification path
- Postaviti lozinku
- Spremiti .pfx
⚠️ Kada MMC može stvarati probleme?
- nema opcije “Export private key”
- certifikat je u krivom spremištu
- privatni ključ nije exportable
- instaliran pod krivim korisnikom
👉 U tim slučajevima PowerShell je sigurniji.
⚙️ Osnovno podešavanje programa
🔐 Preduvjet
- Certifikat mora biti instaliran ili spremljen na disk.
▶️ Prvo pokretanje
- Nakon pokretanja pojavljuje se systray ikona.
- Prvi put: desni klik → Namještanja.
- Obavezno ispuniti karticu System.
💡 Savjet: Nakon instalacije fiskalizirajte jedan probni račun.
Request / Response datoteke
- 📥 Request file – POS puni
- 📤 Response file – POS čita
⚠️ Važno: POS mora obrisati response file nakon čitanja.
🗂️ Log folder
- Nije obavezan
- Preporučuje se kod novih instalacija i nestabilnih mreža
⏱️ Timeout
- Nestrpljivi: 2–3 s
- Strpljivi: 9–10 s
⚠️ Manji timeout = veća šansa za grešku.
🔄 Polling period
- 0 s → .NET watcher
- 1–2 s → ako watcher ne radi (mrežni diskovi)
📴 Offline mode
- Ne šalje podatke na CIS
- Vraća samo ZKI
- Računi se šalju kad internet proradi
⚠️ Račun nije fiskaliziran dok se ne pošalje.
🚫 Višestruke instance
- Program sprječava pokretanje više instanci.
📬 Response file – struktura
Ispravan response izgleda ovako: JIR;UUID;ZKI;KontrolniBroj
- 🔑 JIR – 36 znakova
- 🆔 UUID – 36 znakova
- 🛡️ ZKI – 32 znaka
- 🔢 Kontrolni broj – 20 znakova
❗ Greške u response fileu
1) Greška s vraćenim ZKI‑jem
- JIR i UUID prazni
- ZKI postoji
💡 Račun se može ispisati, ali ga treba ponovno poslati.
2) Teška greška – nema ni ZKI‑ja
- Response file prazan ili nepotpun
❗ Račun se NE SMIJE ispisati. Kupcu se izdaje ručni paragon.
🕒 Točan datum i vrijeme
- CIS odbija račune s krivim timestampom
⚠️ Ako se BIOS resetira → fiskalizacija prestaje raditi.
🔳 QR kod
- Obavezan od 2021.
- Program ga generira automatski
💡 Povremeno skenirajte QR kod.
💻 Ostalo
- Program je 32‑bitni
- Radi na svim Windowsima
- Koristi .NET 4.5
🗄️ Registry kontrola broja računa
Lokacija: HKCU\Software\Fiska
- Sprema datum i broj zadnjeg računa
- Svaki sljedeći račun mora imati veći datum i broj
⚠️ Kritično upozorenje
- Nikada ne brišite fiskalizirani račun
- Provjerite JIR nakon fiskalizacije
- Ako JIR nedostaje odabeite Fiskalizacija → Odabir računa → Ponovljeni
- Ako se ne može ispraviti → ručno obrisati registry ključ
💡 Uvijek prvo pokušajte opciju Ponovljeni.