Schematron / BR-CO / BR-DE

Schematron EN16931 : comment lire les règles

Comprenez la grammaire Schematron, les assert/report et la personnalisation pour vos tests métier.

Règles maintenues par FNFE-MPE et CEN
Mécanisme assert/report avec XPath
Possibilité de whitelister certaines erreurs en sandbox

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.

Personnalisation

Vous pouvez ajouter vos propres règles Schematron (branche interne) pour vérifier des contraintes client. Nous stockons vos règles dans un namespace séparé.

  • BR custom => namespace fr:facturx:custom
  • Chargement via endpoint /api/v1/validate?rules=custom
  • Logs dédiés dans la réponse pour distinguer officiel vs custom

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

15 erreurs Schematron détaillées

Documentation API

Paramètre rules & filtres

Tester en ligne

Visualiser les assert/report