Übergaben
Überblick
Eine freigegebene Abrechnungs-Vorschau wird an ihr Ziel übergeben: an die eigene Faktura, die daraus eine Rechnung macht, oder an lexoffice. Diese Seite ist das Protokoll dieser Übergaben — je Übergabe eine Zeile mit Ziel, Ergebnis, Anzahl der Versuche und dem Grund, falls es nicht geklappt hat.
Wohin eine Vorschau geht, entscheidet eine feste Reihenfolge:
- das Ziel je Kunde, falls für diesen Kunden eines hinterlegt ist,
- sonst die Systemeinstellung
finance.billing.handoffTarget, - sonst lexoffice.
Ist das ermittelte Ziel nicht verfügbar — etwa weil die eigene Faktura nicht installiert oder abgeschaltet ist —, geht die Übergabe an lexoffice.
Die Seite steht im Menü als Unterpunkt von Abrechnung.
Kernaufgaben
Fehler finden. Nur Fehler über der Liste zeigt die Übergaben, die wiederholt werden müssen — fehlgeschlagene und aufgegebene. Der Grund steht in der Spalte Ergebnis unter dem Status (Offen, Übergeben, Fehlgeschlagen, Aufgegeben). Zur Abrechnung an der Zeile öffnet die zugehörige Vorschau.
Automatische Wiederholung. Scheitert eine Übergabe — lexoffice nicht erreichbar, Ziel kurz abgeschaltet —, versucht das System es selbst noch einmal, mit wachsendem Abstand: nach 15 Minuten, dann nach 30 Minuten, 1, 2 und 4 Stunden (höchstens 12 Stunden). Wann der nächste Versuch kommt, steht unter dem Status (Nächster Versuch …). Nach dem sechsten gescheiterten Versuch gibt das System auf: Die Zeile steht auf Aufgegeben, und alle, die in der Marke der Abrechnung übergeben dürfen, bekommen einen Hinweis, der direkt auf die aufgegebenen Übergaben führt. Wird die Vorschau zwischendurch wieder in Bearbeitung genommen, endet die automatische Wiederholung. Wer auf das Aufgeben reagieren will — etwa mit einer Aufgabe für die Buchhaltung —, nimmt in einer Automation den Auslöser Übergabe aufgegeben.
Erneut übergeben. Das Wiederholen-Symbol an einer nicht erfolgreichen Zeile — auch einer aufgegebenen — öffnet Übergabe wiederholen. Das Ziel lässt sich dabei wechseln — etwa wenn lexoffice nicht erreichbar ist und die Rechnung stattdessen in der eigenen Faktura entstehen soll. Eine erfolgreiche Übergabe wird nie wiederholt; das ergäbe einen zweiten Beleg.
Ziele je Kunde. Ziele je Kunde legt fest, dass ein einzelner Kunde anders abgerechnet wird als die übrigen. Es gibt einen Eintrag je Kunde; ein zweiter ändert den bestehenden. Das Papierkorb-Symbol nimmt die Ausnahme zurück — danach gilt für den Kunden wieder die Systemeinstellung.
Felder im Detail
Übergabe wiederholen
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Ziel target | nein | Eigene Faktura oder lexoffice | Wohin die Übergabe jetzt gehen soll. Ohne Änderung bleibt es beim bisherigen Ziel. Ein Ziel, das nicht verfügbar ist, wird mit einer Meldung abgewiesen. |
Übergabe-Ziel je Kunde
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Kunde customerId | ja | bestehender Kunde | Für welchen Kunden die Ausnahme gilt. |
Ziel target | ja | Eigene Faktura oder lexoffice | Wohin die Vorschauen dieses Kunden gehen. Ist das Ziel nicht verfügbar, gilt für ihn lexoffice. |
Einstellungen & Rechte
- Modul
module.finance. - Sehen:
finance.billing.view. Wiederholen:finance.lexoffice.syncoder
finance.recurring.manage. Ziele je Kunde: finance.recurring.manage.
- Vorgabe für alle Kunden: die Systemeinstellung
finance.billing.handoffTargetmitinvoicing
(eigene Faktura) oder lexoffice, zu pflegen unter System. Ohne Eintrag gilt lexoffice.
- Wiederholungs-Lauf: alle 15 Minuten im Hintergrund; sechs Versuche insgesamt, Abstand 15 Minuten
und dann jeweils doppelt so lang, höchstens 12 Stunden. Den Hinweis bekommt, wer finance.lexoffice.sync oder finance.recurring.manage in der Marke der Abrechnung hat.
- Schnittstelle:
GET /api/v1/billing-handoffs(Filterstatus:pending,done,error,
gave_up, mehrere mit Komma, z. B. error,gave_up; Feld nextAttemptAt = nächster automatischer Versuch; dazu target, customerId, brandId, previewUlid), POST /api/v1/billing-handoffs/{ulid}/retry mit optionalem target, /api/v1/billing-handoff-targets für die Ziele je Kunde.
FAQ & Fehlerbilder
„Diese Übergabe war bereits erfolgreich und wird nicht wiederholt." Die Zeile steht auf Übergeben. Ein zweiter Versuch legte einen zweiten Beleg an — deshalb ist er gesperrt.
„Das Übergabeziel … ist nicht verfügbar (Modul nicht installiert oder deaktiviert)." Wählen Sie beim Wiederholen das andere Ziel, oder lassen Sie die eigene Faktura aktivieren.
Ein Kunde landet bei lexoffice, obwohl die eigene Faktura eingestellt ist. Entweder ist die eigene Faktura nicht verfügbar, oder für den Kunden steht unter Ziele je Kunde lexoffice.
**Eine Zeile steht auf Aufgegeben.** Sechs Versuche sind gescheitert, das System versucht es nicht mehr selbst. Prüfen Sie den Grund in der Spalte Ergebnis, beheben Sie ihn und wiederholen Sie von Hand — auf Wunsch an das andere Ziel.
Die Liste ist leer. Es wurde noch keine Vorschau übergeben.