Uputstvo za instalaciju

Otkucaj, registarski naziv „Otkucaj“ · verzija 1.3.6 · otkucaj.com · Korisničko uputstvo · Uputstvo za konfiguraciju

Sve što ovaj dokument kaže o propisima je naše razumevanje, a ne pravni ni poreski savet; pre odluke proverite kod knjigovođe ili u Poreskoj upravi.

Sadržaj

• 1.Šta se instalira, a šta ne
• 2.Načini isporuke
• 3.Varijanta A: rad preko interneta
• 4.Varijanta B: lokalna instalacija u poslovnom prostoru
• 5.Nadogradnja verzije
• 6.Rezervna kopija i vraćanje
• 7.Deinstalacija
• 8.Kontrolna lista posle instalacije

1.Šta se instalira, a šta ne

Elektronski fiskalni uređaj čine tri elementa: ESIR, PFR i bezbednosni element. Ovim uputstvom se instalira samo prvi od njih. Otkucaj jeste ESIR: prikuplja stavke, popuste, plaćanja i podatke o kupcu, sastavlja zahtev, šalje ga PFR-u i prikazuje i štampa račun koji PFR vrati. On ne fiskalizuje račune, ne dodeljuje PFR broj ni brojač i ne potpisuje račun.

L-PFR se nabavlja i instalira odvojeno. Lokalni procesor fiskalnih računa je zaseban program ili uređaj, sa sopstvenim odobrenjem Poreske uprave i sopstvenim evidencionim brojem. Instalira ga njegov isporučilac, po svom uputstvu, i to pre ili posle Otkucaja, svejedno. Otkucaj se na njega samo povezuje preko mreže, što je postupak iz poglavlja 4.7 ovog uputstva. Ako obveznik još nema L-PFR, instalacija Otkucaja se dovodi do kraja i ostavlja u demo režimu, a veza se podešava kad L-PFR stigne.

Bezbednosni element izdaje Poreska uprava obvezniku i on se ne instalira ovim uputstvom. U obliku pametne kartice stoji u čitaču L-PFR-a i njime potpisuje sam L-PFR; Otkucaj kartici ne pristupa. U obliku datoteke (.pfx ili .p12) koristi se uz V-PFR i postavlja se kroz Podešavanja, što je opisano u Uputstvu za konfiguraciju. Nijedan bezbednosni element se ne kopira u direktorijume programa ručno.

2.Načini isporuke

Otkucaj se isporučuje na tri načina. Program je u sva tri isti, baza podataka i podešavanja su u sva tri ista, a razlikuju se samo po tome na kom računaru program radi i ko ga postavlja. Obveznik u svakom trenutku može preći sa jednog načina na drugi, jer se cela instalacija svodi na bazu podataka i jednu konfiguracionu datoteku.

Izbor načina isporuke povezan je sa izborom PFR-a. Uz V-PFR Poreske uprave rade oba načina, jer je stalna veza sa internetom ionako uslov rada. Uz L-PFR radi samo lokalna instalacija, zato što L-PFR sa Otkucajem razgovara preko lokalne mreže objekta, a server u oblaku u tu mrežu ne može da uđe. Kako mi razumemo čl. 6 st. 4 Zakona o fiskalizaciji, obveznik koji radi sa V-PFR-om mora u svakom poslovnom prostoru kome je dodeljen JID da ima i L-PFR, osim ako promet na malo obavlja isključivo preko interneta ili prodaje sopstvena korišćena pokretna materijalna sredstva; Otkucaj sa L-PFR-om radi samo kao lokalna instalacija.

3.Varijanta A: rad preko interneta

U ovoj varijanti se ne instalira ništa na server: program već radi na adresi otkucaj.com. Instalacija se svodi na otvaranje naloga, instalaciju aplikacije na uređaj kasira i proveru štampe.

3.1 Otvaranje i odobravanje naloga

Otvorite https://otkucaj.com/registracija i popunite poslovno ime, PIB, matični broj, broj telefona, e-poštu, korisničko ime i lozinku od najmanje 10 znakova. PIB (9 cifara) i matični broj (8 cifara) proveravaju se po kontrolnoj cifri, a telefon mora biti broj iz Srbije, mobilni ili fiksni. Sa jedne mrežne adrese prihvata se najviše 5 registracija na sat.

