E-Rechnung lässt sich nicht importieren: XRechnung- und ZUGFeRD-Fehler beheben

Schlägt der Import einer XRechnung oder ZUGFeRD-Rechnung fehl, sollten Sie die Originaldatei zunächst unverändert sichern und den Fehler einer von drei Ebenen zuordnen: Datei und Transport, formale Validierung oder Verarbeitung in der Rechnungssoftware. Diese Trennung verhindert, dass eine fachlich fehlerhafte Rechnung durch Umbenennen, manuelles Bearbeiten oder eine PDF-Konvertierung nur scheinbar repariert wird. Notieren Sie außerdem den vollständigen Fehlertext, den Zeitpunkt, den betroffenen Mandanten und die verwendete Softwareversion.

Die wichtigste Unterscheidung lautet: Eine XRechnung besteht im Regelfall aus einer strukturierten XML-Datei. Bei ZUGFeRD befindet sich der strukturierte Rechnungsdatensatz als XML-Anhang in einer PDF/A-3-Datei. Eine sichtbare PDF-Rechnung kann daher lesbar aussehen und trotzdem für den automatisierten Import ungeeignet sein.

Die Datei vor jeder Reparatur eindeutig einordnen

Prüfen Sie zuerst, was tatsächlich eingegangen ist. Die Dateiendung allein ist kein sicherer Beleg für den Inhalt. Eine Datei kann falsch benannt, beim Download verändert oder von einem E-Mail-System entpackt worden sein.

• Eine XRechnung sollte als XML-Datei vorliegen und eine Rechnungsstruktur enthalten, die von der importierenden Anwendung unterstützt wird.
• Eine ZUGFeRD-Rechnung ist eine PDF/A-3-Datei mit eingebetteter Rechnungs-XML. Ein gewöhnliches PDF ohne eingebetteten Datensatz ist keine ZUGFeRD-Rechnung.
• Ein ZIP-Archiv, eine E-Mail-Datei oder ein Downloadcontainer muss gegebenenfalls zuerst außerhalb der Buchhaltungssoftware geöffnet werden. Importiert wird anschließend die eigentliche XML- oder PDF-Datei.
• Eine Bilddatei oder ein eingescanntes PDF enthält ohne zusätzliche strukturierte Rechnungsdaten keine importierbare E-Rechnung.

Öffnen Sie eine unbekannte XML-Datei nicht zuerst in einem Textverarbeitungsprogramm und speichern Sie sie dort wieder ab. Solche Programme können Zeichencodierung, Zeilenumbrüche oder Sonderzeichen verändern. Für die erste Prüfung genügt ein XML-fähiger Betrachter, der die Datei nicht überschreibt.

Eine einzige Prüfreihenfolge für XRechnung und ZUGFeRD

1. Sichern Sie die empfangene Originaldatei mit ihrem ursprünglichen Dateinamen und dokumentieren Sie Absender, Eingangszeit und Übertragungsweg.
2. Prüfen Sie, ob Dateityp und Inhalt zusammenpassen: XML bei XRechnung, PDF/A-3 mit eingebetteter XML bei ZUGFeRD.
3. Testen Sie die Datei mit einem passenden Validator. Für XRechnung sind die von der Koordinierungsstelle für IT-Standards veröffentlichten Validierungsartefakte und Prüfszenarien ein maßgeblicher Prüfpunkt. Bei ZUGFeRD müssen Profil und Spezifikationsstand anhand der Unterlagen des Forums elektronische Rechnung Deutschland geprüft werden.
4. Schlägt bereits die Validierung fehl, liegt der Fehler wahrscheinlich in der Rechnung oder ihrem strukturierten Datensatz. Fordern Sie in diesem Fall eine korrigierte Datei beim Aussteller an.
5. Besteht die Datei die passende Validierung, testen Sie den Import in der vorgesehenen Importfunktion Ihrer Rechnungs- oder Buchhaltungssoftware. Prüfen Sie dabei Mandant, Belegart, Benutzerrechte und unterstützte Formatstände.
6. Funktioniert der Import weiterhin nicht, sichern Sie Fehlerprotokoll, Softwareversion und eine datenschutzgerecht bereitgestellte Beispieldatei für den Software-Support. Löschen oder verändern Sie die Originalrechnung nicht.

