Wie die Terminplanung für Wiederkehrende Rechnungen Tatsächlich Funktioniert

Wenn Sie die wiederkehrende Abrechnung für eine Rechnung aktivieren, "merkt sich" das System nicht einfach, sie erneut zu senden. Es erstellt einen separaten Zeitplan-Datensatz, berechnet ein nächstes Ausführungsdatum, und übergibt diesen Datensatz an einen Hintergrundprozess, der in festen Intervallen nach fälligen Zeitplänen sucht. Dieser Artikel erklärt genau, wie das funktioniert — die Frequenzoptionen, wie das nächste Datum berechnet wird, wenn ein Monat kürzer ist als erwartet, was mit dem Fälligkeitsdatum passiert, und was Sie prüfen sollten, wenn eine wiederkehrende Rechnung nicht wie erwartet versendet wurde.

Was Geschieht, Sobald Sie die Wiederkehrende Abrechnung Aktivieren

Jede Rechnung gehört zu einer Rechnungsgruppe. Wenn Sie diese Gruppe als wiederkehrend markieren und eine Frequenz wählen, schreibt die Plattform eine Zeile in eine dedizierte Zeitplantabelle: Ihre Workspace-ID, die Rechnungsgruppen-ID, die Frequenz, und ein berechnetes next_run_at-Datum. Diese Zeile ist vollständig getrennt von der Rechnung selbst — die Rechnung ist Ihre Vorlage, und der Zeitplan ist die Anweisung, wann sie als Nächstes geklont werden soll.

Wenn Sie die Rechnung später bearbeiten — den Betrag ändern, die Frequenz wechseln, oder die Wiederholung ausschalten — wird der Zeitplan entsprechend aktualisiert. Das Ausschalten der Wiederholung löscht den Zeitplan nicht; es setzt ein Flag, das ihn als inaktiv markiert, sodass die spätere Wiederaktivierung sauber anknüpft, statt einen doppelten Zeitplan zu erzeugen.

Die Vier Frequenzoptionen und Wie das Nächste Datum Berechnet Wird

Vier Frequenzen werden unterstützt: wöchentlich, monatlich, vierteljährlich, und jährlich. Wöchentlich ist am einfachsten — es addiert einfach sieben Tage zum Ankerdatum. Monatlich, vierteljährlich, und jährlich funktionieren alle, indem Kalendermonate (ein, drei, oder zwölf) zum Datum addiert werden.

Der Teil, der sich zu verstehen lohnt, ist, was passiert, wenn der Zielmonat kürzer ist als der Monat, in dem Sie begonnen haben. Wenn Ihr Rechnungsdatum der 31. Januar ist und die Frequenz monatlich, hat der Februar keinen 31. Tag. Ein naives Addieren eines Monats in JavaScript würde das Datum stillschweigend auf den 3. März überlaufen lassen — ein Fehler, der Ihr Abrechnungsdatum jeden Monat weiter nach vorne verschieben würde, bis es irgendwann keinen Sinn mehr ergäbe. Stattdessen erkennt das System, wann der Monatsüberlauf stattgefunden hat, und begrenzt das Datum zurück auf den letzten gültigen Tag des beabsichtigten Monats. Der 31. Januar, monatlich wiederkehrend, wird also zum 28. Februar (oder 29. in einem Schaltjahr), dann zum 31. März, dann zum 30. April — jedes Vorkommen landet auf dem letzten Tag seines Monats, statt vorwärtszurutschen.

Wie das Fälligkeitsdatum Übertragen Wird

Wenn ein neues Vorkommen generiert wird, kopiert das System nicht einfach das Fälligkeitsdatum von der Vorlagenrechnung — es berechnet es neu. Es misst den Abstand in Tagen zwischen dem ursprünglichen Rechnungsdatum und seinem Fälligkeitsdatum (sagen wir, eine Netto-14-Bedingung ist ein 14-tägiger Abstand), und wendet denselben Abstand auf das neue Rechnungsdatum an. Das bedeutet, wenn Sie ursprünglich Netto-14-Bedingungen festgelegt haben, erhält jedes zukünftige Vorkommen automatisch ein Fälligkeitsdatum 14 Tage später, auch wenn die Kalenderdaten jedes Mal unterschiedlich sind.

Was Geklont Wird, und Was Nicht

Jedes neue Vorkommen ist eine wirklich neue Rechnungsgruppe mit eigener ID, keine Bearbeitung der vorherigen. Die Positionsposten, der Kunde, die Währung, und die Vorlageneinstellungen werden alle unverändert übertragen. Was zurückgesetzt wird: Das Rechnungsdatum wird auf heute gesetzt, das Fälligkeitsdatum wird anhand des oben beschriebenen Abstands neu berechnet, der bezahlte Betrag wird auf null zurückgesetzt, und das Zahlungsdatum sowie die Zahlungsmethode werden gelöscht. Wenn Sie eine Basis-Rechnungsnummer festgelegt haben, erhält jedes Vorkommen ein Suffix wie -R2, -R3 und so weiter, sodass Ihre Nummerierungsfolge zur wiederkehrenden Serie zurückverfolgbar bleibt, ohne mit Ihren regulären Rechnungsnummern zu kollidieren.

