Korisničko uputstvo

Otkucaj verzija 1.3.6 · otkucaj.com · Preuzmi PDF

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.O programu
• 2.Pojmovnik
• 3.Zahtevi i instalacija
• 4.Prijava i uloge
• 5.Ekran Kase
• 6.Izdavanje računa korak po korak
• 7.Bar-kod skener
• 8.Načini plaćanja
• 9.Refundacija
• 10.Poništavanje pogrešnog računa
• 11.Kopija računa
• 12.Predračun i konverzija u fiskalni račun
• 13.Avans
• 14.Obuka
• 15.Registar računa (elektronski žurnal), slanje i preuzimanje
• 16.Artikli
• 17.Izveštaji
• 18.Podešavanja
• 19.Rad bez interneta
• 20.Integracije: API i WooCommerce
• 21.Bezbednost i čuvanje podataka
• 22.Rešavanje problema
• 23.Često postavljana pitanja
• 24.Podrška
• 25.Zabranjene funkcije i granice aplikacije
• 26.Indeks: upitnik Poreske uprave, stavka po stavka

1.O programu

Otkucaj je elektronski sistem za izdavanje računa (ESIR) u smislu Zakona o fiskalizaciji. Radi kao veb aplikacija u pregledaču, na računaru, tabletu ili telefonu, bez instalacije posebnog programa. Svaki račun se pre izdavanja prosleđuje procesoru fiskalnih računa (PFR), koji ga fiskalizuje: dodeljuje mu broj, brojač i digitalni potpis. Otkucaj radi sa lokalnim PFR-om (L-PFR), sa virtuelnim PFR-om Poreske uprave (V-PFR), i, za prikaz i obuku, sa ugrađenim demo simulatorom PFR-a.

Otkucaj podržava sve vrste računa i transakcija propisane Tehničkim vodičem Poreske uprave:

Pored kase, Otkucaj obuhvata registar izdatih računa, šifarnik artikala sa uvozom i izvozom, izveštaje o prometu, korisnike sa ulogama, dnevnik aktivnosti, API za integracije i dodatak za WooCommerce. Aplikacija radi i bez interneta kao instalabilna PWA (poglavlje 19).

1.1 Šta Otkucaj jeste, a šta nije

Ovo poglavlje postoji da ne bi bilo zabune ni kod korisnika ni pred Poreskom upravom. Elektronski fiskalni uređaj (EFU) čine tri elementa: ESIR, PFR i bezbednosni element. Bez sva tri se fiskalni račun ne može izdati.

Iz toga slede tri stvari koje vredi zapamtiti:

• Odobrenje se traži po elementu. ESIR i L-PFR su dva odvojena zahteva, dva rešenja i dva evidenciona broja. Odobren ESIR ne znači odobren L-PFR, niti obrnuto.
• Način povezivanja je deo onoga što se odobrava. Prema Tehničkom vodiču, ESIR sa L-PFR-om komunicira preko HTTP-a u lokalnoj mreži, a sa V-PFR-om preko HTTPS-a uz PAK. Otkucaj podržava oba, ali prilikom izbora ESIR-a obveznik treba da proveri za koji je način povezivanja ESIR odobren.
• Lokalni red čekanja nije oflajn fiskalizacija. Ako veza padne, Otkucaj čuva račun u lokalnom redu na uređaju i on tada nije fiskalizovan i nema fiskalnu važnost. Fiskalizuje se tek kada veza do PFR-a bude uspostavljena. Pravo potpisivanje računa bez interneta omogućava jedino L-PFR, zato što on potpisuje lokalno pomoću bezbednosnog elementa. Detalji u poglavlju 19.

Kako mi razumemo čl. 6 st. 4 Zakona o fiskalizaciji, obveznik koji koristi V-PFR mora u svakom poslovnom prostoru kome je dodeljena jedinstvena oznaka (JID) da obezbedi rad najmanje jednog L-PFR-a. Izuzeti su promet na malo isključivo preko interneta i promet sopstvenih korišćenih pokretnih materijalnih sredstava: tada je dovoljan V-PFR, a stalna veza je ionako uslov rada.

2.Pojmovnik

3.Zahtevi i instalacija

3.1 Pregledači i uređaji

Otkucaj radi u svakom savremenom pregledaču: Chrome, Edge, Firefox i Safari u aktuelnim verzijama. Preporučujemo Chrome ili Edge jer u njima najbolje radi instalacija aplikacije i štampa. Potreban je uključen JavaScript. Ekran kase je prilagođen i računaru i tabletu i telefonu.

3.2 Instalacija kao aplikacija (PWA)

Otkucaj je instalabilna progresivna veb aplikacija: dobija svoju ikonu, otvara se u sopstvenom prozoru i čuva šifarnik artikala lokalno, pa se Kasa otvara i bez interneta.

Dugme Instaliraj aplikaciju postoji i na početnoj strani sajta (gornja traka), u odeljku Podešavanja, O aplikaciji, i kao poslednji korak vodiča kroz prve korake (poglavlje 5): klik na njega pokreće isti postupak instalacije kao u tabeli iznad.

3.3 Podešavanje termalnog štampača

1. Instalirajte štampač u operativni sistem sa drajverom proizvođača i podesite širinu papira: rolna 58 mm ili 80 mm.
2. U dijalogu štampe pregledača (Ctrl+P) podesite: margine: bez margina (None), razmera (Scale): 100%, veličina papira: vaša rolna 58 ili 80 mm, i isključite zaglavlja i podnožja (Headers and footers).
3. Odštampajte probni račun iz demo režima i proverite da žurnal staje u širinu papira i da se QR kod čita kamerom telefona. QR kod se štampa u veličini od 40 do 50 mm; podrazumevano 45 mm.

Štampa radi i na običnom A4 štampaču: žurnal se štampa u istom obliku, a ostatak ekrana se ne štampa jer je štampa izolovana samo na račun.

Podržane su rolne od 58 mm i 80 mm i listovi A4 i A5. Najmanja podržana širina rolne je 58 mm, pri širini računa od 32 znaka. Rolne uže od 57 mm nisu podržane: žurnal u rasporedu iz Tehničkog vodiča ne staje u manje znakova po redu, pa bi se redovi lomili.

Na rolni se štampa žurnal, doslovno onako kako ga je PFR potpisao. Na listu A4 i A5 račun se od verzije 1.3.6 ispisuje kao dokument, u rasporedu koji je opisan u poglavlju 6.2. Veličina lista se bira u samoj aplikaciji i upisuje se u pravilo @page dokumenta koji se štampa, pa se ne nasleđuje papir koji je u štampaču zatečen.

3.4 Dva načina rada: na internetu i lokalno u objektu

Otkucaj se može koristiti na dva načina. Oba su predviđena i oba koriste isti program; razlikuju se po tome gde je ESIR instaliran i na koji PFR se povezuje.

Šta je potrebno za lokalnu instalaciju

1. Računar sa operativnim sistemom Windows ili Linux, na kome radi PHP 8.3 ili noviji i MySQL 8 ili MariaDB 10.6 ili noviji.
2. L-PFR, zasebno odobren kod Poreske uprave, instaliran na istom računaru ili u istoj mreži, sa čitačem kartica i bezbednosnim elementom. L-PFR nije deo Otkucaja (videti poglavlje 1).
3. Kopija programa i baza podataka. Instalaciju i početno podešavanje radi isporučilac.

Podešavanja za rad bez interneta

Posle instalacije, u datoteci podešavanja i u odeljku Podešavanja postavlja se sledeće:

• Adresa aplikacije se postavlja na lokalnu adresu, na primer http://localhost:8080 ili adresu računara u mreži. Tako sve veze unutar aplikacije ostaju u lokalnoj mreži.
• Režim PFR-a se postavlja na L-PFR, a adresa L-PFR-a na onu koju je dao njegov isporučilac, najčešće http://localhost:8888. Status veze se odmah vidi u Podešavanjima.
• Provera pri prijavi (Cloudflare Turnstile) se isključuje, jer ona zahteva internet. Prijava i dalje traži korisničko ime i lozinku.
• Slanje računa e-poštom radi samo kada postoji veza. Štampa i preuzimanje žurnala rade uvek.

