einvoicekit

Pourquoi nous l’avons créé

En Europe, les factures électroniques suivent une même norme, l’EN 16931, qui compte à elle seule plus de 200 règles métier. Chaque format national ajoute les siennes : XRechnung en Allemagne, Factur-X et ZUGFeRD en France et en Allemagne, Peppol BIS dans de nombreux pays. En France, depuis le 1er septembre 2026, toute entreprise assujettie à la TVA doit pouvoir recevoir des factures électroniques, et les grandes entreprises et les ETI doivent en émettre. Les PME et les microentreprises devront en émettre à partir du 1er septembre 2027.

Les développeurs qui intègrent la facturation dans leur logiciel ont besoin de deux choses : savoir exactement pourquoi une facture est refusée, et en produire une qui soit acceptée. einvoicekit fait les deux, par API.

Ce que « valide » veut dire ici

La validation se fait en deux étapes, dans l’ordre suivi par le validateur officiel du KoSIT. D’abord le schéma XML (XSD) : le document est-il bien construit ? Puis le schematron, les règles métier officielles : les totaux tombent-ils juste, les champs obligatoires sont-ils là, la ventilation de TVA correspond-elle aux lignes ? Un document qui échoue au schéma s’arrête à la première étape.

Nous ne réécrivons pas ces règles. einvoicekit exécute les fichiers de règles officiels : EN 16931, la configuration KoSIT pour XRechnung 3.0.2, les règles Factur-X 1.09 et Peppol BIS 3.0. Chaque règle métier qu’une facture enfreint revient avec son identifiant, par exemple BR-CO-15, pour qu’un développeur puisse la retrouver et la corriger. Pour les factures françaises, les règles BR-FR publiées pour la réforme française s’ajoutent avec une option.

Générer une facture valide

POST /v1/generate reçoit la facture en JSON et renvoie un Factur-X : un PDF qui contient la facture XML. einvoicekit calcule lui-même les totaux, puis fait passer le résultat par la même validation, plus un contrôle PDF/A-3 avec veraPDF, avant de le renvoyer. Une facture en échec n’est jamais renvoyée comme si elle était valide.

Le contrôle PDF/A-3 s’applique aux PDF générés par einvoicekit. Pour les fichiers que vous déposez, le validateur contrôle les données de la facture, pas la conformité PDF/A du fichier.

Des outils gratuits, et où va votre fichier

Le validateur et le générateur web sont gratuits et sans compte, avec une limite quotidienne. Le validateur envoie votre facture à notre service de validation, où elle est traitée en mémoire et n’est pas stockée. Il ne s’exécute pas dans votre navigateur, et le site d’einvoicekit l’indique.

Les paquets clients sont open source sous licence MIT : @einvoicekit/einvoicekit sur npm et einvoicekit sur PyPI, avec leur code sur GitHub. Le site, l’API et le service de validation ne sont pas open source.

Où il tourne, et comment nous le surveillons

Le site et l’API tournent sur Cloudflare Workers ; le moteur de validation est un service Java sur Cloudflare Containers. Une sonde installée hors de Cloudflare, sur un serveur Hetzner, vérifie le site et l’API toutes les 60 secondes et lance un contrôle plus poussé chaque heure. Sa page de statut est publique : chacun peut y voir le résultat de chaque vérification.

Chaque modification passe par la vérification du formatage, la vérification des types, le linter, les tests du site et de l’API, le build et les tests Java ; chaque déploiement envoie ensuite une vraie requête de validation à l’API en production. Le site existe en anglais, en français et en allemand, et il est en ligne depuis août 2026.

Visiter einvoicekit.com