Zum Inhalt
ONE LOOP / Dokumentation / Apps & Verbindungen

Apps & Verbindungen

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

  1. Wähle Rechnungszahlung empfangen als Workflow-Auslöser.

  2. Stelle Payment stage ein:

    • any: bei jedem relevanten Zahlungseingang.

    • partial: nur bei Teilzahlungen.

    • final: nur bei der Zahlung, die die Rechnung vollständig ausgleicht.

  3. 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

eventId

Eindeutige Kennung des Ereignisses. Speichere sie vor Folgeaktionen, die bei erneuter Zustellung nicht doppelt laufen dürfen.

invoiceId

Interne ID der Rechnung für Verknüpfungen und Protokolle.

invoiceNumber

Sichtbare Rechnungsnummer, etwa für E-Mails oder interne Notizen.

invoiceUrl

Direkter Link zur Rechnung in Lexware Office.

invoiceStatus

Rechnungsstatus zum Ereigniszeitpunkt; zur Abschlussentscheidung zusätzlich paymentStage und isFullyPaid verwenden.

paymentStatus

Von Lexware gelieferter Zahlungsstatus; nur Zusatzinformation, keine alleinige Abschlussbedingung.

paymentStage

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

paymentAmount / paymentAmountFormatted

Betrag dieser einzelnen Zahlung als Zahl bzw. lesbarer Text.

paymentDate / paymentDateFormatted

Zahlungsdatum im Format YYYY-MM-DD bzw. lesbarer Darstellung.

paymentType

Zahlungsart, sofern geliefert; kann leer sein.

paymentItemCount

Anzahl der Zahlungseinträge, die zum Ereignis gehören.

Zahlungsstand

Variable

Bedeutung und Nutzung

paidAmountTotal / paidAmountTotalFormatted

Summe der erfassten Zahlungen als Zahl bzw. Text.

settledAmountTotal / settledAmountTotalFormatted

Bereits ausgeglichener Gesamtbetrag als Zahl bzw. Text.

remainingAmount / remainingAmountFormatted

Nach diesem Ereignis noch offener Betrag als Zahl bzw. Text.

isPartialPayment

true, wenn nach dem Ereignis noch ein Betrag offen ist.

isFullyPaid

true, wenn die Rechnung vollständig ausgeglichen ist. Als If/Else-Bedingung für Folgeprozesse.

Kontakt und Beträge der Rechnung

Variable

Bedeutung und Nutzung

lexwareContactId

Interne Lexware-ID des Rechnungskontakts.

contactName

Name des Rechnungskontakts, zum Beispiel für Ansprache oder Notizen.

contactEmail

E-Mail-Adresse des Kontakts, sofern vorhanden und für den Prozess passend.

customerNumber

Kundennummer, sofern vorhanden; für Abgleiche mit anderen Systemen.

totalNetAmount

Netto-Gesamtbetrag der Rechnung.

totalTaxAmount

Steuer-Gesamtbetrag der Rechnung.

totalAmount / totalAmountFormatted

Brutto-Gesamtbetrag als Zahl bzw. lesbarer Text.

currency

Währung der Rechnung, zum Beispiel EUR.

Zeitwerte

Variable

Bedeutung und Nutzung

eventDate / eventDateFormatted

Technischer Ereigniszeitpunkt als ISO-Zeitstempel bzw. lesbarer Text.

voucherDate / voucherDateFormatted

Rechnungsdatum als YYYY-MM-DD bzw. lesbarer Text.

dueDate / dueDateFormatted

Fälligkeitsdatum, sofern vorhanden, als YYYY-MM-DD bzw. lesbarer Text.

wasOverdue

true, wenn die Rechnung beim vollständigen Ausgleich überfällig war.

daysOverdue

Anzahl überfälliger Tage, sonst 0.

Praxisbeispiel: nur nach vollständiger Zahlung fortfahren

Eine Rechnung über 238,00 € wird zweimal mit je 119,00 € bezahlt.

  1. Der Trigger steht auf final.

  2. Die erste Teilzahlung startet keinen Workflow-Lauf.

  3. Bei der zweiten Zahlung stehen paymentStage = final, isFullyPaid = true und remainingAmount = 0 bereit.

  4. Eine If/Else-Bedingung prüft isFullyPaid.

  5. Im Ja-Zweig wird eine interne Notiz erstellt: Rechnung {{invoiceNumber}} vollständig bezahlt am {{paymentDateFormatted}}.

  6. Für einen Link zum Beleg verwendest du invoiceUrl.

Grenzen und Prüfung

  • Ereignisse werden mindestens einmal zugestellt. Verhindere doppelte Folgeaktionen mit eventId oder 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.

← Zur Artikelübersicht