Nalog se otvara neaktivan i prijava sa njim nije moguća dok ga administrator ne odobri. To je namerno: prijava mora da prođe kroz nekoga ko zna da je obveznik stvaran. Ako su obaveštenja podešena, administrator o novoj registraciji dobija poruku odmah. Po aktivaciji korisnik se prijavljuje uobičajeno, korisničkim imenom i lozinkom.

3.2 Prva prijava i vodič kroz prve korake

Otvorite https://otkucaj.com/prijava i prijavite se. Obrazac je zaštićen nevidljivom proverom (Cloudflare Turnstile), koja ne traži slagalice ni prekucavanje znakova; ako servis provere trenutno nije dostupan, prijava prolazi i bez nje. Posle 8 pogrešnih pokušaja u minutu prijava se sa te mrežne adrese privremeno zaključava.

Polje Ostani prijavljen na ovom uređaju je označeno unapred i na kasi u objektu ga treba ostaviti tako: kasir se prijavljuje jednom i ostaje prijavljen i posle gašenja računara. Na tuđem ili deljenom računaru ga isključite. Prijava na svim uređajima se prekida u Podešavanja, Korisnici, dugmetom Odjavi me svuda, a isto se dešava i pri promeni lozinke ili deaktivaciji naloga.

Pri prvoj prijavi otvara se kratak vodič kroz pet koraka: osnove Kase, kartice otvorenih računa, vrste računa i plaćanja, izdavanje i štampa, i na kraju instalacija aplikacije. Vodič se može ponovo pokrenuti u svakom trenutku: Podešavanja, Podaci o obvezniku, O aplikaciji, dugme Vodič.

3.3 Instalacija aplikacije na uređaj (PWA)

Otkucaj je instalabilna veb aplikacija: dobija svoju ikonu, otvara se u sopstvenom prozoru i čuva šifarnik artikala lokalno, pa se Kasa otvara i kada veza padne. Instalacija nije obavezna, ali se na kasi preporučuje, zbog rada bez interneta i brže prečice.

Isto dugme Instaliraj aplikaciju postoji i u gornjoj traci početne strane i u Podešavanja, Podaci o obvezniku, O aplikaciji. Aplikacija se otvara na ekranu Kase i radi u punom prozoru, bez adresne trake.

3.4 Podešavanje štampača i provera QR koda

1. Instalirajte štampač u operativni sistem sa drajverom proizvođača i podesite veličinu papira: rolna 58 mm ili 80 mm za žurnal, list A4 ili A5 za račun kao dokument. Radi i običan kancelarijski štampač.
2. U Podešavanja, Štampa i plaćanje izaberite istu širinu papira i širinu računa u znakovima: uobičajeno 40 za rolnu od 80 mm i 32 za rolnu od 58 mm. Dozvoljeni raspon je 32 do 64 znaka.
3. U dijalogu štampe pregledača (Ctrl+P) postavite margine na „bez margina“, razmeru na 100% i isključite zaglavlja i podnožja. Pregledač ta podešavanja pamti, pa se rade samo prvi put po uređaju.
4. Odštampajte probni račun i lenjirom izmerite QR kod. Mora biti kvadrat stranice od 40 do 50 mm. Otkucaj ga štampa na 41 mm na rolni od 58 mm i na 45 mm na rolni od 80 mm i na listovima A4 i A5, što je u oba slučaja unutar propisanog raspona.
5. Proverite da nijedan red žurnala ne izlazi sa desne ivice papira. Širina otiska računa je 46 mm na rolni od 58 mm i 68 mm na rolni od 80 mm, a veličina slova se izvodi iz broja znakova u redu, pa se na užu rolnu prelazi smanjivanjem broja znakova sa 40 na 32, a ne smanjivanjem razmere štampe.

3.5 Provera instalacije

Instalacija je završena kada kroz ceo tok prođe jedan račun vrste Obuka. Ta vrsta prolazi isti put kao pravi račun (PFR, žurnal, QR kod, štampa), ali nosi poruku da nije fiskalni račun, ne ulazi u promet i isključena je iz svih izveštaja, pa je bezbedna za probu.

