xrechnung-check
Command-line client for the free, keyless XRechnung / ZUGFeRD validator API.
pip install xrechnung-check
xrechnung-check invoice.xml
xrechnung-check invoice.xml --json
xrechnung-check zugferd invoice.pdf
xrechnung-check extract invoice.pdf
Until the package is on PyPI, install it from a checkout:
pip install ./cli
FILE is an XRechnung XML document (UBL or CII) or a ZUGFeRD PDF. The command posts it as multipart field file to https://checkxrechnung.com/v1/validate. Python 3.9+. The only dependency is requests.
No API key. Free limit: 50 validations per IP per UTC day, 10 per minute, shared with the ZUGFeRD routes. FILE on the default command is at most 5 MB. zugferd and extract accept a PDF up to 10 MB and call POST /v1/zugferd/validate and POST /v1/zugferd/extract. HTTP 429 carries Retry-After. Higher volume: https://checkxrechnung.com/api-waitlist
Human output lists each issue with its rule id and rule_url. If the API omits rule_url, the CLI uses https://checkxrechnung.com/fehler/<code> (lowercase). --json prints a normalized report: valid, errors[] with rule_id and rule_url, plus summary fields from the API.
| Exit | Meaning |
|---|---|
| 0 | ok was true |
| 1 | the file is invalid, or it is not an e-invoice |
| 2 | usage error, unreadable file, or the API could not be reached |
Docs: https://checkxrechnung.com/en/docs · Rules: https://checkxrechnung.com/fehler/ · OpenAPI: https://checkxrechnung.com/openapi.json
MIT. Copyright (c) 2026 Bobook Limited.
Metadata
Release files for xrechnung-check 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| xrechnung_check-0.2.0.tar.gz | 7.9 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| xrechnung_check-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 16.1 kB
Release files / xrechnung_check-0.2.0.tar.gz
| Download URL | xrechnung_check-0.2.0.tar.gz |
|---|---|
| Size | 7.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c6962ec00820a159135167de4b99b33f836ef9ae212f47a3cf17d580f5f8925a
|
|
BLAKE2b-256 checksum How to use checksums |
043c27d188a361b9852e76c5eac9ef11a0c6ba66fb4690dee335b04d332d0d95
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.5
|
Release files / xrechnung_check-0.2.0-py3-none-any.whl
| Download URL | xrechnung_check-0.2.0-py3-none-any.whl |
|---|---|
| Size | 8.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
501a034ccdb4ae2d1de47e84a57b6106c5e2808156159c0c1def2407319c130f
|
|
BLAKE2b-256 checksum How to use checksums |
2022eb50bfd98bff338918bad98d9a5929aef0feebf1e2ae7f4e45758d243406
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.5
|
Security for xrechnung-check 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.