docentric/e-invoice-validator repository overview

⁠Docentric e-Invoice Validator

A Dockerized REST API and web UI for validating ZuGFeRD, Factur-X and UBL e-invoices (PDF and XML).

This image bundles everything needed to validate e-invoices in a single container:

• ASP.NET Core REST API
• Web-based UI (React + Vite + TypeScript + shadcn/ui with Tailwind CSS)
• Mustang Project validation engine (Java)
• .NET and OpenJDK runtime

No external dependencies required. Everything is preconfigured and ready to run.

⁠What this image does

• Validates ZuGFeRD, Factur-X and UBL e-invoices
• Supports PDF (hybrid) and XML formats
• Provides:
  • Web UI for manual uploads and validation
  • REST API for automated and CI-based validation
• Returns structured validation results (JSON)

⁠Quick start

docker pull docentric/e-invoice-validator:latest
docker run -p 18889:8080 docentric/e-invoice-validator:latest

Open in browser:

http://localhost:18889

⁠API access

Swagger UI is available at:

http://localhost:18889/api/docs/swagger/index.html

Use the API to:

• Upload PDF or XML e-invoices
• Run ZuGFeRD, Factur-X or UBL validation
• Retrieve validation results programmatically

⁠Typical use cases

• CI/CD e-invoice validation
• Automated compliance testing
• Manual validation via browser
• Internal QA tooling
• Integration testing for e-invoice generators

⁠Links

• GitHub repository: https://github.com/Docentric/docentric-e-invoice-validator⁠
• Docentric website: https://ax.docentric.com⁠

⁠Third-Party Components

This project integrates with the Mustang project CLI for ZUGFeRD/Factur-X/UBL validation and PDF/A processing.

Project: https://mustangproject.org/⁠

Mustang-CLI: https://www.mustangproject.org/commandline/⁠

Repository: https://github.com/ZUGFeRD/mustangproject⁠

License: Apache License 2.0

Copyright © 2013-2025 ZUGFeRD Association e.V.

⁠Acknowledgements

We gratefully acknowledge the Mustang project team and the ZUGFeRD Association for their excellent work in creating and maintaining the Mustang-CLI tool, which enables validation, extraction, and processing of ZUGFeRD/UBL/Factur-X documents.

⁠Kudos to Lovable

Special thanks to the Lovable platform⁠ for accelerating development, improving code quality, and making the overall project experience smoother and more enjoyable.

⁠License

MIT License Copyright © 2026 Docentric d.o.o.