Diese Reihenfolge liefert eine klare Zuständigkeit: Ein Validierungsfehler muss in der Regel beim Rechnungsaussteller behoben werden. Eine valide Datei, die nur in einer bestimmten Anwendung scheitert, weist eher auf die Importfunktion, eine nicht unterstützte Variante oder die betriebliche Konfiguration hin.

Was typische XRechnung-Fehler bedeuten

Bei einer XRechnung kann der Fehler auf der reinen XML-Ebene, in der verwendeten Rechnungsstruktur oder in den fachlichen Geschäftsregeln liegen. Die Fehlermeldung sollte daher nicht nur nach dem Wort „XML“ beurteilt werden.

Die XML-Datei ist syntaktisch beschädigt

Meldungen wie „not well-formed“, „unerwartetes Zeichen“ oder Hinweise auf eine bestimmte Zeile sprechen für einen XML-Syntaxfehler. Mögliche Ursachen sind ein nicht geschlossenes Element, unzulässige Steuerzeichen, eine beschädigte Zeichenkodierung oder ein beim Übertragen abgeschnittener Inhalt. Öffnet sich die Datei auch in einem unabhängigen XML-Prüfwerkzeug nicht, sollte der Aussteller eine neue Originaldatei erzeugen und senden.

Schema, Namespace oder Formatstand passen nicht

Ein XML-Dokument kann technisch lesbar sein, aber nicht zur erwarteten Struktur passen. Importprogramme erkennen die Rechnungsart unter anderem anhand von XML-Namensräumen und Dokumentkennungen. Wurde die Rechnung mit einer anderen Syntax oder einem vom Programm nicht unterstützten Formatstand erstellt, kann die Anwendung sie ablehnen, obwohl der Inhalt in einem Browser angezeigt wird.

Vergleichen Sie in diesem Fall die unterstützten XRechnung-Varianten in der Dokumentationsrubrik für E-Rechnungen oder Rechnungsimport Ihrer Software mit dem Ergebnis des Validators. Ändern Sie Namespace oder Versionsangaben nicht von Hand. Diese Angaben gehören zur gesamten Dokumentstruktur und lassen sich nicht zuverlässig durch den Austausch einer einzelnen Textzeile korrigieren.

Eine fachliche Geschäftsregel wird verletzt

Validierungsberichte verwenden häufig Regelkennungen und nennen das betroffene Datenelement. Dahinter können fehlende Pflichtinformationen, unzulässige Kombinationen oder rechnerisch widersprüchliche Werte stehen. Beispiele sind eine nicht schlüssige Summenbildung, unvollständige Angaben zu Steuerkategorien oder ein für den jeweiligen Rechnungsempfänger benötigter Bezug.

Eine solche Rechnung sollte nicht intern umgeschrieben werden. Übermitteln Sie dem Aussteller die Regelkennung, den Fehlertext und – sofern im Bericht enthalten – die Bezeichnung des betroffenen Elements. Der Aussteller kann seine Rechnung im erzeugenden System berichtigen und eine neue Datei ausgeben.

Warum eine ZUGFeRD-PDF trotz sichtbarer Rechnung scheitert

Bei ZUGFeRD müssen zwei Bestandteile zusammen funktionieren: die visuelle PDF-Darstellung und die eingebettete XML-Rechnung. Der Import kann scheitern, obwohl das PDF am Bildschirm vollständig aussieht.

Die eingebettete XML fehlt

Ein normales PDF wird nicht durch einen passenden Dateinamen zu ZUGFeRD. Prüfen Sie mit einem PDF-Werkzeug, das eingebettete Dateien anzeigen kann, ob tatsächlich ein XML-Anhang vorhanden ist. Die genaue Bezeichnung der eingebetteten Datei kann vom verwendeten Spezifikationsstand und Profil abhängen. Verlassen Sie sich daher nicht allein auf einen erwarteten Anhangnamen.

PDF und XML wurden nachträglich getrennt