Wenn die ursprüngliche Vorlagenrechnung inzwischen gelöscht wurde, hat der Zeitplan nichts mehr, wovon er klonen könnte. Statt bei jeder zukünftigen Prüfung stillschweigend zu scheitern oder einen Fehler zu werfen, deaktiviert das System diesen Zeitplan beim ersten Mal, wenn es entdeckt, dass die Quelle fehlt.

Entwurf vs. Gesendet: Was Entscheidet, ob die Neue Rechnung Automatisch Gemailt Wird

Ob die neu generierte Rechnung als Entwurf erstellt oder sofort gesendet wird, hängt von einer Sache ab: ob die Rechnung eine hinterlegte Kunden-E-Mail hat. Wenn ja, wird das neue Vorkommen als "gesendet" markiert, und eine E-Mail geht automatisch an diese Adresse. Wenn keine Kunden-E-Mail hinterlegt ist, wird das Vorkommen stattdessen als Entwurf gespeichert, und nichts wird gemailt — Sie müssten es öffnen und manuell versenden. Dies ist eine bewusste Schutzmaßnahme: Das System mailt niemals stillschweigend ein Dokument an niemanden, aber es blockiert die Automatisierung auch nicht nur, weil Sie nicht jedes Feld ausgefüllt haben.

Wie Oft das System Tatsächlich nach Fälligen Rechnungen Sucht

Ein Hintergrundprozess prüft standardmäßig einmal pro Stunde auf fällige Zeitpläne (konfigurierbar über eine Umgebungsvariable, obwohl die meisten Konten dies nie anfassen). Da Abrechnungsdaten auf Tagesebene liegen — nichts an der wiederkehrenden Abrechnung erfordert Präzision auf Minutenebene — ist eine stündliche Prüfung mehr als ausreichend; es gibt keinen Vorteil, häufiger abzufragen, und es würde nur Serverressourcen verschwenden. Wenn der Prozess läuft, sucht er nach jedem Zeitplan, bei dem next_run_at heute oder früher liegt, generiert die nächste Rechnung für jeden, und schiebt das nächste Ausführungsdatum dieses Zeitplans um ein weiteres Intervall vor. Er verarbeitet bis zu 50 fällige Zeitpläne pro Durchlauf, was auch einen großen Rückstand komfortabel abdeckt, falls der Prozess eine Weile pausiert war.

Wenn Eine Wiederkehrende Rechnung Nicht Versendet Wurde

Die häufigsten Ursachen, nach Wahrscheinlichkeit geordnet: Der Zeitplan wurde deaktiviert, weil die wiederkehrende Abrechnung ausgeschaltet wurde (prüfen Sie den Wiederholungsschalter der Rechnung), die Quell-Vorlagenrechnung wurde gelöscht (der Zeitplan deaktiviert sich selbst stillschweigend), oder es gibt keine Kunden-E-Mail auf der Rechnung, sodass sie korrekt generiert wurde, aber als Entwurf liegen blieb, statt gesendet zu werden. Keiner dieser Fälle ist ein Fehler im zugrunde liegenden Mechanismus — der Zeitplan und der Prozess tun genau das, was ihnen aufgetragen wurde; die übliche Lösung besteht darin, zu prüfen, welche der drei oben genannten Bedingungen auf Ihre spezifische Rechnung zutrifft.

Häufig Gestellte Fragen

Ändert das Bearbeiten eines vergangenen Vorkommens zukünftige Vorkommen? Nein. Jede generierte Rechnung ist unabhängig, sobald sie erstellt wurde. Das Bearbeiten von Vorkommen Nr. 3 hat keine Auswirkung auf Vorkommen Nr. 4 — nur das Bearbeiten der wiederkehrenden Einstellungen im aktiven Zeitplan ändert, was künftig geschieht.

Kann ich mehr als einen wiederkehrenden Zeitplan pro Kunde haben? Ja. Der Wiederholungsstatus wird pro Rechnungsgruppe verfolgt, sodass ein Kunde mehrere unabhängige wiederkehrende Rechnungen haben kann — zum Beispiel einen monatlichen Retainer und eine separate vierteljährliche Wartungsgebühr — die auf völlig unterschiedlichen Zeitplänen laufen.

Was passiert, wenn ich die Frequenz mittendrin ändere? Das nächste Ausführungsdatum wird ab heute mit der neuen Frequenz neu berechnet, sodass die Änderung beim allernächsten Vorkommen wirksam wird, statt rückwirkend.