LogiLL ESIR — korisničko uputstvo
Verzija programa: 0.1.20 · IGAL SOFT DOO · https://logill.com
1. Prijava

Program se otvara ikonom LogiLL ESIR na desktopu (pokreće se i sam pri uključivanju računara). Kasir se prijavljuje svojim korisničkim imenom i lozinkom. Ime i prezime prijavljenog kasira štampa se na svakom računu. Prijava traje 24 sata; „Odjava" je u dnu menija. Novog kasira dodaje vlasnik (pogl. 9.4).
2. Ekran i meni

- Gore levo: logo, naziv programa i verzija; klik vodi na „O programu".
- Na vrhu svake strane: naziv firme, PIB, poslovna jedinica i mesto.
- Meni: Prodaja (Maloprodaja, Pregled računa, Izveštaji) · Šifarnici (Artikli, Kupci, Poreske stope) · Podešavanja (Firma, PFR i štampa, Korisnici, Integracije — pogl. 13) · Sistem (Status, O programu).
2.1 Pokretanje i veza sa PFR-om (Sistem → Status)
- Pri svakom pokretanju LogiLL ESIR se javlja procesoru fiskalnih računa (L-PFR) i proverava ga: da li je dostupan, njegov status (opšti statusni kodovi, npr. „Potreban PIN“, „Bezbednosni element nije umetnut“), da li je PIN bezbednosnog elementa prihvaćen i koje poreske stope važe. Provera se zatim ponavlja na svakih 5 minuta.
- Račun se ne izdaje dok PFR nije spreman. Dok L-PFR traži PIN, kasa piše „PFR traži PIN“. PIN se unosi u L-PFR-u (kod LogiLL LPFR-a: desni klik na ikonu pored sata → „Unesi PIN kartice…“); LogiLL ESIR PIN ne unosi i ne čuva.
- Sa L-PFR-om program komunicira preko HTTP protokola, u skladu sa Tehničkim vodičem Poreske uprave (adresa PFR-a se podešava u Podešavanja → PFR i štampa; v. Uputstvo za konfiguraciju, pogl. 3). V-PFR (HTTPS) ova verzija ne podržava.
- Stanje se vidi u meniju Sistem → Status: PFR dostupan, PIN prihvaćen, statusni kodovi sa opisom, poreske stope, licenca.
3. Izdavanje računa — Maloprodaja
3.1 Vrsta i tip računa
Desno gore se bira vrsta (Promet, Avans, Predračun, Obuka) i tip (Prodaja, Refundacija). Za običnu prodaju: Promet + Prodaja (podrazumevano).
- Promet — fiskalni račun za prodaju robe/usluge.
- Avans — uplata unapred (pogl. 6.1).
- Predračun i Obuka — nisu fiskalni račun; na njima piše „ОВО НИЈЕ ФИСКАЛНИ РАЧУН". Obuka služi za vežbu kasira.
- Kopija se ne pravi ovde, nego iz Pregleda računa (pogl. 8.1).
3.2 Unos stavki
- Stavka se kuca u jednoj liniji: Artikal | Količina | Cena | Dodaj. U polje Artikal skenirajte barkod (GTIN) ili ukucajte šifru ili deo naziva; ispod se nudi lista artikala (strelice ↑ ↓ biraju). Enter bira artikal i puni cenu iz šifarnika, pa kursor ide na Količinu (Enter) → Cenu (Enter) i stavka je dodata; kursor se vraća u polje Artikal. Esc čisti unos.
- Cena u liniji važi samo za taj račun (šifarnik se ne menja). Isti artikal sa istom cenom povećava količinu postojećeg reda, a sa drugom cenom ide kao poseban red.
- Ukupno i dugme Naplati su na vrhu desne kolone, pa se iznos vidi dok se kucaju stavke.
- Čitač bar koda radi kao tastatura (upisuje broj u polje Artikal) i ne komunicira sa PFR-om, pa ne ometa njegov rad. Vage i drugi uređaji se ne povezuju sa programom.
- Količina u korpi: dugmad − / + u redu stavke.
- Izbacivanje stavke pre izdavanja: „Ukloni".
- Popust na stavku: u koloni Popust % upišite procenat (npr. 10). Važi samo za taj račun. PFR-u ide već umanjena cena, a naziv stavke dobija nastavak, npr. „(-10%)“. Ispod polja se vidi cena posle popusta.
- Izmena cene: kliknite cenu u redu, upišite novu, Enter. Nova cena važi samo za taj račun (šifarnik se ne menja); promenjena cena je označena žuto. Cena mora biti veća od nule. Esc vraća staru cenu.
- Iznosi se zaokružuju na dve decimale (polovina na više: 1,005 → 1,01).
- Ukupno, osnovica i PDV po poreskoj oznaci vide se ispod korpe, takođe zaokruženi na dve decimale (polovina na više). Konačne iznose poreza računa PFR i oni se štampaju na računu.
3.3 Referentni broj
Polje „Referentni broj / Referentno vreme" pojavljuje se kad se račun poziva na drugi račun:
| Račun | Referentni broj | Šta se unosi |
|---|---|---|
| Refundacija | obavezan | PFR broj i PFR vreme računa koji se refundira |
| Avans (sledeća uplata) | po potrebi | prethodni avans |
| Promet iz predračuna | opciono | PFR broj predračuna |
Ako je račun u žurnalu ove kase, vreme se popuni samo kad se upiše broj. Broj i vreme idu zajedno.
3.4 Gde ide račun
Ispod korpe su kvačice za izlaze koji su uključeni (termalni štampač, A4, elektronski — PDF). Bar jedan mora biti izabran.
3.5 Prečice
| Taster | Radnja |
|---|---|
| Enter (u pretrazi) | dodaj artikal |
| F12 | Naplata |
| F8 | gotovina tačno — odmah izdaje račun |
| F4 | otkaži račun (uz potvrdu) |
| Esc | briše polje; na praznom polju otkazuje račun (uz potvrdu) |
4. Naplata (F12)
Panel Naplata pokazuje iznos za naplatu i načine plaćanja koje radnja koristi: Gotovina, Platna kartica, Ček, Prenos na račun, Vaučer, Instant plaćanje, Drugo bezgotovinsko.
- Za gotovinu se kuca koliko je kupac dao — program pokazuje kusur. Prvi Enter pokaže kusur, drugi izdaje račun.
- F1–F7 stavljaju ceo preostali iznos na izabrani način.
- Mešovito plaćanje: upišite iznos na više načina (npr. deo karticom, ostatak gotovinom); gotovina je uvek ostatak dok je ne promenite ručno.
- Dve kartice (ili dva čeka, dva instant plaćanja): dugme „+" pored reda ili taster +.
- Zbir mora biti tačno iznos računa; kusur daje samo gotovina.
- Kod refundacije nema kusura.
- Ako je kasa podešena na režim bez kartice, čeka i instant plaćanja (pogl. konfiguracije 4), ti načini se ne nude — kasir ih unosi kao gotovinu.
Posle izdavanja, ispod Ukupno se pojavljuje zelena kartica „✓ Račun fiskalizovan“: - vrsta i tip računa (npr. PROMET · PRODAJA), PFR broj, brojač i iznos; - KUSUR krupno, kad ga ima; - žuto upozorenje ako štampač nije odštampao — račun je ipak izdat, a primerak se dobija kao Kopija iz Pregleda računa; - dugme Prikaži račun → — otvara baš taj račun u Pregledu računa. Odatle dugme ← Nazad na Maloprodaju (i taster Nazad u pregledaču) vraća na kasu.
Kartica ostaje dok se ne izda sledeći račun.

