Détection des profils Factur-X / ZUGFeRD
Une facture Factur-X ou ZUGFeRD est un PDF contenant une facture CII (UN/CEFACT) lisible par machine intégrée à l'intérieur. FactureCheck extrait ce XML intégré et le valide exactement comme un fichier CII autonome — mêmes règles schématron, mêmes constats — puis indique lequel des cinq profils Factur-X le document déclare.
Les cinq profils
Le profil est lu depuis l'identifiant de spécification du document CII
intégré (GuidelineSpecifiedDocumentContextParameter/ID) et
renvoyé dans metadata.facturx_profile de la réponse de
validation :
- Minimum — quelques champs essentiels, sans lignes de facture.
- Basic WL — Basic sans le détail des lignes.
- Basic — lignes complètes, contenu simplifié.
- EN16931 — le modèle sémantique complet EN 16931.
- Extended — EN16931 plus des champs supplémentaires entre partenaires commerciaux.
Un identifiant qui ne correspond à aucun des cinq est signalé comme
unknown plutôt que deviné.
Contrôles PDF/A-3 et pièce jointe
Cinq codes de la taxonomie couvrent le conteneur PDF lui-même, pas seulement le XML intégré :
- FCX-01 — la conformité PDF/A-3 est déclarée dans les métadonnées XMP.
- FCX-02 — l'entrée
/AFRelationshipdu fichier intégré est présente. - FCX-03 — la pièce jointe se nomme
factur-x.xml(pas un ancien nom ZUGFeRD). - FCX-04 — le niveau de conformité XMP correspond au profil déclaré dans le XML CII.
- FCX-05 — l'identifiant de spécification correspond à l'un des cinq profils connus.
Essayer
curl -X POST https://facturecheck.eu/api/v1/validate \
-H "Content-Type: application/pdf" \
--data-binary @facture.pdfLa réponse a la même forme JSON qu'un envoi XML, avec
metadata.facturx_profile renseigné. La réparation (voir ce qui est corrigé)
agit sur le XML extrait de la même façon que pour un envoi CII simple ; elle
ne réécrit pas le conteneur PDF lui-même.