# Shopify lexoffice Schnittstelle

*Shopify → lexoffice*

**Kurz gesagt:** Eine Shopify-lexoffice-Anbindung macht aus jeder bezahlten Shopify-Bestellung den passenden lexoffice-Datensatz - eine festgeschriebene Rechnung oder einen Beleg - mit dem Kunden als eindeutigem lexoffice-Kontakt, Positionen und Versand im richtigen Steuersatz (19 % oder 7 %) und Erstattungen als Rechnungskorrektur statt als Änderung an einem gesperrten Dokument. Richtig gemacht ist das kein nächtlicher CSV-Import, sondern eine idempotente Pipeline, die das lexoffice-Ratelimit und die GoBD-Unveränderbarkeit respektiert - Ihre Buchhaltung bleibt sauber, ohne dass jemand Bestellungen abtippt.

## Was eine Shopify-lexoffice-Anbindung wirklich leistet

Shopify erfasst alles zu einem Verkauf - den Kunden, die Positionen, den Rabattcode, den Versand, die ausgewiesene Umsatzsteuer, die Erstattung drei Tage später. lexoffice (heute lexware office) braucht denselben Verkauf als saubere Buchhaltung: einen Kontakt für den Käufer, eine Rechnung oder einen Beleg mit dem richtigen Steuersatz auf jeder Zeile und eine Rechnungskorrektur, wenn Geld zurückgeht. Dazwischen steckt erstaunlich viel Fachurteil, das ein CSV-Import oder ein generisches Plugin schlicht nicht trifft.

Eine Shopify-lexoffice-Anbindung schließt diese Lücke automatisch. Sie liest jede relevante Bestellung und Erstattung aus Shopify, findet oder erstellt den passenden lexoffice-Kontakt und schreibt eine korrekt besteuerte Rechnung oder einen Beleg - ohne dass Ihre Buchhaltung eine Zahl abtippt und ohne dass sich Dubletten in den Kontakten stapeln.

## Welche Daten fließen

| Vorgang in Shopify | Wird in lexoffice zu | Hinweis |
| --- | --- | --- |
| Bezahlte Bestellung | Festgeschriebene Rechnung oder Beleg | Wahl hängt davon ab, wer die Rechnung ausstellt; einmalig abgestimmt |
| Kunde / Rechnungsadresse | Kontakt (Rolle Kunde / Debitor) | Dublettenabgleich über E-Mail und Adresse |
| Positionen | Rechnungs- bzw. Belegzeilen | Netto- oder Bruttopreis plus Steuersatz je Position |
| Rabattcode | Positions- oder Belegrabatt | So gesetzt, dass die Belegsumme der Shopify-Summe entspricht |
| Versandzeile | Eigene Position | Versand ist steuerbar und braucht eigene Zeile und Steuersatz |
| Steuerpositionen | `taxType` + Steuersatz (19 % / 7 %) | Inland unkritisch; grenzüberschreitend ist der schwierige Teil |
| Erstattung / Teilerstattung | Rechnungskorrektur | Verweist auf das Original; das Original bleibt gesperrt |
| Zahlung / Transaktion | Dokument als bezahlt markiert | Optional, wo lexoffice den Zahlstatus führt |
| Auszahlung & Gebühren | Bankbuchung / Aufwandsbeleg | Im lexoffice-Bankabgleich, nicht auf der Verkaufsrechnung |

Das Mapping - welche Bestellungen zu Belegen werden, welcher Steuersatz wo gilt, wie Kontakte abgeglichen werden - stimmen wir einmalig ab und hinterlegen es in der Pipeline. Danach ordnet niemand mehr eine Bestellung von Hand zu.

## Die Details, an denen einfache Syncs scheitern

Ein nächtlicher Export oder eine Connector-App von der Stange bringt Sie fast ans Ziel und lässt die teuren Sonderfälle auf Ihrem Schreibtisch:

