Kako deluje davčno potrjevanje računov API: vodič 2026
Davčno potrjevanje računov prek API-ja pomeni, da program samodejno komunicira s FURS. Ko izdate račun, sistem pripravi podatke, jih digitalno podpiše in jih pošlje v potrditev brez ročnega prepisovanja ali dodatnih korakov.
Za delovanje potrebujete namensko digitalno potrdilo, pravilno nastavljen poslovni prostor, elektronsko napravo in programsko opremo, ki podpira FURS API.
Za podjetnike je najpomembneje, da API ni nekaj, kar morajo razumeti tehnično. Dober program za račune vse opravi v ozadju: potrdi račun, shrani EOR, izpiše ZOI in zmanjša možnost napak pri davčno potrjenih računih.
Davčno potrjevanje računov prek API-ja je postopek, pri katerem programska oprema samodejno pošlje podatke o izdanem računu v informacijski sistem FURS in prejme potrditev računa.
V praksi temu pogosto rečemo tudi fiskalizacija računov ali FURS davčno potrjevanje.
Za podjetnika to pomeni, da pri izdaji davčno potrjenega računa ni treba ročno prepisovati podatkov, posebej odpirati drugega sistema ali naknadno potrjevati računa. Program za račune pripravi podatke, izvede podpisovanje, pošlje zahtevo FURS-u in na račun doda potrebne oznake.
To je posebej pomembno pri gotovinskem poslovanju, kartičnih plačilih, mobilnih plačilih, spletnih plačilih in drugih plačilih, ki se po pravilih davčnega potrjevanja obravnavajo kot gotovinska.
Aplikacije, kot je Račun123, imajo FURS API vgrajen neposredno v sistem, zato lahko podjetnik davčno potrjene račune izdaja brez tehničnega znanja.
Kako deluje davčno potrjevanje računov prek API-ja?
Davčno potrjevanje računov prek API-ja deluje kot avtomatizirana povezava med vašim programom za račune in FURS.
Ko izdate račun, program pripravi podatke o računu, jih digitalno podpiše in jih prek varne povezave pošlje FURS-u. FURS podatke preveri in v odgovor vrne enkratno identifikacijsko oznako računa, znano kot EOR.
Zaščitna oznaka izdajatelja računa, znana kot ZOI, se ustvari v programski opremi izdajatelja računa in se skupaj z EOR izpiše na davčno potrjenem računu.
Celoten postopek običajno traja le nekaj sekund.
Osnovni koraki davčnega potrjevanja
- Podjetnik izda račun. V programu za račune izberete stranko, postavke, način plačila in zaključite račun.
- Program pripravi podatke za FURS. Sistem oblikuje podatke o računu v predpisani strukturi.
- Račun se digitalno podpiše. Programska oprema uporabi namensko digitalno potrdilo za davčno potrjevanje.
- Podatki se pošljejo FURS-u. Komunikacija poteka prek varne povezave in predpisanega FURS API-ja.
- FURS vrne EOR. Program shrani potrditev in jo izpiše na računu.
- Račun je zaključen. Na računu se prikažejo podatki, ki dokazujejo davčno potrditev.
Praktičen nasvet: pred prvo uporabo davčnega potrjevanja preverite, ali imate urejen poslovni prostor, elektronsko napravo, blagajnika in namensko digitalno potrdilo. Večina težav pri uvedbi nastane zaradi nepopolnih začetnih nastavitev, ne zaradi samega API-ja.
Kaj potrebujete za davčno potrjevanje prek API-ja?
Za davčno potrjevanje računov prek API-ja ne potrebujete lastnega razvijalca, če uporabljate program, ki ima povezavo s FURS že vgrajeno. Potrebujete pa pravilne podatke in nastavitve.
Najpomembnejši elementi so:
- namensko digitalno potrdilo za davčne blagajne,
- poslovni prostor,
- elektronska naprava,
- oznaka osebe, ki izda račun,
- pravila številčenja računov,
- programska oprema, ki podpira FURS API.
Namensko digitalno potrdilo
Namensko digitalno potrdilo je digitalno potrdilo, ki se uporablja za elektronsko podpisovanje podatkov pri davčnem potrjevanju računov.
Pridobi se prek portala eDavki. Potrdilo je brezplačno, glasi se na zavezanca oziroma poslovni subjekt in velja pet let. Podjetje lahko uporablja eno potrdilo centralno ali več potrdil, odvisno od tehničnih in poslovnih potreb.
Pri uporabi programa, kot je Račun123, potrdilo običajno uvozite v nastavitve davčnega potrjevanja, vnesete geslo in ga povežete s poslovnim prostorom ter elektronsko napravo.
Praktičen nasvet: veljavnost potrdila si označite v koledarju vsaj 30 dni pred potekom. Poteklo digitalno potrdilo je eden najpogostejših razlogov, da davčno potrjevanje nenadoma preneha delovati.
Poslovni prostor in elektronska naprava
Pred začetkom davčnega potrjevanja je treba določiti poslovni prostor in elektronsko napravo za izdajo računov.
Poslovni prostor ni nujno samo klasična pisarna ali trgovina. Pri terenskem delu je lahko poslovni prostor tudi premičen, odvisno od načina poslovanja in pravil, ki jih podjetje določi v internem aktu.
Elektronska naprava pa je naprava oziroma programsko okolje, prek katerega se račun izda in pošlje v potrjevanje.
V praksi to pomeni, da mora imeti podjetnik pravilno urejene:
- oznake poslovnih prostorov,
- oznake elektronskih naprav,
- pravila zaporednega številčenja računov,
- osebe, ki izdajajo račune.
Program za račune mora te nastavitve uporabljati dosledno, saj so del podatkov, ki se pri davčnem potrjevanju povezujejo z računom.
API ali ročno potrjevanje: kaj je bolj smiselno?
Davčno potrjevanje je mogoče izvajati na različne načine. Najbolj preprost način je ročna uporaba rešitve, kot je Mini blagajna, bolj praktična možnost za redno poslovanje pa je uporaba programa za račune z vgrajenim FURS API-jem.
| Metoda | Primerna za | Prednosti | Omejitve |
|---|---|---|---|
| Ročno potrjevanje | Zelo majhen obseg računov | Brez posebne integracije | Več ročnega dela in več možnosti za napake |
| Program z davčnim potrjevanjem | S.p.-ji, obrtniki, manjša podjetja | Hitro izdajanje računov, manj administracije | Treba je pravilno nastaviti potrdilo in poslovni prostor |
| Lastna API integracija | Spletne trgovine, večji sistemi, ERP | Popolna avtomatizacija | Zahteva tehnično znanje in vzdrževanje |
Za večino s.p.-jev, obrtnikov in manjših podjetij je najbolj smiselna srednja možnost: program za račune, ki ima FURS API že vgrajen.
Tako podjetnik ne potrebuje tehničnega znanja, hkrati pa dobi vse prednosti avtomatizacije.
Kdaj je API integracija prava izbira?
API integracija je posebej koristna, kadar:
- izdajate več računov dnevno ali tedensko,
- poslujete na terenu,
- uporabljate mobilno blagajno,
- imate spletno trgovino,
- račune izdajajo različni zaposleni,
- želite zmanjšati ročno administracijo,
- želite manj napak pri davčnem potrjevanju.
Pri spletnih trgovinah je API še posebej pomemben, ker lahko sistem račun ustvari in davčno potrdi samodejno ob naročilu ali plačilu, brez ročnega posredovanja.
Tehnični vidik API integracije
Za uporabnika je davčno potrjevanje videti preprosto: klikne »izdaj račun« in sistem opravi svoje delo.
V ozadju pa se zgodi več tehničnih korakov.
FURS tehnične specifikacije predvidevajo izmenjavo podatkov prek spletnih storitev, pri čemer se lahko uporabljajo XML ali JSON sporočila. Pri REST API načinu se za komunikacijo uporablja HTTPS, vsebina pa mora biti ustrezno podpisana z namenskim digitalnim potrdilom.
Za razvijalce to pomeni, da morajo pravilno urediti:
- strukturo podatkov o računu,
- podpisovanje sporočil,
- komunikacijo s testnim in produkcijskim okoljem,
- obdelavo odgovorov FURS,
- obdelavo napak,
- ponovno pošiljanje v primeru začasnih težav s povezavo.
Podjetnik, ki uporablja rešitev z že vgrajeno integracijo, teh podrobnosti ne potrebuje poznati. Pomembno je le, da uporablja zanesljiv program in pravilno nastavi osnovne podatke.
Testno in produkcijsko okolje
Pri razvoju lastne integracije je priporočljivo najprej uporabiti testno okolje. Tam se preveri, ali program pravilno pripravlja sporočila, podpisuje podatke in obdeluje odgovore FURS.
Šele ko testno potrjevanje deluje stabilno, je smiselno preiti na produkcijsko okolje.
Pri uporabi aplikacije, kot je Račun123, je ta tehnični del že urejen v ozadju. Uporabnik se ukvarja predvsem z nastavitvami podjetja, poslovnega prostora, elektronske naprave in digitalnega potrdila.
Najpogostejše napake pri davčnem potrjevanju prek API-ja
Večina napak pri davčnem potrjevanju ni posledica samega API-ja, ampak napačnih nastavitev ali manjkajočih podatkov.
Napake pri digitalnem potrdilu
- Potrdilo ni uvoženo v program. Brez namenskega digitalnega potrdila program ne more podpisati podatkov za FURS.
- Napačno geslo pri uvozu potrdila. Če geslo ni pravilno, potrdila ni mogoče uporabiti.
- Potrdilo je poteklo. Po izteku veljavnosti je treba pridobiti novo oziroma obnovljeno potrdilo.
- Potrdilo je shranjeno na napačnem mestu. Pri več uporabnikih ali napravah mora biti jasno določeno, kje se potrdilo uporablja.
Napake v podatkih računa
FURS lahko zavrne potrjevanje, če podatki niso pravilno pripravljeni ali manjkajo obvezni elementi.
Najpogostejše napake so:
- napačna ali manjkajoča davčna številka izdajatelja,
- napačna oznaka poslovnega prostora,
- napačna oznaka elektronske naprave,
- nepravilno številčenje računov,
- nepravilen datum ali čas izdaje,
- nepravilen znesek ali DDV obravnava,
- manjkajoči podatki o osebi, ki izda račun.
Težave z internetno povezavo
Davčno potrjevanje prek FURS potrebuje internetno povezavo. Če povezava v trenutku izdaje računa ni na voljo, mora program pravilno obravnavati tak primer.
Kakovostna programska rešitev mora uporabniku jasno pokazati, ali je račun potrjen, nepotrjen ali čaka na ponovno pošiljanje. To je posebej pomembno pri terenskem delu, kjer povezava ni vedno stabilna.
Praktičen nasvet: pri mobilni blagajni vedno preverite, ali je račun dejansko dobil EOR. Če ga ni, račun ni bil uspešno potrjen in ga je treba obravnavati po pravilih za naknadno potrjevanje.
Kako se izogniti težavam pri FURS API-ju?
Najboljši način za preprečevanje težav je dobra začetna nastavitev in redno preverjanje sistema.
- Digitalno potrdilo shranite varno. Potrebujete ga za davčno potrjevanje, zato naj ne bo shranjeno samo v enem e-poštnem sporočilu.
- Nastavite opomnik za potek potrdila. Potrdilo velja več let, zato se na obnovo hitro pozabi.
- Preverite poslovne prostore in naprave. Oznake naj bodo skladne z internim aktom in nastavitvami v programu.
- Redno posodabljajte programsko opremo. Spremembe tehničnih specifikacij in certifikatov lahko vplivajo na delovanje integracije.
- Testirajte po večjih spremembah. Po menjavi certifikata, naprave ali poslovnega prostora naredite testni račun.
- Ekipo naučite osnov. Vsak, ki izdaja račune, mora vedeti, kaj pomeni potrjen in nepotrjen račun.
Pri zanesljivem programu za račune uporabnik ne rabi poznati tehničnih podrobnosti API-ja, mora pa razumeti osnovno logiko: račun je davčno potrjen šele, ko sistem uspešno pridobi EOR.
Ključne ugotovitve
Davčno potrjevanje računov prek API-ja je za večino podjetnikov najbolj praktičen način, da se računi potrjujejo hitro, pravilno in brez dodatnega ročnega dela.
| Točka | Podrobnosti |
|---|---|
| API avtomatizira potrjevanje | Program sam pripravi, podpiše in pošlje podatke o računu FURS-u. |
| EOR potrdi uspešno potrjevanje | FURS ob uspešni potrditvi vrne EOR, ki se shrani in izpiše na računu. |
| ZOI ustvari programska oprema | ZOI je zaščitna oznaka izdajatelja računa in nastane v programu izdajatelja. |
| Digitalno potrdilo je nujno | Brez namenskega digitalnega potrdila davčno potrjevanje prek API-ja ne deluje. |
| Nastavitve so ključne | Poslovni prostor, elektronska naprava in številčenje morajo biti pravilno urejeni. |
| Dober program zmanjša napake | Uporabnika vodi skozi postopek in jasno označi, ali je račun potrjen. |
Kar sem se naučil pri FURS integracijah
Ko smo začeli razvijati davčno potrjevanje v Račun123, sem mislil, da bo največji izziv tehnična povezava s FURS.
Ni bil.
Tehnični del je zahteven, ampak predvidljiv. Specifikacije so jasne, testno okolje obstaja, odgovori sistema so strukturirani.
Večji izziv je bil narediti postopek razumljiv za podjetnika.
Podjetnika ne zanima, ali je sporočilo poslano v XML ali JSON obliki. Ne zanima ga podpisovanje podatkov, certifikati v ozadju ali način komunikacije z API-jem.
Zanima ga nekaj precej bolj preprostega:
Ali je račun pravilno izdan?
Ali je davčno potrjen?
Ali ga lahko pošljem stranki?
Ali bom imel ob nadzoru urejene podatke?
Zato mora dober program za račune tehnično kompleksnost skriti v ozadje. Uporabniku mora pokazati samo tisto, kar je pomembno: ali je račun uspešno potrjen, ali čaka na potrditev ali pa je prišlo do napake.
Največ težav v praksi ni bilo zaradi FURS API-ja, ampak zaradi osnovnih stvari.
Poteklo digitalno potrdilo.
Napačno geslo.
Neurejen poslovni prostor.
Napačno številčenje.
Uporabnik, ki ni vedel, da račun še ni potrjen.
Moje priporočilo je preprosto: digitalno potrdilo obravnavajte kot ključ do davčnega potrjevanja. Shranite ga varno, nastavite opomnik za obnovo in uporabljajte program, ki vas jasno opozori, ko nekaj ni v redu.
Dober API ni tisti, ki ga uporabnik vidi.
Dober API je tisti, ki tiho in zanesljivo dela v ozadju.
— Gašper Parte, ustanovitelj aplikacije Račun123
Račun123: avtomatsko davčno potrjevanje brez tehničnih zapletov
Račun123 je slovenska aplikacija za izdajanje računov, ki ima davčno potrjevanje prek FURS vgrajeno neposredno v sistem.
Podjetniku ni treba razumeti tehničnih podrobnosti API-ja. V aplikaciji nastavi davčno potrjevanje, uvozi namensko digitalno potrdilo, uredi poslovni prostor in začne izdajati davčno potrjene račune.
Račun123 omogoča:
- izdajanje davčno potrjenih računov,
- mobilno POS blagajno,
- davčno potrjevanje pri gotovinskih in kartičnih plačilih,
- UJP e-račune,
- izvoz za računovodstvo,
- integracije s spletnimi trgovinami,
- uporabo na telefonu in računalniku.
Za podjetnike, ki želijo skladno izdajati račune brez tehničnih zapletov, je Račun123 enostaven način za povezavo z FURS in urejeno izdajo davčno potrjenih računov.
Ustvarite brezplačen račun in preizkusite Račun123.
Pogosta vprašanja
Kaj je davčno potrjevanje računov prek API-ja?
Davčno potrjevanje prek API-ja pomeni, da program za račune samodejno pošlje podatke o računu FURS-u in prejme potrditev. Uporabnik računa ne potrjuje ročno v ločenem sistemu.
Kaj je EOR?
EOR je enkratna identifikacijska oznaka računa. FURS jo vrne ob uspešno potrjenem računu in pomeni, da je bil račun prijavljen davčnemu organu.
Kaj je ZOI?
ZOI je zaščitna oznaka izdajatelja računa. Ustvari jo programska oprema izdajatelja računa z uporabo namenskega digitalnega potrdila in se izpiše na davčno potrjenem računu.
Ali moram za FURS API znati programirati?
Ne, če uporabljate program, ki ima davčno potrjevanje že vgrajeno. Programersko znanje je potrebno predvsem pri razvoju lastne integracije ali povezavi večjega sistema z FURS API-jem.
Kaj je namensko digitalno potrdilo?
Namensko digitalno potrdilo je digitalno potrdilo, ki se uporablja za podpisovanje podatkov pri davčnem potrjevanju računov. Pridobi se prek eDavkov, glasi se na zavezanca in velja pet let.
Kaj se zgodi, če internetna povezava med potrjevanjem pade?
Če povezava ni na voljo, račun morda ne dobi EOR takoj. Program mora jasno pokazati, da račun ni potrjen ali da čaka na ponovno pošiljanje. Račun je uspešno davčno potrjen šele, ko prejme EOR.
Ali je davčno potrjevanje prek API-ja primerno za s.p.?
Da. Za s.p.-je, ki izdajajo davčno potrjene račune, je program z vgrajenim FURS API-jem pogosto najpreprostejša rešitev, ker zmanjša ročno delo in možnost napak.
Ali Račun123 podpira davčno potrjevanje računov?
Da. Račun123 podpira davčno potrjevanje prek FURS, mobilno izdajo računov, POS blagajno, UJP e-račune in izvoz podatkov za računovodstvo.
