Zum Inhalt springen
DSGVO-konform. Gehostet in der EU.
14 Tage kostenlos testen →
E-RechnungHeartbeat-MonitoringJahreswechsel
Monitoring 18 Min. Lesezeit 20. Nov. 2026

E-Rechnung ab 2027: Rechnungslauf per Heartbeat überwachen

E-Rechnung ab 2027: Der Versand wird oft ein nächtlicher Job. So meldet ein Heartbeat, wenn der Lauf ausbleibt, leer läuft oder an der Validierung scheitert.

X

XICTRAQ®

XICTRAQ®

E-RechnungHeartbeat-MonitoringCronjobsJahreswechsel
800.000 €
Vorjahresumsatz, bis zu dem für 2027 noch Papierrechnungen zulässig sind (§ 27 Abs. 38 UStG)
55 %
der Unternehmen ab 20 Beschäftigten nutzten 2024 die E-Rechnung im Versand (Bitkom)
3.600 s
höchste Toleranz eines Heartbeats nach der Fälligkeit (XICTRAQ®-Dokumentation)
Rechnungslauf mit Heartbeat: fünf Nächte um den JahreswechselDer Job meldet nach jedem Lauf die Zahl der gültigen Rechnungen an den HeartbeatStichtag1.1.2027Papier nur bis800.000 € Umsatzim VorjahrERP-ExportRechnungslauf 02:00ValidierungVersand 07:30PingHeartbeat „Rechnungslauf“ · 0 2 * * 1-5 · Europe/BerlinToleranz 45 Min., expect_output an, Ping mit items und exit_codeMo 28.12.items=38Di 29.12.items=41Mi 30.12.items=40Do 31.12.items=44Mo 4.1.!items=0, LeerlaufFr 1.1.2027 (Neujahr): Heartbeat vorher pausiert, daher kein Alarm für diesen TagWarnung · Mo 02:12Heartbeat ohneErgebnis:RechnungslaufLief, lieferte aber keine/zuwenige Ergebnisse (Items: 0)Exit-Code 0: der Jobselbst sah keinen FehlerZustellung: E-Mail undBereitschaft (Eskalation)1Erzeugung meldet itemsPing nach Validierung: items=41,exit_code=0, Laufzeit über /start2Fehler aktiv meldenstatus=fail und output, z. B.„3 Rechnungen mit Validierungsfehler“3Versand: eigener Heartbeatwerktags 07:30, items = versendet,Abweichung zur Erzeugung: status=failQuelle Stichtag und Umsatzgrenze: § 27 Abs. 38 UStG. Zeitplan, items und Uhrzeiten sind Beispielwerte.
Am 1. Januar 2027 endet für viele Unternehmen die Schonfrist bei der E-Rechnung: Wer im Vorjahr mehr als 800.000 Euro Gesamtumsatz hatte, kann Rechnungen an andere inländische Unternehmer für Leistungen des Jahres 2027 nicht mehr auf Papier oder als einfaches PDF übermitteln (§ 27 Abs. 38 UStG). Damit wird der Rechnungsversand in vielen Betrieben zum ersten Mal ein automatischer Rechnungslauf: Export aus der Warenwirtschaft, Erzeugung der strukturierten Datei, Validierung, Versand. Dieser Beitrag behandelt nicht das Format, sondern den Lauf. Er zeigt, wie ein Heartbeat meldet, wenn der Rechnungslauf ausbleibt, leer läuft oder mit Validierungsfehlern endet, und wo diese Überwachung an ihre Grenze kommt.

Was sich zum 1. Januar 2027 ändert

Die Pflicht selbst steht im Umsatzsteuergesetz (UStG). Für eine Leistung an einen anderen Unternehmer ist die Rechnung als elektronische Rechnung auszustellen, wenn der leistende Unternehmer und der Leistungsempfänger im Inland ansässig sind (§ 14 Abs. 2 UStG). Elektronisch heißt dabei nicht „per E-Mail“: Eine elektronische Rechnung wird in einem strukturierten elektronischen Format ausgestellt, übermittelt und empfangen und ermöglicht eine elektronische Verarbeitung (§ 14 Abs. 1 UStG). Ein PDF im Anhang einer Mail ist nach dieser Begriffsbestimmung eine sonstige Rechnung.

