Repository navigation
Ce que valide ZeRechnung
État au 17 novembre 2026, version v0.1.0, branche
mainau commita580779(PR #51 : schematrons Factur-X 1.09.2 de BASIC, EN 16931 et EXTENDED) ; les schematrons BR-FR et XRechnung UBL, au commita4f328a(PR #38) ; le schéma des factures XRECHNUNG et EXTENDED-CTC-FR, au commit6f892aa(PR #45) ; le contrôle de la Leitweg-ID et de la GEBA, au commit3905159(PR #42) ; la lecture du XML ZUGFeRD 1.0, au commit4767fba(PR #41) ; les règles de syntaxe du schematron EXTENDED-CTC-FR, au commit442deb0(PR #47) ; les tests sur les artefacts officiels et la parité avec KoSIT et Mustang, en CI depuis le commitd63e792(PR #44) ; la conversion en PDF/A-3 et sa vérification par veraPDF, au commitfe8db5e(PR #68) ; la lecture du contenu des pages, des programmes de police et des données JPEG 2000, au commit3ab8263(PR #73). Cette page liste les normes et les jeux de règles que ZeRechnung applique réellement, d'après le code : version de l'artefact officiel, nombre de règles du catalogue, profils couverts, conditions d'application et limites connues. Seul ce qui est fusionné dansmainy est présenté comme validé ; le travail en cours est signalé à part. La comparaison avec la norme complète et avec les autres librairies est sur la page Grille de la norme.
- En bref
- Quels jeux s'appliquent
- Détail par jeu de règles
- Ce qui n'est pas validé
- Syntaxe UBL 2.1
- Tests sur les artefacts officiels
- Identifiants propres au package
Deux syntaxes sont validées : CII (UN/CEFACT CrossIndustryInvoice, D22B en écriture, D16B accepté en lecture, ainsi que le CrossIndustryDocument de ZUGFeRD 1.0), seule ou dans un PDF hybride, et UBL 2.1 (Invoice et CreditNote OASIS, en XML seul). validate et la CLI reconnaissent la syntaxe à l'élément racine ; un PDF Factur-X qui embarque un UBL est refusé, Factur-X imposant le CII. Les règles des schematrons officiels sont réécrites en Go : ni moteur XSLT, ni Java, ni appel réseau. Chaque constat porte l'identifiant officiel de la règle, sa gravité, sa source, le chemin XPath et la ligne.
Jeu (validate.RuleSet) |
Norme ou artefact officiel | Version | Règles au catalogue | Erreurs / avert. / info | Appliqué |
|---|---|---|---|---|---|
Schema |
XSD Factur-X, un par profil ; XSD OASIS UBL 2.1 (Invoice, CreditNote) ; XSD FatturaPA ; XSD Facturae, un par version ; spécification ZUGFeRD 1.0 | 1.09.2 (= ZUGFeRD 2.5.2) ; 2.1 ; 1.2.4 ; 3.2, 3.2.1 et 3.2.2 ; 1.0 | 17 : 11 contrôles communs aux syntaxes, 4 contrôles ZUGFeRD 1.0, 2 contrôles Facturae | 14 / 3 / 0 | d'office |
EN16931 |
Artefacts de validation CEN TC 434, CII et UBL ; motif de syntaxe du schematron EXTENDED-CTC-FR (FNFE-MPE) | 1.3.17 ; 1.4.0.04 | 1 565 : 793 en CII, règles métier communes, 759 règles de syntaxe UBL, 13 règles du schematron EXTENDED-CTC-FR absentes du catalogue CEN | 397 / 1 168 / 0 | d'office |
FacturX |
Schematrons Factur-X MINIMUM et BASIC WL ; schematrons et listes de codes BASIC, EN 16931 et EXTENDED ; XSLT EXTENDED | 1.09 ; 1.09.2 | 544 : 229 règles écrites d'après les schematrons et l'XSLT, 315 assertions de listes de codes générées (48 BASIC, 58 EN 16931, 209 EXTENDED) | 523 / 21 / 0 | d'office, CII seulement |
France |
Schematrons BR-FR de la réforme (FNFE-MPE, France_RFE), CII et UBL ; profils admis | 1.4.0.04 | 197 + 3 : 170 assertions en CII, 173 en UBL | 199 / 1 / 0 | sur option |
Germany |
Schematrons XRechnung (KoSIT), CII et UBL ; Formatspezifikation Leitweg-ID ; GEBA Formatspezifikation | 3.0.2 ; 2.0.2 ; 1.0.1 | 66 : 52 en CII, 57 en UBL, 4 contrôles d'identifiants | 48 / 17 / 1 | d'office pour XRECHNUNG, sinon sur option |
GermanyProfile |
Profils acceptés par le BMF (BMF-Schreiben du 15/10/2024) | — | 1 | 1 / 0 / 0 | sur option |
ChorusPro |
Spécifications externes Chorus Pro, annexe EDI | V4.23 | 8 | 8 / 0 / 0 | sur option |
Peppol |
Schematrons Peppol BIS Billing 3.0, CII et UBL (PEPPOL-EN16931-CII.sch, PEPPOL-EN16931-UBL.sch) |
3.0.21 (inchangés en 3.0.22) | 166 : 90 en CII, 165 en UBL | 139 / 27 / 0 | d'office pour un BT-24 Peppol, sinon sur option |
Italy |
Regole tecniche italiennes (art. 3 du d.lgs. 148/2018), appendices 2 (CIUS-IT) et 3 (extensions EXT-IT), sans schematron officiel ; XSD FatturaPA pour les listes de codes | 2.7 (règles inchangées depuis 2.5) ; 1.2.4 | 149 : 59 règles CIUS-IT, 45 règles des extensions (BR-IT-DE), 5 contrôles d'identifiants, 40 contrôles du SDI sur le contenu d'une FatturaPA | 141 / 8 / 0 | d'office pour un BT-24 CIUS-IT, sinon sur option |
Conteneur PDF (zerechnung.Check, CheckContainer) |
Spécification Factur-X 1.08 et 1.09 (§ 5.3, § 6.2.2) ; ISO 19005-2, 19005-3 et 19005-4 | — | 72 contrôles (PDF-01 à PDF-72) | 57 / 15 / 0 | pour tout PDF |
validate.Catalog(set) renvoie les règles d'un ensemble de jeux, CII et UBL confondus, sans doublon quand un identifiant existe dans les deux syntaxes : 2 124 pour Default (schéma, EN 16931, Factur-X), 2 565 avec tous les jeux. zerechnung rules [-fr] [-de] [-choruspro] [-peppol] les affiche. Les 72 contrôles du conteneur sont dans zerechnung.ContainerCatalog.
Profils. MINIMUM, BASIC WL, BASIC, EN 16931, EXTENDED, EXTENDED-CTC-FR, XRECHNUNG et PEPPOL sont reconnus par leur identifiant BT-24 (cbc:CustomizationID en UBL), y compris les graphies anciennes ou fautives trouvées dans la nature. Options.Profile force un profil.
| Profil | Schéma | EN 16931 | Factur-X | Ajouté d'office |
|---|---|---|---|---|
| MINIMUM | XSD MINIMUM | — (pas une facture EN 16931) | schematron MINIMUM 1.09 | |
| BASIC WL | XSD BASIC WL | — (pas une facture EN 16931) | schematron BASIC WL 1.09 | |
| BASIC | XSD BASIC | règles métier ; syntaxe CII, gravités et listes de codes du schematron Factur-X BASIC 1.09.2 | identification du profil, 48 listes de codes du schematron BASIC 1.09.2 | |
| EN 16931 | XSD EN 16931 | toutes les règles ; dans un PDF Factur-X (Hybrid), comme BASIC, selon le schematron EN 16931 1.09.2 |
identification du profil ; dans un PDF Factur-X, 58 listes de codes du schematron EN 16931 1.09.2 | |
| XRECHNUNG | XSD EN 16931 | toutes, gravités de la configuration KoSIT 3.0.2 | identification du profil | BR-DE |
| PEPPOL | XSD EN 16931 | toutes les règles | identification du profil | Peppol |
| EXTENDED | XSD EXTENDED | sous-ensemble retenu par Factur-X, le reste en avertissement ; listes de codes du schematron Factur-X | 61 règles BR-FXEXT d'EXTENDED 1.09.2, 209 listes de codes du schematron EXTENDED 1.09.2 | |
| EXTENDED-CTC-FR | XSD EXTENDED | comme EXTENDED, mais les listes de codes du CEN en avertissement et, en CII, les règles de syntaxe du schematron EXTENDED-CTC-FR de la FNFE à la place de celles du CEN | 61 règles BR-FXEXT, sans les listes de codes du schematron EXTENDED | |
| ZUGFeRD 1.0 (basic, comfort, extended) | contrôle structurel minimal (ZF1-01 à ZF1-03) | — (antérieur à EN 16931) | — | avertissement ZF1-04, quels que soient les jeux |
| inconnu | XSD EXTENDED, avec l'avertissement XSD-PROFILE | toutes les règles | identification du profil (erreur FX-PROFILE-01 ou 02) | |
| UBL 2.1 (EN 16931, XRECHNUNG, PEPPOL…) | XSD UBL 2.1 d'Invoice ou de CreditNote | règles des artefacts UBL, UBL-CR, UBL-SR, UBL-DT ; gravités KoSIT pour XRECHNUNG | — (règles propres au CII) | BR-DE (schematron UBL), Peppol (schematron UBL) |
validate.XML(xml, opts) valide un XML seul ; zerechnung.Check(pdf, opts) contrôle le conteneur puis le XML, avec l'option Hybrid. Avec opts nil ou vide, le jeu Default s'applique, plus BR-DE pour une facture XRECHNUNG et les règles Peppol pour une facture Peppol. Les options sont les mêmes pour le CII et l'UBL ; chaque jeu applique les règles de la syntaxe de la facture.
| Option | Jeux appliqués |
|---|---|
nil ou &validate.Options{}
|
Schema, EN16931, FacturX ; plus Germany si BT-24 est XRECHNUNG, Peppol si BT-24 est l'identifiant Peppol BIS Billing 3.0, Italy si BT-24 est un identifiant CIUS-IT |
Auto: true |
En plus : France pour un vendeur en France (BT-40 = FR), GermanyProfile pour un vendeur en Allemagne (BT-40 = DE) ; Check y ajoute l'/AFRelationship du pays (PDF-14, PDF-40). Auto n'ajoute jamais Peppol, ni Germany à une facture ZUGFeRD |
Rules: … |
Les jeux demandés (validate.Default | validate.France, etc.), plus toujours Germany pour une facture XRECHNUNG, Peppol pour une facture Peppol et Italy pour une facture CIUS-IT, plus ceux d'Auto si l'option est mise |
RejectBasicWL: true |
Avec France, BASIC WL devient une erreur (FR-PROFILE-03) |
PublicBuyer{ServiceCodeRequired, EngagementRequired} |
Paramétrage de l'acheteur public dans l'annuaire Chorus Pro, lu par ChorusPro
|
Profile: invoice.ProfileBasic |
Valide contre ce profil plutôt que celui que déclare BT-24 |
Hybrid: true |
Le XML est celui d'un PDF Factur-X : une facture EN 16931 reçoit le schematron Factur-X 1.09.2 de son profil plutôt que les règles CEN 1.3.17 (BASIC et EXTENDED le reçoivent toujours). zerechnung.Check le fixe, zerechnung.Create aussi quand il valide le XML (PR #51) |
Depuis la PR #37, l'ajout de Germany à une facture XRECHNUNG et de Peppol à une facture Peppol ne dépend plus de Rules : Rules: validate.Default | validate.France garde BR-DE sur une facture XRECHNUNG. En ligne de commande, -fr, -de, -choruspro et -peppol s'ajoutent aux règles par défaut, sans jamais retirer BR-DE ni Peppol ; -hybrid fixe Hybrid pour un XML seul, un PDF étant toujours validé avec.
-
Référence : XSD Factur-X 1.09.2. Le paquet FeRD ZUGFeRD 2.5.2 donne BASIC, EN 16931 et EXTENDED ; le paquet FNFE-MPE 1.09 donne MINIMUM et BASIC WL, que le corrigendum 1.09.2 ne modifie pas. Les cinq schémas sont compilés en tables Go (
internal/schema/tables_gen.go) pargo generate. -
XRECHNUNG : une facture XRECHNUNG en CII est contrôlée, comme dans le validateur KoSIT, contre le XSD UN/CEFACT CII D16B complet de la configuration KoSIT XRechnung 3.0.2 (release du 31/08/2026), compilé dans
internal/schema/cii_d16b_tables_gen.go(PR #45). Les éléments D16B hors du jeu EN 16931 y sont admis et ce sont les règles CII-SR qui les signalent ;udt:DateTime(xs:dateTime) et les attributs à valeur fixe sont contrôlés ; une seule référence à une facture antérieure (BG-3) est permise, etcii.Marshaln'en écrit qu'une pour XRECHNUNG. - EXTENDED-CTC-FR : contrôlée contre le XSD EXTENDED. Il est inclus dans le XSD CII D22B avec lequel le paquet FNFE-MPE 1.4.0.04 valide les factures CII (les tests le vérifient sur les tables compilées), et le schematron EXTENDED-CTC-FR de la FNFE ramène le D22B au périmètre d'EXTENDED par 434 règles CII-SR actives (48 autres sont en commentaire), dont 38 bloquantes, que le D22B seul laisserait passer. Depuis la PR #47, ces règles sont appliquées (voir EN 16931).
-
FatturaPA : un document FatturaPA (FPA12, FPR12) est contrôlé contre le XSD FatturaPA 1.2.4 de l'Agenzia delle Entrate, compilé dans
internal/schema/fatturapa_tables_gen.go; le XSD 1.2.3 ne s'en distingue que par le régime fiscal RF21. Le contenu deds:Signaturen'est pas vérifié par le schéma, les autres jeux ne s'appliquent pas. S'y ajoutent, sous leurs codes et la sourceSDI, les 40 contrôles du SDI sur le contenu qui ne demandent aucune de ses données : identifiants par leur format et leur clé, transmission, taux et natures, montants des lignes et des récapitulatifs, dates et numéros, retenue et caisse, parties selon le type de document (00300 à 00476, PR #86) ; ne sont pas faits ceux qui interrogent le SDI ou l'Anagrafe tributaria (00002, 00311, 00312, 00320 à 00327, 00404, 00477). La signature d'un fichier se vérifie à part, avecfatturapa.VerifySignature, sous les codes du SDI (critère IT5 de la Grille de la norme) ; xmllint rend les mêmes verdicts en CI (PR #79). -
Facturae : un document Facturae est contrôlé contre le XSD de sa version (3.2, 3.2.1 ou 3.2.2, reconnue par l'espace de noms de la racine), publié par facturae.gob.es et compilé dans
internal/schema/facturae_tables_gen.goavec la mention de source exigée. Le contenu deds:Signatureet desExtensionsn'est pas vérifié. FE-01 signale une valeur illisible (montant, taux, date, code pays, moyen de paiement) ou un document sans en-tête, parties ou facture ; l'avertissement FE-02, émis quels que soient les jeux choisis, rappelle que Facturae n'est pas une syntaxe d'EN 16931 : les autres jeux ne s'appliquent qu'après conversion en UBL ou en CII. Pas de jeu espagnol : les règles de l'AEAT sont un brouillon sans codes d'erreur, et le contrôle du NIF n'est pas publié (PR #84). -
ZUGFeRD 1.0 : pas de XSD ZUGFeRD 1.0. Le document est lu à travers une vue CII D16B ;
validatelui applique un contrôle structurel minimal : identifiant ZUGFeRD 1.0 connu (ZF1-01), valeurs lisibles (ZF1-02), données qui identifient une facture : numéro, type, date, vendeur, acheteur, devise et montant total (ZF1-03). L'avertissement ZF1-04, émis quels que soient les jeux choisis, rappelle qu'une facture ZUGFeRD 1.0 n'est pas une facture EN 16931 : ni les règles EN 16931, ni celles de Factur-X, ni les règles nationales ne s'y appliquent (PR #41). -
Catalogue : 11 contrôles, plus ZF1-01 à ZF1-03 (erreurs) et ZF1-04 (avertissement) pour ZUGFeRD 1.0, et FE-01 (erreur) et FE-02 (avertissement) pour Facturae. Les 11 contrôles : XSD-ROOT, XSD-NAMESPACE, XSD-UNEXPECTED, XSD-ORDER, XSD-MISSING, XSD-COUNT, XSD-ATTRIBUTE, XSD-ATTRIBUTE-MISSING, XSD-TYPE, XSD-TEXT (erreurs) et XSD-PROFILE (avertissement : profil inconnu, contrôlé contre EXTENDED). XSD-TYPE couvre
xs:decimal,xs:double,xs:boolean,xs:base64Binary,xs:date,xs:time,xs:dateTime, les énumérations, les valeurs fixes, les longueurs et les motifs. -
UBL : XSD OASIS UBL 2.1 (os-UBL-2.1, schémas
xsdrtd'Invoice et CreditNote), compilés en tables Go (internal/schema/ubl_tables_gen.go) ; mêmes contrôles XSD-* qu'en CII (PR #36). Sur 11 000 variantes des factures UBL du corpus et de la suite KoSIT modifiées au hasard (ordre, cardinalités, types, attributs, espaces de noms, extensions), le verdict est celui de xmllint (libxml2) avec les XSD OASIS. -
Limites : le schéma EXTENDED est plus strict que la FNFE. Sur 2 931 variantes des 5 exemples EXTENDED-CTC-FR de France_RFE, 125 sont acceptées par la FNFE (valides contre le D22B, aucune règle bloquante) mais rejetées par le schéma EXTENDED : deux contenus dans une note, deux descriptions d'article ou de conditions de paiement, un second
BusinessProcessSpecifiedDocumentContextParameter, une description dans les conditions de livraison, l'absence des totaux du document (BG-22). En UBL, le contenu des extensions (ext:ExtensionContent, déclaréxsd:anylax) n'est pas vérifié : les schémas de signature qu'il importe (xmldsig, XAdES) ne sont pas compilés, seuls l'espace de noms et le nombre de ses éléments le sont.
-
Référence : artefacts de validation CEN TC 434 1.3.17 (
validation-1.3.17, syntaxe CII). Le catalogue est généré depuis les artefacts (internal/rules/en16931/catalog_gen.go), les listes de codes aussi. -
Catalogue : 793 assertions (328 erreurs, 465 avertissements) : BR (58), BR-CO (19), BR-CL (23), BR-DEC (21), règles par catégorie de TVA BR-S, BR-Z, BR-E, BR-AE, BR-IC, BR-IG, BR-IP, BR-G, BR-O, BR-B (94), règles de syntaxe CII-SR (478) et CII-DT (100).
-
EXTENDED-CTC-FR : en CII, les règles de syntaxe du motif EN16931-CII-Syntax du schematron
EXTENDED-CTC-FR-CII.schde la FNFE-MPE (France_RFE 1.4.0.04) remplacent celles du CEN, avec ses niveaux et ses messages : 535 règles (108 erreurs, 427 avertissements), soit 434 CII-SR (38 bloquantes), 92 CII-DT et 9 règles propres (CII-FREXT-SR-069, 072, 106, 293, 366 et 439, CII-EXT-DT-018, CII-FREXT-DT-024, CII-FREXTDT-027). Le catalogue est généré du schematron (internal/rules/en16931/ctcfr_gen.go). Les données qu'EXTENDED-CTC-FR admet n'y sont pas signalées : notes de ligne avec sujet, type et mesure d'une caractéristique d'article, référence de commande et Incoterm à la ligne, plusieurs cartes ou mandats de paiement… Les constats sont ceux de la XSLTEXTENDED-CTC-FR-CII.xsltexécutée par Saxon (même nombre par règle et par niveau) sur les 28 exemples CII et Factur-X, qui n'en ont aucun, et sur les 8 716 variantes qu'elle traite parmi 10 000 (elle s'arrête sur une erreur de type pour les autres) ; 525 des 535 règles y sont déclenchées (PR #47). -
UBL : artefacts CEN 1.3.17 pour UBL (PR #34). Les règles métier et les listes de codes gardent leurs identifiants, avec les contextes et les tests UBL : catégories L et M, tolérances, BR-DEC comptées sur le texte, listes de codes propres à l'UBL (types de facture et d'avoir, codes de date de TVA). Elles tournent sur une vue CII du document, ou directement sur l'UBL quand le contexte UBL ne se traduit pas en CII (BR-CL, BR-DEC, BR-09, BR-11, BR-17, BR-20, BR-52 à 57, BR-61 à 65, BR-CO-03, BR-CO-18). S'y ajoutent 759 règles de syntaxe (62 erreurs, 697 avertissements) : UBL-CR (678, éléments et attributs qu'EN 16931 n'utilise pas, en avertissement), UBL-SR (57, cardinalités), UBL-DT (24, types de données), générées du schematron officiel (
internal/rules/ubl/catalog_gen.go). Les constats sont situés dans l'UBL (chemin et ligne). -
Profils : BASIC et au-delà. Rien pour MINIMUM et BASIC WL, qui ne sont pas des factures EN 16931. Gravités ajustées comme chez les validateurs de référence :
- XRECHNUNG : celles de la configuration KoSIT 3.0.2 (CII-SR-452 à 454, 465 et 466 en erreur, BR-CL-21 et 23 en avertissement, CII-SR-475 et 476 en information) ;
- BASIC, EXTENDED, et EN 16931 dans un PDF Factur-X (
Hybrid) : celles du schematron Factur-X 1.09.2 du profil, leur référence, que Mustang applique aussi (PR #51). Ses listes de codes (assertions FX-SCH-A du jeuFacturX) remplacent les BR-CL du CEN, qui ne sont pas signalées. Pour BASIC et EN 16931, seules les règles de syntaxe CII qu'il reprend le sont : CII-SR-463 à 470, 472 et 473, plus 474 à 476 pour EN 16931, et CII-DT-097 (dates au format 102), gardée en plus comme dans le schematron EXTENDED. CII-DT-031 (currencyIDsur un autre montant que le total de TVA), que les schematrons Factur-X admettent, ne l'est donc plus. CII-SR-465 et 466 (contact avec un nom de personne et un service) passent en erreur, et CII-SR-464, dont le test ne peut pas échouer dans ces schematrons, n'est pas signalée ; - EXTENDED et EXTENDED-CTC-FR : seules les règles que garde le schematron EXTENDED conservent leur gravité, les autres règles métier passent en avertissement et les règles CII-SR qui restreignent CII au jeu EN 16931 ne sont pas signalées. Les listes de codes d'EXTENDED-CTC-FR restent celles du CEN, en avertissement.
Seule, une facture EN 16931 reçoit les règles CEN 1.3.17, comme dans le validateur KoSIT : son identifiant,
urn:cen.eu:en16931:2017, est celui de toute facture CII conforme à EN 16931 sans CIUS, et rien dans le XML ne dit qu'elle est destinée à un PDF Factur-X. Une facture EXTENDED-CTC-FR en CII reçoit les règles de syntaxe de son schematron, ci-dessus. Une facture ZUGFeRD 1.0 ne reçoit aucune règle EN 16931. -
Limites : les règles suivent le XPath du schematron plutôt que la prose de la norme, pour donner les mêmes verdicts. Les assertions qui ne peuvent jamais échouer dans les artefacts officiels ne sont pas implémentées (BR-CO-05 à 08, BR-IP-08 et 09, BR-IG-08 et 09, CII-SR-039 à 044, CII-DT-010 à 012) ; CII-SR-042 à 044 s'exécutent en revanche parmi les règles EXTENDED-CTC-FR, dont les contextes le permettent, et CII-DT-010 à 012 n'y sont pas exécutées, comme dans la XSLT de la FNFE. Le motif métier du schematron EXTENDED-CTC-FR (BR-FREXT…) n'est pas appliqué. La mise à jour des listes de codes du 15/11/2026 reste à suivre (#20).
-
Référence : schematrons Factur-X 1.09 MINIMUM et BASIC WL (
Factur-X_1.09_MINIMUM.sch,Factur-X_1.09_BASICWL.sch, FNFE-MPE / FeRD, 10/06/2026) ; schematrons Factur-X 1.09.2 de BASIC, EN 16931 et EXTENDED et leurs listes de codes (FACTUR-X_<profil>.sch,FACTUR-X_<profil>_codedb.xml, FeRD, ZUGFeRD 2.5.2), ceux que Mustang 2.26.0 embarque ; XSLT de validation EXTENDED de Factur-X 1.09.2 (FeRD, ZUGFeRD 2.5.2). -
Catalogue : 544 règles (523 erreurs, 21 avertissements) :
- identification du profil pour tous les profils : FX-PROFILE-01 à 03 et FX-SCH-A-000026. Une graphie obsolète de BT-24 (FX-PROFILE-03) est une erreur là où le schematron Factur-X s'applique, sa liste des BT-24 ne gardant que les identifiants actuels (FX-SCH-A-000493, 000556, 000636), et un avertissement pour une facture EN 16931 contrôlée selon les règles CEN ;
- BASIC, EN 16931 et EXTENDED : 315 assertions de listes de codes FX-SCH-A-* en erreur (48 pour BASIC, 58 pour EN 16931, 209 pour EXTENDED), générées depuis les schematrons et leurs fichiers codedb par
internal/rules/facturx/gen(codedb_gen.go), avec la sémantique du motif : seule la première règle dont le contexte correspond à un nœud s'y applique. Leurs listes, celles de la FNFE-MPE et de FeRD, remplacent les BR-CL du CEN et en diffèrent sur quelques codes : schéma d'adresse électronique 9958, motifs de remise ABK, ADZ et CAO, unités d'emballage (PackageQuantity) d'EXTENDED… (PR #51) ; - MINIMUM et BASIC WL : règles EN 16931 que ces schematrons reprennent (champs obligatoires, totaux BR-CO-11 à 16 calculés depuis les montants d'en-tête, ventilation et catégories de TVA, BR-DEC), assertions structurelles FX-SCH-A-*, et éléments « not used » signalés en avertissement (FX-NOT-USED) ;
- EXTENDED et EXTENDED-CTC-FR : 61 règles BR-FXEXT-* de l'XSLT 1.09.2, avec ses gravités (sous-types et regroupements de lignes, totaux avec tolérance, frais logistiques BG-X-42, frais pour compte de tiers BG-34, ventilation de TVA par catégorie, taux et motif d'exonération, attributs d'article, notes, immatriculations fiscales), plus BR-FXEXT-G-08, qui vient du schematron MINIMUM ;
- deux ajouts propres au package : FX-DATE (une date au format 102 est un vrai jour du calendrier) et FX-MIN-CO-15 (avertissement : BR-CO-15 appliquée à MINIMUM, que le schematron officiel ne contrôle pas).
-
Profils : le schematron Factur-X 1.09.2 s'applique d'office à BASIC et EXTENDED, qui n'existent qu'en Factur-X et ZUGFeRD, et à EN 16931 quand le XML est celui d'un PDF Factur-X (
Hybrid, que fixezerechnung.Check). Ses autres assertions sont les règles métier du CEN, qu'applique le jeuEN16931avec les gravités du schematron, ou des contraintes que le schéma du profil exprime déjà. EXTENDED-CTC-FR reçoit les règles BR-FXEXT, mais pas les listes de codes du schematron EXTENDED ; XRECHNUNG, PEPPOL et une facture EN 16931 seule ne reçoivent que l'identification du profil, leurs règles métier et leurs listes de codes étant celles d'EN 16931. Le jeu ne s'applique pas à l'UBL, ses règles étant propres au CII. -
Limites : les assertions de MINIMUM et BASIC WL qui demandent les listes ISO 3166, ISO 4217, ISO 6523, EAS, VATEX, UNTDID 4451 et 4461 ne sont pas implémentées (FX-SCH-A-000031, 000036, 000040, 000045, 000162, 000181, 000196 et une partie de 000023), ni celles que le schéma du profil impose déjà ou qui ne peuvent pas échouer (BR-CO-05, BR-CO-06, BR-AF-09, BR-AG-09, CII-SR-464, FX-SCH-A-000021). Le XML d'un PDF Factur-X EN 16931 extrait par un autre outil reçoit les règles CEN si l'appelant ne fixe pas
Hybrid. L'identifianturn:cen.eu:en16931:2026est lu comme EN 16931:2017 (#20).
- Référence : schematron « BR-FR-Flux2-Schematron-CII » 1.4.0.04 de la FNFE-MPE (dépôt fnfempe/France_RFE), bloquant au plus tard le 01/10/2026.
-
Catalogue : 59 règles (29 BR-FR, 10 BR-FR-CO, 4 BR-FR-DEC, 13 BR-FR-MV, 3 BR-FR-BD), déclinées en 170 assertions, toutes en erreur : SIREN et SIRET et leur cohérence, adresses électroniques en schéma 0225 et 0224, mentions obligatoires (notes PMT, PMD, AAB), cadres de facturation BT-23, taux de TVA, codes de pièces jointes, formats décimaux, factures multi-vendeurs et à double sens. S'y ajoutent les 3 contrôles des profils admis, qui ne viennent d'aucun schematron : FR-PROFILE-01 (MINIMUM, erreur), FR-PROFILE-02 (BASIC, avertissement), FR-PROFILE-03 (BASIC WL, erreur avec
RejectBasicWL). -
UBL : schematron
BR-FR-Flux2-Schematron-UBL1.4.0.04, vérifié sur le document UBL lui-même (PR #38) : 173 assertions. Le schematron en compte 175, mais BR-FR-16_BT-103 et BR-FR-DEC-01_BT-111 ne se déclenchent jamais, une règle antérieure de leur pattern captant le nœud. Identifiants scindés ou renommés par rapport au CII (BR-FR-01_BT-1-1 et -2, BR-FR-05_BT-22-1 à -3, BR-FR-06_BT-21-1 à -4, BR-FR-30_BT-21, BR-FR-32-ID…), dates BR-FR-03 sur BT-134 et BT-135, multi-vendeurs et autofacturation par les références de ligne. -
Profils : le schematron vise EN 16931 et EXTENDED-CTC-FR ; le package l'applique quel que soit le profil, l'appelant décidant quand les règles françaises s'appliquent (
France, ouAutopour un vendeur en France). Les assertions qui portent sur des éléments du seul jeu EXTENDED (variantes EXT-FR-FE-, BR-FR-MV-, BR-FR-BD-*) ne se déclenchent jamais sur une facture EN 16931. - Limites : le schematron compte 171 assertions. BR-FR-DEC-01_BT-111 n'est pas au catalogue : dans la référence, BR-FR-DEC-01_BT-110 a le même contexte et passe avant elle, si bien qu'elle ne se déclenche jamais ; le package fait de même. BR-FR-30 vise un chemin que le schéma CII ne définit pas et ne peut se déclencher que sur un document invalide au schéma ; elle est implémentée telle qu'écrite. L'obligation de l'option pour la TVA sur les débits (BT-8 = 5 en CII, 3 en UBL) ne se contrôle pas : la facture ne dit pas si le fournisseur a opté. Les règles UBL n'ont pas été confrontées à une exécution du schematron officiel : elles sont vérifiées par des tests de mutation à identifiants exacts.
-
Référence : schematron XRechnung 3.0.2 de KoSIT (
XRechnung-CII-validation.sch, motifs cii-pattern, cii-extension-pattern et cii-cvd-pattern, variables decommon.sch). -
Catalogue : 52 assertions (40 erreurs, 11 avertissements, 1 information) :
- 37 de la CIUS (BR-DE-, BR-DE-TMP-32, BR-TMP-), appliquées à toute facture ;
- 7 de l'extension (BR-DEX-*), appliquées quand BT-24 est l'identifiant de l'extension XRechnung ;
- 8 des données de véhicules utilitaires (BR-DE-CVD-*, BR-TMP-CVD-01), appliquées quand BT-24 est l'identifiant CVD.
GermanyProfileajoute DE-PROFILE-01 (erreur) : MINIMUM et BASIC WL, que le BMF n'accepte pas comme factures électroniques. -
UBL : schematron
XRechnung-UBL-validation.sch3.0.2, vérifié sur le document UBL (PR #38) : 57 assertions, 34 de la CIUS, 14 de l'extension, 8 CVD et PEPPOL-EN16931-R043. Règles dont le contexte ou le test diffère du CII : BR-DE-1 (cac:PaymentMeans), BR-DE-23-a à 25-a, BR-DE-30 et 31 (mandat SEPA), BR-TMP-2, BR-DE-16 ; propres à l'UBL : BR-TMP-6, BR-DEX-02, 03 et 09 à 14 ; sans équivalent UBL : BR-TMP-3, 4, 5, 7 et BR-DEX-15. -
Identifiants (PR #42) : le schematron exige BT-10 et admet les schémas 0204 et 0246 sans en contrôler la forme.
Germanyajoute quatre avertissements, aux identifiants propres au package. DE-LEITWEG-01 et DE-LEITWEG-02 portent sur BT-10 et sur BT-34 et BT-49 de schéma 0204 : format de la Formatspezifikation Leitweg-ID 2.0.2 (Grobadressierung de 2, 3, 5, 8, 9 ou 12 chiffres commençant par un code de Land 01 à 16 ou 99, Feinadressierung facultative de 1 à 30 lettres ou chiffres) et chiffres de contrôle MOD 97-10. DE-GEBA-01 et DE-GEBA-02 portent sur BT-34 et BT-49 de schéma 0246 : format de la GEBA Formatspezifikation 1.0.1 (W-IdNr, Unterscheidungsmerkmal et sous-adresse facultatifs) et chiffre de contrôle MOD 11,10 de la W-IdNr. Une valeur mal formée n'est pas soumise au contrôle de clé ; le message de clé donne la valeur attendue. -
Profils : BR-DE s'applique d'office aux factures XRECHNUNG ;
Autone l'applique pas à une facture ZUGFeRD, pour laquelle seul DE-PROFILE-01 est ajouté (vendeur en Allemagne). -
Limites : une facture XRECHNUNG B2B dont BT-10 porte une autre référence qu'une Leitweg-ID reçoit DE-LEITWEG-01, qu'elle peut ignorer ; les identifiants de partie et d'entité juridique (BT-29, BT-46, BT-47…) de schéma 0204 ou 0246 ne sont pas contrôlés. Les BR-DE sont confrontées à KoSIT en CI, sur les factures XRechnung CII et UBL du corpus et de la suite KoSIT : mêmes erreurs sur les 128 factures comparées (section 6). Le schematron est reproduit tel qu'écrit, y compris ses particularités (BR-DE-16 comparé à la chaîne entière, listes de codes étendues qui laissent passer un
schemeIDvide, BR-TMP-3 qui compare les quantités de base comme des chaînes). Les règles UBL n'ont pas été confrontées à une exécution du schematron officiel ; les factures UBL de la suite KoSIT les passent toutes. Le jeu n'écrit pas les règles Peppol que les schematrons XRechnung incorporent, sauf PEPPOL-EN16931-R043 en UBL : une facture UBL vérifiée avecGermanyetPeppolvoit R043 signalée par chacun.
-
Référence : schematrons Peppol BIS Billing 3.0
PEPPOL-EN16931-CII.schetPEPPOL-EN16931-UBL.sch, version 3.0.21, inchangés dans le correctif 3.0.22 (OpenPEPPOL/peppol-bis-invoice-3). Chaque facture reçoit le schematron de sa syntaxe. -
Catalogue : 166 identifiants (139 erreurs, 27 avertissements). En CII, 90 assertions (73 erreurs, 17 avertissements) :
- 25 règles PEPPOL-EN16931-R* : processus métier BT-23 et identifiant BT-24, référence acheteur ou de commande, adresses électroniques, notes, remises et charges, totaux de TVA dans la devise de comptabilité, périodes et montants de ligne, quantités de base ;
- 17 contrôles d'identifiants selon leur schéma ICD (PEPPOL-COMMON-R*) : GLN, identifiants norvégiens, danois, belges, italiens, suédois, australiens et néerlandais ;
- 41 règles nationales de Norvège (NO-R, 2), du Danemark (DK-R, 13), d'Italie (IT-R, 4), de Suède (SE-R, 13) et des Pays-Bas (NL-R, 9), appliquées selon le pays du vendeur, et de l'acheteur pour certaines ;
- 7 listes de codes et formats restreints (PEPPOL-EN16931-CL*, P0100, F001).
En UBL, 165 assertions (139 erreurs, 26 avertissements), vérifiées sur le document UBL et non sur sa vue CII (PR #39), dont 76 propres à l'UBL : pas d'élément vide (R008), une seule devise (R051), remises sur le prix (R044, R046), codes de type de facture et d'avoir (P0100, P0101, P0112), motifs d'exonération (P0104 à P0111), règles nationales grecques (GR-R, GR-S), islandaises (IS-R) et allemandes (DE-R).
-
Profils : appliqué d'office quand BT-24 est
urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0(profilinvoice.ProfilePeppol, contrôlé contre le XSD EN 16931), sinon seulement sur demande (validate.Peppol,zerechnung validate -peppol). Jamais parAuto: la plupart des factures Factur-X et ZUGFeRD valides n'ont ni BT-23 Peppol, ni adresse électronique, ni référence acheteur. -
Limites : chaque schematron est reproduit tel qu'écrit. En UBL, le pays du vendeur des règles norvégiennes, italiennes et grecques est le préfixe de son identifiant de TVA, son adresse seulement à défaut ; PEPPOL-EN16931-R080 ne porte que sur un avoir, DK-R-005 à 011 que sur une facture ; DK-R-003 y est une erreur, un avertissement en CII. Le schematron CII vise parfois l'UBL plus que le CII : l'identifiant de TVA est cherché avec le
schemeIDVATde l'UBL (en CII, c'est donc l'adresse du vendeur qui décide des règles norvégiennes et italiennes, et NO-R-001, SE-R-001, SE-R-002 ne voient pas un identifiantVA) ; PEPPOL-EN16931-P0100 viseram:ExchangedDocument, absent d'une facture CII ; DK-R-007 cherche le mandat de prélèvement sous le moyen de paiement.
- Référence : Regole tecniche de l'art. 3, alinéa 1, du d.lgs. 148/2018, version 2.7 (applicable au 11/01/2027 ; règles inchangées depuis la 2.5, à la référence légale de BR-IT-DE-004 près), appendice 2 (CIUS-IT) et appendice 3 (extensions EXT-IT de la facture domestique) ; aucun schematron officiel, les règles sont écrites d'après les tableaux, le texte italien prévalant.
-
Catalogue : 149 identifiants (141 erreurs, 8 avertissements) :
- 59 des 61 règles CIUS-IT de l'appendice 2 (BR-IT, BR-IT-DC) : longueurs et jeux de caractères, adresses et provinces, identifiants, moyens de paiement, catégories de TVA, split payment ; 3 en avertissement parce qu'elles ne décident que du mappage par le SDI (PR #76) ;
- les 45 règles des extensions de l'appendice 3 (BR-IT-DE-001 à 042, 050 à 052), en erreur : extensions UBL reconnues par leur URI
urn:fdc:agid.gov.it:fatturapa:…(documentation AgID) et éléments UBL hors EN 16931 de l'appendice 4.2 (retenues, établissement stable et tiers intermédiaire du vendeur, représentant fiscal, transporteur, expédition, documents de transport…) ; listes de codes du XSD FatturaPA 1.2.4 (PR #82) ; - 5 contrôles d'identifiants en avertissement : identifiant de spécification (IT-PROFILE-01), Partita IVA (IT-PIVA-01/02), Codice Fiscale (IT-CF-01/02) ;
- 40 contrôles du SDI sur le contenu d'un document FatturaPA, en erreur et sous leurs codes (00300 à 00476 de l'annexe 1 des spécifications techniques 1.9.1 et 1.10) : ceux qui ne demandent aucune donnée du SDI. Ils s'appliquent à toute FatturaPA, quel que soit le jeu choisi ; voir le schéma ci-dessus et le critère IT6 de la Grille de la norme (PR #86).
-
Profils : appliqué d'office quand BT-24 est un identifiant CIUS-IT, transfrontalier ou suivi de l'extension EXT-IT (profil
invoice.ProfileCIUSIT), sinon seulement sur demande (validate.Italy,zerechnung validate -it) ; jamais parAuto. Les règles BR-IT-DC et BR-IT-DE ne visent qu'un vendeur en Italie (BT-40). En UBL, les règles de l'appendice 2 tournent sur la vue CII du document, celles des extensions sur l'UBL lui-même ; BR-IT-DE-052 s'applique aussi au CII. -
Limites : BR-IT-DC-291 et BR-IT-DC-480 dépendent de faits absents de la facture. Les règles propres à la documentation AgID (BR-IT-DE-043 à 049…) ne sont pas vérifiées. L'appendice 3 contredit le schéma UBL 2.1 (plusieurs remises dans une seule
ext:ExtensionContent: XSD-COUNT) et l'appendice 4.2 (NAou0pour BR-IT-DE-040, la règle est suivie). Aucune parité n'est mesurable, faute d'artefact exécutable officiel.
- Référence : spécifications externes Chorus Pro, annexe EDI V4.23 (règles G1.05, G2.06, G2.07, G2.16 à G2.19, G2.29, G3.01, G3.03, G3.04, S2.04, S2.13), annexe des messages d'erreur V3.02, dossier Chorus Pro des spécifications externes DGFiP v3.1 (numéro de facture de 20 caractères au plus en B2G après la réforme).
-
Catalogue : 8 contrôles en erreur, CPRO-01 à CPRO-08 : SIRET de la structure publique (BT-46 en schéma 0009, ou BT-47 de 14 caractères en schéma 0002 ou sans schéma) avec clé de Luhn, code service BT-10 et numéro d'engagement BT-13 (ou référence du marché BT-12) selon
PublicBuyer, longueurs et caractères admis, type 751 refusé, numéro de facture. Chaque message donne le code de rejet Chorus Pro qu'il anticipe. - Profils : tous ; jamais appliqué d'office, rien dans le XML ne disant que l'acheteur est public. En UBL, les contrôles tournent sur une vue CII du document ; leurs constats sont situés dans l'UBL.
- Limites : aucun schematron officiel ne couvre ces contrôles. Ce que Chorus Pro vérifie dans son annuaire (existence du SIRET et du code service, structure active) ne se contrôle pas hors ligne.
-
Référence : spécification Factur-X 1.08 et 1.09 (nom de fichier, XMP
fx, § 5.3 et § 6.2.2 pour l'/AFRelationship), ISO 19005-2 (PDF/A-2), ISO 19005-3 (PDF/A-3) et ISO 19005-4 (PDF/A-4) ; profils de validation veraPDF de PDF/A-2b et PDF/A-3b pour la numérotation des clauses. -
Catalogue : 72 contrôles (57 erreurs, 15 avertissements) :
- identification PDF/A : PDF/A-3 (A, B, U) ou PDF/A-4 (F, E) déclaré (PDF-04, PDF-05),
pdfaid:rev(PDF-29), version PDF cohérente avec la partie déclarée (PDF-30) ; - pièce jointe de la facture : présente et lisible (PDF-09), nom de fichier (PDF-10, PDF-11), unique (PDF-28),
/AFRelationshipprésente et admise (PDF-12, PDF-13), dans le/AFdu catalogue (PDF-15), type MIME,/ModDate,/Fet/UF(PDF-16 à PDF-20) ; -
/AFRelationshipselon le profil et le pays : PDF-14 (avertissement :Datapour MINIMUM et BASIC WL,AlternativeouSourceau-delà,Dataadmis aussi quand les règles françaises s'appliquent) et PDF-40 (erreur :Alternativeseule quand les règles allemandes s'appliquent) ; - XMP : présent et lisible (PDF-02, PDF-03), schéma Factur-X, ZUGFeRD 2.0 ou 1.0, type de document, nom de fichier et niveau de conformité cohérents avec le XML (PDF-21 à PDF-24, PDF-26, PDF-27), schéma d'extension PDF/A (PDF-25) ;
- prérequis PDF/A vérifiables sans rendu : chiffrement (PDF-01), output intent et profil ICC (PDF-06, PDF-07),
/ID(PDF-08), polices incorporées (PDF-31, avertissement), JavaScript, actions interdites et/AA(PDF-32 à PDF-34), cohérence entre/Infoet le XMP (PDF-35, avertissement),/Infod'un document PDF/A-4 absent ou réduit à ModDate (PDF-70), autres pièces jointes avec/AFRelationship, type MIME et présence dans un/AF(PDF-36, PDF-37, PDF-39), filtres LZW, Crypt autre qu'Identity et non standard (PDF-38) ; - exigences de PDF/A-2 et PDF/A-3 vérifiées sans rendu (PDF-41 à PDF-69, PDF-71 et PDF-72), clause par clause d'ISO 19005-2 et 19005-3, non appliquées à un document PDF/A-4 : syntaxe du fichier (en-tête PDF-41, fin de fichier PDF-42, tables xref PDF-43, chaînes hexadécimales PDF-44, flux PDF-45, noms en UTF-8 PDF-46, objets PDF-47, permissions PDF-48, limites d'implémentation PDF-49), output intents et leur profil ICC (PDF-50), espaces de couleur (profils ICC PDF-51 ; espaces device PDF-52 et espaces Separation et DeviceN PDF-53, avertissements), états graphiques (PDF-54, PDF-55, PDF-58), images (PDF-56), XObjects (PDF-57), polices (dictionnaires PDF-59 et encodages TrueType PDF-60, noms de glyphes des
Differencesdans l'Adobe Glyph List compris, avertissements), annotations (PDF-61 à PDF-63), formulaires (PDF-64), XMP (paquets PDF-65, propriétés des schémas prédéfinis et leurs types de valeur PDF-66, schémas d'extension PDF-67), contenu optionnel (PDF-68), présentations et/Requirements(PDF-69) ; - contenu des pages, avec les formulaires, motifs, masques, glyphes Type 3 et apparences d'annotation qu'il utilise : opérateurs et ressources (PDF-71), chaînes hexadécimales (PDF-44), imbrication de
qet limites des nombres et des chaînes (PDF-49), images en ligne (PDF-55, PDF-56), espaces de couleur posés par les opérateurs (PDF-52), surimpression (PDF-51), opérateurri(PDF-55), transparence (PDF-58) ; en-tête JP2 des images JPEG 2000 (PDF-56), CID des CMap embarquées (PDF-49),/IDdu trailer le plus récent d'un fichier linéarisé ou mis à jour (PDF-08) ; - glyphes que montre le texte, lus dans les programmes de police TrueType, CFF et OpenType et dans les glyphes Type 3, les codes étant associés aux glyphes comme veraPDF le fait : glyphe présent dans le programme, de la largeur du dictionnaire à une unité près, autre que
.notdef;CharSetd'une police Type 1 sous-ensemble etCIDSetd'une CIDFont listant exactement les glyphes du programme (PDF-72).
- identification PDF/A : PDF/A-3 (A, B, U) ou PDF/A-4 (F, E) déclaré (PDF-04, PDF-05),
-
Limites : ce n'est pas un validateur PDF/A complet comme veraPDF : les programmes de police Type 1, les glyphes des polices Type 0 à CMap prédéfinie autre qu'Identity, les glyphes et largeurs du texte invisible (mode de rendu 3, que veraPDF ne contrôle pas non plus) et les types de valeur des schémas d'extension XMP ne sont pas vérifiés. Les niveaux A et U (structure logique, correspondance Unicode) sont hors périmètre : Factur-X et ZUGFeRD n'exigent que B, et un PDF qui déclare A ou U est contrôlé comme B. Sur le corpus veraPDF, 5 des 614 fichiers invalides PDF/A-2b et PDF/A-3b ne sont pas signalés : un type de valeur XMP, et 4 fichiers d'identification PDF/A-2 que PDF-04 signale déjà, comme tout le corpus ; aucun fichier valide ne lève d'erreur PDF/A. Une police non incorporée n'est qu'un avertissement (PDF-31), faute de savoir si elle affiche du texte visible ; PDF-35 n'est pas appliqué à PDF/A-4, et les exigences de PDF/A-2 et PDF/A-3 ne lui sont appliquées qu'en partie ; PDF-39 ne trouve pas les associations faites dans le contenu des pages. L'analyse du contenu et des polices est toujours active : elle ajoute environ 0,2 ms au contrôle d'une facture de 149 Ko. Un PDF chiffré est signalé (PDF-01), pas déchiffré.
CheckContainer, qui ne reçoit pas d'options, n'applique PDF-40 qu'à XRECHNUNG ;Checkl'applique aussi avecGermany,GermanyProfileouAutopour un vendeur en Allemagne. Un hôte non PDF/A est refusé à l'écriture sur option (EmbedOptions.RequirePDFA, PR #61), ou converti en PDF/A-3 (EmbedOptions.ConvertPDFA, PR #68, ci-dessous).
| Sujet | État dans main
|
Issue |
|---|---|---|
Contenu des extensions UBL (ext:ExtensionContent) |
Espace de noms et nombre des éléments vérifiés, contenu non (xmldsig, XAdES non compilés), sauf celui des extensions italiennes EXT-IT, que vérifient les règles BR-IT-DE du jeu Italy pour un vendeur en Italie |
— |
XML ZUGFeRD 1.0 (CrossIndustryDocument) |
Lu et réécrit en Factur-X (PR #41), pas écrit en ZUGFeRD 1.0 ; ni XSD ZUGFeRD 1.0, ni règles métier : contrôle structurel minimal (ZF1-01 à ZF1-04) | #13 (fermée) |
| Motif métier du schematron EXTENDED-CTC-FR (BR-FREXT…) | Non appliqué : une facture EXTENDED-CTC-FR reçoit les règles métier de la XSLT Factur-X EXTENDED. En UBL, elle reçoit les règles UBL du CEN, pas celles du schematron UBL EXTENDED-CTC-FR | — |
| Conformité PDF/A complète | Exigences de PDF/A-2 et PDF/A-3 de niveau B vérifiées sans rendu, contenu des pages et programmes de police compris (PDF-41 à PDF-69, PDF-71 et PDF-72, PR #63 et PR #73) ; non vérifiés : programmes de police Type 1, types de valeur des schémas d'extension XMP, niveaux A et U (hors périmètre), une partie des exigences de PDF/A-4. La conversion en PDF/A-3 (ConvertPDFA) est partielle : ce qui demande un moteur PDF (police à incorporer, DeviceCMYK sans profil, annotation sans apparence…) est refusé |
#8 (fermée), #62 (fermée), #65 (fermée) |
| Règles BR-FR du schematron UBL | Vérifiées par des tests de mutation, pas confrontées à une exécution du schematron officiel. Les BR-DE le sont, à KoSIT, par le job de parité (section 6) | — |
| EN 16931:2026, prochaine version Factur-X, listes de codes du 15/11/2026 | Suivi, rien à implémenter tant que les textes ne sont pas publiés ou intégrés | #20 |
| Contrôles du SDI qui interrogent ses données | Doublons de fichier et de facture (00002, 00404), codes destinataires (00311, 00312), cohérence avec l'Anagrafe tributaria et groupes TVA (00320 à 00327), déclarations d'intention (00477) : hors ligne ; les autres contrôles du contenu sont faits (PR #86) | — |
| Annuaire Chorus Pro, plateformes agréées, cycle de vie CDAR, e-reporting | Hors ligne ou hors périmètre | — |
Les règles sont réécrites, pas interprétées : une nouvelle version d'un artefact officiel demande une mise à jour du code. Les catalogues EN 16931 du CII et de l'UBL, celui des règles de syntaxe d'EXTENDED-CTC-FR, les assertions de listes de codes des schematrons Factur-X 1.09.2, les listes de codes et les tables de schéma (XSD Factur-X et UBL 2.1) sont régénérés par go generate ; les autres règles Factur-X, les règles BR-FR, BR-DE et Peppol sont écrites à la main, et les tests vérifient l'alignement.
La prise en charge de l'UBL 2.1 (#11) est fusionnée dans main depuis le 17/11/2026, en quatre PR :
| PR | Apport |
|---|---|
| #34 | Paquet ubl : lecture (ubl.Parse) et écriture (ubl.Marshal) des factures et avoirs dans le même modèle que le CII ; validation EN 16931 selon les artefacts UBL (règles métier, listes de codes, UBL-CR, UBL-SR, UBL-DT) ; détection de la syntaxe dans validate et la CLI |
| #36 | Schéma XSD OASIS UBL 2.1 d'Invoice et CreditNote, dans le jeu Schema
|
| #38 | Schematrons BR-FR et XRechnung UBL, vérifiés sur le document UBL |
| #39 | Schematron Peppol BIS Billing 3.0 UBL, vérifié sur le document UBL |
Seuls les contrôles Chorus Pro passent encore par une vue CII du document UBL.
go test ./... n'a besoin que du dépôt. La CI l'exécute avec -race sur Go 1.24 et sur la dernière version, après gofmt et go vet, et fait tourner 30 secondes de fuzzing sur le lecteur PDF, le codec Flate, le lecteur XML et la lecture de BT-24. Les artefacts officiels ne sont pas dans le dépôt : les tests qui s'en servent s'activent par des variables d'environnement. Depuis la PR #44, le workflow Conformité les récupère à des versions figées (commit pour les dépôts, SHA-256 pour les fichiers) avec conformance/fetch.sh, à chaque push sur main et à chaque pull request, et lance go test ./... avec les 10 variables : le job échoue si un seul test est ignoré. Un deuxième job compare ZeRechnung à KoSIT et Mustang (ci-dessous), un troisième fait vérifier par veraPDF les PDF que convertit ConvertPDFA (ci-dessous).
| Variable | Contenu | Tests | Ce qu'ils garantissent |
|---|---|---|---|
FX_CORPUS |
Clone complet de ZUGFeRD/corpus |
TestCorpus, TestCheckContainerCorpus (racine) |
Chaque PDF du corpus s'ouvre et son XML de facture s'extrait, sauf ceux du dossier unstructured (PDF sans pièce jointe), qui doivent être signalés sans facture (ErrNoInvoice, PDF-09). Les constats du conteneur sont journalisés par règle, pas vérifiés |
TestCorpusParity (EN 16931) |
Les 26 XML CII valides de XML-Rechnung/CII n'ont que les erreurs que signale le validateur de référence : BR-CL-25 sur 2 fichiers (schéma d'adresse 9958 absent de la liste EAS 1.3.17), CII-SR-465 sur les 4 XRECHNUNG (gravité de la configuration KoSIT) |
||
TestCorpus (schéma) |
Chaque XML CII du corpus est valide contre le XSD 1.09.2 de son profil, sauf 7 exemples ZUGFeRD 2.0 et 2.1 plus anciens que les schémas actuels, listés avec leur raison. Le schéma d'une facture XRECHNUNG est le XSD CII D16B : l'échantillon fail XRechnung 722825203 y est valide, comme chez KoSIT, et échoue sur BR-DE-18 |
||
TestCorpus (Factur-X) |
Aucune erreur des règles de profil, sauf huit exceptions connues, chacune avec sa raison : Facture_UE_BASICWL.xml (exemple FNFE de 2017 sans date de livraison : BR-IC-11 et BR-IC-12), Avoir_FR_type381_BASIC.xml (BT-24 d'un brouillon de Factur-X 1.0 : FX-PROFILE-03) et six exemples EXTENDED de ZUGFeRD 2.0 et 2.1 dont des codes sortent des listes du schematron EXTENDED 1.09.2, que Mustang refuse aussi (schéma d'adresse 9958, motifs de remise ABK, ADZ et CAO, unités d'emballage) |
||
TestCorpus (BR-DE) |
Les factures du corpus qui se déclarent XRechnung 3.0 (BT-24) n'ont aucune erreur BR-DE, sauf l'échantillon fail, qui doit donner exactement BR-DE-18 ; toute règle signalée est au catalogue |
||
TestCorpus (BR-FR) |
Pas de panique, toute règle signalée est au catalogue. Pas de verdict attendu : les exemples du corpus ne sont pas des factures de la réforme française | ||
TestCorpusRoundTrip (cii) |
Tout XML CII se lit, ZUGFeRD 1.0 compris (vue CII D16B) ; la réécriture dans le profil puis la relecture redonnent le même modèle, une deuxième écriture est identique à la première ; sans perte signalée, l'arbre complet du document d'origine se retrouve dans le XML réécrit, dans son profil et en EXTENDED. Avec FX_XSD, chaque XML écrit est vérifié contre les XSD d'origine ; seule est admise l'absence de ventilation de TVA (BG-23) quand la source n'en a pas, ce qui arrive sur 4 factures ZUGFeRD 1.0 : Marshal n'invente pas ce groupe |
||
TestOfficialNegativeCases (racine) |
Les 24 factures de ZUGFeRDv2/fail et les 2 exemples not_validating de XML-Rechnung lèvent les règles que lèvent KoSIT et Mustang. Le CIDSet incomplet que Mustang relève avec veraPDF sur ZUGFeRD_2_fully_compliant_complete.pdf lève PDF-72 depuis la PR #73. Sept n'ont pas d'erreur, chacune avec sa raison : les cinq exemples FNFE-MPE que le corpus a déplacés sans dire ce qui est faux, où Mustang ne trouve pas d'erreur non plus, un prix net incohérent qu'aucune règle EN 16931 ne vérifie, un exemple où aucune référence ne trouve d'erreur. Une facture ajoutée au dossier fail doit y être décrite |
||
TestDifferentialFiles, FuzzParse (internal/xmltree) |
Le lecteur XML accepte les mêmes documents qu'encoding/xml et donne le même arbre. Avec le corpus, ce paquet prend environ 8 minutes |
||
FX_CORPUS_XML |
XML extraits des PDF valides du corpus : ZUGFeRDv1/correct, ZUGFeRDv2/correct et XML-Rechnung/FX (125 fichiers), à la même place relative, avec l'extension .xml
|
TestCorpusXML (EN 16931), et les tests ci-dessus qui lisent aussi ce dossier |
Les 104 XML CII extraits n'ont que les erreurs attendues (BR-CL-25 sur 6 fichiers, CII-SR-465 sur 7, BR-CL-11 sur 1), toutes signalées aussi par l'XSLT CEN 1.3.17. TestCorpus (racine) compare chaque XML extrait au fichier de même nom dans ce dossier, octet pour octet aux fins de ligne près : la comparaison ne vaut référence que si le dossier a été produit par un autre outil |
TestCorpus (ubl), TestUBLCorpus (schéma), TestFiles (EN 16931 UBL) |
Les 28 factures UBL de XML-Rechnung/UBL sont lues, réécrites et relues dans le même modèle, valides contre le XSD UBL 2.1, et validées sans autre erreur que celles attendues |
||
FX_KOSIT |
Clone de itplr-kosit/xrechnung-testsuite |
TestKoSIT (BR-DE) |
Toutes les factures CII et UBL de la suite de tests KoSIT passent les règles BR-DE sans erreur |
TestKoSITCII (schéma) |
Les 41 factures CII de la suite sont des XRECHNUNG valides contre le XSD CII D16B | ||
TestCorpus (ubl), TestUBLCorpus (schéma), TestFiles (EN 16931 UBL) |
Les 45 factures UBL de la suite sont lues, réécrites, valides contre le XSD UBL 2.1 et validées sans erreur | ||
FX_PEPPOL |
Clone de OpenPEPPOL/peppol-bis-invoice-3, 3.0.21 ou suivante |
TestOfficial, TestOfficialUBL (Peppol) |
Les tests unitaires officiels CII (rules/unit-CII-*) et UBL (rules/unit-UBL-*) donnent le résultat attendu par leur schematron ; les assertions qu'ils ne font jamais échouer (PEPPOL-COMMON-R040, R041, R056-2 en CII ; PEPPOL-EN16931-R008, PEPPOL-COMMON-R041, R056-2, IS-R-001 à 010 en UBL) le sont par les tests du package |
TestPeppolExamples (validate) |
Les exemples officiels (rules/examples, rules/snippets) passent la validation par défaut sans erreur |
||
FX_XSD |
XSD Factur-X 1.09.2, un dossier par profil | cii |
Le XML écrit par cii.Marshal est valide contre les XSD d'origine |
FX_XSD_DIR |
Paquets XSD FeRD ZUGFeRD 2.5.2 et FNFE-MPE 1.09 | internal/schema/gen |
Les tables de schéma régénérées sont identiques à celles du dépôt |
FX_UBL_ZIP |
Paquet OASIS UBL-2.1.zip |
TestUpToDateUBL (internal/schema/gen) |
Les tables du schéma UBL régénérées sont identiques à celles du dépôt |
FX_KOSIT_CONF |
Archive de la configuration du validateur KoSIT XRechnung 3.0.2 (release 2026-08-31) |
TestUpToDateCII (internal/schema/gen) |
Les tables du XSD CII D16B régénérées sont identiques à celles du dépôt |
FX_FNFE |
Clone de fnfempe/France_RFE, tag v1.4.0.04 |
TestFNFE (schéma, EN 16931), TestUpToDateCII (internal/schema/gen), TestCTCFRUpToDate (internal/rules/en16931/gen) |
Les 28 exemples CII et Factur-X (Z.example/TEST) sont valides contre le XSD de leur profil et contre le XSD CII D22B ; les tables du D22B, compilées pour les tests, sont identiques à celles du dépôt. Contrôlés comme des factures EXTENDED-CTC-FR, ces exemples n'enfreignent aucune règle de syntaxe du schematron EXTENDED-CTC-FR, comme avec la XSLT de la FNFE ; le catalogue régénéré depuis le schematron est identique à ctcfr_gen.go
|
FX_FACTURX_SCH |
Schematrons Factur-X 1.09.2 de BASIC, EN 16931 et EXTENDED et leurs listes de codes (FACTUR-X_<profil>.sch, FACTUR-X_<profil>_codedb.xml), ceux que Mustang 2.26.0 embarque, copiés de LandrixSoftware/validator-configuration-zugferd au commit 8399f54 ; SHA-256 de chacun des 6 fichiers, vérifié sur le texte en LF |
TestUpToDate (internal/rules/facturx/gen) |
Les 315 assertions de listes de codes régénérées depuis les schematrons sont identiques à codedb_gen.go
|
FX_VERAPDF |
Dossiers PDF_A-2b et PDF_A-3b de veraPDF/veraPDF-corpus (CC BY 4.0), commit bb75f4f
|
TestVeraPDFCorpus (racine) |
Les fichiers valides ne lèvent aucune erreur PDF/A (6-1-5-t01-pass-a lève PDF-35 en avertissement, contrôle que veraPDF ne fait pas pour PDF/A-2 et PDF/A-3) ; chaque fichier invalide lève une règle de sa clause (609 sur 614), sauf les 5 listés avec leur raison. Un fichier qui change de verdict fait échouer le test |
TestConvertCorpus (racine) |
Chaque fichier valide se convertit en PDF/A-3, sauf 6-1-12-t02-pass-a (document signé) ; un fichier invalide se convertit ou est refusé (ErrNotConvertible) ; un fichier converti repasse les règles PDF/A du package et se convertit de nouveau. Avec FX_PDFA_OUT et FX_PDFA_REPORT, le rapport de veraPDF sur les fichiers convertis est vérifié : tous passent, sauf l'échec connu, listé avec sa raison |
Le dossier FX_CORPUS_XML ne doit pas contenir les XML extraits des PDF des dossiers fail : ils sont faits pour échouer, et les tests qui lisent ce dossier attendent des factures valides.
Depuis la PR #44, ces tests tournent en CI à chaque push : le dernier run du workflow Conformité fait foi. Le tableau garde les mesures détaillées du 17/11/2026, mesurées sur main (e569630) pour le CII, et sur a4f328a pour l'UBL, avec ZUGFeRD/corpus au commit 84f8d8f (10/11/2026, clone complet), la suite KoSIT publiée le 31/08/2026 et le dépôt Peppol en 3.0.22. Tous les tests passent, et le run Conformité de a580779 (v0.1.0) aussi.
| Test | Résultat |
|---|---|
| Extraction (racine) | 151 PDF : 150 extraits, 1 PDF unstructured signalé sans facture ; 125 XML identiques à ceux de FX_CORPUS_XML (produit ici avec zerechnung extract : la comparaison vérifie la stabilité de l'extraction, pas une référence externe) |
| Conteneur (racine) | 151 PDF lus, une pièce jointe dans les 150 attendus. Constats les plus fréquents, journalisés : PDF-06 (65 fichiers), PDF-35 (61), PDF-11 (59), PDF-14 (40), PDF-40 (7) |
| Parité EN 16931 | 26/26 XML CII avec exactement les erreurs de la référence |
| EN 16931 sur les XML extraits | 104 XML CII, aucune erreur inattendue |
| Schéma | 147 XML CII : 140 valides contre le XSD de leur profil (D16B pour les 15 XRECHNUNG, échantillon fail compris), 7 exceptions connues (mesuré sur 6f892aa) |
| Schéma D16B et D22B | 41/41 factures CII KoSIT valides contre le D16B ; 28/28 exemples FNFE valides contre le XSD de leur profil et le D22B ; 9 000 variantes aléatoires (KoSIT contre le D16B, EXTENDED contre le D22B et contre le XSD EXTENDED) au même verdict que xmllint ; EN 16931 inclus dans le D16B au nombre de BG-3 près, EXTENDED inclus dans le D22B |
| Factur-X | 147 XML CII : aucune erreur, hors les exceptions connues (une sur e569630 ; huit depuis a580779, qui applique les listes de codes Factur-X 1.09.2, vérifiées par le run Conformité) |
| BR-DE, corpus | 147 XML CII, dont 6 qui se déclarent XRechnung 3.0 : aucune erreur, hors l'échantillon fail (BR-DE-18) |
| BR-DE, suite KoSIT | 41 factures CII et 45 UBL, aucune erreur ; seulement l'information BR-DE-TMP-32 sur les mêmes cas en CII et en UBL |
| Leitweg-ID, suite KoSIT | Mesuré sur 3905159 (PR #42) avec zerechnung validate : 44 avertissements DE-LEITWEG sur les 86 factures, tous sur des valeurs de test hors spécification. Code de Land 90 (90000000-03083-72, 36 factures), Grobadressierung de 10 chiffres (2), texte Leitweg-ID (1), clés fausses (5). Aucun DE-GEBA |
| BR-DE, corpus (UBL) | 31 fichiers UBL lus avec les 43 CII : aucune erreur BR-DE sur ceux qui se déclarent XRechnung, hors l'échantillon fail CII |
| BR-FR, corpus (UBL) | 31 fichiers UBL : pas de panique, toute règle signalée au catalogue UBL |
| Peppol | CII : 87 jeux, 351 tests ; UBL : 153 jeux, 678 tests, 687 assertions ; résultat attendu sur tous. 26 exemples officiels valides |
| UBL (lecture, schéma, EN 16931) | 73 factures (28 du corpus, 45 de la suite KoSIT) lues, réécrites et relues dans le même modèle, toutes valides contre le XSD UBL 2.1 ; seules erreurs EN 16931, celles attendues : BR-CL-25 sur les deux exemples au schéma 9958 (comme en CII), et l'exemple not_validating…, invalide à dessein |
Aller-retour cii
|
Mesuré sur d63e792 : 169 XML lus, dont 22 ZUGFeRD 1.0 ; 139 réécrits avec tout leur arbre dans leur profil, 153 en EXTENDED. Les autres ont une valeur illisible (1) ou des données que leur profil (29) ou aucun profil Factur-X (15) n'admet, ce que Marshal signale. Avec les XSD, une seule erreur admise : la ventilation de TVA absente de 4 factures ZUGFeRD 1.0 |
Le deuxième job du workflow Conformité exécute KoSIT validator 1.6.3 (configuration XRechnung 3.0.2 du 2026-08-31) et Mustang 2.26.0 sur 282 factures du corpus et de la suite KoSIT, puis compare facture par facture les règles levées en erreur. Java ne sert que dans la CI : la librairie reste en pur Go. La comparaison applique les niveaux (customLevel) des scénarios KoSIT, et rapproche les assertions « liste de codes » du schematron Factur-X d'EN 16931, que Mustang applique à un XML EN 16931 seul, de la règle BR-CL du CEN qui porte sur le même élément, et celles sur BT-24 de FX-PROFILE. Un écart absent de conformance/parity/known.txt fait échouer le job. La méthode complète est dans conformance/README.md.
| Référence | Factures comparées | Mêmes erreurs | Écarts justifiés |
|---|---|---|---|
| KoSIT validator 1.6.3, configuration du 2026-08-31 | 128 | 128 | 0 |
| Mustang 2.26.0 | 282 | 241 | 41 |
Les écarts avec Mustang viennent des références elles-mêmes :
- Mustang n'applique pas Peppol BIS 3.0 aux factures UBL Peppol du corpus ;
- il n'applique pas la configuration KoSIT aux factures XRechnung : ni ses niveaux (CII-SR-465 en erreur, information pour certaines règles des scénarios Extension et CVD), ni le XSD CII D16B ;
- il embarque le schematron XRechnung 2.4.0, quand KoSIT et le package appliquent la 2.6.0 (
cbc:IDvide admis souscac:OrderReference).
Depuis la PR #51, le package applique les schematrons Factur-X 1.09.2 comme Mustang à BASIC, à EXTENDED et à EN 16931 dans un PDF Factur-X : mêmes erreurs sur toutes ces factures du corpus, et known.txt perd les sept justifications qui venaient de ces schematrons (223 factures aux mêmes erreurs et 59 écarts avant). À un XML EN 16931 seul, il applique les règles CEN 1.3.17 comme KoSIT, là où Mustang garde le schematron Factur-X ; sur le corpus, les deux constats se rapprochent (FX-SCH-A-000571 et BR-CL-25 sur les deux exemples au schéma 9958), sans écart.
Les CII-SR-475 et 476 que lèvent KoSIT et Mustang sur les factures à plusieurs documents 916 viennent d'un contexte erroné de CEN 1.3.16 (eInvoicing-EN16931#508), corrigé en 1.3.17, la version que suit le package. Ce sont des avertissements : elles sortent de la comparaison des erreurs.
Le rapport du job donne aussi, pour chaque facture invalide du corpus, les erreurs levées par le package et par chaque référence ; TestOfficialNegativeCases fige ces verdicts. La suite de tests KoSIT ne contient que des factures valides.
Depuis la PR #68, le troisième job du workflow Conformité convertit avec ConvertPDFA les fichiers PDF/A-2b et PDF/A-3b du corpus veraPDF, valides et invalides, ainsi que les PDF non conformes que génèrent les tests de convert_test.go (actions, JavaScript, LZW, états graphiques, annotations, ressources héritées, pièces jointes incomplètes, XMP refusé…), puis fait valider les fichiers convertis par veraPDF 1.30.3, lancé depuis son image Docker figée par empreinte. La conversion reste en pur Go : veraPDF ne sert que dans la CI. Un fichier converti que veraPDF rejette sans figurer dans la liste des échecs connus de convert_corpus_test.go fait échouer le job, comme un échec connu qui passe.
| Fichiers | Convertis | Refusés | Acceptés par veraPDF | Échecs connus |
|---|---|---|---|---|
| Corpus veraPDF PDF/A-2b et PDF/A-3b (998) | 836 | 162 | 835 | 1 |
| PDF non conformes générés par les tests | 10 | — | 10 | 0 |
Le seul fichier valide refusé est un document signé : le réécrire casserait sa signature. Depuis la PR #73, la conversion refuse aussi les 23 fichiers que veraPDF rejetait encore, pour leurs glyphes, largeurs et tables de police (16 fichiers), leurs valeurs CID au-delà de 65535 (2) ou leurs données JPEG 2000 (5) : le contrôle du package les voit désormais. Le seul échec connu relève de ce que la conversion ne lit pas : un type de valeur d'un schéma d'extension XMP sans pdfaType:field. Mesuré au commit 3ab8263.
conformance/fetch.sh récupère les artefacts aux versions de la CI et affiche les variables à exporter. Il demande git, curl et pdfdetach (poppler-utils) :
eval "$(conformance/fetch.sh)" && go test -count=1 ./...La comparaison avec KoSIT et Mustang (conformance/parity.sh) demande en plus Java 17 ou plus récent et unzip ; la vérification des conversions par veraPDF (conformance/verapdf.sh), git, Go et Docker.
Ces identifiants ne viennent d'aucun artefact officiel ; les autres reprennent ceux des schematrons, avec leurs messages.
| Identifiants | Jeu | Rôle |
|---|---|---|
| XSD-* | Schema |
Contrôles du schéma compilé (Factur-X et UBL 2.1) |
| ZF1-01 à 04 |
Schema (ZF1-04 quels que soient les jeux) |
Contrôle structurel minimal d'une facture ZUGFeRD 1.0 |
| FX-PROFILE-01 à 03, FX-DATE, FX-MIN-CO-15, FX-NOT-USED | FacturX |
Identification du profil, dates réelles, BR-CO-15 en MINIMUM, éléments « not used » |
| FR-PROFILE-01 à 03 | France |
Profils admis par la réforme |
| DE-PROFILE-01 | GermanyProfile |
Profils acceptés par le BMF |
| DE-LEITWEG-01, 02, DE-GEBA-01, 02 | Germany |
Format et clé de la Leitweg-ID et de la GEBA |
| CPRO-01 à 08 | ChorusPro |
Rejets Chorus Pro anticipés |
| PDF-01 à PDF-72 | conteneur | Contrôles du PDF hybride |
ZeRechnung
Guides
- Creating invoices
- Reading invoices
- Validating invoices
- Coverage and accuracy
- Testing
- License and provenance
By country
- Facturer en France
- E-Rechnungen in Deutschland
- E-facturen in Nederland
- Fatturazione elettronica in Italia
- Facturación electrónica en España
- Guides par pays
En français