4.Prijava i uloge

1. Otvorite https://otkucaj.com i kliknite Prijava.
2. Unesite korisničko ime i lozinku koje ste dobili od administratora.
3. Posle prijave otvara se ekran Kasa.

Posle 8 pogrešnih pokušaja u minutu prijava se privremeno zaključava. Zaboravljenu lozinku resetuje administrator u odeljku Podešavanja, Korisnici.

Ime kasira se upisuje na svaki izdati račun, a svaka radnja se beleži u dnevnik aktivnosti.

Registracija i odobravanje naloga

Novi obveznik može sam da otvori nalog na stranici Registracija; link ka njoj postoji i na stranici za prijavu. Obrazac traži: poslovno ime, PIB, matični broj, broj telefona iz Srbije, e-poštu, korisničko ime i lozinku od najmanje 10 znakova.

• Nalog se otvara neaktivan: prijava nije moguća dok ga administrator ne odobri u odeljku Podešavanja, Korisnici.
• Ako su Telegram obaveštenja podešena (poglavlje 18), administrator odmah dobija poruku o novoj registraciji.
• Po aktivaciji korisnik se prijavljuje uobičajeno, korisničkim imenom i lozinkom.

Zaštita prijave: Cloudflare Turnstile

Obrasci za prijavu i registraciju zaštićeni su proverom Cloudflare Turnstile. Provera je nevidljiva: ne traži slagalice ni prekucavanje znakova, najčešće se završi sama, u deliću sekunde. Ako servis provere trenutno nije dostupan, prijava svejedno prolazi, tako da niko ne može ostati zaključan zbog ispada treće strane.

5.Ekran Kase

Kasa je podeljena na dva dela: levo je izbor artikala, desno je korpa sa plaćanjima i dugmetom za izdavanje.

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

Duž leve ivice ekrana stoji sajdbar sa glavnim menijem. Dugme ⟨ pri njegovom dnu sužava sajdbar na ikone, pa Kasa dobija više prostora; ponovni klik ga vraća u punu širinu. Izabrano stanje se pamti po uređaju.

Pretraga i izbor artikala

• Pretraga: kucajte naziv, PLU ili bar-kod; spisak se sužava dok kucate. Taster Enter potvrđuje unos: ako uneti tekst tačno odgovara PLU-u ili GTIN-u, artikal se odmah dodaje u korpu (ponašanje skenera, poglavlje 7). Ako ukucani ili skenirani kod ne odgovara nijednom artiklu, spisak artikala odgovara da poklapanja nema, a unos ostaje u polju da se ispravi.
• Kategorije: ispod pretrage stoje dugmad kategorija (npr. Pića, Hrana). Klik filtrira mrežu artikala na izabranu kategoriju, ponovni klik vraća sve.
• Mreža artikala: klik na pločicu artikla dodaje jedan komad u korpu.
• Slobodan unos: za robu ili uslugu koje nema u šifarniku otvorite „Slobodan unos“ i ukucajte naziv, cenu i poresku oznaku. Stavka ide u korpu kao i svaka druga.
• Poreske oznake: ispod izbora artikala stoji sklopivi odeljak Poreske oznake. Klik na njega ispisuje sve važeće oznake, naziv poreske kategorije uz svaku i stopu. Tu ih kasir može pogledati u svakom trenutku, a to je i jedino mesto na kom ih vidi: Podešavanja otvara samo administrator. Prikazan je isti spisak koji važi i na računu i koji dolazi od PFR-a, nikad iz aplikacije (poglavlje 18.6).

Više otvorenih računa

Iznad korpe stoje kartice otvorenih računa. Dugme + otvara nov prazan račun, a klikom na karticu prelazite sa jednog kupca na drugog, na primer kada kasir naplaćuje više stolova ili kada jedan kupac „sačeka“. Svi otvoreni računi se čuvaju lokalno u uređaju i preživljavaju osvežavanje stranice i zatvaranje pregledača; brišu se tek izdavanjem ili ručnim zatvaranjem kartice.

Korpa

• Količina: menja se tasterima − i + ili direktnim unosom. Podržani su decimalni unosi, npr. 0,375 za 375 grama.
• Cena: jedinična cena svake stavke može se izmeniti direktno u korpi (npr. za robu sa istaknutom akcijskom cenom).
• Popust po stavci: svaka stavka ima polje popusta u procentima; iznos stavke se odmah preračunava.
• Popust na ceo račun: unesite procenat za ceo račun i Otkucaj ga raspoređuje po svakoj stavci, tako da zbir stavki i dalje odgovara onome što PFR obračunava.
• Uklanjanje stavke: svaki red u korpi ima dugme × u gornjem desnom uglu i uklanja se pojedinačno, dok ostale stavke ostaju netaknute. Stavka nestaje i kada joj količinu spustite na nulu. Stavke se uklanjaju sve dok račun nije izdat; posle izdavanja se račun više ne menja, nego se stornira (poglavlje 10).
• Avansne stavke: dugmad za propisane avansne stavke (poglavlje 13).

Polja uz račun

• Vrsta računa (Promet, Avans, Predračun, Obuka, Kopija) i vrsta transakcije (Prodaja, Refundacija). Kopiju računa koji postoji u ovoj instalaciji redovno izdajete iz samog računa u registru, i referentni broj se tada popunjava sam. Vrsta Kopija se bira ovde kada originala nema u ovoj instalaciji, na primer kad je račun izdat na drugom uređaju: tada referentni broj unosite ručno, a bez njega izdavanje nije moguće (poglavlje 11).
• ID kupca: identifikacija kupca u obliku šifra:vrednost (tabela u poglavlju 9). Obavezna kod refundacije, a unosi se i kad kupac traži račun sa svojim PIB-om.
• Opciono polje kupca: oznaka dokumenta koji bliže određuje namenu računa, takođe u obliku šifra:vrednost (najviše 20 znakova). Unosi se samo kada za njim ima potrebe, a tada se štampa na računu ispod ID kupca. Najčešće: 50: broj korporacijske kartice (način plaćanja je tada uvek Vaučer), 30: broj PPO-PDV potvrde, 20: broj SNPDV obrasca, 60:ddmmgggg_ddmmgggg kalendarski mesec na zbirnoj refundaciji prometa po korporacijskim karticama.
• Reklamni tekst: proizvoljan tekst koji se štampa ispod kraja računa (npr. „Hvala na poverenju“); kod zatvaranja avansa ovde automatski stoji broj i datum avansnog računa.
• ESIR vreme: datum i vreme uplate avansa, kada je avans uplaćen prenosom na račun pre dana izdavanja računa Avans Prodaja. Kako mi razumemo čl. 11 Pravilnika o vrstama fiskalnih računa, takav račun se izdaje najkasnije narednog radnog dana od prijema uplate (poglavlje 13). ESIR vreme ne služi za naknadno izdavanje računa za promet.
• Plaćanja: redovi plaćanja sa automatskim poljem „ostatak“ (poglavlje 8).

6.Izdavanje računa korak po korak

1. Pronađite artikle pretragom, skenerom ili klikom i dodajte ih u korpu.
2. Po potrebi izmenite količine i cene, unesite popuste.
3. Proverite vrstu računa (za običnu prodaju: Promet, Prodaja).
4. Po potrebi unesite ID kupca, Opciono polje kupca i reklamni tekst.
5. Izaberite način plaćanja; kod deljenog plaćanja dodajte još redova (poglavlje 8).
6. Kliknite Izdaj račun. Otkucaj šalje zahtev PFR-u, a zatim prikazuje žurnal sa QR kodom.
7. Kliknite Štampaj za štampu, ili pošaljite račun e-poštom (poglavlje 15).

Elementi izdatog računa

Žurnal je formatiran na 40 znakova po redu, na ćirilici, u rasporedu iz Tehničkog vodiča, i sadrži redom:

• PIB, poslovno ime, naziv i adresu prodajnog mesta obveznika;
• oznaku kasira, ID kupca ako je unet, i ESIR broj (broj iz registra odobrenih ESIR-a, poglavlje 18);
• vrstu računa i transakcije (npr. PROMET PRODAJA);
• stavke: naziv, količina, jedinična cena, iznos i poreska oznaka;
• red sa ukupnim iznosom računa i redove plaćanja po načinima;
• poreski pregled po oznakama: Đ 20%, E 10%, G 0%, A van PDV; stope uvek dolaze iz PFR-a, nikad iz aplikacije;
• PFR vreme, PFR broj računa u obliku JID-JID-redni broj i brojač, npr. 143/302PP: 143. račun vrste Promet Prodaja od ukupno 302 računa;
• QR kod i link za proveru računa; štampani QR kod ima od 40 do 50 mm (podrazumevano 45 mm);
• posle kraja računa: reklamni tekst, ako je unet.

Kopija, Predračun i Obuka štampaju „OVO NIJE FISKALNI RAČUN“ u dvostrukoj veličini slova. U demo režimu to važi za svaku vrstu računa, uključujući i Promet Prodaju: demo simulator nema PFR, pa nijedan dokument koji on napravi nije fiskalni račun (poglavlje 25).

6.1 Elementi fiskalnog računa, polje po polje

Ispod je ceo žurnal jednog stvarnog računa, onako kako ga je potpisao PFR i kako se štampa, u širini od 40 znakova. Račun je izdat u test okruženju Poreske uprave (poglavlje 18.1), pa su podaci o obvezniku ispisani onako kako su upisani u tom sistemu: mesto prodaje je tamo registrovano pod istim nazivom kao i obveznik, zato se taj red ponavlja, a grad stoji kao NOT APPLICABLE jer u test sistemu nije popunjen. Poreske oznake i stope su takođe one koje važe u test sistemu, ne srpske. Ništa od toga ne piše aplikacija: zaglavlje, poreski pregled i fiskalni metapodaci dolaze iz odgovora PFR-a i prikazuju se kako su primljeni (poglavlje 25).

============ ФИСКАЛНИ РАЧУН ============
RS112978955
Saša Mihajlović pr Računovodstveni poslovi TEFIS Vlasotince
Saša Mihajlović pr Računovodstveni poslovi TEFIS Vlasotince
Hajduk Veljka 9
NOT APPLICABLE
Касир:                  Филип Михајловић
ИД купца:                   10:112978955
Опционо поље купца:        50:6600123456
ЕСИР број:                    1667/1.3.6
-------------ПРОМЕТ ПРОДАЈА-------------
Артикли
========================================
Назив   Цена         Кол.         Укупно
Кафа еспресо /ком (Ж)
       220,00          2          440,00
Хлеб бели 500г /ком (A)
        89,99          1           89,99
----------------------------------------
Укупан износ:                     529,99
Ваучер:                           529,99
========================================
Ознака       Име      Стопа        Порез
Ж             VAT   19,00%         70,25
A             VAT   10,00%          8,18
----------------------------------------
Укупан износ пореза:               78,43
========================================
ПФР време:          16.09.2026. 12:51:21
ПФР број рачуна:    25MLSU5E-Dt1Ov2o0-22
Бројач рачуна:                   16/22ПП
========================================
======== КРАЈ ФИСКАЛНОГ РАЧУНА =========

Tabela ispod imenuje svaki element računa oznakom koju nosi u upitniku Poreske uprave za administrativni i tehnički pregled ESIR-a, odeljak 16, i govori kako taj element izgleda na papiru, odakle dolazi i kada se prikazuje. Redovi koji se ne vide u primeru iznad prikazuju se samo na određenim vrstama računa i tu su navedeni u obliku u kom se štampaju.

6.2 Račun kao dokument na A4 i A5

Od verzije 1.3.6 račun se na listu papira ne štampa kao žurnal nego kao dokument. Rolna ostaje ista: tamo se i dalje štampa žurnal koji je PFR potpisao, znak po znak. Razlika je u tome što žurnal ima smisla na traci od 40 znakova, a na listu A4 ili A5 ostavlja praznih osam desetina strane i nečitak je sa metar udaljenosti, dok račun koji ide uz pošiljku, u prilog e-pošte ili u knjigovodstvo najviše puta upravo tako i putuje.

Tako oblikovan račun je predviđen Tehničkim vodičem. Njegovo poglavlje „Mapping“ kaže da ESIR koji ne štampa žurnal nego sopstveno oblikovan račun mora da koristi propisanu mapu elemenata, dakle da svaku vrednost uzme iz zahteva za fiskalizaciju i iz odgovora PFR-a. Otkucaj radi tačno to: nijedan podatak na dokumentu ne nastaje u aplikaciji, nijedan iznos se ne računa ponovo i nijedan element iz odeljka 16 Tehničkog uputstva ne izostaje.

Oba formata nose isti raspored; razlikuju se samo veličinom slova i razmakom, tako da račun i na A5 staje na jednu stranu. Izmereno na serverski izrađenom PDF-u: strana A4 209,9 × 297,0 mm, strana A5 148,2 × 209,9 mm, QR kod 45,0 × 45,0 mm na obema, pročitan čitačem i upoređen sa adresom za proveru koja je uz račun zapisana.

Dokument se otvara sa stranice računa, dugmadima Nov izgled (1.3.6) A4 i A5, i preuzima kao PDF: bilo iz dijaloga štampe pregledača, bilo sa servera, preko adrese /api/v1/invoices/{uuid}/document?paper=a4doc|a5doc&format=pdf (poglavlje 20). Veličina lista se upisuje u pravilo @page samog dokumenta, pa štampač dobija list koji je izabran, a ne onaj koji je u njemu zatečen. Dugme Dokument bez oznake verzije otvara oblik koji odgovara verziji upisanoj u podešavanjima: sa 1667/1.3.6 nov A4 dokument, sa 1651/1.3.5 onaj iz ranije verzije.

7.Bar-kod skener

Otkucaj radi sa svakim skenerom koji se javlja kao tastatura (USB ili Bluetooth HID), bez ikakvog podešavanja u aplikaciji.

• Skener ukuca bar-kod u polje pretrage i pošalje Enter; Otkucaj pronađe artikal po GTIN-u i odmah ga doda u korpu. Isto važi i kad kod ili PLU ukucate ručno pa pritisnete Enter.
• Prefiks količine: ukucajte 2*kod ili 2xkod (npr. 2*1001) pa potvrdite: stavka ulazi u korpu sa količinom 2. Radi i sa skenerom: ukucajte 2* pa skenirajte.
• Bar-kod se vezuje za artikal u šifarniku, polje GTIN/bar-kod (poglavlje 16). Ako kod nije pronađen, Otkucaj to jasno kaže: dodajte artikal u šifarnik ili iskoristite slobodan unos.

Skener je za aplikaciju obična tastatura: on upisuje znakove u polje pretrage i pritiska Enter, i to je sve što radi. Ne razgovara sa PFR-om, nije deo toka izdavanja računa i ne može da ga odloži ni prekine. Isto važi za svaki drugi uređaj koji se povezuje na ovaj način, na primer vagu koja izlaz šalje kao otkucane znakove.

8.Načini plaćanja

Otkucaj podržava svih sedam načina plaćanja propisanih čl. 6 Pravilnika o vrstama fiskalnih računa:

U zahtevu koji Otkucaj šalje PFR-u svaki način plaćanja nosi svoj numerički kod iz Tehničkog vodiča:

8.1 Primljeno i povraćaj

U polje iznosa uz način plaćanja unosi se ono što je kupac stvarno dao. Ako se ostavi prazno, taj način plaćanja pokriva ceo račun. Ako je uneti iznos veći od iznosa „Za uplatu“, razlika je povraćaj: prikazuje se na Kasi dok kasir kuca, štampa se na računu u redu „Povraćaj“ i ne ulazi u promet. Primer iz Tehničkog uputstva: račun je 349,90, kupac daje 200,00 gotovinom i 200,00 karticom, povraćaj je 50,10.

Iznos manji od ukupnog nije dozvoljen: račun koji nije pokriven je greška, a ne povraćaj. Kod refundacije povraćaja nema, pa se zbir mora poklopiti tačno.

8.2 Podeljeno plaćanje

Jedan račun može imati više redova plaćanja. Kada unesete prvi iznos, polje ostatak automatski pokazuje koliko je još nepokriveno, a nov red plaćanja se popunjava tim iznosom.