- **Kontakt-Dubletten.** lexoffice erzwingt keine eindeutige E-Mail bei Kontakten, und Gast-Bestellungen in Shopify tragen keine dauerhafte Kunden-ID. Ohne Abgleichstrategie entsteht pro Bestellung ein neuer Debitor und eine Kontaktliste, die niemand mehr sortiert bekommt. Der Abgleich muss über E-Mail und Adresse laufen, bevor überhaupt ein Kontakt angelegt wird.
- **GoBD-Unveränderbarkeit.** Ist eine lexoffice-Rechnung einmal festgeschrieben, lässt sie sich weder bearbeiten noch löschen, nur korrigieren. Eine Pipeline, die ein gebuchtes Dokument "aktualisieren" will, scheitert - Erstattungen und Korrekturen müssen als Rechnungskorrektur zum Original raus, nie als Änderung.
- **Rechnung oder Beleg.** Hat Shopify dem Kunden schon seinen Beleg geschickt, wird das Dokument bei einer zweiten nummerierten lexoffice-Rechnung doppelt ausgestellt. Die Entscheidung zwischen festgeschriebener Rechnung und Beleg ist eine buchhalterische, keine Voreinstellung - und sie ändert Ihren Nummernkreis.
- **Das Limit von zwei Anfragen pro Sekunde.** Die lexoffice-API deckelt Schreibzugriffe bei rund zwei pro Sekunde je Schlüssel. Ein Massenimport oder ein Verkaufstag läuft sofort in 429-Fehler - Schreibzugriffe müssen gepuffert, gedrosselt und mit Backoff wiederholt werden, statt in einer Schleife zu feuern.
- **Grenzüberschreitende Umsatzsteuer.** Inland mit 19 % und 7 % ist einfach. EU-Fernverkäufe im OSS, Reverse-Charge im B2B und Drittland-Exporte brauchen jeweils die richtige Steuerbehandlung, und die OSS-Abbildung ist in lexoffice das schwächste Glied - Bestimmungsland und Steuerstatus des Kunden müssen die Kontierung steuern.
- **Rundung.** Shopify rechnet Summen auf seine Art, lexoffice rechnet aus den Positionen neu. Netto-gegen-Brutto-Rundung kann einen Cent Differenz lassen, der auf einer Zeile aufgelöst werden muss - sonst passt die Belegsumme nicht zur Bestellung.
- **Idempotenz.** Läuft ein naiver Import erneut, wird dieselbe Bestellung ein zweites Mal gegen ein unveränderbares Buch gebucht, das Sie dann nicht einfach löschen können. Die Pipeline muss wissen, dass sie für eine Shopify-Bestellung bereits ein Dokument erzeugt hat, und es nie erneut anlegen.

## Wie wir sie bauen und betreiben

Wir behandeln das als Pipeline, nicht als nächtlichen Lauf. Bestell- und Erstattungsvorgänge aus Shopify werden per Webhook oder zeitgesteuert abgeholt, validiert, dem richtigen lexoffice-Kontakt zugeordnet und als abgestimmte Rechnung oder Beleg ausgegeben - Erstattungen als Rechnungskorrektur zum Originaldokument.

Die Pipeline ist idempotent: Jede Shopify-Bestellung trägt eine stabile Kennung, die wir auf ihr lexoffice-Dokument abbilden, sodass ein erneuter Lauf nie eine Dublette gegen GoBD-gesperrte Datensätze erzeugt. Sie respektiert das lexoffice-Ratelimit von Haus aus, drosselt und wiederholt Schreibzugriffe und kapselt Teilfehler, sodass eine fehlerhafte Bestellung nie den ganzen Stapel blockiert. Sie läuft auf cloud-nativer, vollständig EU-gehosteter AWS-Infrastruktur - Bestell- und Kundendaten verlassen die EU nicht, was AVV und DSGVO sauber hält.

Und dann halten wir sie am Laufen. Monitoring, Alerting, Incident Response und das Beobachten von API-Änderungen bei Shopify und lexoffice liegen vertraglich bei uns, mit festem Ansprechpartner und SLA. Ihre Buchhaltung hängt nicht mehr daran, dass jemand an einen Import denkt.

## Wann sich diese Anbindung lohnt

Wenn Sie eine Handvoll Inlandsbestellungen im Monat mit einem einzigen Steuersatz abwickeln, ist der lexoffice-eigene Import oder ein leichter Connector völlig in Ordnung - und wir sagen Ihnen das auch. Eine betreute Pipeline lohnt sich, wenn das Bestellvolumen steigt, wenn Gast-Bestellungen und Dubletten Ihre Kontakte zumüllen, wenn Erstattungen und GoBD-Korrekturen zur monatlichen Pflichtübung werden, oder wenn Sie grenzüberschreitend im OSS verkaufen und die Kontierung von Anfang an stimmen muss - denn eine gesperrte, falsche Rechnung zu korrigieren ist weit teurer, als eine richtige zu bauen.

## Häufig gestellte Fragen

### Soll jede Shopify-Bestellung eine lexoffice-Rechnung oder ein Beleg werden?

Das hängt davon ab, wer die rechtsgültige Rechnung ausstellt. Verschickt Shopify dem Kunden bereits seinen Beleg, buchen wir jede Bestellung als Beleg in lexoffice und vermeiden so eine zweite Rechnungsnummer. Soll lexoffice das führende System sein, das die Rechnung ausstellt und nummeriert, erzeugen wir stattdessen festgeschriebene Rechnungen. Das klären wir einmalig mit Ihnen und Ihrem Steuerberater, denn es bestimmt Nummernkreis, USt-Ausweis und das, was Ihre Kanzlei später sieht.

### Legt die Schnittstelle doppelte Kunden in lexoffice an?

