VeriFactu Phase 3: Versand an die AEAT

Was ist Phase 3

Phase 3 von VeriFactu ist der automatische Versand der Rechnungsaufzeichnungen an die Steuerbehörde (AEAT) mittels SOAP/XML-Nachrichten. Sie ergänzt die vorherigen Phasen (SHA-256-Hash und QR) mit der effektiven Übermittlung jeder Anlage und Stornierung einer Rechnung an das SII-System der AEAT.

Mit dieser aktiven Phase generiert Frihet die XML-Datei gemäß der Anordnung HAC/1177/2024, signiert sie mit Ihrem digitalen Zertifikat und sendet sie direkt an die Server der AEAT. Alles geschieht im Hintergrund, ohne manuelle Intervention.

Digitales Zertifikat

Um Aufzeichnungen an die AEAT zu senden, benötigen Sie ein gültiges digitales Zertifikat. Frihet akzeptiert Zertifikate im .pfx- oder .p12-Format.

Wo man ein Zertifikat erhält

Aussteller	Typ	Kosten
FNMT (Fabrik für Münzen und Briefmarken)	Natürliche oder juristische Person	Kostenlos
CamCert (Handelskammern)	Unternehmen	Variabel
ACCV (Region Valencia)	Regional	Kostenlos

Zertifikat hochladen

1. Gehen Sie zu Einstellungen > Compliance
2. Klicken Sie im Abschnitt Digitales Zertifikat auf Zertifikat hochladen
3. Wählen Sie Ihre .pfx- oder .p12-Datei aus
4. Geben Sie das Passwort des Zertifikats ein

Verschlüsselung des Passworts

Das Passwort Ihres Zertifikats wird vor der Speicherung mit AES-256-GCM verschlüsselt. Es wird niemals im Klartext gespeichert.

Sandbox vs. Produktion

Der Umschalter Sandbox-Modus unter Einstellungen > Compliance ermöglicht es, Aufzeichnungen an die Testumgebung der AEAT zu senden, bevor der echte Versand aktiviert wird.

• Sandbox: Die Aufzeichnungen werden an den Test-Endpoint gesendet. Die AEAT validiert sie, registriert sie aber nicht offiziell. Nützlich, um zu überprüfen, ob das Zertifikat und die Daten korrekt sind.
• Produktion: Die Aufzeichnungen werden an den offiziellen Endpoint gesendet. Die Rechnungen werden im SII-System der AEAT registriert.

tipp

Aktivieren Sie den Sandbox-Modus während der ersten Tage, um zu bestätigen, dass Ihr Zertifikat ordnungsgemäß funktioniert und die Daten fehlerfrei generiert werden.

Automatischer Versand

Aktivierung

1. Gehen Sie zu Einstellungen > Compliance
2. Aktivieren Sie den Umschalter Automatisch an AEAT senden

Mit diesem aktiven Umschalter wird jede ausgestellte oder stornierte Rechnung automatisch gesendet:

Workflow für Anlage (ausgestellte Rechnung)

1. Der SHA-256-Hash der Rechnung wird berechnet (unveränderliche Kette)
2. Die XML-Datei für die Anlage wird gemäß der AEAT-Spezifikation generiert
3. Die XML-Datei wird mit Ihrem digitalen Zertifikat signiert
4. Sie wird per SOAP an den Endpoint der AEAT gesendet
5. Die Antwort (zugewiesener CSV oder Fehler) wird gespeichert

Workflow für Stornierung (stornierte Rechnung)

1. Der Stornierungs-Hash wird mit den 5 erforderlichen Feldern berechnet
2. Die XML-Datei für die Stornierung wird generiert
3. Sie wird signiert und an den Endpoint der AEAT gesendet
4. Die Antwort und der Stornierungsstatus werden gespeichert

Beide Workflows sind Fire-and-Forget: Der Benutzer kann weiterarbeiten, während der Versand im Hintergrund verarbeitet wird.

Manueller Versand

Wenn der automatische Versand nicht aktiv ist oder wenn Sie eine bestimmte Rechnung erneut senden müssen:

1. Öffnen Sie die betreffende Rechnung
2. Klicken Sie auf das Aktionsmenü (drei Punkte)
3. Wählen Sie An AEAT senden
4. Ein Bestätigungsdialog mit der Vorschau des Hash wird angezeigt
5. Bestätigen Sie, um den Versand zu starten

Der manuelle Versand folgt dem gleichen technischen Workflow wie der automatische.

Versandstatus

Jede Rechnung zeigt ein Badge mit ihrem Versandstatus an die AEAT an:

Status	Badge	Beschreibung
Ausstehend	Umriss (ohne Farbe)	Hash berechnet, Versand nicht gestartet
Gesendet	Grau	SOAP-Nachricht gesendet, wartet auf Antwort von der AEAT
Akzeptiert	Grün	Die AEAT hat die Aufzeichnung akzeptiert und einen CSV-Code zugewiesen
Abgelehnt	Rot	Die AEAT hat die Aufzeichnung abgelehnt. Fehlerdetails anzeigen
Fehler	Rot	Technischer Fehler beim Versand (Netzwerk, Zertifikat, Timeout)

