Erreur profil Factur-X : URN officiel MINIMUM, BASIC WL, BASIC, EN16931, EXTENDED

En bref

• Le profil Factur-X est déclaré via GuidelineSpecifiedDocumentContextParameter/ID à la racine du document.
• 5 profils standards Factur-X : MINIMUM, BASIC WL, BASIC, EN16931, EXTENDED.
• XRECHNUNG est un profil de référence/customization allemand, pas un profil standard Factur-X.
• Les URN officiels FNFE-MPE utilisent le préfixe CEN long pour BASIC et EXTENDED (pas de forme courte :basic / :extended).
• Réparable automatiquement par /repair quand le profil peut être déduit du contenu.

Ce que l’erreur veut dire

Le profil Factur-X est déclaré via l’élément GuidelineSpecifiedDocumentContextParameter/ID placé sous ExchangedDocumentContext. La valeur est un URN normalisé qui désigne le profil et sa version. Sans cette balise (ou avec une valeur invalide), notre validateur ne peut pas déterminer quel jeu de règles Schematron appliquer.

Quand cette erreur arrive

Cas typiques : (a) ERP qui omet complètement GuidelineSpecifiedDocumentContextParameter ; (b) URN d’une ancienne version (urn:factur-x.eu:0p9:basic) ; (c) forme courte utilisée au lieu du préfixe CEN long pour BASIC et EXTENDED ; (d) tentative d’utiliser XRECHNUNG comme si c’était un profil Factur-X standard ; (e) profil revendiqué ne correspondant pas au contenu réel.

Exemple XML qui déclenche l’erreur

<rsm:ExchangedDocumentContext>
  <ram:GuidelineSpecifiedDocumentContextParameter>
    <ram:ID>urn:factur-x.eu:1p0:basic</ram:ID>  <!-- ❌ forme courte insuffisante pour BASIC -->
  </ram:GuidelineSpecifiedDocumentContextParameter>
</rsm:ExchangedDocumentContext>

Exemple XML corrigé (URN officiel BASIC)

<rsm:ExchangedDocumentContext>
  <ram:GuidelineSpecifiedDocumentContextParameter>
    <ram:ID>urn:cen.eu:en16931:2017#compliant#urn:factur-x.eu:1p0:basic</ram:ID>
  </ram:GuidelineSpecifiedDocumentContextParameter>
</rsm:ExchangedDocumentContext>

Correction manuelle

Utiliser l’URN officiel FNFE-MPE correspondant au profil :

Le profil XRECHNUNG est un profil de référence allemand distinct — si vous le voulez, utilisez son URN spécifique, mais sachez qu’il ne fait pas partie des 5 profils standards Factur-X.

Réparable automatiquement par /repair ?

Oui, sous conditions — l’endpoint /repair corrige automatiquement cette erreur quand les données structurées sont récupérables. Dans les cas ambigus, une décision humaine reste nécessaire.

Et maintenant ?

curl -X POST https://api.facturxapi.com/api/v1/repair \
  -H "Authorization: Bearer VOTRE_CLE" \
  -F "file=@facture.xml"

Voir aussi

• Catalogue complet des erreurs BR-* EN16931
• Comprendre les messages Schematron EN16931
• Corriger automatiquement les erreurs réparables