Podatki in posebnosti FURS

Viri

Seznam	Koda	Obseg (19. 10. 2026)	Kaj iz njega vzamemo
Pravne osebe	furs_po	145.368	vse, vključno z DDV
Fizične osebe, ki opravljajo dejavnost	furs_dej	139.289 registracij (138.658 davčnih)	vse razen DDV (ga ni na seznamu)
Fizične osebe, identificirane za DDV	furs_fo	59.492	samo zastavico DDV po davčni številki
Odvzem ID za DDV po uradni dolžnosti	furs_mt, furs_np	35.009	davčna, datuma
Skupine DDV	furs_vat_groups	7 skupin, 27 vrstic	skupina in člani

FURS sezname objavlja ob delovnih dneh med 7. in 8. uro. Sinhronizacija jih prevzame isti dan; datum vira je v source.as_of in glavi X-Data-As-Of. Stanje posameznih seznamov vidite na GET /v1/meta/status.

Posebnosti, ki jih morate poznati

DDV za s.p. pride iz FO

Seznam DEJ ne vsebuje podatka o DDV. vat.registered za fizične osebe izračunamo s pridružitvijo seznama FO po davčni številki (vat.source: "furs_fo"). Seznam FO vsebuje tudi osebe, ki niso podjetniki (npr. kmetje, najemodajalci); zato iz njega ne shranjujemo imen ali naslovov, in GET /v1/vat/validate za takšne osebe vrne samo da/ne.

Oznake P, O, S, Č

vat.scope_code je oznaka iz seznama FURS: P = ni zavezanec po 76.a členu ZDDV-1, O = posebna ureditev (občasni prevoz potnikov), S = skupina DDV, Č = član skupine DDV.

Pripone matične številke

Matična ima 10 števk: prvih 7 je osnovna številka, zadnje 3 pripona enote (000 je glavna enota). Iskanje po 7 števkah vrne vse enote; zato by-registration-number vrne seznam. Kontrolne vsote matične ne preverjamo, ker je FURS sam ne upošteva dosledno.

Dve registraciji ene osebe

631 davčnih številk ima na seznamu DEJ dve matični (dve dejavnosti). API vrne en entity z obema v registrations[]; polja na vrhu ustrezajo primarni (aktivni, najstarejši) registraciji.

Zastavice stanja so hevristika

status_flags (in_bankruptcy, in_liquidation) razberemo iz naziva (»v stečaju«, »v likvidaciji«). FURS ne objavlja ločenega polja.

Pravna oblika je razbrana

legal_form je razbrana iz naziva, tudi ko je zapisana sredi naziva. Od v1.2 jo bomo nadomestili s pravno obliko iz PRS (AJPES).

inactive ni izbris

Ko zapis izgine s seznama FURS, postane status: "inactive" z deactivated_on. Pravne osebe ostanejo trajno; fizične osebe 12 mesecev kot neaktivne, nato samo po točnem ID-ju, po 5 letih jih izbrišemo.

Svežina PRS (v1.2)

Podatki iz Poslovnega registra (AJPES, CC BY 4.0) se osvežujejo na dva tedna, ne dnevno. Polja iz PRS bodo jasno označena z lastnim datumom vira.

Pripis vira

V vsakem odgovoru je Vir: FURS. Če podatke prikazujete uporabnikom, pripis ohranite, kjer je to razumno izvedljivo.