Kuhlware SevDesk-Connector
Überträgt Shopware-Bestellungen mit Kunden und Produkten automatisch an sevDesk, erzeugt dort Aufträge und Rechnungen und hängt das Rechnungs-PDF an die Bestellung an.
- Version 2.1.1
- Shopware 6.6.x – 6.7.x
- Hersteller Kuhlware
- Bestellungen, Kunden und Produkte automatisch nach sevDesk übertragen
- Rechnung direkt oder über den Zwischenschritt Auftrag erzeugen
- Rechnungs-PDF aus sevDesk landet als Dokument in der Shopware-Bestellung
- Auslöser frei wählbar über Bestell- und Zahlungsstatus
- Übertragungsstatus, Fehlermeldung und gesendete Daten an der Bestellung
Weniger Buchhaltungsarbeit: Deine Shop-Bestellungen landen als Rechnung direkt in sevDesk.
Der Kuhlware SevDesk-Connector überträgt Bestellungen aus Shopware 6 automatisch an sevDesk. Kunden und Produkte werden dabei angelegt oder verknüpft, aus der Bestellung entsteht in sevDesk ein Auftrag oder direkt eine Rechnung. Das Rechnungs-PDF wird zurück in die Shopware-Bestellung geladen und steht dort als Dokument bereit.
Das bringt dir der Connector
- Kein manuelles Abtippen von Kunden, Adressen und Bestellpositionen in sevDesk.
- Du bestimmst, wann übertragen wird: bei einem bestimmten Bestellstatus oder erst, wenn die Zahlung eingegangen ist.
- Jede Übertragung ist an der Bestellung nachvollziehbar: sevDesk-ID, Status, Fehlermeldung, gesendete Daten und Zeitstempel.
So funktioniert es
Sobald eine Bestellung angelegt oder geändert wird, prüft das Plugin, ob sie nach deinen Einstellungen übertragen werden soll. Dann legt es den Kunden samt Rechnungsadresse an oder aktualisiert ihn, überträgt die Produkte und erzeugt die Rechnung. Alternativ erstellt es zuerst einen Auftrag und wandelt ihn um, sobald der gewählte Zahlungsstatus erreicht ist. Das PDF der Rechnung wird aus sevDesk geladen und als Rechnungsdokument an der Bestellung gespeichert. Versandkosten und Gutscheine werden als eigene Positionen übernommen.
Konfiguration
- API-Token eines sevDesk-Benutzers, optional abweichende API-URL, Verbindungstest per Button
- Auftrag vor Rechnung oder direkte Rechnung
- Auslöser über Bestell- und Zahlungsstatus
- Präfix für Auftragsnummern, gemeinsame Kundennummern, Aktualisierung vorhandener Kunden und Produkte
- Kontaktperson in sevDesk und ISO-Ländercodes für „Steuerfrei EU“
Bestehende Bestellungen übertragen
Mit dem Konsolenbefehl bin/console kuhlware:sev-desk-connector:sync werden noch nicht übertragene Bestellungen der aktiven Verkaufskanäle nachgeholt, zum Beispiel nach einer Störung oder bei der Ersteinrichtung.
Voraussetzungen und Datenschutz
Du brauchst ein sevDesk-Konto mit API-Token. Das Plugin ist kompatibel mit Shopware 6.6 und 6.7. Prüfe vor dem Produktivbetrieb in sevDesk, ob Steuersätze, Zahlungsarten und Rechnungen deinen Anforderungen entsprechen; die steuerliche Behandlung verantwortest du selbst. Bei der Übertragung werden personenbezogene Kundendaten an sevDesk gesendet. Schließe dafür einen Auftragsverarbeitungsvertrag mit sevDesk ab und erwähne die Übertragung in deiner Datenschutzerklärung.
Externe Services: sevDesk: Bei Bestellungen werden Kunden- (Name, Firma, Adresse, E-Mail, Telefon, USt-IdNr.), Produkt- und Bestelldaten an die sevDesk-API gesendet. Ein sevDesk-Konto mit API-Token ist erforderlich.
Funktionen
- Automatische Übertragung, sobald eine Bestellung im Shop oder in der Administration angelegt oder geändert wird
- Kunden werden in sevDesk angelegt, mit Rechnungsadresse, E-Mail-Adresse und Telefonnummer; vorhandene Kunden werden erkannt und optional aktualisiert
- Produkte werden mit Name, Artikelnummer, Beschreibung, Preisen, Bestand und Einheit nach sevDesk übertragen; bereits vorhandene Produkte werden verknüpft
- Bestellpositionen, Versandkosten und Gutscheine werden als Positionen übernommen
- Wahlweise direkte Rechnung oder Auftrag, der später in eine Rechnung umgewandelt wird
- Auslöser über Bestellstatus (Auftrag) und Zahlungsstatus (Rechnung, Standard: bezahlt) einstellbar
- Rechnungs-PDF wird aus sevDesk geladen und als Rechnungsdokument an der Shopware-Bestellung gespeichert
- Steuertyp bei Netto-Bestellungen anhand des Rechnungslands; Länderliste für „Steuerfrei EU“ konfigurierbar
- Zahlungsarten werden zugeordnet, Kontaktperson über die E-Mail-Adresse eines sevDesk-Benutzers festlegbar
- Eigener Präfix für Auftragsnummern und Option für identische Kundennummern in Shopware und sevDesk
- Status, Fehlermeldung, gesendete Daten und Zeitstempel als Zusatzfelder an Bestellung, Kunde und Produkt
- Konsolenbefehl zum Nachholen noch nicht übertragener Bestellungen: bin/console kuhlware:sev-desk-connector:sync
- Schutz vor doppelter paralleler Verarbeitung einer Bestellung
- Verbindungstest, Debug-Modus und Log-Datei mit maskiertem API-Token
Installation
- Plugin installieren und aktivieren, danach den Cache leeren.
- Besorge in sevDesk den API-Token eines Benutzers, der die Kontaktperson für die Bestellungen sein soll.
- Öffne die Plugin-Konfiguration (Erweiterungen > Meine Erweiterungen > Kuhlware SevDesk-Connector). Wähle oben den Verkaufskanal, wenn du pro Verkaufskanal unterschiedliche Einstellungen nutzen möchtest.
- Trage den API-Token ein. Die API-URL musst du nur ändern, wenn sie von https://my.sevdesk.de/api/v1/ abweicht.
- Klicke auf „Teste API-Verbindung“, um den Zugang zu prüfen.
- Trage die E-Mail-Adresse des sevDesk-Benutzers als Kontaktperson ein und lege Präfix, Auftrags- oder Rechnungs-Logik sowie die Auslöser (Bestell- und Zahlungsstatus) fest.
- Schalte „SevDesk Abgleich aktivieren“ ein und speichere.
- Bestehende Bestellungen nachträglich übertragen: bin/console kuhlware:sev-desk-connector:sync
FAQ
Mit welchen Shopware-Versionen ist das Plugin kompatibel?
Das Plugin ist für Shopware 6.6 und 6.7 ausgelegt.
Wann wird in sevDesk eine Rechnung erstellt?
Das legst du fest: Bei „Rechnungs erstellen bei Status“ wählst du den Zahlungsstatus, der die Rechnung auslöst (Standard: bezahlt). Wahlweise erzeugt das Plugin zuerst einen Auftrag und wandelt ihn in eine Rechnung um.
Was passiert, wenn der Kunde oder das Produkt in sevDesk schon existiert?
Vorhandene Kunden und Produkte werden erkannt und verknüpft. Über zwei Optionen legst du fest, ob sie bei einer neuen Bestellung zusätzlich aktualisiert werden.
Finde ich die Rechnung auch in Shopware?
Ja. Das Rechnungs-PDF wird aus sevDesk geladen und als Rechnungsdokument an der Shopware-Bestellung gespeichert.
Wie erkenne ich Fehler bei der Übertragung?
An der Bestellung stehen sevDesk-ID, Status, Fehlermeldung, die gesendeten Daten und der Zeitstempel. Zusätzlich gibt es eine Log-Datei, im Debug-Modus mit mehr Details. Der Konsolenbefehl holt noch nicht übertragene Bestellungen nach.
Muss ich etwas zum Datenschutz beachten?
Ja. Kundendaten wie Name, Firma, Adresse, E-Mail-Adresse, Telefonnummer und USt-IdNr. werden an sevDesk gesendet. Schließe einen Auftragsverarbeitungsvertrag mit dem Anbieter ab und nimm die Übertragung in deine Datenschutzerklärung auf.
Changelog
2.1.1 20.07.2026 Shopware 6.6.x – 6.7.x
Fixed
- Den "Verbindung testen"-Endpunkt auf sevDesk-API-Hosts beschränkt, damit er nicht für Anfragen an beliebige URLs missbraucht werden kann (SSRF)
- API-Token vor dem Schreiben der Request-URLs in das Log maskiert
2.1.0 18.06.2025
Changed
- Kompatibilität mit Shopware 6.7
2.0.0
- Kompatibilität für Shopware 6.6
1.0.5
Fixed
- Rechnungserstellung: Berechne den Nettopreis korrekt, wenn keine Tax-Collection vorhanden ist
- Produkt-Sync: SevDesk-id aus customFields durch Produkt-Entity-Translations erhalten, wenn nicht direkt in Entity gesetzt
1.0.4
Fixed
- Rechnungserstellung: Rechnungsdatum in SevDesk auf heute setzen (Datum der Rechnungserstellung)
1.0.3
Added
- CustomFields: Feld mit den an SevDesk gesendeten Daten und einem Zeitstempel, wann sie gesendet wurden, hinzugefügt
Fixed
- Product-Sync: wenn ein Produkt noch keine SevDesk-id hat, aber bereits in SevDesk existiert, wird die Info nur in das Shopware-Produkt geschrieben, wenn die Produkt-Aktualisierung-Konfiguration nicht gesetzt ist
1.0.2
Added
- Produktbeschreibung zum Produkt-Mapping hinzufügen
- Sync-Prozess: Protokollierung der Anfrage-Einträge in der Log-Datei im Falle eines Fehlers
1.0.1
Added
- Erstellen einer Lock-Datei sobald eine Bestellung für SevDesk verarbeitet wird, damit diese nicht parallel doppelt verarbeitet werden kann
Fixed
- Sync-Prozess: Prüfen des letzten statt des ersten Bestell-Transaktions-Eintrags, um zu prüfen, ob ein Auftrag mit SevDesk synchronisiert werden soll
1.0.0
Added
- Admin-Konfiguration für Verbindungs-Infos und sonstige Einstellungen
- Produkt-Übertragung mit Mapping Klasse erstellen
- Kunden-Übertragung mit Mapping Klasse erstellen
- Bestell-Übertragung mit Mapping Klasse erstellen
- Rechnungs-PDF von SevDesk runterladen und an Shopware-Bestellung anhängen
- Kunden-Rechnungs-Adresse im Kontakt synchronisieren
- Admin-Konfiguration für Auftrags-Prefix (Default: SW)
- Bestell-Status abfragen einbinden als Trigger-Punkte
- Kunden-Ansprechpartner (SevDesk - Required Field) über Konfigurations-E-Mail-Adresse hinterlegen
- Shop-Gutscheine in Auftrag aufnehmen