8.3 Režim po čl. 6 st. 2 Pravilnika

Kako mi razumemo čl. 6 st. 2 Pravilnika o vrstama fiskalnih računa, uređaj preko koga se evidentira usluga predaje hrane i pića za konzumaciju na licu mesta ili promet hrane i pića u objektu pekare mora da nudi samo četiri načina plaćanja, čak i ako se preko njega evidentira i drugi promet. Za takve obveznike Otkucaj ima poseban režim u Podešavanjima: načini platna kartica, ček i instant plaćanje su isključeni, a takve uplate se unose kao gotovina. U tom režimu ostaju četiri načina: Drugo bezgotovinsko (kod 0), Gotovina (1), Prenos na račun (4) i Vaučer (5). Kodovi 2, 3 i 6 se ne mogu uneti ni na Kasi ni preko API-ja: kasir ih ne vidi, a zahtev koji ih sadrži odbija se uz objašnjenje. Jedna instalacija Otkucaja radi isključivo u jednom od ova dva režima; režim bira administrator i važi za sve kasire.

9.Refundacija

Refundacija je fiskalni račun kojim se vraća promet: ceo račun ili pojedine stavke. Pravila:

• Refundacija obavezno nosi referentni broj originalnog računa (PFR broj u obliku JID-JID-broj).
• Refundacija obavezno nosi ID kupca.
• Stavke se refundiraju po ceni po kojoj su stvarno naplaćene (sa popustom ako ga je bilo).

Šifarnik sadrži i ostale identifikacije iz Tehničkog vodiča; navedene su najčešće.

Postupak

1. Otvorite Računi, pronađite originalni račun i kliknite Refundacija. Kasa se otvara sa popunjenim stavkama i referentnim brojem originala.
2. Obrišite stavke koje se ne vraćaju ili smanjite količine.
3. Unesite ID kupca, npr. 20: i broj lične karte kupca.
4. Izaberite način isplate i kliknite Izdaj račun: izdaje se račun Promet Refundacija.

Refundacija se može izdati i ručno: na Kasi izaberite transakciju Refundacija i sami upišite referentni broj. Bez referentnog broja i ID kupca Otkucaj ne dozvoljava izdavanje.

Referentni broj kada originalnog fiskalnog računa nema

Referentni broj redovno glasi na PFR broj originalnog računa, u obliku JIDZahteva-JIDPotpisa-RedniBroj. Za promet nastao pre uvođenja elektronskog fiskalnog uređaja takvog broja nema, pa Tehničko uputstvo propisuje dva rezervna oblika. Oba se unose ručno, u isto polje referentnog broja:

• XXXXXXXX-XXXXXXXX-121 za promet nastao pre uvođenja EFU. Prvi deo, XXXXXXXX-XXXXXXXX, je predefinisan i upisuje se tako kako stoji, a 121 je broj pod kojim je račun zaveden u evidenciji računa ili u knjigovodstvu.
• XXXXXXXX-AB123456-159 za račun iz stare fiskalne kase. Prvi deo je predefinisan, AB123456 je IBFM, identifikacioni broj fiskalnog modula, a 159 je broj isečka.

Isplata u gotovini: potpis kupca

Kada se novac kupcu vraća u gotovini, posle refundacije odmah izdajte i Kopiju refundacije (dugme Kopija na upravo izdatoj refundaciji). Kopija Refundacija štampa prostor „Potpis kupca“: kupac se potpisuje pri preuzimanju novca, a potpisani primerak ostaje prodavcu kao dokaz isplate.

10.Poništavanje pogrešnog računa

Izdati fiskalni račun se ne može izmeniti ni obrisati. Pogrešan račun (pogrešna cena ili količina, račun izdat za promet koji se nije dogodio) poništava se refundacijom sopstvenog računa, pri čemu se kao ID kupca unosi sopstveni PIB prodavca. Kada kupac odustane i dobije novac nazad, to je refundacija sa ID-om kupca (poglavlje 9):

1. Otvorite Računi, pronađite pogrešan račun i kliknite Refundacija. Ostavite sve stavke i količine: poništava se ceo račun.
2. U polje ID kupca unesite 10: i svoj PIB (npr. 10:SVOJPIB).
3. Izaberite isti način plaćanja kao na originalu i kliknite Izdaj račun.
4. Ako je kupac i dalje tu, izdajte odmah nov, ispravan račun Promet Prodaja.

11.Kopija računa

U Otkucaju se kopija izdaje iz već izdatog računa (Pravilnik dozvoljava i istovremeno i naknadno izdavanje) i uvek nosi referentni broj originalnog računa; bez njega izdavanje nije moguće. Postoje dva puta do nje, prema tome gde je original.

Original je u ovoj instalaciji. Otvorite račun u registru i kliknite Kopija. Otkucaj sam popunjava referentni broj originala i izdaje račun vrste Kopija kroz PFR. To je redovan put i ne traži da se išta prekucava.

Originala nema u ovoj instalaciji. Na Kasi izaberite vrstu računa Kopija, ukucajte stavke i ručno unesite referentni broj originalnog računa. Tako se kopija izdaje i za račun izdat na drugom uređaju ili u drugom programu. Propisani rezervni oblici referentnog broja, kada originalnog fiskalnog računa uopšte nema, navedeni su u poglavlju 9.

• Kopija štampa „OVO NIJE FISKALNI RAČUN“ u dvostrukoj veličini slova i ne ulazi u promet.
• Kopija Refundacije štampa i prostor „Potpis kupca“ (poglavlje 9).
• Tipična upotreba: kupac je izgubio račun, potreban je duplikat za reklamaciju ili knjigovodstvo, potvrda isplate refundacije.

12.Predračun i konverzija u fiskalni račun

Predračun je ponuda: prolazi kroz PFR kao vrsta Predračun, ali nije fiskalni račun, ne ulazi u promet i štampa „OVO NIJE FISKALNI RAČUN“. Izdaje se sa Kase izborom vrste Predračun.

Kada kupac prihvati ponudu i plati:

1. Otvorite predračun u registru računa.
2. Kliknite Izdaj fiskalni račun. Kasa se otvara sa svim stavkama predračuna, a referentni broj predračuna je automatski popunjen.
3. Izaberite način plaćanja i kliknite Izdaj račun: izdaje se normalan račun Promet Prodaja.

13.Avans

Avansni račun se izdaje kada kupac plati pre isporuke dobra ili usluge. Otkucaj pokriva ceo životni ciklus avansa: izdavanje, dodatne uplate, i zatvaranje u jedan klik.

Izdavanje avansnog računa

1. Na Kasi izaberite vrstu Avans. Pojavljuju se dugmad propisanih avansnih stavki:

2. Kliknite stavku po poreskoj stopi buduće isporuke. Količina je uvek 1, a kao cenu unesite iznos primljenog avansa.
3. Ako buduća isporuka sadrži robu po različitim stopama, dodajte po jednu avansnu stavku za svaku stopu i podelite iznos.
4. Izaberite način plaćanja (tipično prenos na račun) i izdajte račun Avans Prodaja.

ESIR vreme: uplate primljene ranije

Ako je avans uplaćen virmanom koji vidite tek narednog dana na izvodu, u polje ESIR vreme unesite stvarni datum i vreme uplate. Kako mi razumemo čl. 11 st. 5 Pravilnika o vrstama fiskalnih računa, račun Avans Prodaja se tada izdaje najkasnije narednog radnog dana od dana prijema uplate. Na računu će stajati i ESIR vreme (stvarno vreme uplate) i PFR vreme (vreme fiskalizacije).

Dodatni avansi

Ako kupac uplati još avansa pre isporuke, izdajte nov avansni račun na isti način, sa referentnim brojem prethodnog avansnog računa (Tehničko uputstvo, 9.1.1). Pri zatvaranju se refundira ukupan iznos svih avansa, a referenca ide na poslednji avansni račun.

Zatvaranje avansa u jedan klik

Kada se roba isporuči ili usluga izvrši, otvorite poslednji avansni račun u registru i kliknite Zatvori avans. Otkucaj tada:

