NAME

Quiq::KositValidator - Validator für XRechnungen

BASE CLASS

Quiq::Hash

DESCRIPTION

Der Validator ist eine Zusammenstellung aus Java-Code und Schematron-Dateien zur Validierung von XRechnungs-XML.

Der Validator ist im jeweils aktuellen "XRechnung Bundle" enhalten, welcher von XRechnung Versionen und Bundles heruntergeladen werden kann.

  1. Bundle herunterladen und entpacken

    $ mkdir xrechnung-3.0.2-bundle-2025-07-10
    $ cd xrechnung-3.0.2-bundle-2025-07-10
    $ unzip ../xrechnung-3.0.2-bundle-2025-07-10.zip
  2. KoSIT-Validator aus dem Bundle heraus entpacken und installieren

    Beispiel-Verzeichnis ist ~/sys/opt/kosit-validator, dieses kann aber frei gewählt werden.

    $ mkdir ~/sys/opt/kosit-validator
    $ cd ~/sys/opt/kosit-validator
    $ unzip .../validator-1.5.0-distribution.zip
    $ unzip .../validator-configuration-xrechnung_3.0.2_2025-07-10.zip
  3. KoSIT-Validator testen

    Eine Beispiel-Datei ubl.xml wird zum Herunterladen in kosit-validator/docs/usage.md erwähnt.

    $ perl -MQuiq::KositValidator -E '$kvl = Quiq::KositValidator->new("~/sys/opt/kosit-validator");say $kvl->validate("ubl.xml")'

    Es kann z.B. auch eine EN16931 ZUGFeRD XML-Datei validiert werden.

METHODS

Klassenmethoden

new() - Konstruktor

Synopsis

$kvl = $class->new($validatorDir,%options);

Arguments

$validatorDir

Verzeichnis mit den zum Validator gehörenden Dateien

Options

-javaDir => $javaDir (Default: undef)

Verzeichns mit dem Programm java. Beispiel: /opt/jdk/bin

Returns

Validator-Objekt

Description

Instantiiere ein Objekt der Klasse und liefere eine Referenz auf dieses Objekt zurück.

Objektmethoden

validate() - Validiere XRechnungs-XML

Synopsis

$status = $kvl->validate($xmlFile,%options);

Arguments

$xmlFile

Datei mit XRechnungs-XML

Options

-verbose => $bool (Default: 0)

Gib Laufzeitinformation über die Verarbeitung auf STDOUT aus.

Returns

(Integer) Status der Validierung: 0 = ok, 1 = fehlgeschlagen.

Description

Validiere XRechnungs-XML-Datei $xmlFile und liefere den Status der Validierung zurück.

VERSION

1.235

AUTHOR

Frank Seitz, http://fseitz.de/

COPYRIGHT

Copyright (C) 2026 Frank Seitz

LICENSE

This code is free software; you can redistribute it and/or modify it under the same terms as Perl itself.