1. Otvorite Kasu, dodajte jedan artikal i izaberite vrstu računa Obuka.
2. Izdajte račun i sačekajte da se pojavi žurnal sa QR kodom.
3. Kliknite Štampaj i proverite otisak: svi redovi unutar papira, QR kod 40 do 50 mm, tekst čitljiv.
4. Skenirajte QR kod telefonom i otvorite adresu za proveru.
5. Otvorite Računi i proverite da je taj račun u registru.

4.Varijanta B: lokalna instalacija u poslovnom prostoru

U ovoj varijanti ceo Otkucaj radi na računaru u objektu obveznika. To je varijanta koju zahteva rad sa L-PFR-om i rad bez interneta. Postupak ispod vodi od praznog računara do proverenog računa i izvodi se jednom po prodajnom mestu.

4.1 Sistemski zahtevi

• Računar sa operativnim sistemom Windows ili Linux.
• PHP 8.3 ili noviji (izdavalac produkcijski radi na 8.5), sa proširenjima pdo_mysql, mbstring, openssl i curl. Proširenje json je od PHP 8 deo jezgra. Proverava se komandom php -m.
• MySQL 8.0 ili noviji, odnosno MariaDB 10.6 ili novija.
• Veb server koji PHP izvršava preko FastCGI-ja ili sličnog (nginx, Apache, IIS).
• L-PFR, zasebno odobren kod Poreske uprave, instaliran na istom računaru ili u istoj lokalnoj mreži, sa čitačem kartica i bezbednosnim elementom. Nije deo Otkucaja i nabavlja se odvojeno (poglavlje 1).
• Termalni štampač rolne 58 ili 80 mm sa drajverom za taj sistem, ili običan A4 štampač.

Ako server sam izdaje račune e-poštom, potreban mu je i izlaz za poštu. Bez njega sve ostalo radi, a slanje računa e-poštom ne.

4.2 Raspakivanje i prava nad direktorijumima

Isporučeni paket sadrži tri direktorijuma i šemu baze:

otkucaj/
  app/         програм, подешавања, преводи, погледи
  public/      једини директоријум који веб сервер сме да служи
  bin/         командне алатке (migrate.php, seed.php)
  schema.sql   шема базе података

Raspakujte paket van direktorijuma koji veb server služi, na primer u /var/www/otkucaj na Linux-u ili C:\otkucaj na Windows-u. Veb server će kasnije pokazivati samo na podputanju public.

Prava: vlasnik svih datoteka neka bude korisnik pod kojim radi veb server (na Linux-u najčešće www-data). Programu je za rad dovoljno pravo čitanja. U svom direktorijumu on u radu piše samo u jedan podput, private, pored app i public, u koji čuva digitalni sertifikat bezbednosnog elementa. Taj direktorijum ne morate praviti unapred: aplikacija ga pravi sama pri prvom postavljanju sertifikata, sa pravima 0750, a samu datoteku sertifikata upisuje sa pravima 0600.

4.3 Kreiranje baze i uvoz šeme

Napravite bazu i korisnika. Kodni raspored mora biti utf8mb4, jer i korisničko sučelje i nazivi artikala i ceo žurnal idu na ćirilici:

CREATE DATABASE kasir CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'kasir'@'127.0.0.1' IDENTIFIED BY 'ЛОЗИНКА';
GRANT ALL PRIVILEGES ON kasir.* TO 'kasir'@'127.0.0.1';
FLUSH PRIVILEGES;

Zatim uvezite šemu:

mysql -u kasir -p kasir < schema.sql

Šema pravi tabele i upisuje početno stanje: podrazumevane srpske poreske oznake (Đ 20%, E 10%, G 0%, A van PDV), širinu računa od 40 znakova i oba okruženja, pri čemu je aktivno test okruženje u demo režimu. Podaci o obvezniku se namerno upisuju prazni: ovo je prenosiv proizvod i račun ne sme da nosi ime firme koja ne postoji. Unose se kasnije, kroz Podešavanja.

4.4 Konfiguraciona datoteka

Kopirajte app/config.sample.php u app/config.php i popunite pet vrednosti. Datoteka vrši povratak niza i izgleda ovako:

<?php
return [
    'debug'    => false,
    'base_url' => 'http://localhost:8080',
    'app_key'  => '64 хексадецималне цифре',
    'db' => [
        'host' => '127.0.0.1',
        'name' => 'kasir',
        'user' => 'kasir',
        'pass' => 'ЛОЗИНКА',
    ],
];

