Skip to content
ONE LOOP / Documentation / Apps & connections

The source documentation is currently available in German. No English translation is implied.

Apps & connections

Angebot erstellen

ONE LOOP: Ein Angebot in Lexware Office erstellen, das offizielle PDF am Kontakt speichern und die zurückgegebenen Daten im Workflow weiterverwenden.

Die Action Create Quotation erstellt ein finalisiertes Angebot in Lexware Office, speichert dessen offizielles PDF im aktuellen Kontakt und gibt die finalen Daten an den Workflow zurück.

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.

Kundentyp und Kontaktzuordnung

Das Pflichtfeld Lexware customer type bestimmt, ob das Dokument einer Firma oder einer Privatperson zugeordnet wird. Die Integration prüft zuerst eine bestehende, passende Zuordnung; danach eine exakte E-Mail- oder Stammdatenübereinstimmung und legt erst dann einen neuen Lexware-Kontakt an. Ein Wechsel von Privatperson zu Firma wandelt keinen bestehenden Kontakt um.

Die vollständige Entscheidungskette, Pflichtdaten, Rückgabevariablen und Fehlerfälle findest du unter Firmen- und Privatkunden zuordnen.

Wann diese Action passt

  • Nach einem Formular, Termin oder einer Verkaufschance

  • Mit Produkten aus dem CRM

  • Mit eigenen Positionen aus Workflow-Variablen

Die Action erstellt kein Zahlungsereignis und keinen öffentlichen Annahme-Link.

Positionsquelle

Auswahl

Technischer Wert

Verwendung

CRM products

product

Produkte und EUR-Beträge sind im CRM gepflegt.

Map my own fields

manual

Positionen und Steuerwerte kommen aus Feldern im Workflow.

Eine Quelle aus bezahlten Vorgängen gibt es bei Angeboten bewusst nicht.

Gemeinsame Felder

Feld / Referenz

Pflicht

Format und Standard

Bedeutung

Title / title

Nein

Text bis 25 Zeichen

Angebotsüberschrift; leer verwendet den Lexware-Standard.

Introduction / introduction

Nein

Text bis 2.000 Zeichen

Text vor den Positionen.

Remark / remark

Nein

Text bis 2.000 Zeichen

Text nach den Positionen.

Expiration Date / expirationDate

Ja

Exakt YYYY-MM-DD, z. B. 2026-09-30

Gültigkeitsdatum. Ungültige Kalendertage werden abgewiesen.

Lexware customer type / customerEntityType

Ja

auto, company, person

Kontaktstruktur in Lexware Office.

Produkt- und manuelle Felder

Für CRM products gelten bis zu zehn Plätze mit productNSelection und optional productNQuantity; die Menge ist leer standardmäßig 1. Die Produkt-Auswahl verbindet genau ein Produkt mit einem EUR-Betrag und wird serverseitig erneut geprüft.

Für Map my own fields sind die Positionen identisch aufgebaut wie bei Rechnung erstellen:

Feldmuster

Pflicht

Bedeutung

itemNName

Bei genutzter Position

Bezeichnung der Position.

itemNDescription

Nein

Zusätzliche Beschreibung.

itemNQuantity

Bei genutzter Position

Positive Menge, leer = 1.

itemNUnit

Nein

Einheit, leer = Stück.

itemNUnitPrice

Bei genutzter Position

EUR-Betrag je Einheit.

itemNTaxRate

Bei genutzter Position

Steuersatz ohne Prozentzeichen.

itemNDiscount

Nein

Rabatt in Prozent, leer = 0.

taxType, taxSubType, taxTypeNote, customerVatId

Steuerfallabhängig

Steuerart, Unterart, Hinweis und USt-IdNr.

Payload-Beispiel

{ "data": { "sourceMode": "manual", "customerEntityType": "auto", "title": "Angebot", "expirationDate": "2026-09-30", "taxType": "net", "item1Name": "Konzept-Workshop", "item1Quantity": "1", "item1Unit": "Pauschale", "item1UnitPrice": "1200.00", "item1TaxRate": "19" }, "extras": { "locationId": "location_example_123", "contactId": "contact_example_123", "executionId": "execution_example_123" }, "meta": { "key": "one_loop_lexware_create_quotation" } }

Alle Ausgabevariablen

Variable

Bedeutung im Workflow

success, status

Vollständiger Erfolg und Ergebnisstatus.

errorCode, errorMessage, retryable, warnings

Fehler- und Hinweiswerte für Prüfung oder interne Benachrichtigung.

sourceMode, sourceReferenceType, sourceReferenceId

Verwendete Quelle und technische Zuordnung.

lexwareContactId, customerMatchMethod, customerCreated, customerUpdated

Ergebnis der Kontaktauflösung.

quotationId

Lexware-Kennung des Angebots.

quotationNumber

Sichtbare Angebotsnummer.

quotationStatus

Status, etwa open.

voucherDate, expirationDate

Beleg- und Gültigkeitsdatum.

currency, netAmount, taxAmount, grossAmount

Währung und finale Gesamtwerte.

officialDocumentMimeType, officialDocumentFileName

Typ und Name des offiziellen Dokuments.

quotationDocumentId

Kennung der PDF-Kopie am Kontakt; nicht die Lexware-Angebots-ID.

quotationFileUrl

URL der PDF-Kopie für nachfolgende Workflow-Schritte.

quotationFileName, quotationMimeType

Dateiname und Typ der PDF-Kopie.

contactDocumentStatus

Bei vollständigem Erfolg uploaded.

lexwareViewUrl

Interner Lexware-Link; nicht öffentlich versenden.

customerCenterAvailable

In Version 1 immer false.

customerCenterUrl, quotationAcceptUrl

In Version 1 immer leer. Es wird kein Annahme-Link erzeugt.

Praxisbeispiel: Angebot in Auftragsbestätigung überführen

  1. Mit dieser Action ein Angebot erstellen.

  2. Den Trigger Angebotsstatus geändert mit Filter accepted anlegen.

  3. In der Action „Auftragsbestätigung erstellen“ die Trigger-Ausgabe quotationId in das Feld quotationId mappen.

  4. Anschließend orderConfirmationFileUrl für die interne Weiterverarbeitung verwenden.

CRM-Produkte und vollständige Steuerdaten

Bei CRM-Produkten stammen Steuerart, Steuersatz und Netto-/Bruttobezug aus der zugehörigen Produktkonfiguration. Rechnung und Angebot können auch feste Produktsteuern verwenden, die erst über die vollständigen Produktdaten aufgelöst werden. Produkt und Preis müssen zum aktuellen Standort gehören. Automatische Steuern bleiben ohne verbindlich berechnete Steuerergebnisse ungeeignet; die App rät keinen Satz und ersetzt die Produktsteuer nicht durch manuelle Angaben.

Prüfe im ersten passenden Lauf die gewählte Produkt-Preis-Kombination, Menge, Netto-/Bruttosumme, Steuer und das offizielle PDF. Eine erfolgreiche manuelle Position belegt nicht automatisch denselben CRM-Produktfall.

← Back to articles