eFacturePy — `ads-facturx`

Génération, validation et assemblage de factures électroniques Factur-X / EN 16931 en Python.

Python Version Build Status

🧭 Sommaire

À propos
Fonctionnalités
Architecture du dépôt
Installation
Démarrage rapide
API publique
Modèle de données
Validation EN 16931
Développement
Tests
Dépendances
Auteur

📖 À propos

eFacturePy est le dépôt de travail du package Python ads-facturx, un outil qui permet de :

produire un XML Cross Industry Invoice conforme au profil urn:cen.eu:en16931:2017 ;
générer le PDF/A-3 associé à l’aide de ReportLab ;
embarquer ce XML dans le PDF pour obtenir une Factur-X valide (via factur-x) ;
valider la facture via XSD (EN16931) et Schematron (moteur SaxonC-HE).

✨ Fonctionnalités

✅ Génération d’un XML Factur-X / EN 16931 à partir d’un dict métier
✅ Génération d’un PDF de facture (template par défaut + logo personnalisable)
✅ Fusion PDF + XML → fichier Factur-X conforme
✅ Validation XSD (profil en16931)
✅ Validation Schematron via XSLT précompilé (SaxonC)
✅ Modèles Pydantic v2 pour typer et valider les données métier

🏗️ Architecture du dépôt

eFacturePy/
├─ ads_facturx/              # Package distribué sur PyPI
│  ├─ Builders/              # Génération XML + PDF + Factur-X
│  ├─ Validators/            # XSD + Schematron (XSLT EN16931-CII)
│  ├─ models/                # Schémas Pydantic (DevisData, Invoice, …)
│  ├─ Samples/               # Jeu de données et XML de référence
│  └─ tests/                 # Tests unitaires pytest
├─ eFacturePy/               # Sorties d’exemple (PDF/XML générés)
├─ archive/                  # Ressources brutes : XSD, XSL, Schematron, Saxon
├─ dist/                     # Wheels et sdist historiques                   
├─ pyproject.toml            # Configuration Poetry
└─ poetry.lock

📦 Installation

Depuis PyPI :

pip install ads-facturx

Prérequis : Python ≥ 3.12. SaxonC-HE est installé automatiquement via la dépendance saxonche.

🚀 Démarrage rapide

from ads_facturx import (
    generate_xml, write_xml_from_string,
    xml_check_xsd, xml_check_schematron,
    generate_invoice, generate_facturx,
)
from ads_facturx.Samples.data import sample_raw_data as data

DESTINATION = "eFacturePy"

xml_string = generate_xml(data)
xml_path   = write_xml_from_string(xml_string, DESTINATION, "my_first_xml")

xml_check_xsd(xml_string)
report = xml_check_schematron(xml_path=xml_path)
print(report)

generate_invoice(file_name="my_first_invoice.pdf",
                 destination_folder=DESTINATION,
                 data=data, title="Ma facture",
                 logopath="TA_logo_reduced.jpg")

generate_facturx(file_name="my_first_invoice.pdf",
                 destination_folder=DESTINATION,
                 xml=xml_string)

🔌 API publique

Exposée via from ads_facturx import ... :

Fonction	Rôle
`generate_xml(data)`	Construit la chaîne XML CII EN 16931 à partir d’un `dict`.
`write_xml_from_string`	Sérialise l’XML sur disque (`destination_folder`, `file_name`).
`xml_check_xsd`	Valide l’XML avec le XSD `facturx` / niveau `en16931`.
`xml_check_schematron`	Applique les règles Schematron EN16931-CII via SaxonC.
`generate_invoice`	Génère le PDF de facture (ReportLab, logo + annexes optionnels).
`generate_facturx`	Embarque le XML dans le PDF pour produire la Factur-X finale.

🧾 Modèle de données

Le package fournit des schémas Pydantic v2 dans ads_facturx/models (notamment DevisData, Invoice, InvoiceLine, Company, Partner, …). generate_invoice valide les données via DevisData.model_validate(data) et applique des règles EN 16931 critiques (ex. obligation du numéro de TVA vendeur pour la catégorie S).

Un exemple complet de payload est fourni dans ads_facturx/Samples/data.py.

✅ Validation EN 16931

XSD : xml_check_xsd s’appuie sur factur-x (flavor="facturx", level="en16931").
Schematron : xml_check_schematron exécute Validators/xslt/EN16931-CII-validation.xslt avec SaxonC et renvoie la liste des failed-assert (id, location, message).

📚 Dépendances

factur-x, saxonche, pydantic, reportlab (voir pyproject.toml et poetry.lock).

👤 Auteur

Antoine Ducoulombier — Alchimie Data Solutions · antoine.ducoulombier@alchimiedatasolutions.com

Release files for ads-facturx 0.5.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ads-facturx 0.5.3
File	Size	Uploaded
ads_facturx-0.5.3.tar.gz	167.7 kB	Sep 10, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for ads-facturx 0.5.3
File	Interpreter	ABI	Platform	Reset
ads_facturx-0.5.3-py3-none-any.whl 178.9 kB Sep 10, 2026	Python 3	none	any	Details

Total release size:346.6 kB

Release files / ads_facturx-0.5.3.tar.gz

Download URL	ads_facturx-0.5.3.tar.gz
Size	167.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`a6d9bd34fc55434322eab535ea7a177416347e2c77d893cafdf2df493472d525`
BLAKE2b-256 checksum How to use checksums	`780bcec9679ab6b781768b0f9efeb8c3050832c58cd75e87ec35fcfcad9252aa`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.4.3 CPython/3.10.11 Windows/10`

Release files / ads_facturx-0.5.3-py3-none-any.whl

Download URL	ads_facturx-0.5.3-py3-none-any.whl
Size	178.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`60c09701474f61f81591dae1bd4f27b13974604503389011555895ccdd1e4a10`
BLAKE2b-256 checksum How to use checksums	`1eb9a9efb1aacd2473507d394ddb0e7bfdc9935432113d5925b1783071840598`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.4.3 CPython/3.10.11 Windows/10`