Skip to main content

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)

Source distribution for xrechnung-check 0.2.0
File Size Uploaded Provenance
xrechnung_check-0.2.0.tar.gz 7.9 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for xrechnung-check 0.2.0
File Interpreter ABI Platform
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.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page