Apps & Verbindungen
Firmen- und Privatkunden zuordnen
ONE LOOP: Firmen und Privatpersonen in Lexware-Office-Abläufen zuordnen und kontrolliert testen. Die allgemeine Verfügbarkeit 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 löst diese Funktion?
Beim Erstellen einer Rechnung oder eines Angebots muss Lexware Office wissen, ob der aktuelle Workflow-Kontakt eine Firma oder eine Privatperson ist. Die Integration wählt den passenden Kontakt aus, aktualisiert ihn nur unter sicheren Bedingungen oder legt ihn neu an.
So vermeidest du, dass eine bestehende Privatperson ungewollt zu einer Firma geändert wird – oder dass eine Firma mit einem gleichnamigen Privatkontakt vermischt wird.
Der Kundentyp wird nur in Rechnung erstellen und Angebot erstellen gewählt. Eine Auftragsbestätigung verwendet das bereits angenommene Angebot weiter; sie führt keine neue Kundentyp-Auswahl aus.
Das Feld: Lexware customer type
Auswahl in der Action | Technischer Wert | Wann verwenden? | Wie entscheidet die Integration? |
|---|---|---|---|
Detect automatically from CRM contact |
| Standard, wenn die Kontaktpflege zuverlässig ist. | Mit nativer Firmenbezeichnung oder Business ID wird der Kontakt als Firma behandelt; sonst als Privatperson. |
Company / business customer |
| Wenn das Dokument an eine Firma gehen soll. | Erzwingt eine Firmenstruktur, unabhängig davon, ob eine Person im Kontakt eingetragen ist. |
Private person |
| Wenn das Dokument an eine natürliche Person geht. | Erzwingt eine Personenstruktur, unabhängig von einer eventuell vorhandenen Firmenbezeichnung. |
Das Feld ist in beiden Actions Pflicht. Bereits gespeicherte ältere Action-Konfigurationen ohne dieses Feld verhalten sich wie auto.\n\nWichtig: Eine vorhandene Business ID löst bei auto zwar die Firmen-Erkennung aus. Die native Firmenbezeichnung bleibt trotzdem Pflicht; ohne sie wird kein Dokument erstellt.
Welche Kontaktdaten werden benötigt?
Die Integration liest den aktuellen Workflow-Kontakt. Er muss zum aktuellen Standort gehören. Ein Kontakt aus einem anderen Standort oder ein fehlender Kontakt wird nicht verwendet.
Kundentyp | Pflichtdaten | Optionale Daten | Nicht automatisch verwendet |
|---|---|---|---|
Firma | Native Firmenbezeichnung, Straße, Postleitzahl, Ort, zweistelliger Ländercode | E-Mail, Telefon, Umsatzsteuer-ID | Eine Firmenbezeichnung, die nur in einem eigenen Zusatzfeld steht |
Privatperson | Nachname, Straße, Postleitzahl, Ort, zweistelliger Ländercode | Vorname, E-Mail, Telefon | Eine Firmenbezeichnung, wenn du ausdrücklich |
Fehlt eine Pflichtangabe, wird kein Dokument erstellt. Der Workflow liefert dann errorCode = LEX_CUSTOMER_001_REQUIRED_DATA_MISSING. Der Fehler benennt das erste fehlende Feld, etwa companyName oder lastName.
So sieht die Übergabe aus
Du wählst den Kundentyp im sichtbaren Action-Feld. Die Kontaktdaten werden nicht als großer JSON-Block in das Feld kopiert: Sie stammen aus dem aktuellen Workflow-Kontakt.
{
"data": {
"customerEntityType": "company"
},
"extras": {
"locationId": "aktueller-standort",
"contactId": "aktueller-workflow-kontakt"
}
}
Die Integration lädt daraufhin den Kontakt, prüft seinen Standort und verwendet für eine Firma zum Beispiel Firmenbezeichnung und Rechnungsadresse. Für eine Privatperson verwendet sie Vorname, Nachname und Rechnungsadresse.
Die Zuordnungsreihenfolge
Die Prüfung läuft immer in dieser Reihenfolge. Sobald ein sicherer Treffer gefunden wurde, werden spätere Stufen nicht mehr verwendet.
1. Gespeicherte passende Zuordnung
↓ kein passender Treffer
2. Exakte E-Mail-Übereinstimmung
↓ kein passender Treffer
3. Exakte Stammdaten-Übereinstimmung
↓ kein passender Treffer
4. Neuen Lexware-Kontakt anlegen
1. Gespeicherte passende Zuordnung: mapping
Nach einer erfolgreichen Zuordnung speichert die Integration die Verbindung zwischen dem Workflow-Kontakt, dem Standort und dem Lexware-Kontakt. Sie prüft dabei die aktuelle rechtliche Identität:
Firma: Kundentyp, Firmenbezeichnung und – falls vorhanden – Umsatzsteuer-ID.
Privatperson: Kundentyp, Vor- und Nachname.
Passt diese Identität weiterhin, wird der hinterlegte Lexware-Kontakt wiederverwendet. Eine geänderte Anschrift kann dabei sicher aktualisiert werden, sofern der Lexware-Kontakt einfach aufgebaut ist.
2. Exakte E-Mail-Übereinstimmung: email
Gibt es keine passende gespeicherte Zuordnung, sucht die Integration nach exakt derselben E-Mail-Adresse. Groß-/Kleinschreibung und überflüssige Leerzeichen ändern den Vergleich nicht.
Eine gleiche E-Mail-Adresse reicht allein nicht aus. Der gefundene Kontakt muss zusätzlich zum gewählten Kundentyp und zur rechtlichen Identität passen:
Eine Firma wird nicht mit einer Privatperson zusammengeführt.
Bei Firmen dürfen sich Firmenbezeichnung oder Land nicht widersprechen.
Bei Privatpersonen dürfen sich vorhandener Vor- oder Nachname oder das Land nicht widersprechen.
Eine abweichende Umsatzsteuer-ID wird bei Firmen nicht zusammengeführt.
Teilen sich verschiedene Personen oder Firmen dieselbe E-Mail-Adresse, wird kein unpassender Kontakt verändert. Die Prüfung geht stattdessen zur Stammdatenprüfung weiter oder legt einen neuen Kontakt an.
3. Exakte Stammdaten-Übereinstimmung: master_data
Ohne sicheren E-Mail-Treffer sucht die Integration nach einer vollständigen Übereinstimmung der Stammdaten:
Kundentyp | Vergleichte Daten |
|---|---|
Firma | Firmenbezeichnung, Land, Postleitzahl und Straße; zusätzlich passende rechtliche Identität |
Privatperson | Vorname, Nachname, Land, Postleitzahl und Straße |
Nur ein Name allein genügt nicht. Mindestens drei Zeichen im Suchnamen sind erforderlich. Schreibweisen werden für den Vergleich vereinheitlicht, zum Beispiel bei Groß-/Kleinschreibung und mehrfachen Leerzeichen.
4. Neuanlage: created
Findet die Integration keinen sicheren Treffer, legt sie einen neuen Lexware-Kontakt mit dem gewählten Kundentyp an:
Firma: Firmenbezeichnung, Rechnungsadresse, optionale E-Mail und optionales Telefon.
Privatperson: Vorname, Nachname, Rechnungsadresse, optionale E-Mail und optionales Telefon.
Danach speichert sie die neue Zuordnung für spätere Dokumente.
Was passiert bei einem Wechsel zwischen Firma und Privatperson?
Ein bestehender Lexware-Kontakt wird niemals von Privatperson zu Firma oder von Firma zu Privatperson umgewandelt.
Beispiel:
Dein Kontakt „Max Mustermann“ wird bisher als Privatperson abgerechnet.
Später ergänzt du die Firma „Muster GmbH“ und wählst
company.Die alte Privatperson bleibt für frühere Dokumente erhalten.
Die Integration verwendet einen passenden bestehenden Firmenkontakt oder legt einen neuen Firmenkontakt an.
Wechselt der Kontakt später wieder zurück, kann die frühere passende Privatpersonen-Zuordnung wiederverwendet werden.
Damit bleiben historische Dokumente und ihre ursprüngliche Kontaktform nachvollziehbar.
Wann wird ein vorhandener Kontakt aktualisiert?
Ein wiederverwendeter Kontakt wird nur aktualisiert, wenn dies sicher ist. Als einfach gilt ein Kontakt, wenn in jeder gespeicherten Adress-, E-Mail- und Telefonart höchstens ein Wert liegt und – bei Firmen – höchstens eine Kontaktperson vorhanden ist.
Situation | Verhalten | Hinweis im Ergebnis |
|---|---|---|
Einfacher Kontakt, E-Mail passt oder ist noch nicht vorhanden | Kontaktdaten können aktualisiert werden. |
|
Komplexer Kontakt mit mehreren Einträgen | Kontakt wird verwendet, aber nicht automatisch geändert. |
|
Bestehende E-Mail weicht von der Workflow-E-Mail ab | Kontakt wird verwendet, aber die E-Mail wird nicht überschrieben. |
|
Was passiert bei mehrfachen gleichen Treffern?
Gibt es mehrere vollständig identische Lexware-Kontakte, blockiert die Integration die Dokumenterstellung nicht. Sie wählt den Treffer nachvollziehbar aus:
zuerst die niedrigere Kundennummer,
bei gleicher oder fehlender Kundennummer die niedrigere technische Kontakt-ID.
Der Workflow erhält zusätzlich die Warnung LEX_CONTACT_W003_DUPLICATE_IDENTITY_MATCH_SELECTED in warnings. Prüfe diesen Fall später in Lexware Office und bereinige die doppelten Kontakte bewusst.
Beziehung zu Steuerfeldern
Kundentyp und Steuerart sind zwei getrennte Einstellungen. Das Wählen von company aktiviert keine besondere Steuerart automatisch.
Die Steuerarten intraCommunitySupply, constructionService13b, externalService13b, thirdPartyCountryService und thirdPartyCountryDelivery sind nur für Firmen zulässig. Bei Privatpersonen stoppt der Workflow vor der Kontaktanlage mit LEX_CONTACT_006_COMPANY_REQUIRED_FOR_TAX_TYPE.
Für intraCommunitySupply muss außerdem eine Umsatzsteuer-ID am Firmenkontakt vorhanden sein. Fehlt sie, lautet der Fehler LEX_CONTACT_005_VAT_ID_REQUIRED.
Die Ergebnisvariablen verstehen und verwenden
Nach Rechnung erstellen oder Angebot erstellen prüfst du diese Variablen im nächsten Schritt:
Variable | Mögliche Werte / Bedeutung | So setzt du sie ein |
|---|---|---|
| Technische ID des tatsächlich verwendeten Lexware-Kontakts. | Für Protokolle oder technische Folgeaktionen verwenden. |
|
| In einer Notiz protokollieren oder bei |
|
| If/Else: bei |
|
| In einem Änderungsprotokoll verwenden. |
| Zusätzliche Hinweise ohne zwingenden Fehler. | Vor einer automatischen Folgeaktion auf Warnungen prüfen. |
|
| Erst dann mit Dokumentnummer oder Datei-Link weiterarbeiten. |
| Fehlerkennung und verständliche Fehlerbeschreibung. | Im Fehlerzweig des Workflows speichern oder an die zuständige Person geben. |
Realistisches Beispiel: Neuer Firmenkunde trotz gleicher E-Mail
Ein Kontakt „Anna Beispiel“ ist als Privatperson in Lexware Office vorhanden. Später bestellt die „Beispiel GmbH“ über dieselbe E-Mail-Adresse.
In Rechnung erstellen wählst du Company / business customer.
Der Workflow-Kontakt enthält die native Firmenbezeichnung „Beispiel GmbH“ sowie vollständige Rechnungsadresse.
Die E-Mail-Suche findet den bestehenden Privatkontakt, erkennt aber den anderen Kundentyp.
Der Privatkontakt wird nicht geändert.
Die Integration sucht nach einem passenden Firmenkontakt und legt ihn an, falls keiner vorhanden ist.
Der Workflow liefert
customerMatchMethod = created,customerCreated = trueund die neuelexwareContactId.Im nächsten Schritt erstellst du mit diesen Werten eine interne Prüfnachricht.
Ergebnis prüfen
Nach einem Testlauf:
Prüfe im Workflow-Verlauf
customerMatchMethod,customerCreated,customerUpdated,warningsundlexwareContactId.Öffne den zurückgegebenen
lexwareViewUrlund kontrolliere den verwendeten Kontakt in Lexware Office.Teste mindestens diese Fälle getrennt: Privatperson, Firma, gleicher E-Mail-Wert bei unterschiedlichen Kundentypen und Wechsel von Privatperson zu Firma.
Prüfe bei Firmen mit besonderer Steuerart zusätzlich die Umsatzsteuer-ID.
Typische Fehler vermeiden
Verwende für eine Firma die native Firmenbezeichnung des Workflow-Kontakts, nicht nur ein eigenes Zusatzfeld.
Wähle
companybewusst, wenn ein Kontakt sowohl persönliche als auch Firmenangaben enthält.Überschreibe Warnungen nicht: Sie bedeuten, dass die Dokumenterstellung zwar fortgesetzt wurde, eine automatische Kontaktänderung aber ausgelassen wurde.
Nutze
customerMatchMethodundcustomerCreatedfür einen transparenten internen Prüfpfad.Ändere einen bestehenden Kontakt nicht manuell zwischen Firma und Privatperson, um eine alte Zuordnung „passend zu machen“. Lege oder verwende die korrekte rechtliche Identität.