5. Kupac na računu (identifikacija kupca)
Kupac se unosi samo kad mora da se identifikuje (npr. firma, refundacija).
- Pretraga kupca iz spiska (naziv, PIB, JMBG…) ili ručni unos ID-a u obliku
šifra:broj, npr.10:104087401(PIB),20:009876543(lična karta). - Ako kupac iz spiska ima više dokumenata, birate koji ide na račun.
- Opciono polje kupca (npr.
20:broj SNPDV,50:broj korporacijske kartice) unosi se samo uz ID kupca. - Program proverava oblik broja i kontrolnu cifru PIB-a i JMBG-a pre slanja.
- Naziv i adresa kupca iz spiska štampaju se ispod fiskalnog računa.
Šifre ID kupca: 10 PIB · 11 JMBG (preduzetnik) · 12 PIB:JBKJS · 13 penzionerska kartica · 14 PIB poljoprivrednog gazdinstva · 15 JMBG poljoprivrednog gazdinstva · 16 BPG · 20 lična karta · 21 izbeglička legitimacija · 22 EBS · 23 pasoš · 30 strani pasoš · 31 diplomatska legitimacija/LK · 32–35 lična karta MKD/MNE/ALB/BIH · 36 lična karta EU/CH/NO/IS · 40 strani poreski broj. Opciono polje: 20 SNPDV · 21 LNPDV · 30–33 PPO/ZPPO/MPPO/IPPO-PDV · 50 broj korporacijske kartice · 60 period storna korporacijskih kartica.
6. Posebni računi
6.1 Avans
- Vrsta Avans, tip Prodaja. Umesto artikala unosi se iznos uplate po poreskoj stopi („Uplata avansa" → stopa, iznos, Dodaj). Naziv stavke („10: Аванс") sastavlja program.
- Ako je novac uplaćen ranije (virman), upišite Datum uplate — štampa se kao ESIR vreme.
- Polje Reklama (predmet avansa) štampa se ispod računa.
- Sledeća uplata za isti posao: Pregled računa → avans → Nova uplata avansa (poziva se na prethodni).
- Zatvaranje: Pregled računa → avans → Zatvori avans (konačni račun) → otkucajte artikle koji su predmet prometa → Naplata (naplaćuje se samo ostatak). Program sam izdaje Avans-Refundaciju na zbir uplata i zatim konačni račun; na računu piše Плаћено авансом, ПДВ на аванс i Преостало за плаћање.
6.2 Promet iz predračuna
Pregled računa → predračun → Promet iz predračuna: otvara se Maloprodaja sa stavkama, cenama i kupcem sa predračuna i referencom na predračun. Proverite stavke pa Naplata.
6.3 Promet bez naknade (poklon)
Promet + Prodaja → uključite Promet bez naknade. Na računu: „00:" ispred naziva svake stavke, način plaćanja Drugo bezgotovinsko, a ispod računa napomena kupcu da je promet bez naknade. F12 traži samo potvrdu. (Uzorci, reklamni materijal i pokloni male vrednosti se ne evidentiraju.)
6.4 Jednonamenski vaučer
Promet → uključite Jednonamenski vaučer → izaberite poresku stopu i upišite iznos → Postavi → Naplata. Jedan vaučer po jednoj stopi na računu. Kada kupac vaučerom plaća robu, fiskalni račun se ne izdaje. Povraćaj novca za vaučer: Refundacija (pogl. 8.2).
6.5 Korporacijska kartica
ID kupca + opciono polje 50: broj kartice; način plaćanja je uvek Vaučer (Naplata nudi
samo njega).
7. Pregled računa (elektronski žurnal)

