Metadata-Version: 2.5
Name: zugferd
Version: 0.1.0
Summary: Generate, validate (official KoSIT rules) and parse ZUGFeRD / Factur-X e-invoices via the xrechnung.dev API. Alias of the `xrechnung` package. No JVM required.
Project-URL: Homepage, https://xrechnung.dev
Project-URL: Documentation, https://xrechnung.dev/zugferd-python/
Author-email: "xrechnung.dev" <dev@xrechnung.dev>
License-Expression: MIT
License-File: LICENSE
Keywords: e-rechnung,einvoice,en16931,factur-x,pdf/a-3,xrechnung,zugferd
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial :: Accounting
Classifier: Typing :: Typed
Requires-Python: >=3.9
Requires-Dist: xrechnung<1,>=0.1.0
Description-Content-Type: text/markdown

# zugferd

Generate, validate and parse **ZUGFeRD 2.x / Factur-X** (PDF/A-3) and **XRechnung** e-invoices from Python
through the [xrechnung.dev](https://xrechnung.dev) API.

This package is a thin alias of [`xrechnung`](https://pypi.org/project/xrechnung/) — same API, same code.
Zero dependencies beyond it, **no JVM required**, and every document is always validated with the current
official KoSIT rules (XRechnung 3.0.2, Schematron 2.6.0).

```bash
pip install zugferd
```

```python
import zugferd

pdf = zugferd.generate(invoice, format="zugferd", language="de")   # PDF/A-3 with embedded EN 16931 XML
open("rechnung.pdf", "wb").write(pdf)

result = zugferd.validate("rechnung.pdf")
for e in result.errors:
    print(e.code, e.message, e.doc_url)
```

Free tier: 10 documents per month without an API key. See the full documentation in the
[`xrechnung` README](https://pypi.org/project/xrechnung/). MIT licensed.
