Tehnične specifikacije - davčno potrjevanje računov 

Objavljena navodila in aplikacije, primeri shem in aplikacij, digitalna potrdila in pogosto zastavljena vprašanja.
Novice

25.07.2025 - Objavljena je nova verzije tehnične dokumentacije (v2.9), kjer je dopolnjena shema za prijavo poslovnih prostorov s podatki za avtomate in dodan nov servis za masovno prijavo poslovnih prostorov.

29.04.2025 - V testnem sistemu za davčno potrjevanje računov (https://blagajne-test.fu.gov.si:9002/...), smo zamenjali digitalno potrdilo za podpis. Nov javni ključ je objavljen v razdelku »Digitalna potrdila«.

07.11.2024 - FURS bo dne 3.12.2024 med 22:00 in 24.00 uro v produkcijskem sistemu davčnih blagajn zamenjal digitalno potrdilo za vzpostavitev TLS povezave (blagajne.fu.gov.si). Novo digitalno potrdilo je objavljeno v razdelku »Digitalna potrdila« in v tehnični dokumentaciji (v2.8).
Vzpostavljeno je začasno vzporedno produkcijsko okolje (https://blagajne.fu.gov.si:9009/...) z novim digitalnim potrdilom, kjer lahko preverite delovanje. Začasno produkcijsko okolje bo po 17.12.2024 umaknjeno. Poskrbite, da bo vaša programska oprema za davčno potrjevanje računov delovala tudi po zamenjavi digitalnega potrdila.

23.09.2024 - V testnem sistemu za davčno potrjevanje računov (https://blagajne-test.fu.gov.si:9002/...), smo zamenjali digitalno potrdilo za vzpostavitev TLS seje. Nov javni ključ je objavljen v razdelku »Digitalna potrdila«.

13.11.2023 - FURS bo dne 6.12.2023 med 22:00 in 24.00 uro v produkcijskem sistemu davčnih blagajn zamenjal digitalno potrdilo za vzpostavitev TLS povezave (blagajne.fu.gov.si). Novo digitalno potrdilo je objavljeno v razdelku »Digitalna potrdila« in v tehnični dokumentaciji (v2.6).
Vzpostavljeno je začasno vzporedno produkcijsko okolje (https://blagajne.fu.gov.si:9009/...) z novim digitalnim potrdilom, kjer lahko preverite delovanje. Začasno produkcijsko okolje bo po 20.12.2023 umaknjeno. Poskrbite, da bo vaša programska oprema za davčno potrjevanje računov delovala tudi po zamenjavi digitalnega potrdila.

22.09.2023 - V testnem sistemu za davčno potrjevanje računov (https://blagajne-test.fu.gov.si:9002/...), smo zamenjali digitalno potrdilo za vzpostavitev TLS seje. Nov javni ključ je objavljen v razdelku »Digitalna potrdila«.


Navodila za razvijalce

Tehnična dokumentacija (različica 2.9) za razvijalce programske opreme za elektronske naprave.


Aplikacije

Preverjanje kakovosti natisnjenih kod
    Aplikacija za preverjanje kakovosti natisnjenih kod: Android.
    Navodila za uporabo aplikacije.


Sheme in primeri

Sheme za izmenjavo z IS FU
    Posamezno potrjevanje računov in poslovnih prostorov: XML, JSON, WSDL.
    Masovno pošiljanje podatkov o računih in poslovnih prostorih: XML, JSON, WSDL
    Shema xmdsig: xmldsig-core-schema.xsd.

Primeri sporočil
    Podpisano sporočilo za potrjevanje računa: XML, JSON.
    Podpisano sporočilo za prijavo prostora: XML, JSON.
    Podpisano sporočilo za potrjevanje računa iz vezane knjige: XML, JSON.
    Navaden račun z dvema stopnjama DDV: XML.
    Storno za račun »Navaden račun z dvema stopnjama DDV«: XML.
    Račun izdan v svojem imenu za svoj račun in v tujem imenu za tuj račun: XML.
    Storno za RAČUN4. Z elektronskim računom se spreminja elektronski račun: XML.
    Račun izdan v tujem imenu in za tuj račun: XML.
    Podpisano sporočilo za prijavo premičnega poslovnega prostora: XML.
    Navaden račun z dvema stopnjama DDV, sporočilo za masovno pošiljanje: XML, JSON.
    Prijava poslovnega prostora, sporočilo za masovno pošiljanje: XML, JSON.
    Prijava poslovnega prostora (avtomat): XML, JSON.

Primeri kode
    Primer aplikacije v C#
    V zip datoteki je C# projekt (.net 4.7) za Visual Studio 2012, v katerem so prikazani primeri vzpostavitve osnovne komunikacije s Furs sistemom za davčno potrjevanje računov. Projekt zajema primere kode za podpisovanje in pošiljanje osnovnih XML sporočil (echo, poslovni prostor, račun). Namen objavljene kode je olajšati vzpostavitev osnovne komunikacije razvijalcem s Furs sistemom in koda kot taka ni namenjena in optimizirana za delovanje v produkcijskem okolju.


Digitalna potrdila

Digitalna potrdila IS FU
    Povezave do javnih ključev digitalnih potrdil IS FU.

    Testno okolje:
        • Javni ključ digitalnega potrdila za vzpostavitev TLS povezave: blagajne-test.fu.gov.si.cer.
        • Javni ključ digitalnega potrdila za podpis: DavPotRacTEST.cer.
        • Vmesno potrdilo izdajatelja SIGOV-CA: sigov-ca2.xcert.crt.
        • Korensko potrdilo SI-TRUST Root za izdajatelja SIGOV-CA: si-trust-root.crt.

    Produkcijsko okolje:
        • Javni ključ digitalnega potrdila za vzpostavitev TLS povezave: blagajne.fu.gov.si.cer.
        • Javni ključ digitalnega potrdila za podpis: DavPotRac.cer.
        • Vmesno potrdilo izdajatelja SIGOV-CA: sigov-ca2.xcert.crt.
        • Korensko potrdilo SI-TRUST Root za izdajatelja SIGOV-CA: si-trust-root.crt.

Testna digitalna potrdila za razvijalce
Za pridobitev testnega digitalnega potrdila je potrebno poslati elektronsko sporočilo na naslov sd.fu(at)gov.si.
V sporočilu navedite naziv podjetja, katero bo razvijalo programsko rešitev za davčno potrjevanje računov in bo uporabljalo zahtevano digitalno potrdilo.
Testna digitalna potrdila so izdana na naključno davčno številko in anonimiziran naziv (npr. »Testna oseba n«).
Potrdila bodo dostavljena v obliki datoteke ».p12«.


Pogosta vprašanja

Pogosta vprašanja
    Vprašanja in odgovori so objavljeni na tej povezavi.

Dodatna vprašanja
    Za ostale tehnične informacije pišite na sd.fu(at)gov.si