Yann AbadieHire me on Upwork

All selected work

Factur-X France 2027

A zero-dependency Python validator for French e-invoices (Factur-X, EN 16931). It ships as a CLI, a library and a reusable GitHub Action, with a browser-only audit page on the FacturKit site.

Status
Status: Released
Stack
Python standard library, GitHub Actions, PDF/A-3, EN 16931
Last commit
17 November 2026
Try it
Sources
Each tag opens the README line that makes the claim, at commit d724024.

The problem

France’s e-invoicing reform makes structured invoices such as Factur-X mandatory. Per README, every company must be able to receive them from 1 September 2026, and small companies must issue them from 1 September 2027. README L42–44 (source in the Factur-X France 2027 repository) A plain office PDF no longer qualifies. README L228 (source in the Factur-X France 2027 repository) Finance teams need to catch a bad file before a platform rejects it.

What I built

The README is in French, with an English summary. README L240 (source in the Factur-X France 2027 repository)

System as built

  1. Invoice in

    A PDF/A-3 file, a CII XML file, or a whole folder.README L86–94 (source in the Factur-X France 2027 repository)

  2. Streams decompressed

    /FlateDecode and /ObjStm; the XML is pulled from /EmbeddedFiles.README L194 (source in the Factur-X France 2027 repository)

  3. PDF/A-3 checks

    The /AF entry, XMP metadata and conformance level.README L195–196 (source in the Factur-X France 2027 repository)

  4. CII root and profile

    Namespace and profile URN.README L197–198 (source in the Factur-X France 2027 repository)

  5. Header, SIREN and totals

    Luhn checks and strict Decimal arithmetic.README L199–201 (source in the Factur-X France 2027 repository)

  6. The 4 mentions for 2026–2027

    Buyer SIREN, operation category, delivery address, VAT regime.README L202–205 (source in the Factur-X France 2027 repository)

  7. Report

    Terminal, JSON or pull-request annotations; exit code 1 if an invoice fails.README L93–97 (source in the Factur-X France 2027 repository)

How it is verified

What this means for your project

Status & limits

  • Working. v1.0.0 was released on 14 November 2026; last commit 17 November 2026.
  • This repository covers audit and verification only. It does not generate invoices. README L213 (source in the Factur-X France 2027 repository)
  • It runs the 14 checks it lists and nothing more. It is a tool, not a certification.