python-furs-fiscal
Installation
$ pip install furs_fiscal
Quick Start
Registering Immovable Business Premise
Registering new Business Premises is simple. But you will need to obtain certain information from your client such as:
- Real Estate Cadastral Number
- Real Estate Building Number
- Real Estate Building Section Number
One thing you should also keep in mind is your premise address - if your premise is located at Trzaska cesta 24A you will need to pass house number 24 and additional number A as separate parameters. If your street does not have additional house number/letter just pass None.
from furs_fiscal.api import FURSBusinessPremiseAPI
api = FURSBusinessPremiseAPI(p12_path='my_cert.p12',
p12_password='cert_pass',
production=True, request_timeout=2.0)
api.register_immovable_business_premise(tax_number=10039856,
premise_id='BP101',
real_estate_cadastral_number=112,
real_estate_building_number=11,
real_estate_building_section_number=1,
street='Trzaska cesta',
house_number='24',
house_number_additional='A',
community='Ljubljana',
city='Ljubljana',
postal_code='1000',
validity_date=datetime.now() - timedelta(days=60),
software_supplier_tax_number=24564444,
foreign_software_supplier_name=None,
special_notes='/')NOTE: As of 23.11.2015 FURS does require you to send some kind of Special note to them. Empty string will raise invalid JSON on their side.
Registering Movable Business Premise
In order to register Movable Business Premise you will need to define one of three types:
- TYPE_MOVABLE_PREMISE_A: Movable object such as vehicle, movable stand etc.
- TYPE_MOVABLE_PREMISE_B: Object at permanent location such as news stand, market stand etc.
- TYPE_MOVABLE_PREMISE_C: Individual electronic device in cases when the company does not use other business premises
from furs_fiscal.api import FURSBusinessPremiseAPI, TYPE_MOVABLE_PREMISE_A
api = FURSBusinessPremiseAPI(p12_path='my_cert.p12',
p12_password='cert_pass',
production=True,
request_timeout=2.0)
api.register_movable_business_premise(tax_number=10039856,
premise_id='BP102',
movable_type=TYPE_MOVABLE_PREMISE_A,
validity_date=datetime.now() - timedelta(days=60),
software_supplier_tax_number=24564444,
foreign_software_supplier_name=None,
special_notes='')Calculate Invoice ZOI - Protected ID
At the end of every Invoice your should print ZOI (Protected ID). To obtain it follow the next procedure:
from furs_fiscal.api import FURSInvoiceAPI
api = FURSInvoiceAPI(p12_path='my_cert.p12',
p12_password='cert_pass',
production=False,
request_timeout=1.0)
date_issued = datetime.now()
zoi = api.calculate_zoi(tax_number=10039856,
issued_date=date_issued,
invoice_number='11',
business_premise_id='BP101',
electronic_device_id='B1',
invoice_amount=Decimal('19.15'))Generate Data for QR/Code128/PDF417
You're supposed to print QR Code/Code128 or PDF 417 on every invoice after the ZOI. To obtain the data for QR/Code128/PDF417 perform the following method call on FURSInvoiceAPI object.
qr_data = api.prepare_printable(tax_number=10039856,
zoi=zoi,
issued_date=date_issued)Get EOR From FURS
To obtain FURS EOR code - UniqueID, you'll have to call the following method. It provides several other parameters, for issuing invoice storno and special tax rules. Please read the full documentation.
eor = api.get_invoice_eor(zoi=zoi,
tax_number=10039856,
issued_date=date_issued,
invoice_number='11',
business_premise_id='BP101',
electronic_device_id='B1',
invoice_amount=66.71,
low_tax_rate_base=35.14,
low_tax_rate_amount=3.34,
high_tax_rate_base=23.14,
high_tax_rate_amount=5.09,
operator_tax_number=12345678)Contributing
This library should be sufficient to integrate into your software as is, but there is still some work that needs to be done.
You can contribute in one of the following areas:
- Detailed documentation
- More examples for various use-cases
- Support for issuing invoices with multiple seller tax rates
- Tests - I'll be adding them soon, but I'll be grateful if you'd help
- Support for Decimal object serialization
Contact
Boris Savic
- Twitter: @zitko
- Email: boris70@gmail.com