Datoteku zatim zaključajte: ona nosi lozinku baze i ključ instalacije. Na Linux-u je dovoljno chmod 640 app/config.php uz vlasništvo korisnika veb servera. Ona se nalazi van direktorijuma koji se služi, pa se ne može preuzeti sa mreže; to se ipak proveri u poglavlju 8.

Posle popunjavanja konfiguracije pokrenite migraciju šeme. Ona je idempotentna, svaka izmena prvo proverava zatečeno stanje, pa se sme pokrenuti i na svežoj bazi i posle svake nadogradnje:

php bin/migrate.php

Alatka ispisuje šta je primenila i koliko je koraka već bilo na mestu. Tu se, između ostalog, dodeljuje serijski broj instalacije u obliku OTK-XXXXXXXXXXXX. On je jedinstven za tu instalaciju, izveden iz slučajnih bajtova, i ne menja se ni posle nadogradnje ni posle vraćanja rezervne kopije.

4.5 Veb server, lokalna adresa i port

Veb server se podešava po tri pravila:

1. Korenski direktorijum je public, nikad direktorijum iznad njega. U njemu su samo datoteke koje smeju da se služe.
2. Svaki zahtev koji nije postojeća datoteka vodi na public/index.php. Otkucaj ima jedan ulazni program koji sam odlučuje koju stranicu prikazuje. Uz program se ne isporučuje nijedna datoteka sa pravilima preusmeravanja, pa se to pravilo upisuje u podešavanja samog servera. U nginx-u je to try_files $uri /index.php$is_args$args;.
3. PHP se izvršava preko FastCGI procesa, u verziji iz poglavlja 4.1.

Port birate slobodno; uobičajeno je 8080 za lokalnu instalaciju. Ista adresa i port moraju stajati i u parametru base_url, inače će adrese u porukama e-pošte i u linkovima za proveru računa pokazivati na pogrešno mesto.

Provera pri prijavi. Zaštita obrasca za prijavu (Cloudflare Turnstile) zahteva internet. Na instalaciji koja radi bez veze isključuje se upisom u tabelu podešavanja:

UPDATE settings SET v = '0' WHERE k = 'turnstile_enforce';

Prijava i dalje traži korisničko ime i lozinku i dalje se zaključava posle 8 pogrešnih pokušaja u minutu. Ako provera ostane uključena a mreže nema, prijava svejedno prolazi, jer provera namerno propušta korisnika kad servis za proveru nije dostupan; preporuka je ipak da se na lokalnoj instalaciji izričito isključi.

4.6 Prvi administratorski nalog

Sveže instalirana baza nema nijednog korisnika, a obrazac za registraciju pravi nalog koji je neaktivan dok ga neko ne odobri. Prvi nalog se zato pravi iz komandne linije:

php bin/seed.php admin ЛОЗИНКА-ОД-НАЈМАЊЕ-10-ЗНАКОВА "Име Презиме"

Alatka pravi administratorski nalog, a ako korisnik tog imena već postoji, postavlja mu novu lozinku i vraća mu ulogu administratora. Treći parametar je ime koje se ispisuje i štampa na računu; ako se izostavi, upisuje se „Administrator“. Ako je šifarnik artikala prazan, alatka uz to upisuje osam oglednih artikala, da Kasa ne bude prazna pri prvoj probi; oni se kasnije brišu ili zamenjuju sopstvenim šifarnikom.

Prijavite se tim nalogom i odmah promenite lozinku u Podešavanja, Korisnici. Ostale kasire otvara administrator, kroz isti ekran, sa ulogom Kasir.

4.7 Povezivanje na L-PFR

L-PFR mora već biti instaliran i pokrenut, sa bezbednosnim elementom u čitaču. Njegov isporučilac daje adresu i port na kojima sluša.

1. Otvorite Podešavanja, karticu Okruženje i PFR, za okruženje u kom radite.
2. Za Režim rada izaberite L-PFR.
3. U polje L-PFR adresa unesite adresu koju je dao isporučilac, na primer http://localhost:8888, ili adresu računara u lokalnoj mreži ako L-PFR radi na drugom računaru.
4. Sačuvajte i pogledajte status veze na istoj kartici. On se očitava uživo, pri svakom otvaranju Podešavanja i početne strane.