- Lista izdatih računa: PFR datum i vreme, broj, vrsta, iznos, status. Podrazumevano današnji dan; za druge dane promenite od / do (prazno = svi računi).
- Pretraga po PFR broju (nalazi i kopije i refundacije tog računa), ID-u ili nazivu kupca; filter po vrsti.
- Klik na red otvara račun — slika računa tačno kakav je odštampan (prikaz Traka ili A4), kupac, kasir, gde je izdat, link za proveru na portalu Poreske uprave.
- ← Nazad vraća listu na isto mesto. Ako je račun otvoren sa kase (dugme Prikaži račun → posle fiskalizacije), dugme glasi ← Nazad na Maloprodaju i vraća na kasu:

- Statusi: Fiskalizovan · Greška (PFR nije prihvatio — poruka je na računu) · Nije fiskalizovano (PFR nije podešen).
8. Kopija, refundacija, storno (iz Pregleda računa)
8.1 Kopija
Dugme Kopija na fiskalizovanom računu: izdaje se Kopija sa istim stavkama i referencom na original. Na njoj krupno piše „ОВО НИЈЕ ФИСКАЛНИ РАЧУН". Original se štampa samo jednom.
8.2 Refundacija (povraćaj kupcu)
- Dugme Refundacija → panel sa stavkama: kupljeno / već vraćeno / koliko se vraća. Može ceo račun ili deo.
- ID kupca koji prima novac je obavezan (npr.
20:broj lične karte). - Način povraćaja: istog dana kao original — istim načinom (i na karticu); kasnije ili posle dnevnog preseka na POS terminalu — samo gotovinom.
- Posle refundacije program odmah izdaje i Kopiju refundacije sa mestom za potpis kupca (za svaki način povraćaja — gotovinom i na karticu) — kupac je potpisuje i ona ostaje u radnji.
8.3 Storno — poništavanje pogrešnog računa
Kada je račun izdat greškom (pogrešna količina, cena, kupac…): dugme Storno → potvrda. Program izdaje refundaciju celog računa sa PIB-om vaše firme kao ID kupca i referencom na pogrešan račun. Zatim izdajte nov, ispravan račun. Storno ne može ako je deo računa već refundiran. Ako je kupac pravno lice ili preduzetnik, obavestite ga da je račun poništen. Avans se stornira samo poslednja uplata, dok avans nije zatvoren.
9. Šifarnici
9.1 Artikli
„+ Novi artikal" ili Izmeni u redu: šifra (prazno = sledeći broj), naziv, jedinica mere, cena, poreska stopa (samo stope od PFR-a), barkod/GTIN, status. Ispod barkoda piše da li je ispravan GTIN (šalje se PFR-u). Na računu se naziv štampa sa jedinicom mere, odvojeno kosom crtom (npr. „Ceđeni sok/l“, „Sveska/kom“). Artikal koji je već na računu se ne briše — postavlja se na Neaktivan. Izvoz/Uvoz: TXT (otvara se u Excel-u), JSON, XML; uvoz prvo pokaže koliko je novih i izmenjenih, a upisuje tek posle potvrde; ako u fajlu ima grešaka, ništa se ne upisuje.
9.2 Kupci
Pravno ili fizičko lice, naziv / ime i prezime, adresa, mesto i dokumenti (PIB, JMBG, lična karta, pasoš…) — bar jedan.
9.3 Poreske stope
- Program preuzima poreske stope od PFR-a (konfiguracioni parametri koje PFR vraća pri svakoj proveri, pogl. 2.1) i koristi samo njih. Stope se ne unose i ne menjaju ručno.
- Ekran Šifarnici → Poreske stope prikazuje na zahtev važeće stope: poresku oznaku, naziv poreza i procenat (npr. Ђ = 20%, Е = 10%, Г = 0%).
- Program prihvata onoliko oznaka koliko PFR vrati. Kad Poreska uprava promeni stope ili doda novu oznaku, program ih preuzima sam pri sledećoj proveri, bez nove verzije.
- Artiklu se dodeljuje jedna od tih oznaka (pogl. 9.1). Na fiskalnom računu se uz svaku stavku štampa poreska oznaka, a ispod stavki tabela Ознака / Име / Стопа / Порез — onako kako je vratio PFR.
9.4 Korisnici
Kasiri: korisničko ime, lozinka, ime i prezime (ide na račun). Ne može se obrisati sopstveni nalog ni poslednji aktivni korisnik.
10. Izveštaji (informativni)

