Zum Inhalt
ONE LOOP / Dokumentation / Apps & Verbindungen

Apps & Verbindungen

Angebotsstatus geändert

ONE LOOP: Workflows bei angenommenen oder abgelehnten Angeboten testen. Die allgemeine Verfügbarkeit der Integration 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 ein Angebot in Lexware Office den Status angenommen oder abgelehnt erhält. Er stellt die Angebots-, Kontakt- und Betragsdaten als Workflow-Variablen bereit. Er ändert das Angebot nicht.

Einrichtung

  1. Wähle Angebotsstatus geändert als Workflow-Auslöser.

  2. Lege bei Quotation status fest, auf welche Statusänderung der Workflow hören soll:

    • accepted: Angebot angenommen.

    • rejected: Angebot abgelehnt.

  3. Speichere und veröffentliche den Workflow.

  4. Ändere den Status eines Testangebots und kontrolliere den Workflow-Verlauf.

Wenn Annahme und Ablehnung unterschiedliche Prozesse auslösen sollen, erstelle je einen Workflow mit dem passenden Filter.

Payload-Beispiel

Die folgenden Werte stehen als Variablen im Workflow zur Auswahl. Das Beispiel zeigt eine Annahme:

{ "eventId": "lexware-quotation-9d4e1b7a-accepted-1", "quotationId": "9d4e1b7a-709c-4e2a-b90e-f3c17c721001", "quotationNumber": "ANG-2026-0017", "quotationStatus": "accepted", "previousQuotationStatus": "open", "lexwareContactId": "1d7f56b6-43da-4ec1-9f31-120d88e2a001", "contactId": "contact-one-loop-001", "locationId": "location-one-loop-001", "voucherDate": "2026-08-12", "voucherDateFormatted": "12.08.2026", "expirationDate": "2026-08-26", "expirationDateFormatted": "26.08.2026", "currency": "EUR", "netAmount": 200, "taxAmount": 38, "grossAmount": 238, "lexwareViewUrl": "https://app.lexware.de/permalink/quotations/9d4e1b7a-709c-4e2a-b90e-f3c17c721001", "quotationFileUrl": "https://files.example.test/quotation.pdf", "quotationDocumentId": "document-lexware-001", "providerEventDate": "2026-08-21T10:02:48.000Z", "providerEventDateFormatted": "21.08.2026, 12:02" }

Alle Workflow-Variablen

Ereignis und Angebotsstatus

Variable

Bedeutung und Nutzung

eventId

Eindeutige Kennung dieser Statusänderung. Nutze sie, damit eine Folgeaktion bei erneuter Zustellung nicht doppelt läuft.

quotationId

Interne Lexware-ID des Angebots. Bei einer angenommenen Angebotsbestätigung übergibst du diese Variable an das Feld Quotation der Aktion Auftragsbestätigung erstellen.

quotationNumber

Sichtbare Angebotsnummer für E-Mails, Notizen und interne Hinweise.

quotationStatus

Neuer Status des Angebots: accepted oder rejected.

previousQuotationStatus

Status unmittelbar vor diesem Ereignis. Hilft bei Prüfungen und Protokollen.

Kontakt und Standort

Variable

Bedeutung und Nutzung

lexwareContactId

Interne Lexware-ID des zugehörigen Kontakts.

contactId

Kennung des verknüpften ONE LOOP Kontakts, sofern vorhanden. Nutze sie für kontaktbezogene Folgeaktionen.

locationId

Kennung des Standorts, aus dem der Vorgang stammt. Nützlich für standortübergreifende Abläufe und Protokolle.

Daten und Beträge

Variable

Bedeutung und Nutzung

voucherDate / voucherDateFormatted

Angebotsdatum im Format YYYY-MM-DD bzw. als lesbarer Text.

expirationDate / expirationDateFormatted

Ablaufdatum des Angebots im Format YYYY-MM-DD bzw. als lesbarer Text.

currency

Währung des Angebots, zum Beispiel EUR.

netAmount

Netto-Betrag des Angebots für Berechnungen.

taxAmount

Steuerbetrag des Angebots für Berechnungen.

grossAmount

Brutto-Betrag des Angebots für Berechnungen und Nachrichten.

Variable

Bedeutung und Nutzung

lexwareViewUrl

Direkter Link zum Angebot in Lexware Office. Füge ihn zum Beispiel in eine interne Aufgabe ein.

quotationFileUrl

Download-Link zur Angebotsdatei, sofern verfügbar. Dieser Wert kann leer sein.

quotationDocumentId

Kennung des zugehörigen Dokuments, sofern verfügbar. Dieser Wert kann leer sein.

Zeitpunkt

Variable

Bedeutung und Nutzung

providerEventDate

Technischer Zeitstempel des Ereignisses im ISO-Format.

providerEventDateFormatted

Derselbe Zeitstempel als lesbarer Text für interne Nachrichten.

Praxisbeispiel: angenommene Angebote intern übergeben

Ein Angebot wird in Lexware Office angenommen.

  1. Der Workflow verwendet den Filter accepted.

  2. Der Trigger liefert unter anderem quotationId, quotationNumber, contactId, grossAmount und lexwareViewUrl.

  3. Eine interne Aufgabe erhält den Text: Angebot {{quotationNumber}} wurde angenommen. Betrag: {{grossAmount}} {{currency}}.

  4. Im nächsten Schritt nutzt du Auftragsbestätigung erstellen und übergibst quotationId an dessen Feld Quotation.

  5. Der Workflow-Verlauf enthält die Angebotsnummer und den Link zur Prüfung in Lexware Office.

Bei einer Ablehnung verwendest du einen separaten Workflow mit rejected, zum Beispiel für eine interne Rückmeldung oder eine geplante Nachfassaufgabe.

Grenzen und Prüfung

  • Ereignisse werden mindestens einmal zugestellt. Sichere Folgeaktionen mit eventId gegen doppelte Ausführung ab.

  • Der Trigger reagiert nur auf die Status accepted und rejected.

  • quotationFileUrl und quotationDocumentId sind nur verfügbar, wenn das Angebot zuvor über diese Integration erstellt wurde. Plane leere Werte ein.

  • Beträge sind Zahlen. Wenn du einen formatierten Betrag für einen Text brauchst, bilde ihn in einem nachfolgenden Schritt passend ab.

Prüfe nach einem Test die Angebotsnummer, den neuen Status, die Beträge und lexwareViewUrl im Workflow-Verlauf gegen das Angebot in Lexware Office.

Angebot annehmen und Auftragsbestätigung erzeugen

Im geprüften privaten Ablauf führt ein neu angenommenes Angebot zum richtigen Kontakt und Workflow. Verwende quotationId für die Auftragsbestätigung; quotationNumber ist nur die sichtbare Nummer. Auch der aktuelle Zahlungstrigger benötigt eine sichere Kontaktzuordnung vor seiner Zustellung.

Nach einer Neuinstallation den Angebotsstatus-Trigger neu auswählen, accepted/rejected-Filter und Folgevariablen neu binden, speichern und Workflow veröffentlichen. Ein alter bereits verarbeiteter Statuswechsel ist kein neuer Testfall.

← Zur Artikelübersicht