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

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

14.12.2021 – Objavljena je posodobljena verzija aplikacije za preverjanje kakovosti in pravilnosti natisnjenih kod - Preveri kodo (razdelek Aplikacije).

1.10.2020 - FURS bo dne 18.11.2020 med 22:00 in 24.00 uro v produkcijskem sistemu davčnih blagajn zamenjal digitalno potrdilo za vzpostavitev TLS povezave (blagajne.fu.gov.si) in digitalno potrdilo za podpisovanje FURS odgovorov (DavPotRac). Novi digitalni potrdili sta objavljeni v razdelku »Digitalna potrdila« in v tehnični dokumentaciji (v2.1).
Vzpostavljeno je začasno vzporedno produkcijsko okolje (https://blagajne.fu.gov.si:9009/...) z novimi digitalnimi potrdili, kjer lahko preverite delovanje. Začasno produkcijsko okolje bo po 16.12.2020 umaknjeno. Poskrbite, da bo vaša programska oprema za davčno potrjevanje računov delovala tudi po zamenjavi digitalnih potrdil.

17.06.2020 - V testnem sistemu za davčno potrjevanje računov (https://blagajne-test.fu.gov.si:9002/...), bomo dne 24.06.2020 med 14:00 in 16:00 uro zamenjali digitalno potrdilo za vzpostavitev TLS seje in digitalno potrdilo za podpisovanje FURS odgovorov, v tem času bo moteno delovanje testnega okolja.

17.06.2020 - Objavljena je nova verzija tehnične dokumentacije (verzija 2.0).

13.02.2019 - V sistemu za davčno potrjevanje računov bomo onemogočili protokol TLS 1.1. Sistem bo med posegom nemoteno deloval, po posegu bo ostalo omogočeno davčno potrjevanje računov samo še s protokolom TLS 1.2.

Časovnica posega:
28.2.2019 ob 13:00:
    • izveden bo izklop TLS 1.1 protokola v testnem okolju (https://blagajne-test.fu.gov.si:9002/...),
    • objavljen bo začasen vzporedni produkcijski naslov https://blagajne.fu.gov.si:9009/..., kjer bo izklopljen protokol TLS 1.1 in vklopljen samo protokol TLS 1.2. Začasen vzporedni produkcijski naslov bo delujoč do 20.5.2019.
23.4.2019 ob 21:00:
    • izveden bo izklop protokola TLS 1.1 v produkcijskem okolju (https://blagajne.fu.gov.si:9003/...).

13.02.2019 - Objavljena je nova verzija tehnične dokumentacije (verzija 1.9).


Navodila za razvijalce

Tehnična dokumentacija (različica 2.2) 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: XML, JSON, WSDL.
    Masovno pošiljanje podatkov o računih: 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.

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 dev.blagajne.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 dev.blagajne.fu(at)gov.si