Skip to content

Configuration for validating documents against the German XRechnung standard using the KoSIT validation tool

License

Notifications You must be signed in to change notification settings

itplr-kosit/validator-configuration-xrechnung

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

72 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Validator Configuration for XRechnung

Validator configuration for Universal Business Language (UBL) and UN/CEFACT Invoice and CreditNote documents against EN16931:2017 and the German Core Invoice Usage Specification (CIUS) XRechnung 1.1.

It contains all necessary XML Schema and Schematrons to validate UBL and CII invoice XML documents for conformity with CIUS XRechnung 1.1.

In particular:

Usage

Change according to your environment.

In an empty directory:

  1. Downloads:
# download validator 
curl -L 'https://github.com/itplr-kosit/validator/releases/download/validationtool-1_0_1/validationtool-dist-1.0.1-standalone.zip' --output validator.zip

# download configuration
curl -L 'https://github.com/itplr-kosit/validator-configuration-xrechnung/releases/download/release-2018-03-05/validator-configuration-xrechnung_1.1_2018-03-05.zip' --output validator-configura
tion.zip

# download a test document
curl -L 'https://raw.githubusercontent.com/itplr-kosit/xrechnung-testsuite/master/instances/01.01a-INVOICE_ubl.xml' --output ubl.xml
# show content of directory
ls
# should show something like this:
ubl.xml validator.zip  validator-configuration.zip
  1. Unzip
unzip validator.zip
unzip validator-configuration.zip
  1. Run Validator
java -jar validationtool-1.0.1-standalone.jar -s scenarios.xml  -h ubl.xml

Validation reports are then written to ${test-document-file-name}-report.xml and ${test-document-file-name}-report.html e.g. ubl-report.xml and ubl-report.html according to above example.

Versioning

The git master branch always has the latest code. Since March 2018 new releases have the following naming and versioning scheme:

The source code gets tagged with release-${release-date} and distributions get the name validator-configuration-xrechnung_${xrechnung-version}_${release-date} e.g. validator-configuration-xrechnung_1.1_2018-03-05.zip

Releases

The release only contains the XML Schema and Schematrons for the validator configuration for XRechnung.

It is always recommended to update to the latest release.

Here you can download the latest release.

Build from Scratch

This repository contains an ANT build.xml which allows downloading all neccessary tools and artefacts for creating this validator configuration for XRechnung. It also allows testing the configuration against a few UBL and UN/CEFACT documents and creates a release zip file.