Mustangproject · PDF/A · Hilfe

Mustang meldet gültig, obwohl die PDF/A-Prüfung scheitert

Lies PDF/A-, XML- und Gesamtergebnis getrennt, wenn wasCompletelyValid trotz PDF-Fehler true liefert.

Quellenstand: 5. November 2026Redaktion: KAN KAI WORKSRedaktionell aktualisiert:

Kurzantwort

Ein positives wasCompletelyValid()-Ergebnis darf widersprechende PDF/A-Einzelbefunde nicht überstimmen. Der dokumentierte Mustang-Fall zeigt genau diese Abweichung bei gültigem XML und ungültiger PDF/A-Prüfung. Vergleiche dieselben Dateibytes, das vorgesehene PDF/A-Profil und die getrennten Prüfergebnisse. Isoliere anschließend Bibliothek, Wrapper und Oberfläche. Eine Annahmeentscheidung muss alle für deinen technischen Ablauf erforderlichen Prüfungen berücksichtigen, nicht nur ein grünes Gesamtflag.

Quellengrundlage: Q1 · Q2

Gilt für
Behandelt eine gemeldete Ergebnisabweichung in Mustang 2.26.0. Die Prüfung trennt PDF/A, Rechnungs-XML und Berichtsauswertung; daraus entsteht keine rechtliche oder steuerliche Freigabe.
So prüfst du das Ergebnis
Gültige sowie gezielt im PDF/A- oder XML-Teil ungültige Testdateien führen jeweils zum erwarteten Gesamtergebnis. Verarbeitungsfehler und fehlende Einzelberichte können nicht unbemerkt als Erfolg durchgehen.
Deine erste Prüfung

Welche Einzelprüfung widerspricht dem Gesamtstatus?

Vergleiche PDF/A-Befund, Rechnungs-XML-Befund und API-Rückgabewert für exakt dieselbe Datei. Ein gültiger XML-Teil bestätigt nicht die PDF-Hülle.

Deine Anwendung verwendet wasCompletelyValid() und erhält true. Im ausführlichen Bericht steht trotzdem ein PDF/A-Fehler, während das eingebettete Rechnungs-XML erfolgreich geprüft wurde. Ein Originalfall beschreibt diese widersprüchliche Zusammenfassung für Mustang 2.26.0. Q1 Für eine automatische Annahme reicht der einzelne Rückgabewert in diesem Befund nicht aus.

Die Prüfschichten einzeln benennen

Eine hybride Rechnung enthält eine PDF-Darstellung und maschinenlesbare Daten. Die jeweiligen technischen Prüfungen beantworten unterschiedliche Fragen. veraPDF ermöglicht eine ausdrückliche PDF/A-Profilwahl und weist das Ergebnis im Prüfbericht aus. Q2 Auch „nicht verarbeitbar“ ist von einem tatsächlich geprüften, aber nicht konformen Dokument zu unterscheiden.

Den Widerspruch reproduzieren

  1. Dateistand festhalten. Sichere die Eingabedatei und ihre Prüfsumme. Stelle sicher, dass API-Ergebnis und Bericht wirklich zu denselben Bytes gehören. Ein neu erzeugter Export kann bereits andere Eigenschaften haben.
  2. Vollständigen Bericht lesen. Notiere Ergebnis und Fehler jeder Prüfschicht: PDF/A, Rechnungs-XML und Gesamtauswertung. Halte Warnungen und Fehler getrennt. Eine farbige Zusammenfassung darf diese Unterschiede nicht verschlucken.
  3. PDF unabhängig prüfen. Verwende einen nachvollziehbaren PDF/A-Validator mit dem für den Arbeitsablauf vorgesehenen Profil. Zeichne Toolversion und Profil auf. Wähle nicht solange andere Profile, bis irgendeines grün wird.
  4. Gleichen Test im Integrationsweg ausführen. Vergleiche direkten Bibliotheksaufruf, Wrapper und angezeigten Status. Wird ein Fehler bereits von der Bibliothek übersehen oder erst in deiner eigenen Zusammenfassung? Dieser Unterschied bestimmt, wo korrigiert werden muss.
  5. Annahmekriterien ausdrücken. Lege technisch fest, welche Prüfschichten erforderlich sind und wie ein fehlendes Ergebnis behandelt wird. Ein Profilfehler darf nicht durch einen anderen erfolgreichen Teiltest aufgehoben werden, wenn beide für den Ablauf erforderlich sind.

Nach einer Korrektur gezielt abnehmen

Teste mindestens einen vollständig erwartungsgemäßen Beispielsatz und einen Satz mit bewusst getrennten Fehlern in PDF beziehungsweise XML. Die neue Auswertung muss beide Fehlertypen erkennen. Ein angekündigter Herstellerfix ist erst dann hilfreich, wenn die tatsächlich eingesetzte Version und dieser Vergleich passen.

Für die Übergabe eignen sich Versionsstände, Profilwahl, bereinigte Einzelberichte und der API-Aufruf. Die technische Validierung bewertet die ausgewählten Regeln; sie ist keine pauschale steuerliche oder rechtliche Freigabe des Belegs. Bewahre die vollständigen Ergebnisse mit Bezug zur Eingabedatei auf.

Häufige Fragen

Ist ein gültiges Rechnungs-XML ausreichend?

Das hängt vom definierten technischen Austauschformat ab. Wenn auch PDF/A verlangt wird, muss diese zusätzliche Prüfung ebenfalls erfolgreich sein.

Kann ich PDF/A-Fehler einfach ignorieren, weil die Datei lesbar ist?

Lesbarkeit und Konformität mit einem bestimmten Profil sind unterschiedliche Eigenschaften.

Fall beschreiben

Unterstützung bei diesem Fehler

Wir können die Auswertung der Prüfschichten und die Freigabelogik deiner Dokumentenverarbeitung untersuchen.

Quellen