Documentation
skeemrr validates e-invoice XML payloads against Schematron business rules for 21 international formats.
How It Works
Validation follows a multi-step pipeline:
- SBDH unwrapping — if the payload is wrapped in a Standard Business Document Header (SBDH) envelope, the inner document is extracted before processing.
- XML parsing & format detection — the XML is parsed and the invoice format is auto-detected from the root element, namespace, and
CustomizationID. Supported formats include FatturaPA, UBL 2.1, CII, PEPPOL BIS 3.0, XRechnung, ZUGFeRD/Factur-X, NLCIUS, RO-CIUS, CIUS-PT, and OIOUBL. - Ruleset chain evaluation — for layered formats, base rules run first, then format-specific rules. For example, a PEPPOL BIS 3.0 invoice runs EN 16931 rules followed by PEPPOL-specific rules. Each failing assertion produces an error with a rule ID, message, severity, and XPath location.
Supported Formats
Italy — FatturaPA
| Format ID | Description | Notes |
|---|
FPA12 | FatturaPA — Public Administration (B2G) | TD01–TD29 document type rules applied |
FPR12 | FatturaPA — Private (B2B/B2C) | TD01–TD29 document type rules applied |
FSM10 | FatturaPA — Simplified | Simplified invoice rules (FSM schema) |
EU Base — EN 16931
| Format ID | Description |
|---|
en16931-ubl-invoice | EN 16931 UBL Invoice |
en16931-ubl-creditnote | EN 16931 UBL Credit Note |
en16931-cii | EN 16931 Cross Industry Invoice (CII) |
PEPPOL
| Format ID | Description |
|---|
peppol-bis3-ubl-invoice | PEPPOL BIS 3.0 UBL Invoice (30+ countries) |
peppol-bis3-ubl-creditnote | PEPPOL BIS 3.0 UBL Credit Note |
peppol-bis3-sbdh | PEPPOL SBDH envelope validation |
Germany — XRechnung
| Format ID | Description |
|---|
xrechnung-ubl | XRechnung CIUS — UBL |
xrechnung-cii | XRechnung CIUS — CII |
Germany / France — ZUGFeRD / Factur-X
| Profile | Description |
|---|
zugferd-minimum | ZUGFeRD/Factur-X MINIMUM profile |
zugferd-basic-wl | ZUGFeRD/Factur-X BASIC-WL profile |
zugferd-basic | ZUGFeRD/Factur-X BASIC profile |
zugferd-en16931 | ZUGFeRD/Factur-X EN 16931 profile |
zugferd-extended | ZUGFeRD/Factur-X EXTENDED profile |
Country-Specific CIUS
| Format ID | Country | Description |
|---|
nlcius | Netherlands | NLCIUS (SI-UBL 2.0) |
ro-cius | Romania | RO-CIUS |
cius-pt | Portugal | CIUS-PT |
oioubl | Denmark | OIOUBL 2.1 |
Auto-Detection
You do not need to specify the format — skeemrr detects it automatically from the XML. For UBL and CII invoices, the CustomizationID determines which ruleset applies (e.g., PEPPOL BIS 3.0, XRechnung, NLCIUS, or base EN 16931). For FatturaPA, the versione attribute on the root element identifies the transmission format. For ZUGFeRD/Factur-X CII documents, the GuidelineSpecifiedDocumentContextParameter ID determines the profile.
Learn More