ZATCA (Fatoora) QR-Code Implementation
An unofficial package help developers to implement ZATCA (Fatoora) QR code easily which required for e-invoicing
Requirements
- python >= 3.8
- zbar-tools
Installation
You can install the package via pypi (pip):
$ pip3 install fatoora
or via github (git):
$ git clone https://github.com/TheAwiteb/fatoora/
$ cd fatoora
$ python3 setup.py install
Usage
Generate Base64
from fatoora import Fatoora
fatoora_obj = Fatoora(
seller_name="Awiteb",
tax_number=1234567891, # or "1234567891"
invoice_date="2021-07-12T14:25:09+00:00", # ISO8601 @see https://en.wikipedia.org/wiki/ISO_8601
total_amount=100, # or 100.0, 100.00, "100.0", "100.00"
tax_amount=15, # or 15.0, 15.00, "15.0", "15.00"
)
print(fatoora_obj.base64)
# AQZBd2l0ZWICCjEyMzQ1Njc4OTEDFDIwMjEtMDctMTJUMTQ6MjU6MDlaBAYxMDAuMDAFBTE1LjAw
Render A QR Code Image
You can render the tags as QR code image easily
from fatoora import Fatoora
fatoora_obj = Fatoora(
seller_name="Awiteb",
tax_number=1234567891,
invoice_date="2021-07-12T14:25:09+00:00",
total_amount=100,
tax_amount=15,
)
fatoora_obj.qrcode("qr_code.png")
Generate hash (sha256)
from fatoora import Fatoora
fatoora_obj = Fatoora(
seller_name="Awiteb",
tax_number=1234567891,
invoice_date="2021-07-12T14:25:09+00:00",
total_amount=100,
tax_amount=15,
)
print(fatoora_obj.hash)
# 7074ff5ad3b05534744037778ad1542e3c8057acd8308f50b95c7834f4955ed0
Read qr code
from fatoora import Fatoora
fatoora_obj = Fatoora(
seller_name="Awiteb",
tax_number=1234567891,
invoice_date="2021-07-12T14:25:09+00:00",
total_amount=100,
tax_amount=15,
)
fatoora_obj.qrcode("qr_code.png")
print(Fatoora.read_qrcode("qr_code.png", dct=True))
# {'seller_name': 'Awiteb', 'tax_number': '1234567891', 'invoice_date': '2021-07-12T14:25:09+00:00', 'total_amount': '100.00', 'tax_amount': '15.00'}
print(Fatoora.read_qrcode("qr_code.png", dct=False))
# AQZBd2l0ZWICCjEyMzQ1Njc4OTEDFDIwMjEtMDctMTJUMTQ6MjU6MDlaBAYxMDAuMDAFBTE1LjAw
Extra Methods
fatoora_obj = Fatoora(
seller_name="Awiteb",
tax_number=1234567891,
invoice_date="2021-07-12T14:25:09+00:00",
total_amount=100,
tax_amount=15,
)
print(fatoora_obj.invoice_date.year)
# 2021
print(fatoora_obj.invoice_date.isoformat())
# 2021-07-12T14:25:09+00:00
print(fatoora_obj.invoice_date.timestamp())
#1626099909.0
print(fatoora_obj.json())
# "{"seller_name": "Awiteb", "tax_number": "1234567891", "invoice_date": "2021-07-12T14:25:09+00:00", "total_amount": "100.00", "tax_amount": "15.00"}"
print(fatoora_obj.dict())
# {'seller_name': 'Awiteb', 'tax_number': '1234567891', 'invoice_date': '2021-07-12T14:25:09+00:00', 'total_amount': '100.00', 'tax_amount': '15.00'}
# Use class to get fatoora details by base64
print(Fatoora.base2dict(fatoora_obj.base64))
# {'seller_name': 'Awiteb', 'tax_number': '1234567891', 'invoice_date': '2021-07-12T14:25:09+00:00', 'total_amount': '100.00', 'tax_amount': '15.00'}
Security
If you discover any security related issues.
License
The MIT License (MIT). Please see License File for more information.
![[Bug]: `read_qrcode` panic when read a qr code contain a url](https://avatars.githubusercontent.com/u/59842932?v=4)
417 Oct 03, 2022
185 Jan 01, 2023
237 Dec 29, 2022
1 Oct 28, 2021
65 Dec 01, 2022
391 Dec 30, 2022
188 Dec 28, 2022
1 Jan 04, 2022
952 Dec 31, 2022
6 May 22, 2022
18 Jan 27, 2022
2 Jan 19, 2022
1.3k Dec 22, 2022
25 Oct 24, 2021
541 Dec 28, 2022
121 Oct 15, 2021
231 Dec 27, 2022
26 Dec 13, 2022
1.7k Dec 31, 2022
13 Mar 31, 2022