MilosLukic/fiskpy

Python fiskalizacija (Hrvatska) python 3.5

fisk.py - simple fiscalization (Fiskalizacija) library for Croatia (Hrvatska)

Note1: This is a fork of kodmasin's fiskpy, designed to support python 3.5 (It should work with pyhton > 3.0, atlhough it wasn't tested). Link to original fiskpy for python 2.7:

https://github.com/kodmasin/fiskpy

REQUIREMENTS

Just run:

pip install -r requirements.txt

USAGE

Echo Request

import fisk
import lxml.etree as et

#As we did not set environment with FiskInit default environment is DEMO. This
#works just with EchoRequest as it does not require key (with password) and certificate.

#test echo 
echo = fisk.EchoRequest("Proba echo poruke")

#send request and print server reply
echo_reply = echo.execute()
if(echo_reply != False):
    print(echo_reply)
else:
    errors = echo.get_last_error()
    print("EchoRequest errors:")
    for error in errors:
        print(error)

PoslovniProstor Request

import fisk
import lxml.etree as et
from datetime import date, timedelta

#fiskpy initialization !!! must be used for PoslovniProstorZahtjev
fisk.FiskInit.init('/path/to/your/key.pem', "kaypassword", '/path/to/your/cert.pem')
#For production environment
#fisk.FiskInit.init('/path/to/your/key.pem', "kaypassword", '/path/to/your/cert.pem', Ture)
#create addres
adresa = fisk.Adresa(data = {"Ulica": "Proba", "KucniBroj": "1", "BrojPoste": "54321"})
#create poslovni prostor      
pp = fisk.PoslovniProstor(data = {"Oib": "12345678901",
                             "OznPoslProstora": "POS1",
                             "AdresniPodatak": fisk.AdresniPodatak(adresa),
                             "RadnoVrijeme": "PON-PET 9:00-17:00", 
                             "DatumPocetkaPrimjene": (date.today() + timedelta(days = 1)).strftime('%d.%m.%Y')})

#you can also access (set and get) attributes of fisk element classes as
pp.SpecNamj = "12345678901"
print(pp.OznPoslProstora)

#poslovni prostor request
ppz = fisk.PoslovniProstorZahtjev(pp)

ppz_reply = ppz.execute()
if(ppz_reply == True):
    print("PoslovniProstorZahtjev seccessfuly sent!")
else:
    errors = ppz.get_last_error()
    print("PoslovniProstorZahtjev reply errors:")
    for error in errors:
        print(error)

#fiskpy deinitialization - maybe not needed but good for correct garbage cleaning 
fisk.FiskInit.deinit()

Racun Request

import fisk
import lxml.etree as et
from datetime import date, timedelta

#fiskpy initialization !!! must be used for RacunZahtjev
fisk.FiskInit.init('/path/to/your/key.pem', "kaypassword", '/path/to/your/cert.pem')
#For production environment
#fisk.FiskInit.init('/path/to/your/key.pem', "kaypassword", '/path/to/your/cert.pem', Ture)

racun = fisk.Racun(data = {"Oib": "12345678901",
              "USustPdv": "true",
              "DatVrijeme": "26.10.2013T23:50:00",
              "BrRac": fisk.BrRac({"BrOznRac": "2", "OznPosPr":"POS2", "OznNapUr":"1"}),
              "Pdv": [fisk.Porez({"Stopa":"25.00", "Osnovica":"100.00", "Iznos":"25.00"}), fisk.Porez({"Stopa":"10.00", "Osnovica":"100.00", "Iznos":"10.00"})],
              "Pnp": [fisk.Porez({"Stopa":"25.00", "Osnovica":"100.00", "Iznos":"25.00"}), fisk.Porez({"Stopa":"10.00", "Osnovica":"100.00", "Iznos":"10.00"})],
              "OstaliPor": [fisk.OstPorez({"Naziv": "Neki porez",  "Stopa":"3.00", "Osnovica":"100.00", "Iznos":"3.00"})],
              "IznosOslobPdv": "100.00",
              "IznosMarza": "100.00",
              "IznosNePodlOpor": "50.00",
              "Naknade": [fisk.Naknada({"NazivN" : "test", "IznosN": "10.00"})],
              "IznosUkupno": "500.00",
              "NacinPlac": "G",
              "OibOper": "12345678901",
              "NakDost": "false",
              "ParagonBrRac": "123-234-12",
              "SpecNamj": "Tekst specijalne namjne"})

#IWe did not supplied required element in constructor so now we set it
racun.OznSlijed = "P"

#Zastitni kod is calculated so print it
print("ZKI: " + racun.ZastKod)

#change one variable and check new zastitni kod
racun.IznosUkupno = "1233.00"
print("ZKI: " + racun.ZastKod)

#create Request and send it to server (DEMO) and print reply
racunZahtjev = fisk.RacunZahtjev(racun)
racun_reply = racunZahtjev.execute()
if(racun_reply != False):
    print("JIR is: " + racun_reply)
else:
    errors = racunZahtjev.get_last_error()
    print("RacunZahtjev reply errors:")
    for error in errors:
        print(error)

#fiskpy deinitialization - maybe not needed but good for correct garbage cleaning 
fisk.FiskInit.deinit()

Provjera Request

import fisk
from lxml import etree as et
from datetime import date, timedelta

#fiskpy initialization 
fisk.FiskInit.init('/path/to/your/key.pem', "kaypassword", '/path/to/your/cert.pem')

