Zum Hauptinhalt springen
Portugal SAF-T (PT) File Checks

Fehler in Portugal SAF-T (PT) File Checks: wann welche Meldung erscheint und was zu tun ist

Die Meldungen von Portugal SAF-T (PT) File Checks sind auf Englisch und sagen fast alle schon, was schiefgelaufen ist, und oft auch den nächsten Schritt: vor dem Validieren generieren, das Log prüfen, ATCUD-Zertifikat und Schlüssel konfigurieren oder es später erneut versuchen. Hier finden Sie jede Meldung im Wortlaut, wann sie laut eigenem Text erscheint und was zu tun ist, ohne etwas anzunehmen, was die Meldung nicht sagt.

FlexigoTech · Verantwortlich: Víctor Gómez · Aktualisiert am 4. November 2026

Das Wichtigste

Versionen
Odoo 17, 18, 19 und 20
Geprüft
im Quellcode des Moduls, Version 20.0 · in den Quellen am Ende
Lesezeit
6 Min.

So lesen Sie eine Meldung von Portugal SAF-T (PT) File Checks

Jede Meldung enthält einen Text, der häufig auf %s endet oder in der Mitte ein %d enthält. An dieser Stelle setzt das Modul die konkreten Daten ein: das Fehlerdetail, den gespeicherten Wert, eine Adresse oder die Anzahl der Versuche. Wenn auf einen Doppelpunkt ein Text folgt, erfahren Sie genau dort, was in Ihrem Fall passiert ist.

In der Tabelle unten stehen die Meldungen so, wie das Modul sie schreibt, mit %s und %d an ihrem Platz. Auf Ihrem Bildschirm sehen Sie statt dieser Platzhalter die echten Daten.

Fehlertabelle: Meldung, wann sie erscheint und was zu tun ist

MeldungWann sie erscheintWas zu tun ist
SAF-T generation failed: %sDie Generierung der SAF-T-Datei schlägt fehl.Lesen Sie das Detail nach dem Doppelpunkt und beheben Sie das Genannte, bevor Sie erneut generieren.
No SAF-T file generated. Run generation first.Es wurde noch keine SAF-T-Datei generiert.Generieren Sie zuerst die Datei, wie die Meldung verlangt.
SAF-T validation failed. Check validation log for details.Die SAF-T-Datei besteht die Validierung nicht.Öffnen Sie das Validierungsprotokoll (validation log) und prüfen Sie das Detail.
SAF-T validation failed: %sDie Validierung schlägt fehl und die Meldung nennt den Grund.Lesen Sie den Grund nach dem Doppelpunkt.
Failed to fetch SAF-T schema from %s: %sDas SAF-T-Schema kann von einer Adresse nicht abgerufen werden.Die Meldung zeigt Adresse und Detail: Prüfen Sie beides.
SAF-T file must be an XML fileDie SAF-T-Datei ist keine XML-Datei.Verwenden Sie eine XML-Datei.
Period start must be before period endDer Periodenbeginn liegt nicht vor dem Periodenende.Korrigieren Sie die Daten, sodass der Beginn vor dem Ende liegt.
XML export failed: %sDer XML-Export schlägt fehl.Lesen Sie das Detail nach dem Doppelpunkt.
CSV export failed: %sDer CSV-Export schlägt fehl.Lesen Sie das Detail nach dem Doppelpunkt.
Annual statistics generation failed: %sDie Generierung der Jahresstatistik schlägt fehl.Lesen Sie das Detail nach dem Doppelpunkt.
NIF must be exactly 9 digits. Current value: %sDie NIF hat nicht genau 9 Ziffern.Die Meldung zeigt den aktuellen Wert: Bringen Sie ihn auf genau 9 Ziffern.
Invalid ATCUD endpoint URL formatDas Format der ATCUD-Endpoint-URL ist ungültig.Prüfen Sie, wie die Endpoint-URL geschrieben ist.
ATCUD certificate and key must be configured in SAF-T settingsATCUD-Zertifikat und Schlüssel sind nicht konfiguriert.Konfigurieren Sie beides in den SAF-T-Einstellungen.
ATCUD rejected the submission. Check error log for details.ATCUD lehnt die Übermittlung ab.Prüfen Sie das Fehlerprotokoll (error log).
Failed to contact ATCUD after %d attempts. Try again later.ATCUD ist nach mehreren Versuchen nicht erreichbar; die Meldung nennt die Anzahl.Versuchen Sie es später erneut.
ATCUD submission failed. Please try again later.Die Übermittlung an ATCUD schlägt fehl.Versuchen Sie es später erneut.
Submission can only be retried from error stateSie wiederholen eine Übermittlung, die nicht im Fehlerstatus ist.Wiederholen Sie nur Übermittlungen im Fehlerstatus.
No submissions found for this companyFür dieses Unternehmen gibt es keine Übermittlungen.Prüfen Sie, ob es das Unternehmen ist, das Sie ansehen wollten.
No email configured for companyFür das Unternehmen ist keine E-Mail konfiguriert.Konfigurieren Sie die E-Mail des Unternehmens.
Email test failed: %sDer E-Mail-Test schlägt fehl.Lesen Sie das Detail nach dem Doppelpunkt.
Several contacts match "%s": enter the email or the tax ID of the data subject.Mehrere Kontakte passen zu Ihrer Eingabe.Geben Sie die E-Mail oder die Steuernummer (tax ID) der betroffenen Person ein.
DSAR processing failed: %sDie DSAR-Verarbeitung schlägt fehl.Lesen Sie das Detail nach dem Doppelpunkt.