1. automatski izdaje račun Avans Refundacija na ukupan primljeni iznos, sa referentnim brojem avansnog računa (ovaj račun služi zatvaranju i ne predaje se kupcu);
2. popunjava Kasu za konačni račun Promet Prodaja: referentni broj je popunjen, a u reklamnom tekstu automatski stoji broj i datum poslednjeg avansnog računa.

Kasir zatim u korpu dodaje stvarno isporučenu robu po punim cenama, unosi plaćanja i izdaje konačni račun.

14.Obuka

Vrsta Obuka služi za uvežbavanje osoblja i probu opreme: račun prolazi ceo tok kao pravi (PFR, žurnal, QR kod, štampa), ali štampa „OVO NIJE FISKALNI RAČUN“ u dvostrukoj veličini slova, ne ulazi u promet i isključen je iz svih izveštaja. Koristite Obuku za probu štampača i posle svake promene PFR režima (poglavlje 18), pre prvog pravog računa.

15.Registar računa (elektronski žurnal), slanje i preuzimanje

15.1 Registar računa i pretraga

Stavka Računi u bočnom meniju otvara elektronski žurnal: spisak svih računa izdatih na ovoj instalaciji, od najnovijeg ka najstarijem, sa datumom, vrstom računa i transakcije, PFR brojem, brojačem računa, kasirom i iznosom. Spisak uvek obuhvata najmanje poslednjih 30 dana, a preko polja za period i starije račune.

Iznad spiska stoji polje za pretragu određenog računa. Pretražuje se ceo žurnal, nezavisno od izabranog perioda, po:

• PFR broju računa (npr. Y9ANWU3Y-Y9ANWU3Y-150) ili njegovom delu;
• brojaču računa (npr. 124/150PP);
• referentnom broju, čime se uz originalni račun nalaze i njegova kopija i refundacija;
• ID kupca i Opcionom polju kupca;
• oznaci kasira;
• iznosu računa;
• nazivu artikla sa računa.

Ispod polja za pretragu je filter po periodu i po vrsti računa za pregledanje žurnala bez zadate pretrage. Klik na Prikaži otvara ceo račun sa žurnalom i QR kodom.

Računi izdati u test okruženju prikazuju se samo dok je to okruženje izabrano i nikada se ne mešaju sa produkcijskim (poglavlje 18.1).

15.2 Dostavljanje računa kupcu

Na stranici svakog računa u registru dostupno je:

• Pošalji e-poštom: unesite adresu kupca; Otkucaj šalje račun kao uredan dokument, sa pregledom artikala, porezima, plaćanjem, QR kodom i fiskalnim isečkom u dnu. Kada se račun dostavlja elektronski, QR kod zamenjuje ta adresa, i to kao pravi hiperlink na koji kupac može da klikne. Kako mi razumemo čl. 13 Pravilnika o vrstama fiskalnih računa, račun u elektronskom obliku umesto štampanog izdaje samo obveznik koji prodaje isključivo preko interneta; u prodajnom objektu kupac uvek dobija štampani račun, a elektronski primerak može mu se poslati dodatno, samo uz njegovu saglasnost.
• Dokument: isti račun kao dokument formata A4 ili A5, za štampu na običnom štampaču, za slanje u prilogu ili za arhivu. Dokument nosi sve elemente iz odeljka 16 Tehničkog uputstva, tim redom, sa QR kodom unutar okvira računa i završnom linijom ispod njega (poglavlje 6.2). Ništa u dokumentu ne zamenjuje fiskalni račun: on jeste taj račun, u obliku koji Tehnički vodič za takav ESIR propisuje. Na stranici dokumenta dugme Sačuvaj kao PDF otvara dijalog štampe, gde se kao odredište bira „Sačuvaj kao PDF“.
• Preuzmi .txt: žurnal kao tekstualni fajl, npr. za arhivu ili slanje kroz druge kanale.
• Štampaj: štampa na termalnom štampaču 58 ili 80 mm, gde ide žurnal, ili na listu A4 i A5, gde ide dokument; štampa se samo račun, bez ostatka ekrana.
• PDF sa servera: isti dokument, ali izrađen na serveru i uvek istovetan, preuzima se sa adrese /api/v1/invoices/{uuid}/document?paper=a4|a5&format=pdf (poglavlje 20). To je put kojim kurirska služba ili prodavnica uzima račun da ga odštampa uz pošiljku.
• PDF: u dijalogu štampe izaberite odredište „Sačuvaj kao PDF“ (ili „Microsoft Print to PDF“) i račun se čuva kao PDF dokument.

16.Artikli

Meni Artikli je šifarnik robe i usluga. Svako polje artikla:

GTIN upisan uz artikal nije samo pomoć skeneru. On putuje PFR-u u zahtevu za fiskalizaciju, kao deo te stavke računa, i tako je globalni broj trgovinske jedinice podržan kroz ceo tok izdavanja. Upisuje se kao 8 do 14 cifara, bez razmaka i crtica; drugi oblici se odbijaju već pri čuvanju artikla.

CSV uvoz i izvoz

Dugmad Izvoz CSV i Uvoz CSV služe za masovan rad sa šifarnikom, npr. prenos iz starog programa ili ažuriranje cena u Excel-u. Format: UTF-8, kolone razdvojene tačka-zarezom:

plu;name;unit;price;label;gtin;active;category
1001;Кока-кола 0,5 l;ком;180,00;Ђ;8600123456789;1;Пића

Red sa već postojećim PLU-om ažurira taj artikal, red sa novim PLU-om dodaje nov. Preporučen tok: Izvoz CSV, izmena u tabelarnom programu, Uvoz CSV.

17.Izveštaji

Meni Izveštaji (administrator) nudi, za proizvoljan period:

• dnevni promet;
• promet po poreskim oznakama;
• promet po načinu plaćanja;
• promet po kasiru;
• najprodavanije artikle.

Pravila obračuna: u promet ulaze fiskalizovani računi vrste Promet i Avans; refundacije umanjuju promet; Obuka, Predračun i Kopija su u potpunosti isključeni. Svaka tabela ima dugme Izvezi CSV: izaberite mesec i prosledite fajl knjigovođi.

18.Podešavanja

Meni Podešavanja vidi samo administrator. Ekran je podeljen na devet kartica, a redosled prati ono čime se zaista počinje: prvo okruženje, jer ono odlučuje da li je račun koji izdate pravi fiskalni račun ili proba, pa bezbednosni element, pa podaci obveznika, pa sve što se retko menja.

Ako vas na neku karticu pošalje traka upozorenja sa vrha ekrana, ona se sama otvori i okvir koji treba da popunite bude istaknut. Ne morate da tražite.

18.1 Okruženje: test i produkcija

Svaka firma u Otkucaju ima dva potpuno odvojena okruženja, i u svakom trenutku jedno je aktivno.

Podaci dva okruženja se nikada ne mešaju. Svaki račun pamti u kom je okruženju izdat, pa lista računa, kontrolna tabla i izveštaji prikazuju samo ono što pripada aktivnom okruženju. Probni račun ne može da uđe u stvarni promet, ni greškom.

Na kartici Okruženje vidite obe kartice jednu pored druge: koja je aktivna, u kom je režimu, koji ima ESIR broj i da li ima sertifikat. Ispod svake stoji i provera spremnosti, u obliku spiska onoga što još nedostaje.

Prebacivanje na produkciju

Dugme Prebaci ovde radi tek kada je to okruženje zaista spremno. Ako nije, aplikacija odbija prelazak i ispisuje šta fali, umesto da vas pusti da otkrijete problem na prvom pravom računu. Produkcija se smatra spremnom kada ima:

1. režim L-PFR ili V-PFR, nikako demo (demo ne izdaje fiskalne račune);
2. ESIR broj koji je broj, dakle evidencioni broj koji je dodelila Poreska uprava;
3. za V-PFR: postavljen sertifikat i unet PAK;
4. za V-PFR: adresu koja nije test adresa Poreske uprave;
5. sertifikat različit od onog u testu.

Dve greške koje aplikacija neće dozvoliti

Isti sertifikat u oba okruženja. Test i produkcija moraju imati različite bezbednosne elemente. Otkucaj pamti otisak svakog sertifikata i odbija da isti postavi u oba; ako se to ipak nekako desi, izdavanje računa se zaustavlja dok se ne ispravi.

