eOtpremnice: portal za slanje otpremnica bez čitača kartica

Ovo je studija slučaja o portalu eOtpremnice, mom proizvodu za slanje i prijem elektronskih otpremnica. Portal radi na adresi eotpremnice.kavon.dev, i registracija je besplatna, uz probni period od 3 meseca. Ako tek ulazite u sistem, rokovi i registracija su u vodiču za eOtpremnice.

Klijent i kontekst

Portal sam napravio za firme koje šalju robu i od 2026. moraju da koriste državni sistem elektronskih otpremnica. Po Zakonu o elektronskim otpremnicama, od 1. 1. 2026. to važi za javni sektor, za isporuke javnom sektoru i za akcizne proizvode, a od 1. 10. 2027. za slanje i prijem između svih firmi u privatnom sektoru. Portal koriste firme koje šalju otpremnice više puta dnevno.

Problem

Pristup državnom sistemu ide preko kvalifikovanog sertifikata na ličnoj karti: čitač kartica na računaru i baš ta osoba prisutna za svaki dokument. Firma koja otprema više puta dnevno time ceo posao vezuje za jednog čoveka. Ako je na terenu ili odsutan, otprema staje.

Uz to se svaka stavka prekucava ručno, iako je roba već prošla kroz fiskalnu kasu i tačno je zapisana u sistemu Poreske uprave. Svako prekucavanje je mesto za grešku.

Ograničenja

Najteži deo je bio sam XML. Državni sistem prima otpremnice samo u formatu UBL 2.1 (međunarodni XML standard za poslovne dokumente), a zvanična uputstva i primeri su slabi, pa je ispravan dokument trebalo sastaviti i proveriti polje po polje.

Drugo ograničenje je bezbednost. API ključ firme otvara pristup njenim dokumentima u državnom sistemu, pa se ne sme čuvati kao običan tekst. Treće je telefon: slanje otpremnice ne sme da čeka da neko sedne za računar, pa portal mora da radi udobno na malom ekranu.

Rešenje

Pristup preko API ključa firme

Firma jednom unese svoj API ključ iz sistema eOtpremnica. Ključ se čuva šifrovan (AES-256-GCM), vezan je za firmu, a ne za osobu, i ko god ima nalog može da pošalje otpremnicu, primi ulaznu ili izda prijemnicu.

Nova otpremnica na jednoj strani

Najčešća radnja je prvo dugme na kontrolnoj tabli. Na jednoj strani su primalac, koji se traži po nazivu ili PIB-u iz baze registrovanih firmi, prevoz iz šifarnika vozača i vozila, i artikli.

Stavke sa fiskalnog računa

Artikli se ne kucaju. Portal pročita QR kod sa fiskalnog računa, kamerom, slikom ili nalepljenim linkom, i iz sistema Poreske uprave sam povuče stavke i količine.

Provera pre slanja

Svaka otpremnica se pre slanja proverava kod državnog validatora XML dokumenata, koji samo proverava i ništa ne kreira. Greška se tako hvata dok se još može ispraviti.

Prijemnice, statusi i akcizna roba

Ulazne i izlazne otpremnice i prijemnice imaju svoje statuse, a dokumenti se povlače iz državnog sistema za izabrani period: 3, 5, 7 ili 10 dana, ili ručno. Portal podržava i akciznu robu, za koju obaveza važi od 1. 1. 2026. U admin delu se odobravaju firme i izdaju licence.

Kako izgleda slanje jedne otpremnice

1. Na kontrolnoj tabli se klikne „Nova otpremnica“, prvo dugme.
2. Bira se tip: eksterna, ka drugoj firmi, ili interna, između sopstvenih objekata. Broj i datum se popunjavaju sami.
3. Primalac se traži po nazivu ili PIB-u, a podaci firme se upisuju iz baze registrovanih firmi.
4. Prevoz se bira iz šifarnika: sopstveni prevoz, vozač i vozilo sa registarskom tablicom.
5. Artikli se uvoze skeniranjem QR koda sa fiskalnog računa, kamerom, slikom ili linkom.
6. Portal proverava XML kod državnog validatora, i tek onda šalje.

Ceo tok staje na jednu stranu i radi isto na telefonu i na računaru.

Za firme koje već imaju svoj program

Portal je najbrže rešenje za firmu bez programa koji pravi otpremnice. Ako firma već ima program za kasu ili magacin, isplati se da otpremnicu pravi on: tada povezujem program sa državnim sistemom, kao kod programa BKC Soft. Kako to izgleda opisano je na stranici eOtpremnice: integracija i portal.

Tehnologije i zašto

Portal je rađen u PHP-u, MySQL-u i JavaScript-u, prvo za telefon. Povezan je sa tri državna sistema: sistemom elektronskih otpremnica Ministarstva finansija, sistemom Poreske uprave za čitanje stavki sa fiskalnog računa i državnim validatorom XML dokumenata. Isto znanje o UBL formatu koristi i servis efakture.exe, preko kog program BKC Soft-a šalje otpremnice; tim putem je poslato preko 5.000 otpremnica.

Rezultat

Portal sam napravio početkom 2026, za oko dve nedelje, i još nedelju dana testirao sve njegove delove. Slanje otpremnica više ne zavisi od jedne osobe i njene lične karte: radi svako ko ima nalog, i sa telefona. Stavke sa fiskalnog računa ulaze skeniranjem umesto prekucavanjem, a provera kod validatora hvata grešku pre slanja. Portal je dostupan i može se isprobati besplatno prva 3 meseca (stanje u oktobru 2026).

Izvori

Rokovi su provereni 4. 10. 2026. u prečišćenom tekstu Zakona o elektronskim otpremnicama („Sl. glasnik RS“ br. 94/2024, 109/2025 i 80/2026), na zvaničnom portalu eotpremnica.efaktura.gov.rs.