Wird eine ZUGFeRD-Datei gedruckt, über einen PDF-Drucker neu erzeugt oder in manchen Bearbeitungsprogrammen erneut gespeichert, kann die eingebettete XML verloren gehen. Der sichtbare Inhalt bleibt erhalten, während der maschinenlesbare Teil verschwindet. Fordern Sie dann die ursprüngliche ZUGFeRD-Datei erneut an, statt das neu erzeugte PDF zu importieren.

Das Profil wird nicht unterstützt

ZUGFeRD kennt unterschiedliche Profile. Nicht jedes Profil enthält denselben fachlichen Umfang, und nicht jede Software verarbeitet alle Varianten. Ermitteln Sie Profil und Spezifikationsstand mit einem geeigneten Validator. Prüfen Sie danach in der Herstellerdokumentation Ihrer Software, welche Kombinationen verarbeitet werden. Ein allgemeiner PDF-Test beantwortet diese Frage nicht.

Die eingebettete XML und die PDF-Anzeige widersprechen sich

Für die automatisierte Verarbeitung verwendet die Software regelmäßig die strukturierten Daten. Weichen Rechnungsnummer, Betrag, Steuerangaben oder Lieferantendaten zwischen PDF und XML voneinander ab, ist eine manuelle Auswahl des vermeintlich richtigen Werts riskant. Stoppen Sie die Freigabe und verlangen Sie eine berichtigte, in sich stimmige Rechnung.

Wenn die Datei valide ist, aber die Software sie ablehnt

Ein erfolgreicher Validierungstest beweist nicht, dass jede Buchhaltungssoftware die Datei importieren kann. Er zeigt zunächst, dass die Rechnung die geprüften technischen und fachlichen Regeln erfüllt. Die Anwendung kann dennoch an ihren eigenen Importgrenzen, Einstellungen oder Stammdaten scheitern.

• Prüfen Sie, ob Sie die spezielle Funktion für E-Rechnungen verwenden. Ein allgemeiner Belegupload übernimmt möglicherweise nur die PDF-Ansicht oder startet lediglich eine Texterkennung.
• Kontrollieren Sie den ausgewählten Mandanten, die Belegart und den vorgesehenen Rechnungseingang. Ein Verkaufsrechnungsmodul verarbeitet gewöhnlich keine Eingangsrechnung.
• Prüfen Sie Rollen und Rechte. Der Benutzer kann zum Hochladen berechtigt sein, ohne E-Rechnungsdaten übernehmen oder neue Lieferanten anlegen zu dürfen.
• Suchen Sie nach einer bereits importierten Rechnung mit derselben Rechnungsnummer und demselben Lieferanten. Eine Dublettenprüfung kann den erneuten Import absichtlich blockieren.
• Vergleichen Sie Lieferantenkennung, Steuerangaben, Währung und Zahlungsdaten mit den Stammdaten. Manche Programme verlangen eine eindeutige Zuordnung, bevor sie den Beleg in den Prüfprozess übernehmen.
• Lesen Sie das Importprotokoll. Eine Meldung über einen unbekannten Lieferanten verlangt eine andere Maßnahme als ein Hinweis auf ein nicht unterstütztes Profil.

Ein hilfreicher Gegenversuch ist der Import einer anderen, bereits erfolgreich validierten E-Rechnung desselben Formats. Scheitern alle Dateien, liegt die Ursache eher in der Funktion, Berechtigung oder Konfiguration. Scheitert nur eine Datei, obwohl der Validator keinen Fehler meldet, sollte der Softwareanbieter die betroffene Formatvariante und das Importprotokoll prüfen.

Fehlermeldungen in die richtige Maßnahme übersetzen

• „Dateiformat unbekannt“: Inhalt und Dateiendung prüfen, Archiv entpacken und die dafür vorgesehene Importfunktion verwenden.
• „XML kann nicht gelesen werden“: Syntax mit einem XML-fähigen Validator testen; bei Beschädigung eine neue Datei anfordern.
• „Schema oder Version nicht unterstützt“: Formatstand und Profil ermitteln und mit der Softwaredokumentation abgleichen.
• „Validierung fehlgeschlagen“: Regelkennung und betroffenes Element sichern und an den Rechnungsaussteller übermitteln.
• „Anhang nicht gefunden“: Bei ZUGFeRD prüfen, ob eine Rechnungs-XML in der PDF eingebettet ist und ob das PDF nachträglich neu erstellt wurde.
• „Lieferant nicht zugeordnet“: Stammdaten und Identifikationsmerkmale prüfen, ohne die Rechnungsdatei zu verändern.
• „Beleg bereits vorhanden“: Dublettenprüfung anhand von Lieferant, Rechnungsnummer und Belegstatus durchführen.

