vcgato29 / validation

Schematron validation artefacts for CEN/TC 434

CEN/TC 434 - EN-16931 - Validation artefacts

Official Schematron validation artefacts for CEN/TC 434. This repository does not contain validation rules for any CIUS.

Latest release

• UBL & CII: v1.2.3 (2019-07-05) - https://github.com/CenPC434/validation/releases/tag/validation-1.2.3
• EDIFACT: v1.0.0 (2018-02-08) - https://github.com/CenPC434/validation/releases/tag/validation-1.0.0

For each syntax a separate folder exists where all related artefacts are to be published.

• ubl - UBL 2.1 (ISO/IEC 19845:2015) - EN mandatory syntax
  • UBL Website: https://www.oasis-open.org/committees/ubl/
  • Used XML Schemas: http://docs.oasis-open.org/ubl/os-UBL-2.1/UBL-2.1.zip
• cii - Cross Industry Invoice (D16B) - EN mandatory syntax
  • XML Schemas overview: http://www.unece.org/cefact/xml_schemas/index.html
  • Used XML Schemas: http://www.unece.org/fileadmin/DAM/cefact/xml_schemas/D16B_SCRDM__Subset__CII.zip
• edifact - UN/EDIFACT (and ISO 26025 based XML version) - EN optional syntax

Validation

The action of performing validation of business documents is not directly supported by the artefacts in this repository. Standalone validation of EN-16931 rules can be performed on the following pages (in arbitrary order - please contact the operators directly):

• https://peppol.helger.com/public/menuitem-validation-bis2 - manual upload
• https://peppol.helger.com/public/menuitem-validation-ws2 - web service details page
• http://validex.net/en-service/ - registration needed
• https://open.validex.net/en/login - manual upload
• https://www.itb.ec.europa.eu/invoice/upload - CEF e-Invoicing support - manual upload
• https://www.itb.ec.europa.eu/invoice/api/validation?wsdl - CEF e-Invoicing support - web service
• https://www.itb.ec.europa.eu/cenws8/upload - similar service for CEN/TC 434 editors - manual upload
• https://www.itb.ec.europa.eu/cenws8/api/validation?wsdl - similar service for CEN/TC 434 editors - web service
• https://invoice.fans/fr/validation-des-messages/ - in French, registration is necessary
• https://invoice.fans/en/message-validation/ - in English, registration is necessary
• https://invoice.fans/de/validierung-von-nachrichten/ - in German, registration is necessary

If you also provide an open service that can validate EN-16931 artefacts and you want to be listed here send us an email to philip[at]helger.com

A simple demo implementation maintained by the project team can be found at https://github.com/CenPC434/java-tools/ - we do not recommend this for production usage.

News and noteworthy

• v1.2.3 - 2019-07-05 (UBL and CII only)

  • See all fixed issues: https://github.com/CenPC434/validation/issues?q=is%3Aissue+is%3Aclosed+milestone%3Av1.2.3
  • Some codelist values were missing

• v1.2.2 - 2019-07-05 (UBL and CII only)

  • See all fixed issues: https://github.com/CenPC434/validation/issues?q=is%3Aissue+is%3Aclosed+milestone%3Av1.2.2

• v1.2.1 - 2019-05-14 (UBL and CII only)

  • See all fixed issues: https://github.com/CenPC434/validation/issues?q=is%3Aissue+is%3Aclosed+milestone%3Av1.2.1

• v1.2.0 - 2019-04-26 (UBL and CII only)

  • Note: this release does NOT contain the EDIFACT validation rules - its development is currently paused/stalled
  • Note: this release is not backwards compatible, and the examples files were changed as well.
  • See all fixed issues: https://github.com/CenPC434/validation/issues?q=is%3Aissue+is%3Aclosed+milestone%3Av1.2
  • The UBL ODS files were removed, because they were out of sync with the used rules
  • The folder names for examples files were unified across the syntaxes
  • The name of the UBL Schematron/XSLT files was changed from EN16931-UBL-model.* to EN16931-UBL-validation.*

• v1.1.0 - 2018-06-26 (UBL and CII only)

  • Note: this release does NOT contain the EDIFACT validation rules - its development is currently paused/stalled
  • New participant identifier schemes are supported
    • 0184 in issue #64
    • 0190 in issue #70
    • 0191 in issue #58
    • 0192 in issue #62
    • 0193 in issue #71
  • Rules targeting attributes were altered (issue #50)
  • Fixed typo in BR-CL-24 UBL (issue #52)
  • Some code list assertions had no id attributes (issue #53)
  • Rule CII-SR-029 was removed and the context of CII-SR-030 was adopted (issue #54)
  • Using xs:decimal instead of xs:double (issue #55)
  • The value of the VAT @schemeID attribute is VAT (instead of VA) (issue #57)
  • Error in rule BR-Z-10 UBL was fixed (issue #59)
  • Fixed error message of BR-AF-05 CII (issue #60)
  • The value 532 was not supported in BR-CL-01 (issue #63)

• v1.0.0 - 2018-02-08 (UBL, CII and EDIFACT)

  • Initial release

Development

For the Java projects contained in this repository, please consider the following prerequisites

• Java JDK 1.8.x latest (was tested only with a JDK and not with a JRE)
• For building on the commandline use Apache Maven 3.x (latest)

Create XSLTs from Schematrons

Invoke mvn -f pom-xslt.xml process-resources after changes - it will regenerate the XSLTs from the source SCHs. Don't forget to update the license headers afterwards (see below).

Create preprocessed Schematrons

After creating XSLTs, the preprocess Schematrons should be created. Preprocessing resolves all includes, abstract rules etc. Invoke mvn -f pom-preprocess.xml generate-resources to create all preprocessed Schematron files.

Check if the examples files match the rules from the XSLTs

Invoke mvn -f pom-validate.xml validate after re-creating the XSLTs (see above).

Update the license headers

The template for the license header resides in the file templates/license-template.txt. To add the license header to all relevant files invoke mvn -f pom-license.xml license:format