Damit der Umstieg nicht an einem einzigen Tag hängt, enthält das Gesetz eine Übergangsregel in Stufen. Für Umsätze der Jahre 2025 und 2026 dürfen Rechnungen bis zum 31. Dezember 2026 noch auf Papier oder, mit Zustimmung des Empfängers, in einem anderen elektronischen Format übermittelt werden (§ 27 Abs. 38 UStG). Für Umsätze des Jahres 2027 gilt diese Erleichterung nur noch, wenn der Gesamtumsatz des Ausstellers im vorangegangenen Kalenderjahr nicht mehr als 800.000 Euro betragen hat (§ 27 Abs. 38 UStG). Unabhängig von dieser Grenze bleibt bis Ende 2027 der elektronische Datenaustausch per EDI (Electronic Data Interchange) in einem anderen Format zulässig, wenn der Empfänger zustimmt (§ 27 Abs. 38 UStG).

Umsatz ausgeführtÜbermittlung bisPapier oder anderes FormatRechtsgrundlage
2025 und 202631.12.2026für alle Unternehmer, anderes elektronisches Format nur mit Zustimmung§ 27 Abs. 38 Nummer 1 UStG
202731.12.2027nur bei höchstens 800.000 Euro Gesamtumsatz im Vorjahr§ 27 Abs. 38 Nummer 2 UStG
202731.12.2027EDI mit Zustimmung des Empfängers, unabhängig vom Umsatz§ 27 Abs. 38 Nummer 3 UStG
ab 2028keine Übergangsstufenicht mehr über § 27 Abs. 38 UStG gedeckt§ 14 Abs. 2 UStG

Wer 2026 mehr als 800.000 Euro Gesamtumsatz erzielt, stellt Rechnungen an inländische Geschäftskunden für Leistungen ab dem 1. Januar 2027 also als E-Rechnung aus, sofern er nicht über EDI abrechnet. Ausgenommen bleiben unter anderem Rechnungen bis 250 Euro Gesamtbetrag und Fahrausweise, die weiter als sonstige Rechnung übermittelt werden dürfen (BMF). Rechnungen an Privatkunden betrifft das nicht, denn das Gesetz knüpft die E-Rechnung an Leistungen an andere Unternehmer (§ 14 Abs. 2 UStG). Für diesen Beitrag zählt die Folge im Betrieb: Der Versand wandert bei vielen von der Hand in einen Job.

Jahreswechsel: zwei Zeitpunkte in einer Regel

Die erste Stufe nennt zwei Daten: den Umsatz vor dem 1. Januar 2027 und die Übermittlung bis zum 31. Dezember 2026 (§ 27 Abs. 38 UStG). Eine Dezember-Rechnung, die erst im Januar hinausgeht, liegt außerhalb dieser Stufe; die Einordnung klärt die Steuerberatung. Für die Technik heißt das: Der erste Lauf im Januar ist kein guter Zeitpunkt für die erste Erprobung.

Vom Rechnungsdruck zum nächtlichen Job

Wie weit die E-Rechnung im Versand verbreitet ist, zeigt eine repräsentative Befragung, für die Bitkom Research zwischen Mitte April und Anfang Juni 2024 insgesamt 1.103 Unternehmen ab 20 Beschäftigten in Deutschland befragt hat (Bitkom). Rund die Hälfte (55 Prozent) nutzte die E-Rechnung damals bereits bei ausgehenden Rechnungen, 30 Prozent häufig und 25 Prozent nur in Einzelfällen (Bitkom). Den Versand per E-Mail, etwa als PDF, nutzten praktisch alle befragten Unternehmen mit 99 Prozent (Bitkom), die Briefpost noch 59 Prozent (Bitkom).

Für Betriebe, die heute ein PDF aus der Warenwirtschaft verschicken oder Papier drucken, ändert sich damit der Ablauf. Typisch ist eine Kette aus vier Schritten: Das ERP-System exportiert die abrechenbaren Vorgänge, ein Konverter erzeugt daraus die strukturierte Rechnung, eine Validierung prüft sie gegen das Format, und ein Versandschritt übermittelt sie per E-Mail, Portal oder Schnittstelle. Oft läuft diese Kette nachts, damit die Rechnungen morgens beim Kunden liegen.

Jeder dieser Schritte kann ausfallen, ohne dass es auffällt. Die Buchhaltung sieht am Morgen keinen Fehler, weil sie den Lauf nicht beobachtet, sondern nur sein Ergebnis erwartet. Die gesetzliche Frist ist dabei selten der Engpass, denn bei Leistungen an andere Unternehmer verlangt das Gesetz die Rechnung innerhalb von sechs Monaten nach der Leistung (§ 14 Abs. 2 UStG). Spürbar wird ein stiller Ausfall woanders: im Zahlungseingang, der um so viele Tage später beginnt, wie der Lauf unbemerkt stand.

