FISCAL VERIFICATION OF INVOICES

Technical specifications


Slovensko
  INSTRUCTIONS
  APPLICATIONS
  SCHEMES AND EXAMPLES
  DIGITAL CERTIFICATES
  FAQ

NEWS

02.02.2018 - Use of protocol TLS 1.0 will be discontinued on 15. 2. 2018 in test environment, use of protocol TLS 1.0 will be discontinued on 30. 6. 2018 in production environment. New version of the technical documentation is published (version 1.7).

07.02.2017 - The testing enviroment will be unavailable due to maintenance work on 09.02.2016 between 7:00 and 24:00. The system will be available again on 10.02.2016.

22.12.2015 - Published a new version of the technical documentation (version 1.6).

08.12.2015 - Published 2 examples of messages for sending mass data on invoices.

02.12.2015 - Published a new version of the technical documentation (version 1.5).

01.12.2015 - Production enviroment for fiscal verification of invoices is open. Access is enabled only for IP addresses in Slovenia. For access from abroad send to the email address dev.blagajne.fu@gov.si the tax number of the issuer, the issuer name and IP address from which you will be accessing.

24.11.2015 - We inform you that the access to the testing environment will be disrupted due to upgrades to the network equipment tomorrow, 25.11.2015 from 13:00 to 16:00.

24.11.2015 - Published a new version of the technical documentation (version 1.4).

24.11.2015 - Published the public keys of the production digital certificates for establishing a TLS connection (blagajne.fu.gov.si.cer), issuer's SIGOV-CA (sigov-ca.crt) and the application certificate for digital signature (DavPotRac.cer).

23.11.2015 - Changes and additions:

  • JSON schema is coherent with the XML schema in fields (Street, Community, PostalCode, SpecialNotes) and XML schema is coherent with JSON schema in fields (City)
  • Published XML schema, JSON schema and WSDL for sending mass data invoices
  • Published a new version of the application for verifing the quality of printed codes for Android and WindowsPhone

11.11.2015 - We inform you that the access to the testing environment will be disrupted due to upgrades to the network equipment on Thursday, 12.11.2015 from 12:00 to 17:00 and on Friday, 13.11.2015 from 12:00 to 17:00.

02.11.2015 - Published a fixed application for verifing the quality of printed codes - date reading is now in accordance with the technical instructions.

Back on top

INSTRUCTIONS

Instructions for developers

last change 05.02.2018

Technical documentation (version 1.7 for electronic devices' software developers.

Back on top

APPLICATIONS

Verification of printed codes' quality

last change 29.02.2016

Application for verifing the quality of printed codes: Android, WindowsPhone.

Instructions for aplication (SI only).

Back on top

SCHEMES AND EXAMPLES

Schemes for comunication with FA IS

last change 07.10.2015

Verification of individual invoices: XML, JSON, WSDL.

Mass transmission of data on invoices: XML, JSON, WSDL

xmdsig scheme: xmldsig-core-schema.xsd.

Message examples

last change 08.12.2015

Signed message for verification of an invoice: XML, JSON.

Signed message for premise registration: XML, JSON.

Signed message for verification of a pre-numbered invoice book: XML, JSON.

Ordinary invoice with two VAT rates: XML.

Storno of the invoice »Ordinary invoice with two VAT rates«: XML.

Invoice issued for own account and in the name of and on behalf of another person: XML.

Storno of the invoice RACUN4. e-invoice is changed with an e-invoice: XML.

Invoice issued in the name of and on behalf of another person: XML.

Signed message for mobile premise registration: XML.

A plain invoice with two VAT rates, a message for sending mass data on invoices: XML, JSON.

Source code exaple

last change 02.12.2015

Example of C# application

In the zip file is a C # project (.net 4.5) for Visual Studio 2012, which shows examples of establishing basic communication with the FARS system for fiscal verification of invoices. The project includes examples of code signing and sending basic XML messages (echo, business premise, invoice). The purpose of the published code is to facilitate the establishment of basic communication with FARS system and, as such, is not designed and optimized to operate in a production environment.

Back on top

DIGITAL CERTIFICATES

FA IS digital certificates

last change 09.09.2015

Links to the public keys of FA IS digital certificates.

Test enviroment:

  • Public key of the digital certificate for establishing a TLS connection: test-tls.cer.
  • Public key of the digital certificate for signature: test-sign.cer.
  • Certificate authority for TLS certificate: sitest-ca.cer.
  • Certificate authority for Tax CA test: TaxCATest.cer.

Production enviroment:

Test digital certificates for developers

published 02.09.2015

For obtaining a test digital certificate you are required to send an email to dev.blagajne.fu (at) gov.si .
In the message indicate the name of the company, which will develop the software solution for the fiscal verification of invoices and will use the requested digital certificate.
Test digital certificates are issued for a random tax number and an anonymised name (eg. "Test person n").
Certificates will be delivered in the form of ".p12" files.

Back on top

FAQ

Additional questions

For additional questions contact us at dev.blagajne.fu(at)gov.si

Back on top