Fehlercodes und vollständige Meldungen sollten unverändert dokumentiert werden. Ein Bildschirmfoto kann ergänzen, ersetzt aber kein exportierbares Import- oder Validierungsprotokoll, wenn die Software ein solches bereitstellt.

Reparieren Sie keine Originalrechnung im laufenden Prozess

Das manuelle Ändern einer eingegangenen XML-Datei ist keine saubere Fehlerbehebung. Schon eine kleine Änderung kann die Integrität des empfangenen Dokuments beeinträchtigen, neue Validierungsfehler erzeugen oder zu Abweichungen zwischen Freigabe, Buchung und Archiv führen. Auch die Umwandlung in ein gewöhnliches PDF beseitigt lediglich die maschinenlesbare Struktur.

Bewahren Sie das empfangene Original zusammen mit dem Fehlernachweis auf. Eine korrigierte Rechnung sollte als neue Datei vom Aussteller eingehen und im Rechnungseingang eindeutig der beanstandeten Fassung zugeordnet werden. Wie die fehlerhafte Vorversion aufbewahrt, gesperrt oder verworfen wird, richtet sich nach Ihrem dokumentierten Rechnungseingangs- und Aufbewahrungsverfahren.

Der betriebliche Ablauf für den nächsten Importfehler

Legen Sie für kleine Unternehmen eine feste Verantwortlichkeit fest: Eine Person nimmt die technische Erstprüfung vor, die Buchhaltung entscheidet über Freigabe oder Rückgabe, und der Systemverantwortliche bearbeitet valide Dateien, die an der Software scheitern. Dokumentiert werden mindestens Originaldatei, Eingangsweg, Fehlermeldung, Validierungsergebnis, Bearbeitungsstatus und Kommunikation mit Aussteller oder Software-Support.

Als Erfolgskontrolle gilt nicht nur, dass der Import ohne Meldung endet. Vergleichen Sie nach der Übernahme Rechnungsnummer, Aussteller, Rechnungsdatum, Brutto- und Steuerbeträge, Währung sowie Zahlungsdaten mit der sichtbaren Rechnung. Erst danach sollte der Beleg in den normalen Prüf- und Freigabeworkflow wechseln.

Häufige Fragen zu besonderen Importfällen

Darf eine vertrauliche Rechnung an einen öffentlichen Online-Validator übertragen werden?

Nicht ohne Prüfung der Datenschutz- und Vertraulichkeitsanforderungen. Verwenden Sie bevorzugt eine intern betriebene oder vom Unternehmen freigegebene Validierungslösung. Für eine Supportanalyse sollten personenbezogene und geschäftlich sensible Daten nur über den vereinbarten sicheren Übertragungsweg bereitgestellt werden.

Kann eine E-Rechnung nach dem Import einfach gelöscht werden?

Der erfolgreiche Import ersetzt nicht automatisch die Aufbewahrung der empfangenen Originaldatei. Entscheidend sind das betriebliche Archivierungsverfahren, die unveränderte Nachweisbarkeit und die für den Einzelfall geltenden Aufbewahrungspflichten. Prüfen Sie die Ablage daher im Zusammenhang mit Verfahrensdokumentation, Buchhaltungssystem und steuerlicher Beratung.

Ist eine manuell erfasste Ersatzbuchung ausreichend, wenn der Import nicht funktioniert?

Eine manuelle Erfassung kann den internen Arbeitsablauf vorübergehend sichern, behebt aber weder einen fehlerhaften Rechnungsdatensatz noch die fehlende Originalablage. Kennzeichnen Sie den Vorgang, verhindern Sie eine spätere Doppelbuchung und lassen Sie klären, ob eine korrigierte E-Rechnung benötigt wird. Die Freigabe sollte erst erfolgen, wenn Rechnungsinhalt und Nachweise verlässlich geprüft wurden.