Vier Arten, wie ein Rechnungslauf still scheitert

Ein Rechnungslauf scheitert selten laut. Vier Muster lassen sich unterscheiden, und jedes braucht ein eigenes Signal.

Der Lauf startet nicht

Der Server wurde neu gestartet, der Zeitplan bei einem Update überschrieben, ein Zugang ist abgelaufen. Diesen Fall fängt nur eine Erwartung ab, die von außen auf ein Lebenszeichen wartet.

Der Lauf läuft leer

Der Export endet sauber mit Exit-Code 0 und findet keine Vorgänge, etwa weil ein Datumsfilter nach dem Jahreswechsel auf das alte Jahr zeigt oder ein neuer Nummernkreis fehlt. Technisch ist alles grün, fachlich fehlen alle Rechnungen.

Die Validierung schlägt fehl

Einzelne oder alle Dateien bestehen die Formatprüfung nicht. Eine Datei mit Formatfehlern erfüllt die Anforderungen an das strukturierte Format nicht und gilt als sonstige Rechnung (BMF). Läuft der Versand trotzdem weiter, gehen Dateien hinaus, die keine E-Rechnung sind.

Der Versand bleibt hängen

Die Rechnungen sind erzeugt, aber der Versandschritt scheitert am Mailserver, an einem abgelaufenen Portalzugang oder an einer gesperrten Schnittstelle. Wer nur den ersten Schritt überwacht, sieht hier einen gesunden Lauf.

Ein fünfter Fall ist leiser: Der Lauf braucht viel länger als sonst, etwa weil die Datenbank an einer Sperre hängt oder zum Jahresanfang die Menge sprunghaft steigt. Auch dafür gibt es ein Signal, dazu weiter unten mehr.

Das Prinzip: der Lauf meldet sich selbst

Ein Heartbeat dreht die übliche Überwachung um. Statt von außen eine Adresse abzufragen, wartet XICTRAQ® auf eine Meldung des Jobs. Kommt sie bis zur Fälligkeit plus Toleranz nicht an, folgt ein Alarm. Die Grundlagen und die Einbindung in Shell, Python oder Kubernetes beschreibt der Beitrag zum Heartbeat-Monitoring für Cron-Jobs. Wie expect_output und eine Mindestzahl einen leeren Export erkennen, erklärt der Beitrag zur Überwachung von Produktfeed-Exporten im Detail. Hier geht es um das, was beim Rechnungslauf anders ist.

Die Meldung ist ein einfacher Aufruf einer eindeutigen Adresse am Ende des Skripts. An die Ping-URL lassen sich Kennzahlen anhängen: items für die verarbeiteten Datensätze, exit_code, duration_ms, eine kurze Notiz über output und status=ok oder status=fail (XICTRAQ®-Dokumentation). Für den Rechnungslauf ist items die wichtigste davon, denn sie trägt die Zahl der erzeugten Rechnungen. Schaltet man am Heartbeat expect_output ein, wertet XICTRAQ® einen Ping mit items=0 als Leerlauf und alarmiert, auch wenn der Exit-Code 0 war (XICTRAQ®-Dokumentation). Alle Parameter stehen in der Heartbeat-Dokumentation.

Was XICTRAQ® sieht und was nicht

XICTRAQ® sieht die Rechnungen nicht. Es prüft weder XRechnung noch ZUGFeRD, liest keine XML-Datei und kennt keine Empfänger. Ausgewertet wird nur, was der Job meldet: ob er sich gemeldet hat, wann, wie lange er lief, wie viele Rechnungen er nennt und ob er einen Fehler meldet.

Zwei Heartbeats: Erzeugung und Versand getrennt

Ein einziger Ping am Ende der ganzen Kette sagt nur, dass sie irgendwann durchgelaufen ist. Für den Rechnungslauf lohnt die Trennung in zwei Heartbeats. Der erste meldet nach Erzeugung und Validierung, wie viele gültige Rechnungen bereitliegen. Der zweite meldet nach dem Versand, wie viele hinausgegangen sind. Fällt der Versand aus, bleibt der zweite Ping aus oder meldet einen Fehler, während der erste grün bleibt. Zwei Heartbeats sind schon im Free-Plan enthalten (XICTRAQ®-Dokumentation).

Oft liegen die beiden Schritte auch zeitlich auseinander. Die Erzeugung läuft nachts, wenn das ERP ruhig ist, der Versand am frühen Morgen, damit die Rechnungen zu Geschäftszeiten ankommen. Zwischen beiden liegt dann ein Zeitfenster, in dem jemand eingreifen kann, bevor fehlerhafte Dateien das Haus verlassen.