Nicht, wenn sie richtig gebaut ist. lexoffice erzwingt keine eindeutige E-Mail-Adresse bei Kontakten, und Gast-Bestellungen in Shopify hinterlassen keinen dauerhaften Kundendatensatz. Ein naiver Sync legt deshalb pro Bestellung einen neuen Debitor an. Die Pipeline gleicht zuerst über E-Mail und Adresse ab und legt nur dann einen Kontakt an, wenn es wirklich keine Übereinstimmung gibt - ein Käufer bleibt ein Kontakt mit einer Kundennummer.

### Wie werden Erstattungen behandelt, wenn lexoffice-Rechnungen gesperrt sind?

Festgeschriebene lexoffice-Dokumente sind nach GoBD unveränderbar - sie lassen sich weder bearbeiten noch löschen, nur korrigieren. Eine Erstattung oder Teilerstattung aus Shopify wird deshalb als Rechnungskorrektur mit Bezug auf das Originaldokument gebucht, mit denselben Konten und Steuersätzen und dem Datum der Erstattung. Die Pipeline versucht nie, eine gebuchte Rechnung zu öffnen oder zu überschreiben.

### Kommt die Schnittstelle bei hohem Bestellvolumen mit dem lexoffice-Ratelimit zurecht?

Ja. Die lexoffice-API erlaubt rund zwei Anfragen pro Sekunde je Schlüssel - ein Massenimport überschreitet das sofort. Unsere Pipeline drosselt und puffert die Schreibzugriffe, hält sich unter dem Limit, wiederholt 429-Antworten mit Backoff und verarbeitet Bestellungen idempotent. So läuft ein Black-Friday-Ansturm sicher durch, statt halb geschrieben abzubrechen.

### Wer betreibt die Schnittstelle nach dem Go-live?

Wir. Die Pipeline läuft auf cloud-nativer, vollständig EU-gehosteter Infrastruktur, die wir überwachen. Ändert Shopify oder lexoffice eine Schnittstelle, ist das vertraglich unser Problem - keine böse Überraschung, die Ihre Buchhaltung zum Monatsabschluss entdeckt. Sie bekommen einen festen Ansprechpartner, Alerting, Incident Response und ein SLA statt eines Skripts, an dessen Ausführung jemand denken muss.

## Häufige Fehler

- [lexoffice: Deine Steuereinstellungen sind fehlerhaft](https://seamless.engineering/de/fehler/lexoffice-steuereinstellungen-fehlerhaft/)
- [lexoffice: Die Rechnungsadresse des Kunden enthält einen Fehler](https://seamless.engineering/de/fehler/lexoffice-rechnungsadresse-fehler/)
- [lexoffice: Es werden keine Rechnungen erstellt](https://seamless.engineering/de/fehler/lexoffice-keine-rechnungen-erstellt/)
- [lexoffice: Steuerfreie B2B-Bestellung ohne USt-IdNr. wird nicht als Rechnung angelegt](https://seamless.engineering/de/fehler/lexoffice-b2b-ohne-ust-id/)

## Verwandte Integrationen

- [Shopify ↔ DATEV](https://seamless.engineering/de/integrations/shopify-datev/): Shopify DATEV Schnittstelle
- [Shopify ↔ sevDesk](https://seamless.engineering/de/integrations/shopify-sevdesk/): Shopify sevDesk Schnittstelle
- [WooCommerce ↔ lexoffice](https://seamless.engineering/de/integrations/woocommerce-lexoffice/): WooCommerce lexoffice Schnittstelle
- [lexoffice ↔ DATEV](https://seamless.engineering/de/integrations/lexoffice-datev/): lexoffice DATEV Schnittstelle
- [Shopify ↔ weclapp](https://seamless.engineering/de/integrations/shopify-weclapp/): Shopify weclapp Schnittstelle
- [Stripe ↔ lexoffice](https://seamless.engineering/de/integrations/stripe-lexoffice/): Stripe lexoffice Schnittstelle

## Nach System

- [Alle Schnittstellen für Shopify](https://seamless.engineering/de/integrations/shopify/)
- [Alle Schnittstellen für lexoffice](https://seamless.engineering/de/integrations/lexoffice/)
- [Shopify API-Changelog](https://seamless.engineering/de/api-changelog/shopify/): 9 Breaking Changes und 2 Deprecations in den letzten 90 Tagen
- [lexoffice API-Changelog](https://seamless.engineering/de/api-changelog/lexoffice/): Keine Breaking Changes oder Deprecations in den letzten 90 Tagen

## Scoping-Gespräch anfragen

Sie möchten diese Integration umsetzen und dauerhaft betreiben lassen? Sagen Sie uns, welche Systeme verbunden werden sollen und welche Daten fließen müssen. Festpreis-Angebot zur Aufwandsabschätzung innerhalb von 48 Stunden.

- E-Mail: hello@seamless.engineering
- Kontaktformular: https://seamless.engineering/de/#contact