Zum Inhalt springen
Ironfang
de

Sprache

EnglishDeutschFrançais

Kostenlose Tools

Kostenloser Peppol-Validator für Rechnungen

Prüfen Sie Ihre UBL-Rechnung oder -Gutschrift gegen die Regeln der EN 16931 und von Peppol BIS Billing 3. Sehen Sie Fehler, Warnungen und Links zu vorhandenen Lösungen.

  • Kostenlos
  • Ohne Anmeldung
  • Rechnungs-XML wird nicht gespeichert

oder die XML-Datei hier ablegen

UBL-Rechnung oder -GutschriftXMLBis 5 MiB

Keine Datei zur Hand? Prüfen Sie eine Beispielrechnung:

Die Beispiele sind fiktive Rechnungen. XML herunterladen: gültiges Beispiel oder Beispiel mit Fehlern, oder lesen Sie die Erläuterung Feld für Feld zum gültigen Beispiel.

Ihr XML wird erst gesendet, wenn Sie die Prüfung starten. Anonymes Rechnungs-XML und Ergebnisse werden nur vorübergehend verarbeitet und nicht gespeichert.

Was mit Ihrer Datei geschieht
  • Ihr XML wird erst gesendet, wenn Sie die Prüfung starten. Bei einem Beispiel wird nur dieses Beispiel gesendet.
  • Es geht von Ihrem Browser an die Ironfang Finance API. Anonymes XML und sein Ergebnis werden nur vorübergehend verarbeitet und nicht gespeichert.
  • Inhaltsfreie Anfrage- und Sicherheitsdaten, einschließlich der IP-Adresse, können bis zu 90 Tage aufbewahrt werden.
  • Für anonyme Nutzung gelten Ratenbegrenzungen. Die Eingabe darf höchstens 5 MiB groß sein.
  • Siehe die Datenschutzerklärung.
Erweiterte Optionen

Lassen Sie beide Optionen auf Erkennen, es sei denn, die Prüfung meldet, dass Profil oder Dokumentart nicht erkannt werden können. Diese Optionen legen keine Version fest. Sie geben Profil und Dokumentart an, für die die API die aktuelle, für den Versand freigegebene Version bestimmt, statt beides aus dem Dokument zu erkennen; das Ergebnis nennt die verwendete Version. Eine angegebene Dokumentart, die dem erkannten Wurzelelement widerspricht, wird vor der Prüfung abgelehnt. Ein Dokument, dessen Wurzelelement nicht gelesen werden kann, braucht beide Angaben und wird dann im Prüfschritt XML oder Schema als ungültig gemeldet.

Automatisiert prüfen? Die Validierungs-API ansehen.

Beispielergebnis

So wird ein Fehler erklärt

Dies ist ein echter Befund aus unserem Beispiel mit Fehlern: Die Summe der Positionsbeträge lautet dort 750.00, die beiden Positionen ergeben aber 740.00. Der Validator meldet außerdem BR-CO-13, die davon abhängige Summe ohne Umsatzsteuer.

XML herunterladen
FehlerBR-CO-10

Die Positionsbeträge ergeben nicht die Summe

Die Summe der Positionen auf Dokumentenebene muss der Summe der einzelnen Nettobeträge der Positionen entsprechen.

Korrekturvorschlag: Addieren Sie die LineExtensionAmount-Werte der InvoiceLine- oder CreditNoteLine-Elemente mit Dezimalarithmetik. Tragen Sie die gerundete Summe in LegalMonetaryTotal/LineExtensionAmount ein.