Das folgende Skript zeigt den ersten Teil. Es meldet den Start, damit XICTRAQ® die Laufzeit selbst berechnet, ruft Export und Erzeugung auf, lässt jede Datei validieren und meldet das Ergebnis. Die Befehle für Export und Validierung sind Platzhalter für das jeweilige ERP und das eingesetzte Prüfwerkzeug.

invoice-run.sh
#!/usr/bin/env bash
# Erzeugt die E-Rechnungen der Nacht, validiert sie und meldet das Ergebnis.
# Aufruf: invoice-run.sh <heartbeat-slug>
set -uo pipefail

HB="https://api.xictraq.com/api/heartbeat/$1"
OUT="/srv/invoices/$(date +%F)"
mkdir -p "$OUT/rejected"

# Beginn melden: XICTRAQ® rechnet daraus die Laufzeit.
curl -fsS -m 10 --retry 3 "$HB/start" >/dev/null || true

# Platzhalter: Export aus dem ERP und Erzeugung der XML-Dateien.
/opt/erp/bin/export-invoices --until today --target "$OUT"
RC=$?

# Validierung je Datei; ungültige Dateien gehen nicht in den Versand.
OK=0; BAD=0
for f in "$OUT"/*.xml; do
  [ -e "$f" ] || break
  if /opt/validator/validate "$f" >"$f.report.txt" 2>&1; then
    OK=$((OK+1))
  else
    BAD=$((BAD+1)); mv "$f" "$f.report.txt" "$OUT/rejected/"
  fi
done

if [ "$RC" -ne 0 ] || [ "$BAD" -gt 0 ]; then
  curl -fsS -m 10 --retry 3 -G "$HB/ping" \
    --data-urlencode "status=fail" --data-urlencode "exit_code=$RC" \
    --data-urlencode "items=$OK" \
    --data-urlencode "output=Export rc=$RC, $BAD Rechnungen mit Validierungsfehler" >/dev/null
  exit 1
fi

# Gemeldet wird die Zahl der gültigen Rechnungen, auch wenn sie 0 ist.
curl -fsS -m 10 --retry 3 "$HB/ping?exit_code=0&items=$OK" >/dev/null

Drei Stellen tragen das Skript. Gezählt wird in den geschriebenen Dateien, nicht in der Datenbank des ERP; nur so fällt auf, wenn der Export Vorgänge findet, aber keine Datei schreibt. Ungültige Dateien verschiebt das Skript in einen eigenen Ordner, damit der Versandschritt sie nicht anfasst. Und Validierungsfehler meldet es aktiv mit status=fail und einer kurzen Notiz, statt den Ping wegzulassen; der Bericht je Datei bleibt für die Klärung am Morgen liegen.

Validierungsfehler aktiv melden

Ob eine Datei die Formatvorgaben erfüllt, lässt sich nach dem Schreiben des Bundesministeriums der Finanzen (BMF) vom 15. Oktober 2025 mit einer geeigneten Validierungsanwendung prüfen (BMF). Das Ergebnis ist mehr als ein technisches Detail: Eine Datei, die wegen Formatfehlern die Anforderungen an das strukturierte Format nicht erfüllt, ist nach demselben Schreiben keine E-Rechnung, sondern eine sonstige Rechnung (BMF). Ein Lauf, der solche Dateien erzeugt und verschickt, endet technisch erfolgreich und verfehlt trotzdem seinen Zweck.

Darum gehört der Validierungsfehler in den Heartbeat, und zwar als aktive Fehlermeldung. Ein Ping mit status=fail setzt den Monitor auf „failed“ und löst sofort einen kritischen Alarm aus, ohne dass erst die Toleranz abläuft. Den gleichen Weg bietet der Endpunkt /fail: Er setzt den Status „failed“ und löst direkt einen Alarm aus, ohne das Grace-Window abzuwarten (XICTRAQ®-Dokumentation). Die Notiz aus output steht im Alarm als Grund, etwa „Export rc=0, 3 Rechnungen mit Validierungsfehler“. So zeigt schon die Meldung, ob ein einzelner Stammsatz klemmt oder der ganze Lauf.

Ob ein einzelner Fehler den ganzen Versand anhält, ist eine fachliche Entscheidung. Für die Überwachung genügt, dass der Job den Zustand meldet und der Versand nur Dateien anfasst, die die Validierung bestanden haben.

Grüne Validierung, falsche Rechnung

Eine bestandene Validierung prüft Format und Geschäftsregeln, nicht jede Pflichtangabe. Inhaltsfehler können auch dann vorliegen, wenn die Validierung keinen Fehler festgestellt hat, etwa bei einem falschen Steuersatz (BMF). Ein Heartbeat ändert daran nichts: Er meldet, was der Job prüft, und nicht mehr.

Zeitplan: Startzeit, Werktage, Zeitzone

Mit eingeschaltetem expect_output alarmiert jeder Ping mit items=0. Für den Rechnungslauf ist das an einem Dienstag richtig und an einem Sonntag falsch, an dem niemand ausgeliefert hat. Ein Zeitplan, der täglich einen Lauf erwartet, meldet so jedes Wochenende einen Leerlauf, und nach dem dritten Wochenende liest diese Warnung niemand mehr. Die Lösung liegt im Zeitplan selbst: Der Heartbeat erwartet nur an Werktagen eine Meldung.

XICTRAQ® nimmt dafür einen vollen Cron-Ausdruck mit eigener Zeitzone; Cron-Ausdrücke werden serverseitig geprüft, und eine gesetzte Zeitzone muss eine gültige Zone der Internet Assigned Numbers Authority (IANA) sein (XICTRAQ®-Dokumentation). Im Wochentagsfeld sind nach POSIX die Werte 0 bis 6 gültig, die 0 steht für Sonntag (POSIX). Der Ausdruck 0 2 1-5 mit der Zone Europe/Berlin bedeutet damit: montags bis freitags um 02:00 Uhr Ortszeit. Der Montagslauf trägt die Vorgänge des Wochenendes mit; seine Zahl liegt höher, und das ist kein Fehler. Ähnlich arbeitet der Bestell-Heartbeat mit Zeitplänen für Tag, Nacht und Wochenende.

Welche Uhrzeit in den Zeitplan gehört, entscheidet über Fehlalarme. Der Heartbeat berechnet die nächste Fälligkeit aus dem letzten Ping und dem Cron-Ausdruck. Trifft der Ping vor der eingetragenen Uhrzeit ein, bleibt die Fälligkeit desselben Morgens offen, und nach Ablauf der Toleranz folgt ein Alarm für einen Lauf, der längst fertig ist. Darum kommt die Startzeit des Laufs in den Zeitplan, und die Toleranz deckt die Laufzeit ab. Sie lässt sich zwischen 0 und 3600 Sekunden einstellen, also auf höchstens eine Stunde (XICTRAQ®-Dokumentation). Braucht der Lauf länger als eine Stunde, gehört die früheste übliche Endzeit in den Zeitplan, und die Toleranz deckt die Spanne bis zur spätesten.

EinstellungHeartbeat „Rechnungslauf“Heartbeat „Rechnungsversand“
Zeitplan (Cron, Europe/Berlin)0 2 1-5 (Startzeit)30 7 1-5 (Startzeit)
Toleranz45 Minuten30 Minuten
Ergebnis erwartet (expect_output)eingeschalteteingeschaltet
Gemeldete Zahl (items)gültige Rechnungen nach der Validierungtatsächlich übergebene Rechnungen
Fehler aktiv meldenstatus=fail bei Exportfehler oder Validierungsfehlerstatus=fail, wenn weniger versendet als bereitlagen
Feste Laufzeitschwelledeutlich über der üblichen Laufzeitdeutlich über der üblichen Laufzeit

Die Uhrzeit 02:00 hat noch eine Eigenheit. Zu Beginn der Sommerzeit wird die Stundenzählung von 2 Uhr auf 3 Uhr vorgestellt, an ihrem Ende erscheint die Stunde von 2 Uhr bis 3 Uhr zweimal (Sommerzeitverordnung). Beides geschieht sonntags, am letzten Sonntag im März und am letzten Sonntag im Oktober (Sommerzeitverordnung). Ein Werktags-Zeitplan umgeht diese Nächte von selbst; wer täglich in dieser Stunde rechnet, liest vorher den Beitrag zur Zeitumstellung im Monitoring.

Feiertage, Jahreswechsel und Betriebsferien

Ein Werktags-Zeitplan kennt keine Feiertage. Fällt ein Feiertag auf einen Werktag, erwartet der Heartbeat trotzdem eine Meldung, und der Job meldet entweder items=0 oder gar nichts. Beides löst einen Alarm aus. Zum Jahreswechsel 2026/27 betrifft das bundesweit zwei Freitage, den 25. Dezember und den 1. Januar; regionale Feiertage kommen je nach Bundesland hinzu. Der einfachste Weg ist, den Heartbeat vor solchen Tagen zu pausieren, denn pausierte Monitore lösen keine Alarme aus (XICTRAQ®-Dokumentation). Nach dem Fortsetzen beginnt die Frist neu, ein fortgesetzter Monitor ist also nicht sofort überfällig.

Heikler sind Betriebsferien zwischen den Jahren. Bleibt ein Monitor länger als sieben Tage im Zustand „missed“, setzt eine Aufräumroutine ihn automatisch auf „paused“ und löst die offenen Heartbeat-Alarme auf (XICTRAQ®-Dokumentation). Das hält die Alarmliste sauber, hat aber eine Folge: Wer nach zwei Wochen Urlaub zurückkommt, findet einen pausierten Monitor statt eines roten. Ein Alarm, der am 23. Dezember ausgelöst wurde, muss deshalb innerhalb dieser sieben Tage jemanden erreichen, der reagiert.

Dafür gibt es die Eskalation. Mit einer Eskalations-Policy, verfügbar ab dem Business-Tarif, folgen weitere Stufen zeitversetzt, solange niemand den Alarm bestätigt, jede mit eigener Verzögerung, eigenen Kanälen und eigenem Empfänger (XICTRAQ®-Dokumentation). Wie eine Bereitschaft über die Feiertage tragfähig bleibt, beschreibt der Beitrag zur On-Call-Rotation. Kanäle und Stufen stellen Sie unter Alerting und Benachrichtigungen ein.

Der erste Lauf im neuen Jahr

Der Lauf am ersten Werktag 2027 trägt die Vorgänge mehrerer freier Tage, oft auch Jahresrechnungen, und er ist bei vielen der erste unter der neuen Pflicht. Ein Filter, der das alte Jahr erwartet, oder ein Nummernkreis, der erst angelegt werden muss, zeigt sich genau hier als Lauf mit items=0. Wer an diesem Morgen erreichbar ist und den Alarm erwartet, verliert in der Regel nur Stunden.

Laufzeit: wann ein Lauf zu lange dauert

Mit einem Aufruf von /start zu Beginn und dem Ping am Ende berechnet XICTRAQ® die Laufzeit selbst. Für sie gilt eine feste Schwelle, die ohne eigenen Eintrag bei 60 Sekunden liegt (XICTRAQ®-Dokumentation); warum dann fast jeder nächtliche Lauf als langsam gilt, zeigt der Beitrag zum Feed-Export. Beim Rechnungslauf zählt für die Schwelle nicht der Durchschnitt, sondern der längste übliche Lauf: Montags trägt er das Wochenende mit, am ersten Werktag im Januar oft auch Jahresrechnungen. An diesem Lauf orientiert sich die Schwelle, mit Puffer.

Die adaptive Erkennung lernt die normale Laufzeit je Wochenstunde, mit dem Mittelwert plus drei Standardabweichungen über ein gleitendes Fenster (XICTRAQ®-Dokumentation). Ein Rechnungslauf an fünf Werktagen liefert ihr je Wochenstunde nur einen Wert pro Woche, zu wenig für eine belastbare Grundlinie. Für ihn ist die feste Schwelle der passende Weg.

Versand: was zwischen Ping und Postfach liegt

Der zweite Heartbeat meldet den Versand. Sinnvoll ist, dass der Versandjob nicht nur seine eigene Zahl meldet, sondern sie gegen die bereitgelegten Rechnungen hält. XICTRAQ® vergleicht die Zahlen zweier Heartbeats nicht miteinander. Der Job kann das aber selbst tun und bei einer Abweichung status=fail mit einer Notiz wie „39 von 41 Rechnungen versendet“ melden. Dann zeigt der Alarm nicht nur, dass etwas fehlt, sondern wie viel.

invoice-dispatch.sh
#!/usr/bin/env bash
# Versendet die validierten Rechnungen und meldet das Ergebnis.
# Aufruf: invoice-dispatch.sh <heartbeat-slug>
set -uo pipefail

HB="https://api.xictraq.com/api/heartbeat/$1"
DIR="/srv/invoices/$(date +%F)"

# Beginn melden, damit auch der Versand eine Laufzeit bekommt.
curl -fsS -m 10 --retry 3 "$HB/start" >/dev/null || true

READY=$(find "$DIR" -maxdepth 1 -name '*.xml' | wc -l)
SENT=0
for f in "$DIR"/*.xml; do
  [ -e "$f" ] || break
  # Platzhalter für den Versandweg: E-Mail, Portal oder Schnittstelle.
  /opt/erp/bin/send-invoice "$f" && SENT=$((SENT+1))
done

if [ "$SENT" -ne "$READY" ]; then
  curl -fsS -m 10 --retry 3 -G "$HB/ping" \
    --data-urlencode "status=fail" --data-urlencode "items=$SENT" \
    --data-urlencode "output=$SENT von $READY Rechnungen versendet" >/dev/null
  exit 1
fi

curl -fsS -m 10 --retry 3 "$HB/ping?exit_code=0&items=$SENT" >/dev/null

Ein Ping mit exit_code=0 bedeutet hier nur, dass der eigene Mailserver, das Portal oder die Schnittstelle die Rechnungen angenommen hat. Ob eine Mail im Postfach des Kunden landet, entscheidet sich danach. SPF, DKIM und DMARC der eigenen Domain lassen sich mit dem kostenlosen Mail-Check ansehen, die Regeln der großen Postfachanbieter erklärt der Beitrag zur E-Mail-Zustellung 2026. Weil Empfänger den Absender über das DNS prüfen, lohnt außerdem ein Blick auf die Nameserver-Redundanz der eigenen Domain.

Was der Heartbeat nicht sieht

Zwei Heartbeats beantworten, ob der Rechnungslauf und der Versand gelaufen sind, wie viele Rechnungen sie melden und ob sie einen Fehler melden. Vier Lücken bleiben:

  • Format und Inhalt. Ob eine Datei gültig ist, sagt die Validierung im Job; ob Steuersatz und Leistungsbeschreibung stimmen, sagt auch sie nicht vollständig.
  • Eingang beim Empfänger. Der Versand-Ping belegt die Übergabe an Mailserver, Portal oder Schnittstelle. Ob der Kunde die Rechnung annimmt oder ablehnt, erfährt der Absender aus Rückläufern und Rückmeldungen, nicht aus dem Heartbeat.
  • Vollständigkeit gegenüber dem ERP. items ist die Zahl, die der Job meldet. Fehlen einzelne Vorgänge schon im Export, etwa weil sie falsch gebucht sind, sieht der Heartbeat eine kleinere, aber plausible Zahl.
  • Schleichende Abweichungen. Eine Mindestzahl über min_items ist ein fester Wert je Heartbeat. Für Rechnungsläufe mit stark schwankender Menge taugt sie nur als grobe Untergrenze; einen Einbruch gegenüber dem Vortag erkennt sie nicht.

Wie bei Sicherungsläufen gilt auch hier: Der Heartbeat belegt den Lauf, nicht jedes Ergebnis im Einzelnen. Für das Ergebnis bleibt der Blick der Buchhaltung auf offene Posten und Rückläufer, möglichst in einem festen Rhythmus, etwa jeden Montag.

Checkliste vor dem 1. Januar 2027

  • Für jeden automatischen Schritt festhalten, wer ihn betreut und wo er läuft: Export, Erzeugung, Validierung, Versand.
  • Zwei Heartbeats anlegen, einen für Erzeugung und Validierung, einen für den Versand.
  • Zeitplan als Cron-Ausdruck mit der Zone Europe/Berlin, nur Werktage, mit der Startzeit des Laufs.
  • Toleranz auf die längste übliche Laufzeit plus Puffer setzen, höchstens eine Stunde.
  • expect_output einschalten und Validierungsfehler mit status=fail und einer kurzen Notiz melden.
  • Eine feste Laufzeitschwelle deutlich über der üblichen Laufzeit eintragen.
  • Feiertage und Betriebsferien planen: Heartbeat vorher pausieren, danach fortsetzen, Bereitschaft festlegen.
  • Die Alarmkette einmal mit einem echten Alarm testen, bevor der erste Lauf im Januar ansteht.

Ein grüner Testknopf zeigt, dass ein Kanal erreichbar ist, nicht, dass um 02:45 Uhr am ersten Werktag jemand liest. Wie eine Übung mit echtem Alarm abläuft, zeigt der Beitrag Alarmkette testen. Ein absichtlicher Ping mit items=0 zeigt zugleich, wie die Warnung im eigenen Postfach aussieht.

Den Rechnungslauf vor dem Stichtag beobachten

Die E-Rechnung verändert für viele Betriebe weniger die Buchhaltung als den Betrieb: Aus einer Tätigkeit wird ein Job, und ein Job braucht jemanden, der merkt, wenn er steht. Zwei Heartbeats, ein Zeitplan, der Werktage und Feiertage berücksichtigt, und eine Fehlermeldung, die den Validierungsfehler beim Namen nennt, reichen dafür in der Regel aus. Einrichten lässt sich das in den Wochen vor dem Jahreswechsel, solange der alte Weg noch trägt. Die Heartbeats von XICTRAQ® sind ab dem Free-Plan enthalten; Umfang je Tarif und Eskalation stehen auf der Preisseite.

Quellen und Rechtsgrundlagen

Dieser Beitrag stützt sich auf: Umsatzsteuergesetz (UStG), § 14 Abs. 1 und 2 sowie § 27 Abs. 38, Fassung auf gesetze-im-internet.de, abgerufen im November 2026; Bundesministerium der Finanzen, Schreiben vom 15. Oktober 2025 „Einführung der obligatorischen elektronischen Rechnung bei Umsätzen zwischen inländischen Unternehmern ab dem 1. Januar 2025; Anpassung des Umsatzsteuer-Anwendungserlasses“, Rn. 6a, 22 und 35a; Bitkom, Presseinformation „Weniger als die Hälfte deutscher Unternehmen empfängt E-Rechnungen“ vom 3. Dezember 2024, Befragung von 1.103 Unternehmen ab 20 Beschäftigten; Sommerzeitverordnung, § 2; The Open Group Base Specifications Issue 8 (POSIX.1-2024), crontab; XICTRAQ®-Dokumentation „Heartbeats & API-Monitoring“. Die Werte im Bild und in den Skripten sind Beispielwerte. Der Beitrag ersetzt keine Steuerberatung.

Ab wann muss ein Unternehmen E-Rechnungen verschicken?
Für Leistungen an andere im Inland ansässige Unternehmer gilt die Pflicht nach § 14 Abs. 2 UStG mit Übergangsregeln. Für Umsätze des Jahres 2027 dürfen Unternehmen mit höchstens 800.000 Euro Gesamtumsatz im Vorjahr noch Papier oder andere Formate nutzen, und für alle bleibt bis Ende 2027 EDI mit Zustimmung des Empfängers zulässig (§ 27 Abs. 38 UStG). Die Einordnung im Einzelfall gehört in die Steuerberatung.
Prüft XICTRAQ® meine E-Rechnungen auf XRechnung oder ZUGFeRD?
Nein. XICTRAQ® sieht die Rechnungen nicht und prüft kein Format. Es wertet aus, was der Rechnungslauf meldet: ob er sich gemeldet hat, wie viele Rechnungen er nennt, wie lange er lief und ob er einen Fehler meldet. Die Formatprüfung bleibt Aufgabe einer Validierungsanwendung im Job.
Warum zwei Heartbeats statt einem?
Erzeugung und Versand scheitern aus unterschiedlichen Gründen und oft zu unterschiedlichen Zeiten. Mit getrennten Heartbeats zeigt der Alarm in der Regel direkt, welcher Schritt steht. Zwei Heartbeats sind bereits im Free-Plan enthalten (XICTRAQ®-Dokumentation).
Welche Uhrzeit trage ich im Zeitplan des Heartbeats ein?
In der Regel die Startzeit des Laufs, und die Toleranz deckt die übliche Laufzeit ab. Trifft der Ping vor der eingetragenen Uhrzeit ein, bleibt die Fälligkeit desselben Tages offen, und es folgt ein Alarm, obwohl der Lauf fertig ist. Die Toleranz reicht bis 3600 Sekunden (XICTRAQ®-Dokumentation).
Was passiert an Feiertagen, die auf einen Werktag fallen?
Ein Werktags-Zeitplan erwartet auch dann eine Meldung. Pausieren Sie den Heartbeat vorher, denn pausierte Monitore lösen keine Alarme aus (XICTRAQ®-Dokumentation). Nach dem Fortsetzen beginnt die Frist neu.
Belegt ein grüner Heartbeat, dass alle Rechnungen angekommen sind?
Nein. Er belegt den Lauf und die gemeldete Zahl, nicht den Eingang beim Empfänger und nicht die inhaltliche Richtigkeit. Eine Validierung findet zudem nicht jeden Inhaltsfehler, etwa einen falschen Steuersatz (BMF). Rückläufer und offene Posten bleiben deshalb Teil der Kontrolle.

Passend in XICTRAQ®

Anleitungen

In 60 Sekunden starten

Lassen Sie XICTRAQ® Ihre Website bewachen.

Kostenloser Plan ohne feste Laufzeit verfügbar. Keine Kreditkarte, keine Installation, keine versteckten Kosten.