Status abfragen

Der Versandstatus ist sichtbar in:

• Der Detailansicht jeder Rechnung (Badge neben der Nummer)
• Der allgemeinen Rechnungsliste (Statusspalte)
• Dem erweiterten Registerbuch (zusätzliche Spalten)

Automatische Wiederholungsversuche

Wenn ein Versand aufgrund eines technischen Fehlers fehlschlägt (Timeout, Netzwerkfehler, AEAT-Dienst nicht verfügbar), versucht Frihet automatisch erneut:

• Häufigkeit: alle 15 Minuten
• Maximale Versuche: 3
• Nach 3 Fehlern: Der Status bleibt Fehler und erfordert manuelle Intervention

Um eine Rechnung mit dem Status Fehler manuell erneut zu versuchen:

1. Öffnen Sie die Rechnung
2. Klicken Sie auf das rote Status-Badge auf Erneut versuchen
3. Ein neuer Versandversuch wird ausgeführt

Indikatoren im PDF

Von der AEAT akzeptierte Rechnungen enthalten zusätzliche Informationen im generierten PDF:

• Badge "Registriert bei AEAT" im Dokumentenkopf
• CSV-Code zugewiesen von der AEAT, zusammen mit dem QR-Verifizierungscode

Diese Indikatoren erscheinen nur, wenn der Versandstatus Akzeptiert ist.

Erweitertes Registerbuch

Mit aktiver Phase 3 enthält das Registerbuch der ausgestellten Rechnungen 3 zusätzliche Spalten:

Spalte	Beschreibung
AEAT-Versandstatus	Status des Versands der Anmeldungsregistrierung (Ausstehend, Gesendet, Akzeptiert, Abgelehnt, Fehler)
CSV AEAT	Sicherer Verifizierungscode, der von der AEAT bei Akzeptanz der Registrierung zugewiesen wird
AEAT-Stornierungsstatus	Status des Versands der Stornierungsregistrierung (falls zutreffend)

Diese Spalten werden am Ende des exportierten CSV hinzugefügt, nach den 12 Standardspalten.

Fehlerbehebung

"Zertifikat nicht konfiguriert"

Es wurde kein digitales Zertifikat hochgeladen. Gehen Sie zu Einstellungen > Compliance und laden Sie Ihre .pfx- oder .p12-Datei hoch.

"NIF nicht konfiguriert"

Das Steuerprofil hat keine NIF. Gehen Sie zu Einstellungen > Steuerprofil und vervollständigen Sie Ihre Steuer-ID.

SOAP-Fehler / Verbindungsfehler

Mögliche Ursachen:

• Zertifikat abgelaufen: Überprüfen Sie das Gültigkeitsdatum Ihres Zertifikats. FNMT-Zertifikate haben eine Gültigkeit von 4 Jahren.
• Falsches Passwort: Laden Sie das Zertifikat erneut mit dem richtigen Passwort hoch.
• AEAT-Dienst nicht verfügbar: Die AEAT hat Wartungsfenster. Das System wird automatisch erneut versuchen.
• Unvollständige Steuerdaten: Überprüfen Sie, ob Ihre NIF, Steueradresse und Unternehmensdaten vollständig sind.

Zertifikat abgelaufen

Ein abgelaufenes Zertifikat blockiert alle Sendungen. Erneuern Sie Ihr Zertifikat bei der FNMT oder CamCert vor dem Ablaufdatum.

Rechnung von der AEAT abgelehnt

Die AEAT kann eine Registrierung ablehnen aufgrund von:

• NIF des Ausstellers stimmt nicht mit dem Zertifikat überein
• Falsches Datumsformat
• Ungültiger Rechnungsart für den Vorgang

Überprüfen Sie die Fehlermeldung in den Rechnungsdetails. Korrigieren Sie die Daten und verwenden Sie Erneut versuchen, um erneut zu senden.

Gesetzlicher Zeitplan

Die Verpflichtung zur Übermittlung an die AEAT hat gestaffelte Fristen gemäß RDL 15/2025:

Art des Steuerpflichtigen	Frist
Gesellschaften (GmbH, AG)	1. Januar 2027
Selbstständige (natürliche Person)	1. Juli 2027

info

Frihet unterstützt bereits den Versand an die AEAT. Es wird empfohlen, den Sandbox-Modus im Voraus zu aktivieren, um die Konfiguration zu validieren, bevor die Verpflichtung in Kraft tritt.

Beziehung zu anderen Phasen

• Phase 1 (SHA-256-Hash): wird automatisch für jede Rechnung berechnet. Sie ist die Grundlage der Registrierung. Siehe VeriFactu.
• Phase 2 (QR AEAT): Der QR-Code im PDF verweist auf die elektronische Zentrale der AEAT zur Verifizierung.
• Phase 3 (AEAT-Versand): diese Seite. Effektive Übertragung der Registrierung an die AEAT via SOAP/XML.

---

Vorherige: VeriFactu | Nächste: Unveränderlichkeit und Registrierung