README.md 1.19 KB
Newer Older
Jakob Heher's avatar
Jakob Heher committed
1
2
# RKSV parser

Jakob Heher's avatar
Jakob Heher committed
3
This is a demonstration script for processing receipt QR codes under the Austrian [Registrierkassensicherheitsverordnung (RKSV)](https://de.wikipedia.org/wiki/Registrierkassensicherheitsverordnung).
Jakob Heher's avatar
Jakob Heher committed
4

Jakob Heher's avatar
Jakob Heher committed
5
QR code data can be passed in one of three ways:
Jakob Heher's avatar
Jakob Heher committed
6

Jakob Heher's avatar
Jakob Heher committed
7
8
9
* Piped from stdin: `./rksv.py --stdin`
* Read from a file: `./rksv.py --file <filename>`
* Read from CLI: `./rksv.py --data <encoded data>`
Jakob Heher's avatar
Jakob Heher committed
10

11
12
For AT1 and AT2 certificates, the certificate is retrieved via LDAP and signature validation is also performed.  
I am looking for real-world AT3 receipts to verify a respective implementation with. If you have such a receipt, please get in touch!
Jakob Heher's avatar
Jakob Heher committed
13

14
15
## UID resolution

16
AT1 certificates are typically issued to a specified UID, not a company name. If you would like to automatically resolve this UID to a name, the parser can do this, using [the Open Data API](https://opendata.host/de/open-data).
17
18
19

To do this, it requires your personal API key to be available in the `OPENDATA_API_KEY` environment variable.

Jakob Heher's avatar
Jakob Heher committed
20
21
## License

Jakob Heher's avatar
Jakob Heher committed
22
23
24
![CC0 Public Domain mark](https://i.creativecommons.org/p/zero/1.0/88x31.png)

This script is licensed under [Creative Commons CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/).