Unakrsno povezivanje adresa. Ako u produkciju unesete test adresu Poreske uprave, računi bi izgledali kao pravi a ne bi bili fiskalni. Ako u test unesete produkcijsku adresu, probni računi bi otišli u stvarnu evidenciju. Oba unosa se odbijaju uz objašnjenje.

18.2 Režim rada (PFR)

Svako okruženje ima svoj režim, sa živim statusom veze:

Put od demoa do prave prodaje: (1) pribavite bezbednosni element od Poreske uprave (za V-PFR digitalni sertifikat, uz PAK koji sami birate pri zahtevu); (2) u test okruženju izaberite L-PFR ili V-PFR, unesite test podatke i izdajte nekoliko probnih računa; (3) kada sve radi, popunite produkcijsko okruženje stvarnim podacima i stvarnim sertifikatom; (4) proverite da provera spremnosti ne prijavljuje ništa; (5) pritisnite Prebaci ovde; (6) izdajte jedan račun vrste Obuka i proverite štampu i QR kod; (7) tek tada izdajte pravi račun.

18.2.1 Autentifikacija ESIR-a i PFR-a

ESIR i PFR se međusobno prepoznaju pre nego što bilo koji podatak o računu promeni ruke. Provera nije jednokratna, pri prvom povezivanju: obavlja se pri svakom obraćanju PFR-u.

V-PFR. Veza ide preko HTTPS-a. Otkucaj se predstavlja klijentskim sertifikatom, a to je bezbednosni element u obliku datoteke (.pfx ili .p12) koji je Poreska uprava izdala tom obvezniku; lozinka kojom se datoteka otvara čuva se šifrovano (18.3). Uz svaki zahtev ide i zaglavlje sa PAK-om. U istom rukovanju Otkucaj proverava i sertifikat V-PFR-a, dakle njegovog izdavaoca i ime domaćina; ta provera je uključena i ne može se isključiti nikakvim podešavanjem. Ako sertifikat nije postavljen, ako lozinka ne otvara datoteku ili ako PAK nije prihvaćen, V-PFR odbija zahtev, račun se ne izdaje, a poruka V-PFR-a se prikazuje kasiru onako kako je stigla.

L-PFR. Veza ide preko HTTP-a, u lokalnoj mreži objekta, i klijentski sertifikat se ne šalje jer u toj vezi nema mesta za njega. Prema bezbednosnom elementu autentifikuje se sam L-PFR, preko čitača pametnih kartica i PIN-a; Otkucaj kartici ne pristupa i ne može da joj pristupi (poglavlje 1). Ako L-PFR nije u stanju da potpiše račun, na primer zato što kartica nije ubačena ili traži PIN, on to javi statusom koji Otkucaj prikazuje (poglavlje 22).

Kada se provera obavlja. Status veze se proverava pri otvaranju početne strane i pri otvaranju Podešavanja, i prikazuje se uživo na kartici Okruženje i PFR. Isto rukovanje se ponavlja pri preuzimanju poreskih stopa (18.6) i pri svakom izdavanju računa. Neuspešna autentifikacija zaustavlja rad pre nego što se napravi šteta: dugme Izdaj račun je isključeno, a razlog je ispisan iznad korpe, dakle pre nego što kasir otkuca celu korpu, a ne tek kad pokuša da izda račun.

18.3 Bezbednosni element

Na kartici Bezbednosni element stoje dva odvojena okvira, jedan za test i jedan za produkciju. U svaki se postavlja njegov sertifikat (.pfx ili .p12) i njegova lozinka. Lozinka se čuva šifrovano, a sama datoteka stoji van veb direktorijuma i nikada se ne služi posetiocima.

Ako je Otkucaj instaliran lokalno na Windows računaru, umesto otpremanja datoteke možete upotrebiti sertifikat koji je već instaliran na tom računaru: izaberite skladište i unesite otisak sertifikata. Na otkucaj.com ta mogućnost ne postoji i ne može da postoji, jer server ne vidi skladište sertifikata vašeg računara.

Prikaz uz svaki sertifikat navodi kome je izdat, do kada važi i njegov otisak. Okvir se oboji i upozori trideset dana pre isteka, i posebno kada je istekao.

Smart karticu koju izdaje Poreska uprava koristi L-PFR, ne Otkucaj. Otkucaj kartici ne pristupa: on sa L-PFR-om razgovara preko mreže. Detaljnije u poglavlju 1.

18.4 Podaci o obvezniku

PIB, poslovno ime, naziv prodajnog mesta i adresa: štampaju se u zaglavlju svakog računa i isti su u oba okruženja. Moraju se poklapati sa podacima o poslovnom prostoru koje ste prijavili Poreskoj upravi. Proverite ih pre prvog računa.

Tu je i pregled O aplikaciji sa podacima koji identifikuju ovaj primerak programa: Proizvođač, naziv proizvoda, Verzija softvera, Serijski broj instalacije i ESIR broj. Serijski broj (oblik OTK-XXXXXXXXXXXX) dodeljuje se automatski pri prvom pokretanju, jedinstven je za tu instalaciju i ne menja se ni posle nadogradnje ni posle vraćanja rezervne kopije; navedite ga kad prijavljujete problem. Tu su i dugme Instaliraj aplikaciju (poglavlje 3) i dugme Vodič koje ponovo pokreće vodič kroz prve korake (poglavlje 5).

18.5 Štampa i plaćanje

Veličina papira (A4, rolna 80 mm, rolna 58 mm), širina računa u znakovima (uobičajeno 40 za rolnu od 80 mm i 32 za rolnu od 58 mm) i režim načina plaćanja: standardni sa svih sedam načina ili režim po čl. 6 st. 2 Pravilnika, obavezan za uslugu hrane i pića za konzumaciju na licu mesta i za pekare (poglavlje 8). Jedna instalacija radi isključivo u jednom režimu plaćanja.

To podešavanje opisuje papir na koji se štampa žurnal i upisuje se u pravilo @page, pa štampač dobija list koji je odabran, a ne onaj koji je u njemu zatečen. Račun kao dokument na A4 i A5 (poglavlje 6.2) ne zavisi od tog podešavanja: format se bira na samoj stranici računa i u pozivu API-ja, jer ista prodavnica često štampa račun na rolni za kupca na kasi i na A5 uz pošiljku.

18.6 Porezi

Pregled važećih oznaka i stopa: Đ 20%, E 10%, G 0%, A van PDV. Merodavan je PFR, ne ova tabela. Dok je povezan L-PFR ili V-PFR, stope se ne mogu menjati ručno: polja su zaključana, a dugme Preuzmi stope sa PFR-a ih osvežava iz izvora. Tako aplikacija ne može da obračuna porez po stopi koju je neko ukucao.

U demo režimu nema PFR-a od koga bi se stope preuzele, pa ostaju uredive i važe podrazumevane srpske stope.

Skup poreskih oznaka nije ugrađen u program. Preuzimanje zamenjuje celu lokalnu tabelu onom koju je PFR vratio, oznaku po oznaku, uključujući i naziv poreske kategorije uz svaku. Ako Poreska uprava uvede novu oznaku, promeni stopu ili povuče postojeću, to se pojavi prvim sledećim preuzimanjem i odmah se štampa na računu, bez izmene aplikacije i bez nove verzije. Broj oznaka nije ograničen na četiri: u test sistemu Poreske uprave ih je, na primer, devet.

18.6.1 Zaokruživanje

Svi novčani iznosi vode se i prikazuju na dve decimale, a količina na tri. Zaokružuje se tako što se druga decimala povećava ako je sledeća cifra 5 ili veća, a ostaje ista ako je manja od 5: 1,005 postaje 1,01, a 1,004 postaje 1,00. Tako se dobijaju iznos stavke (količina puta jedinična cena, sa popustom ako ga ima), ukupan iznos računa, iznos svakog plaćanja i povraćaj. Količina se vodi na tri decimale zato što se roba prodaje i na meru, pa 0,375 kg ostaje 0,375; na računu se suvišne nule ne ispisuju.