NIF, URL, E-Mail und Zertifikat: die Meldungen zu Daten

Eine Gruppe von Meldungen betrifft Daten, die Sie selbst eintragen. Die zur NIF ist die direkteste: Sie verlangt genau 9 Ziffern und zeigt den gespeicherten Wert (Current value: %s), sodass Sie auf einen Blick sehen, was zu viel ist oder fehlt. Die zur URL (Invalid ATCUD endpoint URL format) sagt nur, dass das Format ungültig ist; prüfen Sie also, wie die Adresse geschrieben ist.

Für die Übermittlung an ATCUD verlangt das Modul Zertifikat und Schlüssel in den SAF-T-Einstellungen: Fehlen sie, erscheint ATCUD certificate and key must be configured in SAF-T settings. Bei der E-Mail ist es ähnlich: No email configured for company bedeutet, dass das Unternehmen keine E-Mail hat, und Email test failed: %s erscheint, wenn der E-Mail-Test nicht klappt, mit dem Detail am Ende.

Neues ATCUD-Konfigurationsformular mit den Abschnitten Unternehmen, ATCUD, E-Mail und Benachrichtigungen sowie Upload
ATCUD-Konfigurationsformular in der Rechnungsstellung, noch ohne gespeicherte Daten: Nur die Endpoint-URL ist ausgefüllt, der untere Teil ist abgeschnitten.

Die Meldungen, die auf ein Log verweisen oder um Geduld bitten

Zwei Meldungen enthalten das Detail nicht selbst und verweisen anderswohin: SAF-T validation failed. Check validation log for details. auf das Validierungsprotokoll und ATCUD rejected the submission. Check error log for details. auf das Fehlerprotokoll. In diesen Fällen steht die Ursache nicht im Meldungsfenster, sondern im genannten Log.

Zwei weitere verlangen nur Geduld: Failed to contact ATCUD after %d attempts. Try again later. und ATCUD submission failed. Please try again later. Die erste nennt die Anzahl der Versuche des Moduls. In beiden Fällen sagt der Text, dass Sie es später erneut versuchen sollen.

Liste SAF-T Error Logs mit fünf Einträgen und Spalten für Datum, Fehlertyp, Schweregrad, Meldung und erledigt
Invoicing › SAF-T Error Logs: fünf Einträge mit Datum, Typ, Schweregrad und Meldung, das Erledigt-Kennzeichen nicht gesetzt.

Generieren, validieren und wiederholen: die Reihenfolge laut Meldungen

Manche Meldungen geben die Arbeitsreihenfolge vor. No SAF-T file generated. Run generation first. stellt klar, dass zuerst die SAF-T-Datei generiert werden muss. Submission can only be retried from error state legt fest, dass eine Übermittlung nur aus dem Fehlerstatus wiederholt werden kann. Und Period start must be before period end verlangt, dass der Periodenbeginn vor dem Ende liegt.

Wenn die Datei selbst das Problem ist, achten Sie auf SAF-T file must be an XML file und auf die Exportmeldungen (XML export failed: %s, CSV export failed: %s), die das Detail am Ende enthalten. Welche Einstellungen und Status jeder Datensatz durchläuft, zeigt die Inbetriebnahme des Moduls; Menüs und Aufgaben erklärt wie es intern funktioniert.

Liste Generate SAF-T Files mit sechs Einträgen zu Unternehmen, Periode und Status
Invoicing › SAF-T Accounting › Generate SAF-T Files: sechs Einträge in Draft, Generated, Validated, Validation Failed und Submitted, Dateigröße und Transaktionen auf null.
Rundgang durch die Listen SAF-T-Jahresstatistik, SAF-T Error Logs und Generate SAF-T Files
Von der Jahresstatistik (Unternehmen, Jahr, Gesamtzahl der Dokumente, Gesamtwert und Status Draft oder Exported) zur Fehlerliste und zur Liste der generierten SAF-T-Dateien.

So unterstützt Sie FlexigoTech

Wenn Sie eine Meldung nicht weiterkommen lässt oder Sie Ihre Konfiguration vor dem Übermitteln prüfen lassen möchten: FlexigoTech implementiert Odoo 17, 18, 19 und 20 und entwickelt individuelle Konnektoren und Integrationen. Das Modul kostet 9 € pro Odoo-Version in Odoo Apps, Einmalzahlung zzgl. MwSt., für 17, 18, 19 und 20 (Eintrag in Odoo Apps); der lokale Dienst von FlexigoTech Cloud kostet 29 €/Monat oder 290 €/Jahr zzgl. MwSt. Alle Details finden Sie auf der Modulseite.

Weiterlesen

So funktioniert Portugal SAF-T (PT) File Checks in Odoo im InnerenWelche Menüs Portugal SAF-T (PT) File Checks in der Rechnungsstellung ergänzt, welche Modelle dahinterstehen, welche Status Sie sehen und was extern läuft.Einrichtung von Portugal SAF-T (PT) File Checks in Odoo, erzählt an einem PraxisfallEinrichtung von Portugal SAF-T (PT) File Checks in Odoo an einem erfundenen Fall: ATCUD-Konfiguration, wichtige Felder, Status und Kontrollen der ersten Woche.Portugal SAF-T (PT) File Checks: Umfang, Voraussetzungen und passende Odoo-VersionWas Portugal SAF-T (PT) File Checks laut README abdeckt, was Sie vor der Installation brauchen (NIF, ATCUD, E-Mail) und für welche Odoo-Versionen.
Geprüft im Quellcode des Moduls (Version 20.0) und in den verlinkten Quellen

Quellen