Veza sa L-PFR-om ide preko običnog HTTP-a u lokalnoj mreži, kako propisuje Tehnički vodič, i na njoj se ne šalje nikakav sertifikat: prema bezbednosnom elementu autentifikuje se sam L-PFR, preko čitača kartica. Ako status javlja da PFR nije dostupan, proverite da je L-PFR pokrenut, da je na istoj mreži i da su adresa i port tačni. Ako javi da kartica nije ubačena ili da traži PIN, to rešava L-PFR, ne Otkucaj.

Ukoliko se umesto L-PFR-a koristi V-PFR Poreske uprave, režim se postavlja na V-PFR, a adresa mora počinjati sa https://: običan HTTP se odbija pri čuvanju, zato što se preko njega bezbednosni element ne šalje. Sertifikat i PAK se unose po Uputstvu za konfiguraciju.

4.8 Provera instalacije

1. Otvorite /zdravlje u pregledaču. Odgovor mora biti {"ok":true,"app":"kasir","version":"1.3.6"}. To znači da i program i baza rade.
2. Prijavite se nalogom iz poglavlja 4.6.
3. Otvorite Podešavanja i proverite da kartica Okruženje i PFR pokazuje očekivani režim i živ status veze.
4. Izdajte jedan račun vrste Obuka i odštampajte ga, tačno kao u poglavlju 3.5, uključujući merenje QR koda.
5. Pokušajte da u pregledaču otvorite adresu aplikacije uz dodatak /app/config.php, pa isto sa /private/vpfr-sandbox.p12. Oba zahteva moraju vratiti grešku, a ne sadržaj: te datoteke su van direktorijuma koji veb server služi.

5.Nadogradnja verzije

Nadogradnja menja samo program. Preko postojeće instalacije se prepišu direktorijumi app, public i bin iz novog paketa, pa se pokrene php bin/migrate.php. Pre toga napravite rezervnu kopiju baze po poglavlju 6.

Ono što nadogradnja ne dira: app/config.php (ne nalazi se u paketu i nikada se ne prepisuje), direktorijum private sa bezbednosnim elementom, cela baza podataka sa računima, artiklima, korisnicima i podešavanjima, i serijski broj instalacije, koji ostaje isti i posle nadogradnje i posle vraćanja rezervne kopije, zato što je upisan u bazu. Ako je aplikacija instalirana na uređaj kasira, nova verzija se preuzima sama pri sledećem otvaranju.

6.Rezervna kopija i vraćanje

Celo stanje instalacije čine tri stvari: baza podataka, datoteka app/config.php i direktorijum private. Program se uvek može raspakovati ponovo iz paketa, pa se ne arhivira. Kopija baze se pravi uobičajenom alatkom:

mysqldump -u kasir -p kasir > kasir-2026-08-21.sql

Pravite je najmanje jednom dnevno i držite je van tog računara. Vraćanje ide obrnutim redom: raspakujte program, vratite app/config.php i private, uvezite kopiju baze i pokrenite php bin/migrate.php. Pošto app_key iz konfiguracije otvara lozinku sertifikata, kopija baze bez te datoteke nije dovoljna: sačuvajte obe.

7.Deinstalacija

Aplikacija na uređaju kasira. Na Windows-u: Podešavanja, Aplikacije, pronađite Otkucaj, pa Deinstaliraj, ili u Chrome-u otvorite chrome://apps i uklonite ikonu. Na Android-u: dugi pritisak na ikonu, pa Ukloni. Na iPhone-u i iPad-u: dugi pritisak na ikonu, pa Ukloni aplikaciju. Time se uklanja samo prečica i lokalna kopija; podaci ostaju u bazi na serveru.

Lokalna instalacija. Zaustavite veb server, obrišite direktorijum programa i obrišite bazu i njenog korisnika. Pre brisanja baze obavezno napravite kopiju po poglavlju 6: u bazi su svi izdati računi, a fiskalni račun ne sme nestati samo zato što je program uklonjen. Izričito proverite da ste obrisali i direktorijum private, u kom stoji bezbednosni element.

8.Kontrolna lista posle instalacije

Instalacija se smatra završenom kada svaki red ispod bude potvrđen. Redovi 5 do 8 odnose se samo na lokalnu instalaciju.