Schematron / BR-CO / BR-DE

Schematron EN16931 : comment lire les règles

Comprenez la grammaire Schematron, les assert/report et ce que le diagnostic public vérifie réellement.

Règles maintenues par FNFE-MPE et CEN
Mécanisme assert/report avec XPath
Lecture des erreurs officielles sans promettre de règles privées

Structure d'une règle

Chaque règle Schematron cible un contexte XPath et émet un assert (erreur) ou report (warning). La combinaison context + test + message permet de comprendre la cause métier.

Extrait BR-CO-10
<sch:pattern id="BR-CO-10">
  <sch:rule context="cac:TaxTotal/cbc:TaxAmount">
    <sch:assert test=". = sum(../cac:TaxSubtotal/cbc:TaxAmount)">
      [BR-CO-10] TaxAmount must equal the sum of subtotals.
    </sch:assert>
  </sch:rule>
</sch:pattern>

Comment investiguer

Reprenez le XPath fourni dans la réponse API et cherchez-le dans votre XML. Identifiez la balise BT correspondante pour remonter au champ métier.

Contraintes métier spécifiques

L’API publique /api/v1/validate exécute les contrôles officiels exposés par le contrat API. Elle ne propose pas aujourd'hui de dépôt self-service pour des règles Schematron privées.

  • Gardez vos contrôles métier propres dans votre pipeline ou dans votre ERP
  • Utilisez la réponse API pour relier chaque erreur officielle au champ métier concerné
  • Pour un pilote avec règles spécifiques, contactez l’équipe afin de cadrer le besoin et les limites

Checklist rapide

  • Toujours travailler sur un XML indenté pour lire les XPath
  • Mapper les BT/BR vers vos champs ERP
  • Documenter les règles critiques dans votre wiki produit

Errors library

11 fiches d'erreurs EN16931 : cause, XPath, exemple et correction.

Documentation API

Paramètres validation_target, profils et réponse de validation

Vérifier une facture en ligne

Visualiser le diagnostic et le détail des contrôles