Presek stanja (danas od ponoći), Dnevni, Periodični — po vrsti računa i tipu, po načinu plaćanja i po poreskoj stopi, filter po kasiru. Štampa na termalni, A4 ili PDF. Ovo nije fiskalni dokument — na njemu piše „ОВО НИЈЕ ФИСКАЛНИ РАЧУН".
11. O programu

Sistem → O programu: proizvođač, verzija softvera, serijski broj instalacije, ESIR broj i kontakt za podršku. ESIR broj je IB broj/verzija softvera (npr. 1749/0.1.20) i štampa se na svakom računu kao „ЕСИР број:“.
12. Zabranjene funkcije
LogiLL ESIR po konstrukciji ne može da uradi sledeće (tehničko uputstvo, upitnik Deo 9):
- Ne izdaje nijednu vrstu računa ako nije dobio podatke od PFR-a. Račun se prvo zapiše u žurnal, šalje PFR-u, i tek sa odgovorom PFR-a postaje račun koji se štampa. Ako PFR ne odgovori ili odbije, račun ostaje sa statusom Greška i ne štampa se kao fiskalni račun.
- Ne izostavlja i ne menja nijedan obavezni podatak fiskalnog računa koji je primio od PFR-a. Fiskalni deo računa (od „ФИСКАЛНИ РАЧУН" do „КРАЈ ФИСКАЛНОГ РАЧУНА") štampa se tačno kako ga je PFR vratio, sa QR kodom od PFR-a. Program dodaje samo podatke iznad i ispod tih linija (npr. naziv kupca, napomenu).
- Ne izostavlja i ne menja nijednu informaciju iz zaglavlja (podatke o izdavaocu računa) koju je primio od PFR-a.
- Ne koristi druge poreske stope osim onih koje vrati PFR; stope se ne unose ručno.
- Original računa se štampa jednom; svaki naknadni primerak je Kopija izdata preko PFR-a.
13. Integracije — REST API i razmena fajlova (JSON / TXT / XML)
Spoljni softver (knjigovodstvo, magacin, vaša aplikacija) može da izdaje račune i šalje šifarnik kroz LogiLL ESIR na dva načina:
- REST API (HTTP, JSON) — za program koji može da pošalje HTTP zahtev.
- Razmena preko fajlova — za program koji samo upisuje fajlove u folder (JSON; artikli i kao TXT ili XML).
Gotove primere za kopiranje (svaki poziv API-ja, svaka vrsta računa, JSON/TXT/XML fajlovi, odgovori i greške) nalaze se u posebnom dokumentu: Primeri integracije (API i fajlovi).
U oba slučaja račun izdaje i potpisuje LogiLL ESIR (preko PFR-a), po istim pravilima kao na kasi: spoljni softver ne može da zaobiđe nijednu proveru (plaćanja, poreske oznake, ID kupca, referenca, storno…). Štampu takođe radi LogiLL ESIR.
Važno: API je dostupan samo na računaru gde radi LogiLL ESIR (
http://127.0.0.1:<port>, port 8625–8635). Server logill.com ne poziva kasu. Spoljni softver mora da radi na istom računaru ili da ima mrežni pristup tom računaru.
13.1 Priprema: uključivanje integracije
Podešavanja → Integracije.
- Nova integracija (npr. „Knjigovodstvo"): program prikaže API ključ — samo jednom. Kopirajte ga i sačuvajte; program čuva samo otisak, pa se izgubljeni ključ ne može videti, već se pravi Novi ključ (stari odmah prestaje da važi).
- Isključi / Uključi integraciju: isključena odbija zahteve (
401). - Razmena preko fajlova: uključuje se na istom ekranu (podrazumevano je isključena), uz izbor foldera i dugme Proveri (da li program može da piše u folder). Za fajlove ključ nije potreban — kontrola je pristup folderu.
- Dozvoljene adrese (CORS): spisak adresa sa kojih pregledač sme da zove API (podrazumevano
https://logill.com). Za serverske programe nije bitno. - Dnevnik integracija pokazuje svaki poziv (vreme, integracija, radnja, šifra dokumenta, ishod, poruka), čuva se 30 dana — korisno za podršku. Pregled računa pokazuje izvor svakog računa (kasa, API, fajl).
13.2 REST API (v1)
Osnovna adresa: http://127.0.0.1:<port>/api/v1. Svaki zahtev (osim /status) nosi zaglavlje Authorization: Bearer <API ključ>. Telo je JSON u UTF-8; iznosi imaju najviše 2 decimale, količine do 3.
| Poziv | Šta radi |
|---|---|
GET /status |
da li je kasa spremna (PFR dostupan, PIN, licenca); bez ključa |
GET /poreske-stope |
aktivne poreske stope i oznake od PFR-a — spoljni softver svoje stope mapira na ove oznake |
GET /sinhronizacija |
do kog trenutka je ESIR primio artikle i kupce |
PUT /artikli |
dodaje/menja artikle (ključ je sifra); do 5000 odjednom, sve-ili-ništa |
GET /artikli, GET /artikli?sifra=… |
čita artikle |
PUT /kupci |
dodaje/menja kupce (ključ je šifra komitenta) |
POST /racuni |
izdaje račun (promet, avans, predračun, refundacija, kopija, storno) |
GET /racuni?spoljni_id=… |
status računa po šifri dokumenta |
GET /racuni?posle_id=120&limit=200 |
svi računi posle zadatog; služi za usklađivanje |
GET /racuni/{id}/pdf |
PDF računa za arhivu |
Primer — provera spremnosti i izdavanje računa (PowerShell):
$k = @{ Authorization = 'Bearer VAS_API_KLJUC' }
Invoke-RestMethod http://127.0.0.1:8625/api/v1/status
$racun = @{
spoljni_id = 'DOK-58231'; vrsta = 'Promet'; tip = 'Prodaja'; kasir = 'Jovan Jović'
stavke = @(@{ sifra='1001'; naziv='Sok narandža 1l'; jm='kom'; pfr_oznaka='Ђ'; kolicina=2; cena=189.99 })
placanja = @(@{ nacin='Cash'; iznos=379.98; primljeno=400 })
} | ConvertTo-Json -Depth 5
Invoke-RestMethod http://127.0.0.1:8625/api/v1/racuni -Method Post -Headers $k `
-ContentType 'application/json; charset=utf-8' -Body ([Text.Encoding]::UTF8.GetBytes($racun))
Obavezna polja računa: spoljni_id, vrsta (Promet, Avans, Predračun, Obuka), tip (Prodaja, Refundacija), kasir, stavke (šifra, naziv, jm, poreska oznaka, količina, cena veća od 0) i placanja (zbir mora biti jednak iznosu računa). Načini plaćanja su Cash, Card, Check, WireTransfer, Voucher, MobileMoney, Other. Kupac se šalje kao kupac (ID u obliku 10:101234569, tj. šifra vrste dokumenta i broj), obavezan je kod refundacije. Refundacija, kopija i storno su isti POST /racuni sa referenca (broj i vreme originalnog računa); ESIR proverava da stavke i količine postoje na originalu i da ništa nije već vraćeno.
Odgovor (200, i kad je PFR odbio — tada je status: GRESKA i greska kaže razlog):
{ "id": 128, "spoljni_id": "DOK-58231", "status": "FISKALIZOVAN", "iznos": 379.98,
"pfr": { "broj": "DENJ4FJH-DENJ4FJH-33", "vreme": "2026-10-08T08:07:43+02:00",
"url": "https://suf.purs.gov.rs/v/?vl=…", "tekst": "…", "qr_gif": "…" },
"stampa": [ { "izlaz": "TERMALNI", "ok": true } ] }
Zaštita od duple fiskalizacije: spoljni_id je obavezan i jedinstven po integraciji. Ako pošaljete isti spoljni_id ponovo (npr. jer odgovor nije stigao), PFR-u se ništa ne šalje — vraća se već izdat račun. Posle prekida veze prvo pitajte GET /racuni?spoljni_id=…, pa tek onda ponovo šaljite. Poziv je sinhron: čekajte odgovor najmanje 45 sekundi.
Šifre odgovora: 200 uspeh (proverite status) · 400 loš zahtev (ništa nije poslato PFR-u; kod, poruka i polje kažu šta) · 401 pogrešan ili isključen ključ · 402 licenca nije aktivna · 409 U_OBRADI isti račun se već obrađuje · 503 NIJE_SPREMNA PFR nije dostupan ili traži PIN.
13.3 Razmena preko fajlova (JSON, TXT, XML)
Folder razmene (podrazumevano C:\ProgramData\LogiLL ESIR\razmena\, menja se u podešavanjima) ima četiri podfoldera:
| Folder | Ko piše | Šta je u njemu |
|---|---|---|
ulaz\ |
vaš softver | zahtevi za obradu |
izlaz\ |
LogiLL ESIR | odgovori <ime>.odgovor.json i stanje čekanja <ime>.status.json |
obradjeno\ |
LogiLL ESIR | zahtevi koji su uspeli (briše se posle 30 dana) |
greska\ |
LogiLL ESIR | odbijeni zahtevi (razlog je u odgovoru) |
Kako se šalje zahtev:
1. Upišite fajl <ime>.json.tmp, pa ga preimenujte u <ime>.json — program čita samo .json, pa nikad ne pročita nedovršen fajl.
2. Ime neka počinje datumom i vremenom (20261008-081500_DOK58231.json) — obrada ide po imenu, redom. Kodiranje UTF-8, najviše 5 MB. Folder se proverava svake sekunde.
3. Sadržaj je isti JSON kao za API, uz dodatno polje "radnja": "racun" (svi računi, i kopija, refundacija, storno), "artikli" ili "kupci".
{ "radnja": "racun", "spoljni_id": "DOK-58231", "vrsta": "Promet", "tip": "Prodaja",
"kasir": "Jovan Jović",
"stavke": [ { "sifra": "1001", "naziv": "Sok narandža 1l", "jm": "kom", "pfr_oznaka": "Ђ", "kolicina": 2, "cena": 189.99 } ],
"placanja": [ { "nacin": "Cash", "iznos": 379.98 } ] }
Artikli kao TXT ili XML: šifarnik artikala možete poslati i kao tekstualni fajl (.txt, polja razdvojena tabulatorom ili tačka-zarezom, prvi red je zaglavlje — isti oblik koji se otvara u Excel-u) ili .xml; vrsta se prepoznaje po ekstenziji. Isti format radi i Uvoz na ekranu Artikli, pa najlakše je da prvo izvezete postojeće artikle (Šifarnici → Artikli → Izvoz) i uzmete taj fajl kao uzorak.
Odgovor: pročitajte izlaz\<ime>.odgovor.json (isti JSON kao odgovor API-ja) i obrišite ga kad ga preuzmete — program ga sam ne briše. Uspešan zahtev prelazi u obradjeno\, a odbijen u greska\.
Kad PFR nije dostupan (traži PIN, nema veze, licenca neaktivna): fajl ostaje u ulaz\, a u izlaz\<ime>.status.json piše {"status": "CEKA", "razlog": "…"}; na kasi se pojavljuje upozorenje „N računa čeka".
- Ako PFR proradi u roku od 2 minuta (rok se podešava) od pojave fajla, ESIR račun izdaje sam, redom.
- Ako je fajl stariji, ESIR ga ne izdaje sam (kupac verovatno više nije na kasi): status je CEKA_ODLUKU, a kasir na ekranu bira Izdaj izabrane ili Odbaci izabrane.
- Zahtev možete otkazati brisanjem fajla iz ulaz\, dok nije obrađen.
- Ako se program ugasi usred obrade, fajl ostaje u ulaz\; pri ponovnoj obradi spoljni_id vraća već izdat račun, pa ne nastaje dupli fiskalni račun.
13.4 Šta spoljni softver ne može
- Ne može da menja ili zaobilazi poreske stope — dozvoljene su samo oznake koje vrati PFR.
- Ne može da briše artikle (šalje se
"aktivan": false). - Artikli i kupci koje je poslao spoljni softver su na ekranima ESIR-a zaključani za izmenu (menjaju se u spoljnom softveru), a ručno uneti ostaju slobodni.
- Ne može da izda račun dok licenca nije aktivna (
402); šifarnik i pregled računa rade i tada.
13.5 Slanje izdatih računa na spoljni sistem
Ako firma vodi knjigovodstvo ili zalihe u drugom programu (npr. LogiLL PROMET), ESIR može svaki izdat račun da pošalje tom programu. Funkcija je podrazumevano isključena; uključuje se u Podešavanja → Integracije → Slanje izdatih računa (v. Uputstvo za konfiguraciju, pogl. 8).
- Šalje se samo račun koji je PFR potpisao, posle fiskalizacije, sa podacima onakvim kakve je vratio PFR (PFR broj, vreme, brojač, tekst računa, link za proveru), uz stavke, plaćanja i kupca. Račun koji nije fiskalizovan se ne šalje.
- Izdavanje i štampa ne čekaju slanje. Račun se izda i odštampa odmah; slanje ide u pozadini.
- Bez interneta računi čekaju u redu i šalju se sami kad se veza vrati (ponavljanje na 30 s, pa ređe, najviše na 15 min). Dugme Pošalji neposlate odmah ne čeka razmak.
- Spoljni program prima račun i potvrđuje prijem; ne može ništa da promeni u ESIR-u — ni račun, ni žurnal, ni podešavanja.
- Isti račun može stići više puta (npr. posle prekida veze); primalac ga prepoznaje po PFR broju.
- Računi izdati pre podešavanja slanja ne idu sami; dugme Pošalji i ranije račune (uz izbor datuma „od“) stavlja u red sve fiskalizovane račune od tog dana koji još nisu poslati.
- Stanje na ekranu: koliko računa čeka, poslednje poslato, poslednja greška.
14. Poruke i šta znače (izbor)
| Poruka | Značenje |
|---|---|
| „nedostaje X — zbir plaćanja mora biti Y" | zbir načina plaćanja nije jednak računu |
| „povraćaj na platnu karticu je moguć samo istog dana…" | posle dana kupovine vraća se gotovinom |
| „refundacija mora imati ID kupca koji prima novac" | upišite npr. 20: broj lične karte |
| „… ima pogrešnu kontrolnu cifru" | PIB/JMBG je pogrešno ukucan |
| „uz broj korporacijske kartice (50) način plaćanja je uvek Vaučer" | §9.4 |
| „storno mora obuhvatiti ceo račun" | deo računa je već refundiran |
| „Licenca nije aktivna…" | novi računi se ne izdaju dok se licenca ne obnovi; žurnal radi |
| „PFR nije prihvatio račun: …" | poruka PFR-a; račun je u žurnalu sa statusom Greška |