Dokument- & Formatvalidator
Überprüfen Sie Ihre elektronischen Dokumente vor dem Versand.
Der B2Brouter Validator ist ein kostenloses Online-Tool, mit dem Sie prüfen können, ob eine elektronische Dokumentdatei strukturell korrekt ist und einem bestimmten Format entspricht — bevor Sie sie produktiv einsetzen oder über die API übermitteln.
Verfügbar unter app.b2brouter.net/en/validation.
Was wird validiert?
Section titled “Was wird validiert?”Der Validator prüft:
- Schema-Konformität — ob die XML-Struktur der Formatspezifikation entspricht (z. B. UBL 2.1, CII D16B).
- Geschäftsregeln — ob Pflichtfelder vorhanden sind und Werte innerhalb der zulässigen Bereiche liegen.
- Schematron-Regeln — formatspezifische Validierungsregeln, die durch den Standard definiert sind (z. B. Peppol-BIS-Regeln, EN 16931).
Es wird nicht geprüft, ob der Empfänger existiert oder ob die Routing-Informationen korrekt sind — dies erfolgt erst beim Versand.
Verwendung
Section titled “Verwendung”- Öffnen Sie app.b2brouter.net/en/validation.
- Laden Sie Ihre XML-Datei hoch.
- Klicken Sie auf Validate.
Das Tool gibt eine Liste von Fehlern und Warnungen zurück, jeweils mit dem XPath-Pfad des problematischen Elements und einer Beschreibung der fehlgeschlagenen Regel.
API-Endpoint
Section titled “API-Endpoint”Der Endpoint /documents/validate ermöglicht die programmatische Validierung von Dokumenten. Verwenden Sie ihn, um die Validierung in Ihre Anwendung, CI-Pipeline oder automatisierten Workflow zu integrieren.
Die vollständige API-Referenz finden Sie unter developer.b2brouter.net/reference/validate-document.
Eine Authentifizierung ist erforderlich. Der Endpoint akzeptiert eine Dokumentdatei und gibt strukturierte Validierungsergebnisse zurück.
Was wird validiert?
Section titled “Was wird validiert?”Sowohl das Online-Tool als auch der API-Endpoint prüfen:
- Schema-Konformität — ob die XML-Struktur der Formatspezifikation entspricht (z. B. UBL 2.1, CII D16B).
- Geschäftsregeln — ob Pflichtfelder vorhanden sind und Werte innerhalb der zulässigen Bereiche liegen.
- Schematron-Regeln — formatspezifische Validierungsregeln, die durch den Standard definiert sind (z. B. Peppol-BIS-Regeln, EN 16931).
- Datenbankmodell — feldbasierte Prüfungen anhand unserer Datenbank in Bezug auf die Anforderungen der Steuerbehörde.
- Steuerbericht — für Rechnungen, die einen Steuerbericht erzeugen, Validierung der Rechnungswerte, die für dessen korrekte Erstellung erforderlich sind.
Keines der beiden Tools prüft, ob der Empfänger existiert oder ob die Routing-Informationen korrekt sind — dies erfolgt erst beim Versand.
Validierung beim Erstellen eines Dokuments über die API
Section titled “Validierung beim Erstellen eines Dokuments über die API”Dieselbe Validierung wird automatisch ausgeführt, wenn Sie ein Dokument über die API übermitteln (z. B. POST /documents). Besteht das Dokument die Prüfung nicht, gibt die API einen Validierungsfehler zurück und das Dokument wird abgelehnt, bevor es in das System gelangt.
Das bedeutet, dass Sie /documents/validate nicht vor jeder Übermittlung separat aufrufen müssen — es ist jedoch nützlich für das Debugging und Vorabprüfungen während der Entwicklung.
Ergebnisse verstehen
Section titled “Ergebnisse verstehen”| Ergebnis | Bedeutung |
|---|---|
| Valid | Das Dokument erfüllt alle Schema- und Geschäftsregeln des ausgewählten Formats. |
| Warning | Das Dokument ist technisch gültig, enthält jedoch Werte, die bei manchen Empfängern Probleme verursachen können. |
| Error | Das Dokument entspricht nicht dem Format. Es wird bei der Übermittlung abgelehnt. |
Beheben Sie alle Fehler, bevor Sie das Dokument in einer echten Integration verwenden. Warnungen dienen nur zur Information, sollten jedoch überprüft werden.
Unterstützte Formate
Section titled “Unterstützte Formate”Der Validator unterstützt die wichtigsten von B2Brouter akzeptierten Formate, darunter:
- Peppol BIS Billing 3.0 (UBL)
- EN 16931 (europäischer Standard)
- Factura-e (Spanien)
- FatturaPA (Italien)
- UBL 2.1 Rechnung / Gutschrift
Die vollständige Liste der verfügbaren Formate finden Sie in der Formatauswahl auf der Validierungsseite.
Häufige Anwendungsfälle
Section titled “Häufige Anwendungsfälle”- Vor dem Produktivstart — validieren Sie Beispieldokumente aus Ihrem ERP- oder Abrechnungssystem, um Integrationsprobleme frühzeitig zu erkennen.
- Fehleranalyse bei API-Problemen — wenn die API einen Formatvalidierungsfehler zurückgibt, fügen Sie das Dokument hier ein, um eine detaillierte Fehleranalyse zu erhalten.
- Testen neuer Formate — wenn Sie Unterstützung für ein neues Land oder Format hinzufügen, verwenden Sie den Validator, um Ihre Ausgabe zu prüfen, bevor Sie End-to-End-Tests durchführen.