Vorlage: E-Rechnungen im CI prüfen mit GitHub Actions

Ein GitHub-Actions-Ablauf prüft bei jedem Push und Pull Request alle E-Rechnungen in einem Ordner Ihres Repositorys. Ist eine davon ungültig, schlägt der Lauf fehl.

Zuletzt aktualisiert

Operationen validate_invoice
Plattformen GitHub Actions
Formate XRechnung, ZUGFeRD / Factur-X, Peppol BIS

Stand: Oktober 2026.

Für Softwarehersteller, deren Programm E-Rechnungen erzeugt. Eine Änderung, die die Ausgabe bricht, fällt im Build auf. Sonst fällt sie erst auf, wenn das System eines Kunden die Rechnung ablehnt.

Was die Vorlage macht

Ein erster Job sucht alle XML- und PDF-Dateien im Ordner. Ein zweiter Job prüft jede Datei mit der GitHub Action invowerk-dev/invowerk-action.

Der Schritt schlägt fehl, wenn das Ergebnis valid den Wert false hat. Das Protokoll zeigt die Meldungen mit Erklärung, soweit invowerk eine hat. Geprüft werden Format und Prüfregeln, nicht Beträge oder Steuersätze.

Schritte

  1. Kopieren Sie validate-e-invoices.yml nach .github/workflows/.
  2. Tragen Sie Ihren Rechnungsordner ein (Vorgabe: invoices/).
  3. Legen Sie Ihren API-Schlüssel als Repository-Secret INVOWERK_API_KEY an.

Ohne Schlüssel läuft der Ablauf mit den Limits für anonyme Aufrufe.

Vorlage auf GitHub

Ablauf und Anleitung (englisch): invowerk-dev/invowerk-integrations, templates/e-rechnung-ci-pruefen

API-Schlüssel holen

API-Schlüssel anlegen