apps4everything/kosit-validator-xrechnung repository overview

⁠KoSIT XRechnung Validator

Ready-to-use Docker image for validating German e-invoices against XRechnung 3.0.2, ZUGFeRD/Factur-X, and EN 16931 (UBL & CII).

Built on the official KoSIT Validator⁠ with the XRechnung Validator Configuration⁠.

⁠Quick Start

docker run -d -p 8081:8081 apps4everything/kosit-validator-xrechnung:3.0.2-3

⁠Validate an Invoice

curl -s -X POST http://localhost:8081/ \
  -H "Content-Type: application/xml" \
  -d @invoice.xml

The response is an XML validation report containing the assessment, errors, warnings, and applied rules.

⁠Health Check

curl http://localhost:8081/server/health

The image includes a built-in Docker health check (every 30s).

⁠Versions

⁠Supported Standards

• XRechnung 3.0.2 — German e-invoicing standard (BR-DE rules)
• ZUGFeRD / Factur-X — Cross-border CII-based invoices
• EN 16931 — European norm for electronic invoicing (UBL and CII)

⁠Docker Compose

services:
  xrechnung:
    image: apps4everything/kosit-validator:3.0.2-2
    ports:
      - "8081:8081"
    restart: unless-stopped

⁠Links

• KoSIT Validator⁠ — KoSIT validation engine
• XRechnung Configuration⁠ — Rule sets and scenarios
• xvalidator.de⁠ — Free online validator running this image
• xml-rechnung.eu⁠ — API for generation, validation and archiving

⁠License

Apache 2.0