API

XRechnung per HTTP prüfen, aus Ihrer Rechnungssoftware oder CI-Pipeline.

Schlüssel

Den kostenlosen Beta-Schlüssel bekommen Sie sofort auf der Startseite („API-Schlüssel sofort erhalten“). Limit in der Beta: 500 Prüfungen pro Tag und Schlüssel.

Prüfen

POST https://xrechnung.jestr.ai/api/validate
X-Api-Key: xr_…
Content-Type: application/xml

<rsm:CrossIndustryInvoice …> oder <Invoice …>

curl -s https://xrechnung.jestr.ai/api/validate \
  -H "X-Api-Key: $XR_KEY" -H "Content-Type: application/xml" \
  --data-binary @rechnung.xml

Antwort

{
  "verdict": "REJECT",                 // ACCEPT | REJECT | UNSUPPORTED
  "scenario": "EN16931 XRechnung (CII)",
  "rules": {"config": "v2026-08-31", "published_at": "2026-09-02T14:16:20Z"},
  "errors":   [{"id": "CII-SR-465", "level": "error", "text": "…", "location": "…"}],
  "warnings": [...],
  "infos":    [...]
}

rules.config ist die offizielle KoSIT-Version, gegen die geprüft wurde. So können Sie in Ihren Protokollen belegen, nach welchem Regelwerk eine Rechnung geprüft wurde.

In CI (z. B. GitHub Actions)

- name: XRechnung prüfen
  run: |
    for f in fixtures/*.xml; do
      v=$(curl -s https://xrechnung.jestr.ai/api/validate -H "X-Api-Key: ${{ secrets.XR_KEY }}" \
          -H "Content-Type: application/xml" --data-binary @"$f" | jq -r .verdict)
      echo "$f: $v"; [ "$v" = "ACCEPT" ] || exit 1
    done

Regelwerk-Version abfragen

GET https://xrechnung.jestr.ai/api/rules
GET https://xrechnung.jestr.ai/log.atom   (Feed bei neuen Versionen)

Die Rechnungen werden nur im Arbeitsspeicher geprüft und nicht gespeichert. Technische Konformitätsprüfung, keine Steuer- oder Rechtsberatung.