Stelle im XML/*:Invoice[*][1]/cac:LegalMonetaryTotal[1]

So beheben Sie BR-CO-10 (öffnet in einem neuen Tab)Offizieller Regeltext (auf Englisch) (öffnet in einem neuen Tab)

Technische Details zu BR-CO-10

Meldung des Validators: Eine Geschäftsregel der EN 16931 ist an dieser Stelle nicht erfüllt.

Was eine Prüfung Ihnen liefert

Ironfang Finance API

Rechnungen automatisch in Ihrer Anwendung validieren

Führen Sie dieselben Prüfungen über die Ironfang Finance API aus und verarbeiten Sie die Ergebnisse in Ihrem eigenen Ablauf.

  • Stoppen Sie eine Rechnung, bevor sie versendet wird: Die API liefert dasselbe Ergebnis und dieselben Befunde als JSON.
  • Behalten Sie einen Verlauf: Ergebnisse angemeldeter Nutzer werden 30 Tage gespeichert, und Sie können sie auflisten, lesen oder löschen.
  • Starten Sie schnell mit den SDKs für TypeScript und Python, einer CLI und einer GitHub Action.
Finance-API-Schlüssel anlegenAPI-Dokumentation ansehenTarife ansehen

250 kostenlose Validierungen pro Monat. Keine Karte erforderlich. Dieser Validator ist ohne Konto kostenlos nutzbar. Die Kontoeinrichtung ist derzeit nur auf Englisch verfügbar.

Ironfang Finance / eine Peppol-Rechnung validieren

Erforderliche Berechtigung des Schlüssels:finance:einvoices:write

Anfrage

curl --request POST \
  'https://api.ironfang.uk/finance/v1/einvoices/validate' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/xml' \
  --header 'Accept: application/json' \
  --header 'Idempotency-Key: invoice-2026-001' \
  --data-binary '@invoice.xml'

Beispielantwort, Auszug

200 OK
Content-Type: application/json

{
  "operation_id": "019f29a4-3158-7b81-8f64-f1072146de30",
  "status": "completed",
  "outcome": "valid",
  "ruleset": {
    "id": "fwrs_example_invoice_2026a"
  },
  "findings": [],
  "findings_summary": {
    "returned": 0, "total": 0,
    "cap": 1000, "truncated": false
  }
}

Senden Sie Ihre XML-Datei als Anfragetext. Mit dem optionalen Idempotency-Key können Sie dieselbe Anfrage wiederholen, ohne eine zweite Validierung oder Abrechnung auszulösen. Ungültige Dokumente liefern ebenfalls 200, mit outcome: invalid und ihren Befunden. XRechnung und ZUGFeRD / Factur-X verwenden die V2-Route; siehe den API-Schnellstart.

Fragen

Kurze Antworten zum kostenlosen Validator. Die technischen Details darunter beschreiben Grenzen und XML-Verarbeitung vollständig.

Welche Dokumente kann ich prüfen?
Eine UBL-2.1-Rechnung (Invoice) oder -Gutschrift (CreditNote) im XML-Format nach Peppol BIS Billing 3, ein Dokument pro Prüfung, bis 5 MiB. PDF-Rechnungen, Archive und komprimierte Dateien werden nicht angenommen.
Brauche ich ein Konto?
Nein. Der Validator auf dieser Seite ist ohne Registrierung kostenlos nutzbar, innerhalb der Ratenbegrenzungen für anonyme Nutzung. Ein Konto brauchen Sie nur, um dieselben Prüfungen über die API auszuführen.
Was passiert mit meiner Datei?
Sie wird erst an die Ironfang Finance API gesendet, wenn Sie die Prüfung starten. Anonymes Rechnungs-XML und Ergebnisse werden nur vorübergehend verarbeitet und nicht gespeichert. Inhaltsfreie Anfrage- und Sicherheitsdaten, einschließlich Ihrer IP-Adresse, können bis zu 90 Tage aufbewahrt werden.
Was bedeutet es, wenn die Prüfung bestanden ist?
Das eingereichte Dokument hat die Prüfungen gegen das Schema von UBL 2.1, die EN 16931 und Peppol BIS Billing 3 in der Version des Regelwerks bestanden, die im Ergebnis angegeben ist. Bestanden ist keine Zertifizierung der Rechnung und keine Garantie, dass ein Empfänger sie annimmt, und es wird nichts über das Peppol-Netzwerk gesendet.
Kann ich diese Prüfungen aus meiner eigenen Software ausführen?
Ja. Die Ironfang Finance API führt dieselbe Validierung aus und liefert die Befunde als JSON. Ein kostenloses Konto enthält 250 Validierungen pro UTC-Kalendermonat.
Technische Details: Regelwerke, Grenzen und XML-Verarbeitung

Was geprüft wird

Ihr Dokument wird gegen das aktuelle, für den Versand freigegebene Regelwerk geprüft, eine genau bestimmte und unveränderliche Version: das Schema von UBL 2.1, die Geschäftsregeln der EN 16931 und die Regeln von Peppol BIS Billing 3, in dieser Reihenfolge. Jeder Befund trägt eine stabile Kennung, die offizielle, wo der Standard eine vorgibt, und eine Ironfang-Kennung FW- für die Prüfungen an der Grenze von Eingabe und XML. Das Ergebnis sagt Ihnen, ob das Dokument gegen dieses Regelwerk gültig ist. Es zertifiziert das Dokument nicht, garantiert nicht, dass ein Empfänger es annimmt, und sendet nichts über das Peppol-Netzwerk.

Grenzen

Ein XML-Dokument von höchstens 5 MiB pro Anfrage, dazu Ratenbegrenzungen für anonyme Nutzung. Archive und komprimierte Uploads werden vor der Prüfung abgelehnt. Stehen beide Optionen auf Erkennen, wird ein Dokument, dessen Profil nicht erkannt werden kann, auch eines mit einem DOCTYPE vor dem Wurzelelement, vor der Prüfung mit Profil nicht erkannt abgelehnt. Sobald ein Regelwerk ausgewählt, erkannt oder angegeben werden kann, werden ein DOCTYPE, Entitätsdeklarationen oder Verweise auf andere als die fünf vordefinierten Entitäten von XML sowie XInclude im Prüfschritt XML als ungültig gemeldet; die Regeln werden nicht erreicht.

XML-Verarbeitung

  • UTF-8, oder UTF-16 mit Byte-Order-Mark.
  • Ein DOCTYPE, andere als die fünf vordefinierten Entitäten oder XInclude werden vor der Prüfung abgelehnt oder im Prüfschritt XML als ungültig gemeldet, nie validiert.
  • Es werden höchstens 1.000 Befunde zurückgegeben; ein Ergebnis gibt an, wenn die Liste gekürzt wurde.
  • Der lesbare Bericht und der JSON-Download sind nicht signiert und enthalten kein Rechnungs-XML.

Ressourcen zu Ironfang Finance