lexoffice Integration
Diese Seite ist für die automatisierte Synchronisation von Rechnungen, Kunden und Gutschriften mit lexoffice, einer beliebten Online-Buchhaltungssoftware, vorgesehen. Es gibt derzeit noch keine echte Anbindung an die lexoffice-API (Tickets #1812 und #1822, Stand 2026-08-30) - weder die Verbindungsprüfung noch die Webhook-Registrierung, die Belegliste noch die Synchronisation von Rechnungen, Kunden, Gutschriften oder ganzen Zeiträumen legen einen echten Datensatz in lexoffice an. Eine echte Anbindung erfordert lexoffice-API-Zugangsdaten und eine Betreiber-Entscheidung, ob dieses Merkmal angeboten wird.
Was kann ich hier tun?
- Einen lexoffice-API-Schlüssel probeweise eintragen und „Verbindung testen" anklicken (das zeigt aktuell immer den ehrlichen Hinweis „nicht verfügbar", nie einen echten Verbindungsstatus)
- Eine einzelne Bestellung als Rechnung an lexoffice zu übertragen versuchen (zeigt den ehrlichen Hinweis „nicht verfügbar", keine Bestätigung einer echten Übertragung)
- Mehrere Bestellungen eines Zeitraums in einem Schritt zu übertragen versuchen (Batch-Synchronisation; die Anzahl der gefundenen Bestellungen ist echt, die Übertragung selbst nicht)
- Einen einzelnen Kunden an lexoffice zu übertragen versuchen
- Eine einzelne Gutschrift an lexoffice zu übertragen versuchen
- Das Synchronisations-Protokoll einsehen, um nachzuvollziehen, wann ein Übertragungsversuch stattfand
- Die Steuerzuordnung einsehen, also wie SCS-Steuersätze auf lexoffice-Steuerarten abgebildet werden
- Eine Webhook-URL probeweise eintragen (wird derzeit nicht bei lexoffice registriert)
- Die automatische Synchronisation ein- oder ausschalten
Hinweis zu den Synchronisationsfunktionen (Rechnung/Kunde/Gutschrift/Batch): Bis 2026-08-30 zeigten diese Funktionen eine erfundene „Erfolgreich synchronisiert"-Bestätigung samt erfundener lexoffice-ID an, obwohl kein echter Datensatz in lexoffice entstand (Ticket #1822). Das ist behoben: die Seite zeigt jetzt ausschließlich den ehrlichen Hinweis „nicht verfügbar" - keine erfundene lexoffice-ID mehr.
Schritt für Schritt
- Verbindung testen (noch nicht verfügbar): Tragen Sie oben im Feld „API-Schlüssel" probeweise Ihren lexoffice-API-Schlüssel ein und klicken Sie auf „Verbindung testen". Sie sehen dabei ausschließlich den ehrlichen Hinweis, dass die Anbindung noch nicht eingerichtet ist - keine Organisation, keine Besteuerungsart, kein „Verbunden"-Status.
- Einzelne Rechnung synchronisieren (noch nicht verfügbar): Wechseln Sie zum Tab „Synchronisation" → „Rechnungen", tragen Sie die Bestell-ID ein und klicken Sie auf „Sync". Sie sehen den ehrlichen Hinweis „nicht verfügbar" - keine erfundene lexoffice-Rechnungs-ID.
- Mehrere Rechnungen auf einmal übertragen (noch nicht verfügbar): Legen Sie im Bereich „Batch-Synchronisation" einen Zeitraum fest und klicken Sie auf „Batch Sync". Das Ergebnis zeigt die echte Anzahl gefundener Bestellungen, meldet aber ehrlich, dass keine davon übertragen wurde.
- Verlauf prüfen: Öffnen Sie den Tab „Protokoll", um alle bisherigen Übertragungsversuche mit Status und Zeitpunkt einzusehen.
flowchart LR
A[API-Schlüssel eingeben] --> B[Verbindung testen zeigt ehrlichen Nicht-verfügbar-Hinweis]
B --> C[Rechnung, Kunde oder Gutschrift auswählen]
C --> D[Einzeln oder per Batch übertragen - zeigt ehrlichen Nicht-verfügbar-Hinweis]
D --> E[Eintrag im Synchronisations-Protokoll]
/erp/lexofficeFelder erklärt
| Feld / Element | Bedeutung | Notes/Auswirkung |
|---|---|---|
| API-Schlüssel | Geheimer Zugangsschlüssel aus Ihrem lexoffice-Konto | Wird nur zum Testen und Synchronisieren verwendet, nicht dauerhaft im Klartext im Browser gespeichert |
| Verbindung testen | Zeigt derzeit ausschließlich den ehrlichen Hinweis „nicht verfügbar" | Es gibt noch keine echte Prüfung gegen die lexoffice-API (#1812) |
| Bestell-ID | Eindeutige Kennung einer Bestellung in SELLERLOGIC Commerce Services | Wird benötigt, um eine einzelne Rechnung zu synchronisieren |
| Von / Bis (Batch-Synchronisation) | Zeitraum, dessen Bestellungen übertragen werden sollen | Alle Bestellungen im Zeitraum werden geprüft und ggf. übertragen |
| Synchronisiert / Übersprungen / Fehler | Ergebniszahlen einer Batch-Synchronisation | Solange es keine echte lexoffice-Anbindung gibt (#1822), steht hier immer 0 synchronisiert und alle gefundenen Bestellungen als übersprungen |
| Kunden-ID | Eindeutige Kennung eines Kunden in SCS | Wird benötigt, um einen Kunden als lexoffice-Kontakt zu übertragen |
| Kontaktname | Angezeigter Name des Kunden (echte Messung aus SCS) | Keine Bestätigung einer echten lexoffice-Übertragung (#1822) |
| lexoffice Kontakt-ID | Zeigt derzeit immer „---" an | Es gibt noch keine echte lexoffice-Kontakt-ID (#1822) |
| Gutschrift-ID | Eindeutige Kennung einer Gutschrift in SCS | Wird benötigt, um eine Gutschrift-Übertragung zu versuchen |
| Gutschrift-Nr. / lexoffice Gutschrift-ID | Zeigen derzeit immer „---" an | Es gibt noch keine echte lexoffice-Gutschriftnummer oder -ID (#1822) |
| Datum (Protokoll) | Zeitpunkt der jeweiligen Synchronisation | Bestimmt die Reihenfolge der Protokolleinträge |
| Typ (Protokoll) | Art des übertragenen Datensatzes: Rechnung, Kunde, Gutschrift oder Batch | Zur schnellen Einordnung eines Eintrags |
| Referenz (Protokoll) | ID des betroffenen Datensatzes in SCS | Zur Nachverfolgung, welcher Datensatz gemeint ist |
| lexoffice-ID (Protokoll) | Zugehörige ID in lexoffice, sofern vorhanden | Leer bei Fehlern |
| SCS-Satz / SCS-Bezeichnung | Steuersatz und Bezeichnung, wie er in SCS verwendet wird | Ausgangspunkt der Steuerzuordnung |
| lexoffice-Typ / lexoffice-Bezeichnung | Entsprechende Steuerart und Bezeichnung in lexoffice | Zeigt, wie ein SCS-Steuersatz in lexoffice verbucht wird |
| Webhook-URL | Adresse, an die lexoffice Benachrichtigungen über Änderungen senden soll | Wird derzeit nicht bei lexoffice registriert (#1812) - „Speichern" bestätigt keine echte Registrierung |
| Automatische Synchronisation | Schalter zum Ein-/Ausschalten der automatischen Synchronisation neuer Bestellungen und Kunden | Zeigt eine Bestätigung beim Umschalten an |
Werte & Status
Synchronisationsstatus (Protokoll)
| Label | Bedeutung | Was passiert danach |
|---|---|---|
| Nicht verfügbar | Es gibt noch keine echte lexoffice-Anbindung (#1822) - der Übertragungsversuch wurde protokolliert, aber nichts wurde tatsächlich an lexoffice übertragen | Der Datensatz existiert weiterhin nur in SCS, nicht in lexoffice |
| Fehler | Der Übertragungsversuch ist an einer Eingabeprüfung gescheitert (z. B. ungültiges Schlüsselformat) | Die Meldung im Protokoll zeigt den Grund; ein erneuter Versuch mit korrigierter Eingabe ist möglich |
| Erstellt / Aktualisiert | Historische Status aus der Zeit vor Ticket #1822 | Werden derzeit von keiner Funktion mehr erzeugt - sie erscheinen erst wieder, sobald eine echte lexoffice-Anbindung besteht |
Datensatz-Typen (Protokoll)
| Label | Bedeutung | Was passiert danach |
|---|---|---|
| Rechnung | Eine aus einer Bestellung erzeugte Rechnung | Wird als Rechnung in lexoffice angelegt oder aktualisiert |
| Kunde | Ein Kundendatensatz | Wird als Kontakt in lexoffice angelegt oder aktualisiert |
| Gutschrift | Eine Rückerstattung/Gutschrift | Wird als Gutschrift in lexoffice angelegt oder aktualisiert |
| Batch | Eine Sammel-Synchronisation mehrerer Bestellungen | Fasst mehrere Einzelübertragungen in einem Protokolleintrag zusammen |
Verbindungsstatus
Frühere Versionen dieser Seite zeigten für jeden mindestens 10 Zeichen langen „API-Schlüssel" einen grünen „Verbunden"-Status samt erfundener Organisation und Besteuerungsart an - unabhängig davon, ob überhaupt ein echtes lexoffice-Konto dahinterstand. Das war eine erfundene Anzeige, keine echte Prüfung, und wurde korrigiert (Ticket #1812). Die Seite zeigt jetzt ausschließlich den ehrlichen Hinweis, dass die Verbindungsprüfung nicht verfügbar ist - unabhängig davon, wie der eingetragene API-Schlüssel aussieht.
Häufige Fragen
Wo finde ich meinen lexoffice-API-Schlüssel?
Den API-Schlüssel erstellen und finden Sie in Ihrem lexoffice-Konto unter den Einstellungen für öffentliche API-Zugänge. Sie können ihn hier bereits eintragen - sobald die Anbindung fertig ist, wird die Verbindung damit geprüft.
Was bedeutet „Kleinunternehmer" bei der Besteuerungsart?
Das ist eine steuerliche Sonderregelung (§ 19 UStG) für kleinere Unternehmen, bei der keine Umsatzsteuer ausgewiesen wird. SCS liest diese Einstellung nur aus Ihrem lexoffice-Konto aus, ändert sie aber nicht.
Warum wurde jede Bestellung bei der Batch-Synchronisation übersprungen?
Weil es noch keine echte lexoffice-Anbindung gibt (#1822) - die Anzahl der gefundenen Bestellungen ist eine echte Messung, aber keine davon wird tatsächlich übertragen. Das ändert sich, sobald eine echte lexoffice-API-Anbindung besteht.
Was bedeutet der Status „Nicht verfügbar" im Protokoll?
Es gibt noch keine echte Anbindung an die lexoffice-API. Der Eintrag zeigt, dass ein Übertragungsversuch stattfand, aber nichts wirklich an lexoffice übertragen wurde - keine erfundene Bestätigung.
Wozu dient die Webhook-URL?
Über die Webhook-URL soll lexoffice Ihren Shop künftig automatisch über Änderungen informieren können, ohne dass Sie manuell prüfen müssen. Derzeit wird eine eingetragene Webhook-URL nicht bei lexoffice registriert (#1812) - die Event-Subscriptions-API-Anbindung fehlt noch.