Apps & connections
Rechnungszahlung eingegangen
Teil- und Schlusszahlungen mit Trigger 1.5 filtern und dem richtigen Kontakt zuordnen. Die allgemeine Appfreigabe ist noch nicht bestätigt.
Teststatus
Stand 7. November 2026: Lexware Office Connector 9.2.0 ist privat live; vier Dokument-Actions und beide Trigger wurden im freigegebenen ONE LOOP Teststand geprüft. Der Zahlungstrigger 1.5 ist veröffentlicht. Version 9.3.0 befindet sich in öffentlicher Prüfung; eine allgemeine öffentliche Freigabe oder ein kostenpflichtiger Neukundenabschluss ist noch nicht bestätigt.
Was passiert?
Der Trigger startet einen Workflow, wenn Lexware Office eine Zahlung zu einer Rechnung meldet. Er liest das Zahlungsereignis und stellt dessen Daten als Workflow-Variablen bereit; er erstellt oder ändert keine Rechnung.
Einrichtung
Wähle Rechnungszahlung empfangen als Workflow-Auslöser.
Stelle Payment stage ein:
any: bei jedem relevanten Zahlungseingang.partial: nur bei Teilzahlungen.final: nur bei der Zahlung, die die Rechnung vollständig ausgleicht.
Veröffentliche den Workflow und teste mit einer Rechnungszahlung.
Für einen Abschlussprozess wähle final und prüfe zusätzlich isFullyPaid.
Payload-Beispiel
In einem Workflow wählst du diese Werte als Variablen aus. Das folgende vereinfachte Beispiel zeigt einen finalen Zahlungseingang. Version 1.5 liefert zusätzlich die Filterauswahl paymentStageFilter sowie die gebundene contactId und locationId; echte Werte kommen aus deinem Workflow.
{
"eventId": "lexware-payment-invoice-3d6b2a8c-1",
"invoiceId": "3d6b2a8c-6e1b-4d04-b8d2-9a5a28cc9c01",
"invoiceNumber": "RE-2026-0042",
"invoiceUrl": "https://app.lexware.de/permalink/invoices/3d6b2a8c-6e1b-4d04-b8d2-9a5a28cc9c01",
"invoiceStatus": "paid",
"paymentStatus": "paid",
"paymentStage": "final",
"paymentAmount": 119,
"paymentAmountFormatted": "119,00 €",
"paymentDate": "2026-08-21",
"paymentDateFormatted": "21.08.2026",
"paymentType": "bank_transfer",
"paymentItemCount": 1,
"paidAmountTotal": 238,
"paidAmountTotalFormatted": "238,00 €",
"settledAmountTotal": 238,
"settledAmountTotalFormatted": "238,00 €",
"remainingAmount": 0,
"remainingAmountFormatted": "0,00 €",
"isPartialPayment": false,
"isFullyPaid": true,
"eventDate": "2026-08-21T09:31:22.000Z",
"eventDateFormatted": "21.08.2026, 11:31",
"lexwareContactId": "1d7f56b6-43da-4ec1-9f31-120d88e2a001",
"contactName": "Muster GmbH",
"contactEmail": "buchhaltung@muster.de",
"customerNumber": "K-10042",
"totalNetAmount": 200,
"totalTaxAmount": 38,
"totalAmount": 238,
"totalAmountFormatted": "238,00 €",
"currency": "EUR",
"voucherDate": "2026-08-10",
"voucherDateFormatted": "10.08.2026",
"dueDate": "2026-08-20",
"dueDateFormatted": "20.08.2026",
"wasOverdue": true,
"daysOverdue": 1
}
Zahlenwerte sind Beträge in der Rechnungswährung. Formatted-Variablen sind für Texte gedacht; die Zahlenvariablen für Berechnungen.
Alle Variablen
Ereignis und Rechnung
Variable | Bedeutung und Nutzung |
|---|---|
| Eindeutige Kennung des Ereignisses. Speichere sie vor Folgeaktionen, die bei erneuter Zustellung nicht doppelt laufen dürfen. |
| Interne ID der Rechnung für Verknüpfungen und Protokolle. |
| Sichtbare Rechnungsnummer, etwa für E-Mails oder interne Notizen. |
| Direkter Link zur Rechnung in Lexware Office. |
| Rechnungsstatus zum Ereigniszeitpunkt; zur Abschlussentscheidung zusätzlich |
| Von Lexware gelieferter Zahlungsstatus; nur Zusatzinformation, keine alleinige Abschlussbedingung. |
| Tatsächliche Ereignisstufe partial oder final. any ist ausschließlich eine Filterauswahl; für Abschlussprozesse zusätzlich isFullyPaid prüfen. |
Aktuelle Zahlung
Variable | Bedeutung und Nutzung |
|---|---|
| Betrag dieser einzelnen Zahlung als Zahl bzw. lesbarer Text. |
| Zahlungsdatum im Format |
| Zahlungsart, sofern geliefert; kann leer sein. |
| Anzahl der Zahlungseinträge, die zum Ereignis gehören. |
Zahlungsstand
Variable | Bedeutung und Nutzung |
|---|---|
| Summe der erfassten Zahlungen als Zahl bzw. Text. |
| Bereits ausgeglichener Gesamtbetrag als Zahl bzw. Text. |
| Nach diesem Ereignis noch offener Betrag als Zahl bzw. Text. |
|
|
|
|
Kontakt und Beträge der Rechnung
Variable | Bedeutung und Nutzung |
|---|---|
| Interne Lexware-ID des Rechnungskontakts. |
| Name des Rechnungskontakts, zum Beispiel für Ansprache oder Notizen. |
| E-Mail-Adresse des Kontakts, sofern vorhanden und für den Prozess passend. |
| Kundennummer, sofern vorhanden; für Abgleiche mit anderen Systemen. |
| Netto-Gesamtbetrag der Rechnung. |
| Steuer-Gesamtbetrag der Rechnung. |
| Brutto-Gesamtbetrag als Zahl bzw. lesbarer Text. |
| Währung der Rechnung, zum Beispiel |
Zeitwerte
Variable | Bedeutung und Nutzung |
|---|---|
| Technischer Ereigniszeitpunkt als ISO-Zeitstempel bzw. lesbarer Text. |
| Rechnungsdatum als |
| Fälligkeitsdatum, sofern vorhanden, als |
|
|
| Anzahl überfälliger Tage, sonst |
Praxisbeispiel: nur nach vollständiger Zahlung fortfahren
Eine Rechnung über 238,00 € wird zweimal mit je 119,00 € bezahlt.
Der Trigger steht auf
final.Die erste Teilzahlung startet keinen Workflow-Lauf.
Bei der zweiten Zahlung stehen
paymentStage = final,isFullyPaid = trueundremainingAmount = 0bereit.Eine If/Else-Bedingung prüft
isFullyPaid.Im Ja-Zweig wird eine interne Notiz erstellt:
Rechnung {{invoiceNumber}} vollständig bezahlt am {{paymentDateFormatted}}.Für einen Link zum Beleg verwendest du
invoiceUrl.
Grenzen und Prüfung
Ereignisse werden mindestens einmal zugestellt. Verhindere doppelte Folgeaktionen mit
eventIdoder einer eigenen Prüfung.Eine Rechnung kann nach einer zwischenzeitlichen Änderung erneut vollständig bezahlt sein. Behandle jeden neuen Lauf bewusst.
Rückgängig gemachte Zahlungen lösen keinen eigenen Trigger aus.
Werte wie Zahlungsart, Kontakt-E-Mail, Kundennummer oder Fälligkeit können fehlen.
Prüfe nach einem Testlauf im Workflow-Verlauf Rechnungsnummer, Zahlungsbetrag, Restbetrag und isFullyPaid gegen den Vorgang in Lexware Office. invoiceUrl öffnet die passende Rechnung.
Kontaktzuordnung und richtiger Workflow-Zweig
Vor der Zustellung ordnet der aktuelle Zahlungstrigger die Rechnung einem ONE-LOOP-Kontakt im richtigen Standort zu: über die bestehende sichere Zuordnung oder genau einen Treffer mit derselben E-Mail-Adresse. Er legt dabei keinen Kontakt an. Fehlt eine eindeutige Zuordnung, stoppt die Verarbeitung mit invoice_payment_contact_unresolved; wähle keinen beliebigen Kontakt als Ersatz.
Prüfe bei einem Zuordnungsfehler die Rechnungszuordnung, den Standort und die Kontakt-E-Mail. Mehrere gleiche E-Mail-Adressen sind kein eindeutiger Treffer. Nach einer Korrektur zuerst den vorhandenen Ereignis- und Zustellstatus prüfen; einen alten Zahlungsvorgang nicht blind erneut auslösen.
Lege einen eigenen Zahlungszweig an. Für eine Abschlussnachricht eignet sich paymentStage=final beziehungsweise isFullyPaid=true. Eine Teilzahlung darf nicht denselben Abschlusszweig auslösen. Nach Neuinstallation den Trigger neu auswählen und die Zweigbedingungen auf diese neue Instanz binden.
Zahlungsfilter in Version 1.5
Wähle den aktuellen Auslöser „Rechnungszahlung eingegangen“ und den Zahlungsstufenfilter. any verarbeitet Teil- und Schlusszahlungen, partial ausschließlich Teilzahlungen und final ausschließlich die vollständige Zahlung. Die Filterauswahl heißt technisch paymentStageFilter. Die Ausgabe paymentStage bleibt stets die tatsächliche Stufe partial oder final; auch ein any-Workflow erhält keinen Zahlungsstatus any.
Ältere Workflowkarten werden nicht automatisch auf Version 1.5 umgestellt. Bei der Umstellung den neuen Trigger bewusst auswählen, Filter und verwendete Variablen neu zuordnen und den Workflow speichern und veröffentlichen. Bereits verarbeitete Zahlungen nicht zum Test wiederholen.
Für Abschlussaktionen paymentStage=final und isFullyPaid=true prüfen. Bei any kann dieselbe Rechnung nacheinander einen Teilzahlungs- und einen Abschlusslauf auslösen. Beide sind unterschiedliche Ereignisse; eventId dient zur Absicherung doppelter Folgeaktionen.
Ein ausdrücklich abgewiesener Empfänger verhindert im aktuellen Ablauf nicht die Zustellung an andere passende Empfänger. Der Fehler des betroffenen Empfängers bleibt im Verlauf sichtbar. Ein erfolgreicher zweiter Workflow ist daher kein Nachweis, dass alle Zustellungen erfolgreich waren.