racun = fisk.Racun(data = {"Oib": "12345678901",
            "USustPdv": "true",
            "DatVrijeme": "26.10.2013T23:50:00",
            "BrRac": fisk.BrRac({"BrOznRac": "2", "OznPosPr":"POS2", "OznNapUr":"1"}),
            "Pdv": [fisk.Porez({"Stopa":"25.00", "Osnovica":"100.00", "Iznos":"25.00"}), fisk.Porez({"Stopa":"10.00", "Osnovica":"100.00", "Iznos":"10.00"})],
            "Pnp": [fisk.Porez({"Stopa":"25.00", "Osnovica":"100.00", "Iznos":"25.00"}), fisk.Porez({"Stopa":"10.00", "Osnovica":"100.00", "Iznos":"10.00"})],
            "OstaliPor": [fisk.OstPorez({"Naziv": "Neki porez",  "Stopa":"3.00", "Osnovica":"100.00", "Iznos":"3.00"})],
            "IznosOslobPdv": "100.00",
            "IznosMarza": "100.00",
            "IznosNePodlOpor": "50.00",
            "Naknade": [fisk.Naknada({"NazivN" : "test", "IznosN": "10.00"})],
            "IznosUkupno": "500.00",
            "NacinPlac": "G",
            "OibOper": "12345678901",
            "NakDost": "false",
            "ParagonBrRac": "123-234-12",
            "SpecNamj": "Tekst specijalne namjne"})

#We did not supplied required element in constructor so now we set it
racun.OznSlijed = "P"

#Zastitni kod is calculated so print it
print("ZKI: " + racun.ZastKod)

#change one variable and check new zastitni kod
racun.IznosUkupno = "1233.00"
print("ZKI :" + racun.ZastKod)

#create Request and send it to server (DEMO) and print reply
provjeraZahtjev = fisk.ProvjeraZahtjev(racun)
provjera_reply = provjeraZahtjev.execute()

if(provjera_reply == False):
  print "Request and response data is not the same"
elif(isinstance(provjera_reply, et._Element)):
  for greska in provjera_reply:
    print(u"Code: {} -> Message: {}".format(greska[0].text, greska[1].text))
else:
  print("Unhandled error")

KEY GENERATION

Fiscalization keys and certificates are delivered in .p12 or .pfx format. To be used with this library you should convert them to .pem format. This can be done with openssl.

openssl pkcs12 -in certificate.pfx -out certificate.pem -nodes

Now certificate.pem holds both key and certificate. So you should manually open this file and copy each to separate file including BEGIN/END statements.

Private key should be encrypted so if it is not you should run:

openssl rsa -in key.pem -des3 -out passkey.pem

CA Certificates

####Version >= 0.7.4

CA certificate are included in release. You do should not supply them to FiskInit class.

####Versions < 0.7.4

You will also need CA certificate for DEMO and PRODUCTION environment. This certificate is needed for verification process.

DEMO CA Certificate

You can download this certificate https://demo-pki.fina.hr/crl/democacert.cer

DEMO CA 2014 Certificate (2 of them)

You can download this certificates http://www.fina.hr/Default.aspx?sec=1730

But in time of writing this you have to include old DEMO CA certificate in list too, to work.

PRODUCTION CA Certificate

You can download them from http://www.fina.hr/Default.aspx?art=10758

Troubleshooting

500: Internal Server Error - this was bug before version 0.7.5

ValueError: RSA key format is not supported - this error could happen if your private key is not encrypted. Please check if your private key is encrypted. If it is not please encrypt it (''openssl rsa -in key.pem -des3 -out passkey.pem'')

Changelog

Fork Version 0.8.2

• Added support for Python 3.5 (backward compatibility compromised)
• Added requirements file

Version 0.8.1

• WSDL 1.3 support added (ProvjeraRacuna - can be used just in test environment - cistest.apis-it.hr)
• removed manually added certificate data in signXML

Version 0.8.1 RC

• signxml 2 support
• better handeling of SOAP errors
  • nicer and probably faster lxml usage

Version 0.8.0

• switch from pyxmlsec to signxml
• FiksInit class changes, not back compatible
  • small change in setup.py - now using setuputils

Version 0.7.5

• Bug - response object with errors not handeled correctly, instead only http error 500: Internal Server Error was returned - fixed using requests module

Version 0.7.4

• FINA CA certificates packed in release
• FiskInit - upgraded to use packed FINA certificates

Version 0.7.3

• python 2.7.9 support moved to master branch

Version 0.7.2

• files reorganization to distribute CA certificates together with code - needed for python version above 2.7.8 version

Version 0.7.1

• using urllib instead of httplib

Version 0.7.0

• FiskInit class for easier certificates and password handling

Version 0.6.3

• fixed bug with encrypted keys
• fixed small bug with text part of Element class related to unicode

Version 0.6.2

• added FiskSOAPClientProduction helper class
• EchoRequest unicode bug fixed

Version 0.6.1

• added type information in Validation errors / exceptions
• Exception handling removed from execute method - you have to except them by your self
  • implemented get_id_mag and get_datetime_msg methods of FiskXMLRequest class
  • PoslovniProstorZahtjev execute method false true bug fixed
  • unicode support for 2.x python fixed (I hope)

Version 0.6

• Known bugs fixed
• added execute method to FiskXMLRequest for easier request handling (no more need to parse raw XML returned from server and better error handling). execute method is similar to send method but it parses reply and returns reply as str or False if error occurs. There is also new get_last_error method for accessing possible errors.
  • USAGE section in README now have examples using execute method instead send method. Send method still works as it is used internally
  • little better handling of connection errors of FiskSOAPClient
  • Fisk*Error classes used for exceptions - implementation changed

Version 0.5.1

• Known bugs fixed
• required element check moved to generate method. So required element is check before sending request not at constructor.

Version 0.5

First public release