Ü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. Der Grund steht in der Spalte Ergebnis unter dem Status (Offen, Übergeben, Fehlgeschlagen). Zur Abrechnung an der Zeile öffnet die zugehörige Vorschau.
Erneut übergeben. Das Wiederholen-Symbol an einer nicht erfolgreichen Zeile ö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.
- Schnittstelle:
GET /api/v1/billing-handoffs(Filterstatus:pending,done,error;
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.
Die Liste ist leer. Es wurde noch keine Vorschau übergeben.