Skip to main content

Factur-X & ZUGFeRD 2.3 EN 16931 E-Invoice Engine — Python SDK

PyPI version Python Versions License: MIT Stanza API

Sub-5ms Factur-X, ZUGFeRD 2.x and XRechnung e-invoice validation and parsing from PDF/A-3 hybrid files or UN/CEFACT CII XML.

Official, zero-dependency Python 3.8+ client library for Factur-X & ZUGFeRD 2.3 EN 16931 E-Invoice Engine, built on the Stanza Micro-API Network. Intended for enterprise data pipelines, backend verification, and sub-5ms edge compute.


📦 Installation

pip install stanzaapi-factur-x-validator

🚀 Quickstart

import os
from stanzaapi_factur_x_validator import FacturXValidatorClient

# Initialize client (api_key optional for local evaluation)
client = FacturXValidatorClient(
    api_key=os.getenv("STANZA_API_KEY")
)

# Execute deterministic validation
response = client.validate("<CrossIndustryInvoice xmlns=\"urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100\">...</CrossIndustryInvoice>")

if response.get("success"):
    print("Verification Success:", response["data"])
else:
    print("Validation Error:", response.get("error"), response.get("code"))

📄 Example Response

{
  "success": true,
  "data": {
    "valid": true,
    "profile": "EN16931",
    "invoice_number": "FX-2026-0001"
  }
}

⚙️ Client Options

Parameter Type Default Description
api_key Optional[str] os.getenv("STANZA_API_KEY") Your Stanza API Key. Required for production quotas.
base_url Optional[str] "https://api.stanzaapi.com/factur-x-validator" Public edge API base URL.
timeout int 15 Request timeout in seconds.

📄 License

MIT © Stanza — Powered by Stanza.

Metadata

Release files for stanzaapi-factur-x-validator 1.0.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 stanzaapi-factur-x-validator 1.0.0
File Size Uploaded Provenance
stanzaapi_factur_x_validator-1.0.0.tar.gz 3.9 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for stanzaapi-factur-x-validator 1.0.0
File Interpreter ABI Platform
stanzaapi_factur_x_validator-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 7.8 kB

Release files / stanzaapi_factur_x_validator-1.0.0.tar.gz

Download URL stanzaapi_factur_x_validator-1.0.0.tar.gz
Size 3.9 kB
Tags Source
SHA-256 checksum
How to use checksums
2850ae832b5c942cea1af92f77ce405f2cc135008f1449ec41ee6a98b35656ac
BLAKE2b-256 checksum
How to use checksums
289b525d977b91930dcb43b759e5825e27cc46d574043cb7f01f836bc417cae6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / stanzaapi_factur_x_validator-1.0.0-py3-none-any.whl

Download URL stanzaapi_factur_x_validator-1.0.0-py3-none-any.whl
Size 4.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
69de9e0f412b1cba90fa66f21b0270cc0f0381f02b5cb5ffcd158240c85a6721
BLAKE2b-256 checksum
How to use checksums
02f0b91b099217d2f8cc8c1b3505c86a553932fc036d25cb3663a810f0c1a46d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Security for stanzaapi-factur-x-validator 1.0.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

1.0.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