Apps & connections
Rechnung erstellen
ONE LOOP: Eine Rechnung in Lexware Office erstellen, das offizielle PDF am Kontakt speichern und die geprüften Belegdaten im Workflow weiterverwenden.
Die Action Create Invoice erstellt eine finalisierte Rechnung in Lexware Office, speichert das offizielle PDF im aktuellen Kontakt und liefert die geprüften Belegdaten 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 einer erfolgreichen Zahlung
Mit Produkten, die im CRM gepflegt sind
Mit eigenen Werten aus Formularen, Terminen, Webhooks oder vorherigen Workflow-Schritten
Die Action versendet keine E-Mail. Wenn du ein Dokument weitergeben möchtest, verwende danach die Ausgabe invoiceFileUrl.
Sichtbares Feld: Positionsquelle
Auswahl | Technischer Wert | Wann verwenden? | Was die Integration prüft |
|---|---|---|---|
Paid transaction |
| Rechnung direkt nach einer erfolgreichen Zahlung | Transaktion, Bestellung, Positionen, Steuer, Versand, Kontakt und Standort |
CRM products |
| Positionen sind als Produkte im CRM angelegt | Produkt-Preis-Auswahl, EUR-Währung und Produktsteuer |
Map my own fields |
| Positionen kommen aus Workflow-Variablen | Deine Positions- und Steuerfelder |
Bei Paid transaction wird im Ergebnis sourceMode=purchase zurückgegeben. Das ist die interne Normalisierung und kein Fehler.
Allgemeine Felder
Feld / Referenz | Pflicht | Format und Standard | Bedeutung |
|---|---|---|---|
Title / | Nein | Text bis 25 Zeichen | Überschreibt den Dokumenttitel für diese Rechnung. Leer verwendet den Lexware-Standard. |
Introduction / | Nein | Text bis 2.000 Zeichen | Text vor den Positionen. |
Remark / | Nein | Text bis 2.000 Zeichen | Text nach den Positionen. |
Payment term in days / | Nein | Ganze Zahl von | Zahlungsziel in Tagen. |
Lexware customer type / | Ja |
|
|
Der Kundentyp legt die Kontaktstruktur fest, nicht die Steuerart. Ein bestehender Kontakt wird nicht still von Privatperson zu Unternehmen oder umgekehrt umgewandelt.
Felder bei „Paid transaction“
Feld / Referenz | Pflicht | So verwendest du es |
|---|---|---|
Transaction ID / | Ja | Im Variablen-Picker die Transaktions-ID des vorausgehenden Zahlungsereignisses auswählen. |
In diesem Modus sind manuelle Steuerüberschreibungen nicht erlaubt. Die Integration akzeptiert nur erfolgreiche EUR-Zahlungen für den aktuellen Kontakt und Standort. Versand wird bei Bedarf mit passenden Steueranteilen als Position ergänzt. Jeder Betrag muss centgenau zum Zahlungsvorgang passen.
Felder bei „CRM products“
Es stehen zehn Positionsplätze zur Verfügung. Leere optionale Plätze werden ignoriert.
Feldmuster | Pflicht | Format und Standard | Bedeutung |
|---|---|---|---|
| Position 1 ja | Auswahl „Product & Price“ | Ein Produkt mit genau einem zugehörigen EUR-Betrag auswählen. |
| Nein | Positive Zahl, leer = | Menge des Produkts; |
Die Integration verwendet nur EUR-Beträge. Die Steuer kommt aus der Produktkonfiguration; sie kann in diesem Modus nicht manuell überschrieben werden.
Felder bei „Map my own fields“
Steuerfelder
Feld / Referenz | Pflicht | Zulässige Werte | Bedeutung |
|---|---|---|---|
Tax Type / | Ja |
| Legt fest, ob Positionsbeträge netto oder brutto sind bzw. welcher unterstützte Sonderfall gilt. |
Tax Subtype / | Nein | leer, | Ergänzt die passende Steuerart. |
Tax Note / | Nein | Freitext | Steuerlicher Hinweis. |
Customer VAT ID / | Je nach Steuerart | USt-IdNr. als Text | Nur verwenden, wenn der gewählte Steuerfall sie verlangt. |
Positionsfelder
Für jede Position N von 1 bis 10 stehen diese Felder bereit:
Feldmuster | Pflicht | Format und Standard | Bedeutung |
|---|---|---|---|
| Position 1 ja; weitere nur bei Nutzung | Text | Bezeichnung. Eine Position ohne Namen wird ignoriert. |
| Nein | Text | Zusätzliche Beschreibung. |
| Bei genutzter Position ja | Positive Zahl, leer = | Menge ohne Einheit. |
| Nein | Leer = | Erlaubt: |
| Bei genutzter Position ja | EUR-Zahl ohne Zeichen, z. B. | Betrag je Einheit; bei |
| Bei genutzter Position ja | Zahl ohne Prozentzeichen, z. B. | Steuersatz der Position. |
| Nein | Prozent ohne Zeichen, leer = | Positionsrabatt, z. B. |
Payload-Beispiel
Du schreibst diesen JSON-Block nicht selbst. Er zeigt, welche Werte nach deiner Feldzuordnung ankommen.
{
"data": {
"sourceMode": "manual",
"customerEntityType": "company",
"title": "Rechnung",
"paymentTermDuration": "14",
"taxType": "net",
"item1Name": "Beratung August",
"item1Quantity": "2",
"item1Unit": "Stunde",
"item1UnitPrice": "150.00",
"item1TaxRate": "19",
"item1Discount": "0"
},
"extras": {
"locationId": "location_example_123",
"contactId": "contact_example_123",
"executionId": "execution_example_123"
},
"meta": {
"key": "one_loop_lexware_create_invoice"
}
}
Das Ergebnis dieses Beispiels ist netto 300,00 EUR, Steuer 57,00 EUR und brutto 357,00 EUR.
Alle Ausgabevariablen
Variable | Bedeutung im Workflow |
|---|---|
|
|
| Ergebnisstatus; bei Erfolg |
| Maschinenlesbarer Fehlercode; bei Erfolg leer. |
| Verständliche Fehlermeldung; bei Erfolg leer. |
| Kennzeichnet einen möglichen vorübergehenden Fehler. |
| Liste zusätzlicher Hinweise. |
|
|
| Art der Quelle, etwa |
| Kennung der verwendeten Quelle. |
| Kennung des verwendeten Lexware-Kontakts. |
| Wie der Kontakt gefunden wurde: Zuordnung, E-Mail, Stammdaten oder neu erstellt. |
|
|
|
|
| Lexware-Kennung der Rechnung. |
| Sichtbare Rechnungsnummer. |
| Status der Rechnung, etwa |
| Belegdatum im ISO-Format. |
| Währung, aktuell |
| Final zurückgelesene Netto-, Steuer- und Bruttosumme. |
| Typ und Name des offiziellen Dokuments. |
| Kennung der PDF-Kopie am Kontakt; nicht die Lexware-Rechnungs-ID. |
| URL der PDF-Kopie für den nächsten Workflow-Schritt. |
| Dateiname und MIME-Typ dieser PDF-Kopie. |
| Bei vollständigem Erfolg |
| Interner Link zu Lexware Office, nicht als öffentlicher Link verwenden. |
Praxisbeispiel
Nach der Action folgt eine interne Nachricht oder ein Dokument-Schritt. Wähle im Variablen-Picker dieser Rechnungs-Action:
Rechnungsnummer: invoiceNumber
PDF: invoiceFileUrl
Bruttobetrag: grossAmount
Vor dem Weitergeben prüfen: success=true und contactDocumentStatus=uploaded.
Häufige Fragen: Documents & Contracts mit Direct Payment
Warum kann ein Käufer zwei Rechnungen oder E-Mails sehen?
Warnung:
Bekannte Plattformbeschränkung
Bei Documents & Contracts mit aktivierter Option Direct Payment erzeugt die Plattform technisch zwingend eine eigene Rechnung als Zahlungsobjekt. In der aktuell beobachteten Oberfläche lässt sich Send Invoice bei aktivem Direct Payment nicht unabhängig deaktivieren. Dadurch kann die Plattform zusätzlich automatisch eine eigene Rechnungs-E-Mail an den Käufer senden.
Die ONE LOOP App erstellt nach erfolgreicher Zahlung zusätzlich die fachliche und offizielle Rechnung in Lexware Office. Der Käufer kann dadurch zwei Rechnungsdarstellungen oder zwei Rechnungsnachrichten sehen: eine von der Plattform und eine von Lexware Office. Das ist keine zweite Belastung und keine zweite Zahlung, kann aber buchhalterisch und in der Kommunikation missverständlich sein.
Das Abschalten des Invoice-Moduls in der Standortkonfiguration verhindert diesen internen Documents-&-Contracts-Invoice-Prozess derzeit nicht zuverlässig. ONE LOOP kann die von der Plattform erzeugte Rechnung oder E-Mail mit dieser Marketplace-App nicht unterdrücken. Der Scope
invoices.readonlyist ausschließlich lesend: Er erzeugt oder versendet keine Rechnung, sondern wird bei diesem Quelltyp nur benötigt, um die bereits erzeugten Positions- und Steuerdaten sicher für Lexware Office auszulesen.Wenn auf keinen Fall eine plattformseitige Rechnung oder E-Mail entstehen darf, nutze Documents & Contracts nur für Unterschrift oder Annahme, deaktiviere Direct Payment und sende anschließend im Workflow einen separaten Payment Link. Nach erfolgreicher Zahlung führst du die Lexware-Action aus. Alternativ kannst du Direct Payment verwenden und akzeptierst die zusätzliche plattformseitige Rechnung/E-Mail als aktuelle Plattformbeschränkung.
Was soll ich wählen?
Wähle den Payment-Link-Ablauf, wenn keine plattformseitige Rechnung und keine zusätzliche plattformseitige Rechnungs-E-Mail entstehen darf.
Wähle Direct Payment nur, wenn die zusätzliche plattformseitige Rechnung/E-Mail als aktuelle Plattformbeschränkung für diesen Verkauf akzeptiert werden kann.
Mehr zum grundsätzlichen Verhalten von Direct Payment und Invoice-Versand findest du in der offiziellen Plattformreferenz.
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.