Poreske iznose aplikacija ne računa. Obračunava ih PFR po stopama koje važe u tom trenutku i vraća ih u odgovoru, na dve decimale, a Otkucaj ih prikazuje i štampa tačno onako kako ih je primio, bez sopstvenog zaokruživanja. Iz istog razloga i porez po oznakama i ukupan porez na računu dolaze od PFR-a (poglavlje 25).

18.7 Korisnici i uloge

Otvaranje naloga, dodela uloge (administrator ili kasir), reset lozinke, deaktivacija kasira koji više ne radi. Ovde se i odobravaju nalozi pristigli sa stranice za registraciju: takav nalog je neaktivan dok ga administrator ne aktivira (poglavlje 4).

18.8 API ključevi

Generisanje i opoziv ključeva za integracije (poglavlje 20). Ključ se prikazuje samo jednom, pri generisanju: odmah ga sačuvajte na sigurno mesto. Kompromitovan ključ odmah opozovite i generišite nov.

18.9 Telegram obaveštenja

Odeljak Obaveštenja šalje poruku u vaš Telegram za svaki izdati račun: vrsta računa, iznos, načini plaćanja, PFR broj, brojač i link za proveru. Posebno je korisno vlasnicima koji su veb prodavnicu povezali preko API-ja (poglavlje 20), jer svaku fiskalizovanu porudžbinu vide uživo, na telefonu.

1. Bot token: u Telegramu otvorite @BotFather, komandom /newbot napravite svog bota i iskopirajte dobijeni token.
2. Chat ID: broj vašeg razgovora; najlakše ga saznajete od bota @userinfobot. Može biti i ID grupe, ako obaveštenja treba da vidi više ljudi: u tom slučaju dodajte svog bota u grupu.
3. Uključite prekidače za račune preko API-ja i/ili i za račune sa Kase, prema tome koje račune želite da pratite.
4. Kliknite Pošalji probnu poruku: ako poruka stigne u Telegram, podešavanje je ispravno.

Kada je Telegram podešen, na istu adresu stiže i obaveštenje o svakoj novoj registraciji naloga (poglavlje 4).

18.10 Dnevnik rada

Hronološki zapis: ko je i kada izdao račun, menjao artikle, podešavanja, korisnike i ključeve, uključujući i promenu okruženja i postavljanje sertifikata, sa vremenom i IP adresom. Prikazuje se poslednjih 200 radnji.

19.Rad bez interneta

Otkucaj ima tri sloja rada bez mreže, i važno je razumeti šta koji garantuje:

1. Aplikacija se otvara i oflajn (PWA)

Instalirana aplikacija čuva svoj kod i šifarnik artikala lokalno u uređaju. Kasa se zato otvara i bez interneta: artikli, pretraga, korpa i otvoreni računi rade normalno.

2. Lokalni red čekanja

Ako veza prema serveru pukne baš u trenutku izdavanja, račun se ne gubi: ulazi u lokalni red čekanja, vidljiv na Kasi sa brojem računa na čekanju. Čim se veza vrati, Otkucaj ih automatski šalje i izdaje redom.

Tri stvari se dešavaju iza scene da red ne bi napravio veću štetu od samog prekida:

• Nijedan račun ne može biti izdat dva puta. Svaki račun nosi svoj ključ zahteva. Ako odgovor servera propadne na putu nazad, što izgleda isto kao da zahtev nikada nije ni stigao, ponovno slanje vraća isti račun umesto da izda nov. Dvostruki fiskalni račun se ne može obrisati, samo refundirati, pa se ovde sprečava a ne popravlja.
• Odbijen račun se ne gubi u tišini. Ako server trajno odbije račun iz reda, na primer zbog neispravnog podatka, on izlazi iz reda i Kasa ispisuje razlog i njegov ključ. Ranije je takav račun nestajao bez traga.
• Privremena greška ne blokira kasu. Ako je PFR trenutno nedostupan, račun ostaje u redu i pokušaj se ponavlja na svakih 30 sekundi, a ne u petlji.

3. Potpuna oflajn fiskalizacija: L-PFR

Jedini način da se računi fiskalizuju bez interneta je L-PFR na istom računaru (localhost) ili u lokalnoj mreži: lokalni procesor potpisuje račune oflajn, a podatke Poreskoj upravi isporučuje čim se veza uspostavi, a najkasnije u roku od 5 dana od dana izdavanja svakog računa. V-PFR, nasuprot tome, zahteva internet za svako izdavanje: za rad bez interneta koristite L-PFR.

20.Integracije: API i WooCommerce

Otkucaj API v1

API služi za izdavanje računa iz veb prodavnica, ERP-a i drugih sistema. Autentifikacija je Bearer ključem iz Podešavanja; ograničenje je 240 zahteva u minutu po ključu. Puna specifikacija sa šemama zahteva i odgovora: /api-docs.

curl -H "Authorization: Bearer VAS_KLJUC" https://otkucaj.com/api/v1/status

Greške dolaze u obliku {"error":{"code":"...","message":"..."}}:

WooCommerce dodatak

Za WordPress prodavnice postoji gotov dodatak koji automatski fiskalizuje porudžbine:

1. Preuzmite otkucaj-fiskalizacija.zip.
2. U WordPress upravi: Dodaci, Dodaj novi, Otpremi dodatak; izaberite preuzeti zip, kliknite Instaliraj, pa Aktiviraj.
3. U podešavanjima dodatka unesite: adresu Otkucaja (https://otkucaj.com), API ključ (generisan u Podešavanjima Otkucaja), status porudžbine koji okida izdavanje računa (onaj u kom, kako mi razumemo čl. 6 st. 1 Zakona o fiskalizaciji, nastaje promet ili prijem avansa; odredite ga sa knjigovođom), i mapiranje načina plaćanja WooCommerce-a na fiskalne načine plaćanja.
4. Po izdavanju, dodatak u svaku porudžbinu upisuje PFR broj računa i link za proveru, pa su vidljivi i trgovcu i kupcu. Račun kupcu i dalje treba dostaviti, na primer e-poštom (poglavlje 15.2).
5. Ako pojedini proizvodi idu po drugoj poreskoj oznaci, postavite im meta polje otkucaj_label (vrednost: Đ, E, G ili A).

21.Bezbednost i čuvanje podataka

• Sav saobraćaj ide isključivo preko HTTPS-a.
• Lozinke se čuvaju samo kao heševi savremenim algoritmom; niko, ni administrator, ne može pročitati tuđu lozinku.
• Nalozi imaju uloge sa različitim pravima (poglavlje 4); podešavanja i ključevi su dostupni samo administratoru.
• Svaka radnja se beleži u dnevnik aktivnosti sa vremenom i IP adresom.
• API ključevi se prikazuju samo jednom i mogu se opozvati u svakom trenutku.
• Ograničenje broja zahteva (rate limiting) štiti i prijavu i API od zloupotrebe.
• Svi obrasci su zaštićeni od CSRF napada.
• Baza podataka se automatski arhivira svakog dana.

22.Rešavanje problema

23.Često postavljana pitanja

Da li je Otkucaj odobren od Poreske uprave?
Jeste: evidencioni broj 1667, verzija 1.3.6, klasifikacija 3 (napredni ESIR). Poreska uprava ju je odobrila 8. septembra 2026; ranija verzija 1.3.5 vodi se pod brojem 1651 i ostaje odobrena. Nov nalog ipak počinje u test okruženju, gde računi nisu fiskalni. Za produkciju unosite svoj bezbednosni element i PAK, ESIR broj 1667 i prelazite na L-PFR ili V-PFR. Verzija 1.3.6 donosi račun kao dokument na A4 i A5 (poglavlje 6.2).

Moram li nešto da instaliram?
Sam Otkucaj ne: radi u pregledaču. Instalacija kao aplikacija (PWA) je opciona i preporučena zbog rada bez interneta i brže prečice. Kako mi razumemo čl. 6 st. 4 Zakona o fiskalizaciji, obveznik koji radi sa V-PFR-om mora u svakom poslovnom prostoru da ima i L-PFR, koji se instalira odvojeno; izuzeti su promet na malo isključivo preko interneta i promet sopstvenih korišćenih pokretnih materijalnih sredstava (poglavlje 1.1).

Koji štampač mi treba?
Bilo koji termalni štampač rolne 58 ili 80 mm sa drajverom za vaš sistem, ili običan A4 štampač. Štampani QR kod mora biti kvadrat od 40 do 50 mm i ne sme biti odštampan preko slike ili logoa (čl. 10 Pravilnika o vrstama fiskalnih računa).

Šta se dešava kad nestane internet?
Uz V-PFR račun se bez interneta ne može izdati: Kasa se otvara, ali račun čeka u lokalnom redu i nije izdat dok veza ne proradi. Kako mi razumemo Zakon o fiskalizaciji, promet se ne završava bez fiskalnog računa, a obveznik sa poslovnim prostorom mora da ima L-PFR, koji račune potpisuje i bez interneta (poglavlje 19).

Pogrešio sam račun. Mogu li da ga izmenim?
Ne, izdati fiskalni račun se ne menja. Poništite ga refundacijom sa sopstvenim PIB-om kao ID kupca, pa izdajte ispravan račun (poglavlje 10). Ako je izostao ID kupca, to je, kako mi razumemo Tehničko uputstvo, moguće samo neposredno posle prometa.

Kako da prenesem artikle iz starog programa?
Izvezite ih u CSV i uvezite u Otkucaj (poglavlje 16). Za veće šifarnike to je posao od nekoliko minuta.

Može li više kasira da radi istovremeno?
Da. Svaki kasir ima svoj nalog, a ime kasira stoji na svakom računu. Jedan kasir uz to može držati više otvorenih računa u karticama.

Radi li Otkucaj na telefonu i tabletu?
Da, ekran kase je prilagođen dodiru i malim ekranima, a aplikacija se instalira i na Android i na iPhone.

Kako kupac proverava račun?
Skeniranjem QR koda sa računa, odnosno otvaranjem linka za proveru. Fiskalni računi se proveravaju u sistemu Poreske uprave (suf.purs.gov.rs); demo računi vode na demo proveru i jasno su označeni.

Šta je ESIR broj i odakle mi?
To je broj pod kojim je ESIR upisan u registar odobrenih elemenata fiskalizacije. Dodeljuje se pri odobrenju; administrator ga upisuje u Podešavanja i od tada se štampa na svakom računu.

24.Podrška

Kontakt: obrazac na otkucaj.com/kontakt

Da bismo pomogli brzo, u prijavi problema navedite:

• naziv obveznika i prodajnog mesta;
• PFR režim (Demo, L-PFR ili V-PFR);
• tačan datum i vreme događaja (npr. 19.08.2026 u 14:35);
• PFR broj računa, ako se tiče konkretnog računa;
• tačan tekst poruke o grešci, a idealno i snimak ekrana;
• korake koji su prethodili problemu;
• uređaj i pregledač (npr. Windows 11, Chrome; Android, instalirana aplikacija).

Zvanične informacije o fiskalizaciji: purs.gov.rs. Pogledajte i API dokumentaciju, Politiku privatnosti i Uslove korišćenja.

25.Zabranjene funkcije i granice aplikacije

Postoje tri radnje koje ESIR ne sme da radi i koje moraju biti izričito navedene u korisničkoj dokumentaciji. Navedene su ovde jedna po jedna, svaka sa opisom kako je sprovedena u Otkucaju, da ne bi ostale stvar poverenja.

Bez podataka od PFR-a račun se ne izdaje

Otkucaj ne izdaje nijednu vrstu računa dok od PFR-a sa kojim je povezan ne dobije potrebne podatke. PFR broj, brojač računa, PFR vreme, poreski pregled i potpis ne mogu se uneti ručno, ne mogu se izmeniti i ne postoji ekran na kome bi se to moglo. Ako PFR odbije zahtev ili je nedostupan, račun nije izdat: na ekranu stoji razlog, u registru računa nema ništa, ništa ne ulazi u izveštaje i nema šta da se odštampa. Račun koji čeka u lokalnom redu (poglavlje 19) takođe nije izdat račun: on još nije prošao kroz PFR, aplikacija ga tako i označava i ne prikazuje ga kao račun. Ako instalacija uopšte nije spremna za izdavanje, na primer nema ESIR broj ili sertifikat, dugme Izdaj račun je isključeno pre nego što se korpa otkuca, a razlozi su ispisani (18.2.1).

Isto pravilo važi i za ugrađeni demo simulator, zato što ni on nema PFR. On ne može da napravi fiskalni račun nijedne vrste, ni Promet Prodaju: svaki dokument koji proizvede nosi poruku OVO NIJE FISKALNI RAČUN u dvostrukoj veličini slova na oba kraja, i red DEMO SIMULATOR, BEZ PFR-a odmah ispod početne linije. Demo je podrazumevano stanje sveže instalacije, dakle prvi dokument koji neko može da odštampa, pa on ni izgledom ne sme da liči na fiskalni račun.

Fiskalni deo računa se ne menja

Tekst fiskalnog računa sastavlja i potpisuje PFR. Otkucaj ga prikazuje, štampa, šalje e-poštom i daje za preuzimanje znak po znak onako kako ga je primio: iz njega ne briše ništa i ne menja nijedan podatak koji je PFR vratio. Ono što aplikacija dodaje od sebe ima propisano mesto: red Povraćaj ulazi u blok plaćanja, odmah iza poslednjeg reda plaćanja; QR kod i linija za potpis kupca na Kopiji Refundacije stoje unutar okvira računa, između PFR metapodataka i završne linije; jedino reklamni tekst stoji ispod linije KRAJ FISKALNOG RAČUNA. Jedina obrada samog teksta je prelom predugačkog reda na širinu rolne, pri čemu se nijedan znak ne dodaje i ne uklanja, a prelom pada na razmak koji je u redu već postojao. Preuzimanje žurnala kao .txt daje zapisani tekst bez ijedne takve izmene, jer je žurnal zapis računa.

Isto pravilo važi i za račun kao dokument na A4 i A5 (poglavlje 6.2), samo drugim putem. Tamo se ne prenosi žurnal nego se račun sastavlja po mapi elemenata koju propisuje Tehnički vodič za ESIR bez žurnala: svaka vrednost dolazi iz zahteva za fiskalizaciju i iz odgovora PFR-a, nijedan iznos se ne računa ponovo, nijedan element iz odeljka 16 ne izostaje i nijedan se ne menja. Raspored tih elemenata je propisan i naš je samo u onom što propisi izričito ostavljaju ESIR-u: izgled, font i prostor iznad i ispod fiskalnog računa. Ispod završne linije i na tom obliku stoje samo reklamno polje i red sa nazivom proizvoda i serijskim brojem, koji nije deo fiskalnog računa.

Podaci izdavaoca u zaglavlju se ne prepisuju

Pet redova zaglavlja (PIB, obveznik, mesto prodaje, adresa i grad) formira PFR pri fiskalizaciji i vraća ih ESIR-u u odgovoru. Otkucaj ih ispisuje onako kako ih je primio i ne zamenjuje ih vrednostima iz svojih podešavanja, čak ni kada se razlikuju: podešavanja opisuju obveznika u samoj aplikaciji, a zaglavlje je ono što je Poreska uprava registrovala uz bezbednosni element i što je PFR potvrdio. Uz svaki račun se pamti i podatak o obvezniku onako kako ga je PFR vratio, pa dokument izrađen mesecima kasnije prikazuje obveznika kao u trenutku izdavanja, a ne kako podešavanja glase tog dana.

Iz istog pravila sledi i ono što stoji u poglavlju 18.6: poreske stope koje se primenjuju na račun su isključivo stope koje je vratio L-PFR ili V-PFR. Aplikacija ih ne računa, ne pamti sopstvenu verziju i ne dozvoljava ručni unos dok je PFR povezan.

26.Indeks: upitnik Poreske uprave, stavka po stavka

Tabela ispod povezuje svaku stavku odeljaka 9 do 16 upitnika za administrativni i tehnički pregled funkcionalnosti ESIR-a sa mestom u ovom uputstvu na kome je ta stavka opisana. Svaka oznaka u trećoj koloni je link na to poglavlje.