Wissensdatenbank | Shopware und Shopify Webshop Schnittstelle zur Sage 100 & Sage DMO (SDMO) maniacSeller

Probleme mit Freitextfeldern im Shopware bei Mindestabnahme und Staffelmenge

Marco Schauer — Tue, 28 Apr 2026 22:15:43 +0000

Probleme mit Freitextfeldern im Shop bei Mindestabnahme und Staffelmenge

Wenn Sie Freitextfelder für Mindestabnahme und Staffelmenge in der Schnittstelle Ihres Shopsystems auf benutzerdefinierte Felder der Sage 100 gemappt haben, kann es zu Problemen kommen, wenn die korrespondierenden Felder in Sage den Wert 0 übergeben.

Lösung

Um dieses Problem zu beheben, stellen Sie sicher, dass die entsprechenden Felder in Sage einen Standardwert von mindestens 1 haben.

Öffnen Sie die Einstellungen der Schnittstelle und navigieren Sie zu Freie Textfelder.
Prüfen Sie, ob die Felder “Mindestabnahme” und “Staffelmenge” gemappt sind.
Falls diese Felder gemappt sind, stellen Sie sicher, dass in den korrespondierenden Feldern in Sage als Standardwert mindestens eine 1 hinterlegt ist.
Der Wert 0 darf nicht übergeben werden.

Anbindung neuer Shop/vVerkaufskanal

Marco Schauer — Mon, 27 Apr 2026 15:34:44 +0000

Anbindung eines neuen Verkaufskanals

Wenn Sie einen neuen Shop als zusätzlichen Verkaufskanal im selben System anbinden möchten, sind folgende Schritte erforderlich, um z. B. eigene Artikel oder Preise abbilden zu können:

Artikel dem Verkaufskanal zuordnen

Ordnen Sie die Artikel, die in diesem neuen Verkaufskanal verkauft werden sollen, direkt in der Schnittstelle dem entsprechenden Verkaufskanal zu.

Preisregel einrichten und koppeln

Richten Sie eine neue Preisregel ein. Diese können Sie anschließend unter Einstellungenpreise – Preise der Schnittstelle mit Ihrer Preisliste koppeln.

Preisregel im Verkaufskanal anzeigen

Stellen Sie sicher, dass diese neu eingerichtete Preisregel im entsprechenden Verkaufskanal (z.B. FR Verkaufskanal) hinterlegt und angezeigt wird.

Anbindung neuer Shop

Marco Schauer — Mon, 27 Apr 2026 15:34:43 +0000

Anbindung eines neuen Verkaufskanals

Wenn Sie einen neuen Shop als zusätzlichen Verkaufskanal im selben System anbinden möchten, sind folgende Schritte erforderlich, um z. B. eigene Artikel oder Preise abbilden zu können:

Artikel dem Verkaufskanal zuordnen

Ordnen Sie die Artikel, die in diesem neuen Verkaufskanal verkauft werden sollen, direkt in der Schnittstelle dem entsprechenden Verkaufskanal zu.

Preisregel einrichten und koppeln

Richten Sie eine neue Preisregel ein. Diese können Sie anschließend unter Einstellungenpreise – Preise der Schnittstelle mit Ihrer Preisliste koppeln.

Preisregel im Verkaufskanal anzeigen

Stellen Sie sicher, dass diese neu eingerichtete Preisregel im entsprechenden Verkaufskanal (z.B. FR Verkaufskanal) hinterlegt und angezeigt wird.

Anbindung neuer Shop

Marco Schauer — Mon, 27 Apr 2026 15:34:42 +0000

Anbindung eines neuen Verkaufskanals

Wenn Sie einen neuen Shop als zusätzlichen Verkaufskanal im selben System anbinden möchten, sind folgende Schritte erforderlich, um z. B. eigene Artikel oder Preise abbilden zu können:

Artikel dem Verkaufskanal zuordnen

Ordnen Sie die Artikel, die in diesem neuen Verkaufskanal verkauft werden sollen, direkt in der Schnittstelle dem entsprechenden Verkaufskanal zu.

Preisregel einrichten und koppeln

Richten Sie eine neue Preisregel ein. Diese können Sie anschließend unter Einstellungenpreise – Preise der Schnittstelle mit Ihrer Preisliste koppeln.

Preisregel im Verkaufskanal anzeigen

Stellen Sie sicher, dass diese neu eingerichtete Preisregel im entsprechenden Verkaufskanal (z.B. FR Verkaufskanal) hinterlegt und angezeigt wird.

Anbindung neuer Shop

Marco Schauer — Mon, 27 Apr 2026 15:34:40 +0000

Anbindung eines neuen Verkaufskanals

Wenn Sie einen neuen Shop als zusätzlichen Verkaufskanal im selben System anbinden möchten, sind folgende Schritte erforderlich, um z. B. eigene Artikel oder Preise abbilden zu können:

Artikel dem Verkaufskanal zuordnen

Ordnen Sie die Artikel, die in diesem neuen Verkaufskanal verkauft werden sollen, direkt in der Schnittstelle dem entsprechenden Verkaufskanal zu.

Preisregel einrichten und koppeln

Richten Sie eine neue Preisregel ein. Diese können Sie anschließend unter Einstellungenpreise – Preise der Schnittstelle mit Ihrer Preisliste koppeln.

Preisregel im Verkaufskanal anzeigen

Stellen Sie sicher, dass diese neu eingerichtete Preisregel im entsprechenden Verkaufskanal (z.B. FR Verkaufskanal) hinterlegt und angezeigt wird.

Anbindung neuer Shop

Marco Schauer — Mon, 27 Apr 2026 15:34:39 +0000

Anbindung eines neuen Verkaufskanals

Wenn Sie einen neuen Shop als zusätzlichen Verkaufskanal im selben System anbinden möchten, sind folgende Schritte erforderlich, um z. B. eigene Artikel oder Preise abbilden zu können:

Artikel dem Verkaufskanal zuordnen

Ordnen Sie die Artikel, die in diesem neuen Verkaufskanal verkauft werden sollen, direkt in der Schnittstelle dem entsprechenden Verkaufskanal zu.

Preisregel einrichten und koppeln

Richten Sie eine neue Preisregel ein. Diese können Sie anschließend unter Einstellungenpreise – Preise der Schnittstelle mit Ihrer Preisliste koppeln.

Preisregel im Verkaufskanal anzeigen

Stellen Sie sicher, dass diese neu eingerichtete Preisregel im entsprechenden Verkaufskanal (z.B. FR Verkaufskanal) hinterlegt und angezeigt wird.

Neuen Benutzer anlegen

Marco Schauer — Mon, 27 Apr 2026 15:33:37 +0000

Neuen Benutzer anlegen

Um einen neuen Benutzer anzulegen, melden Sie sich bitte als Administrator in der Schnittstelle an.

Benutzer erstellen und Rechte verwalten

Navigieren Sie nach der Anmeldung zu Einstellungen.
Wählen Sie den Bereich Benutzerverwaltung.
Dort können Sie einen Benutzer erstellen und die entsprechenden Rechte verteilen.

[Ticket#7954609] Unterstützung beim Abruf von 5 Bestellungen aus dem Shopify

Marco Schauer — Mon, 27 Apr 2026 15:31:47 +0000

Problem: Abruf von Shopify-Bestellungen aufgrund fehlender Adressdaten nicht möglich

Bestellungen aus Shopify können nicht in das System importiert werden. Auch ein Neustart des Schnittstellendienstes behebt das Problem nicht.

Fehlerursache

Die Ursache liegt in fehlenden oder unvollständigen Adressdaten bei den betroffenen Bestellungen in Shopify. Insbesondere können Felder wie die RechnungsPLZ (Postleitzahl der Rechnungsadresse) leer (Null) sein, was die Verarbeitung durch das System verhindert.

Fehlermeldung

Im System wird eine Fehlermeldung ähnlich der folgenden angezeigt:

Fehler beim Importieren von Bestellung '[Bestellnummer]'. Microsoft.Data.SqlClient.SqlException (0x80131904): Der Wert Null kann nicht in die Spalte 'RechnungsPLZ' der Tabelle 'Bestellungen' eingefügt werden. Die Spalte lässt keine Null-Werte zu. Fehler beim Einfügen.

Lösung: Adressdaten in Shopify überprüfen und korrigieren

Um die Bestellungen erfolgreich importieren zu können, müssen die fehlenden Adressdaten in Shopify ergänzt werden.

Betroffene Bestellungen identifizieren: Finden Sie die Bestellungen in Shopify, die nicht importiert werden konnten.
Adressdaten prüfen: Öffnen Sie die Details der betroffenen Bestellungen und überprüfen Sie die Rechnungs- und Lieferadressen.
Pflichtfelder ergänzen: Stellen Sie sicher, dass alle erforderlichen Felder, insbesondere die Postleitzahl (PLZ), ausgefüllt sind.
Änderungen speichern: Speichern Sie die vorgenommenen Korrekturen in Shopify.
Import erneut versuchen: Versuchen Sie anschließend, die Bestellungen erneut über die Schnittstelle abzurufen.

Automatischer Bestandsupload funktioniert nicht

Marco Schauer — Mon, 27 Apr 2026 15:29:28 +0000

Automatischer Bestandsupload funktioniert nicht

Wenn der automatische Bestandsupload nicht funktioniert, kann dies verschiedene Ursachen haben, wie z.B. einen nicht mehr existierenden Pfad zur Schnittstelle oder fehlende Berechtigungen für den ausführenden Dienst.

Problembeschreibung

Der automatische Bestandsupload funktioniert nicht, möglicherweise seit dem Einspielen eines Updates der Schnittstelle. Im Log des Dienstes finden sich Einträge wie:

Unable to restart the application: Unable to access "C:\Program Files (x86)\maniac developer GmbH\maniacSeller Shopschnittstelle\maniacConnect.exe".
Dies deutet darauf hin, dass der Dienst die benötigte ausführbare Datei nicht finden oder darauf zugreifen kann.

Fehleranalyse und Lösungsansätze

1. Prüfen des Installationspfades

Überprüfen Sie, ob der in der Fehlermeldung genannte Pfad zur Schnittstelle noch existiert. Es ist möglich, dass die Schnittstelle deinstalliert wurde oder der Pfad sich geändert hat. Prüfen Sie, ob sich stattdessen eine Datei namens maniacSellerGen2.exe auf dem System befindet.

2. Überprüfen der AlwaysUp-Dienste

Die Automatikprozesse werden in der Regel über AlwaysUp als Dienste ausgeführt. Überprüfen Sie den Status dieser Dienste:

Öffnen Sie AlwaysUp.
Suchen Sie die Einträge für die Schnittstelle (z.B. “maniacSeller Shopschnittstelle”).
Stellen Sie sicher, dass die Dienste aktiviert sind und auf “automatisch starten” konfiguriert sind.

3. Anpassen der Berechtigungen für den Dienst

Es kann vorkommen, dass die Berechtigungen für den Dienst nicht ausreichen, um die Anwendung zu starten oder auf den Pfad zuzugreifen. Passen Sie die Anmeldeinformationen des Prozesses in AlwaysUp an:

Wählen Sie in AlwaysUp den entsprechenden Dienst aus und klicken Sie auf Bearbeiten.
Navigieren Sie zum Reiter Logon.
Geben Sie hier die Anmeldeinformationen eines Benutzers mit Administratorrechten ein (z.B. Scheu-Dental\Admin-loock).
Speichern Sie die Änderungen und versuchen Sie, den Dienst neu zu starten.

4. Überprüfen der Intervallzeiten

Die Intervallzeiten für die automatischen Prozesse können direkt in AlwaysUp beim entsprechenden Dienst ausgelesen werden. Dies gibt Aufschluss darüber, in welchen Abständen die Synchronisation versucht wird.

5. Status des letzten Laufs überprüfen

Um zu prüfen, ob der automatische Bestandsupload erfolgreich war, können Sie den Status des letzten Laufs (Last Run) in der Übersicht oder im Log von AlwaysUp einsehen. Wenn hier kein aktuelles Datum steht, hat der Prozess nicht erfolgreich synchronisiert.

Effekte beim Übertrag von HTML-Text zum Shopware wegen der Shopware-HTML-Codebereinigung

Marco Schauer — Fri, 17 Apr 2026 12:23:15 +0000

Problem: Piktogramme werden in Shopware-Texten nicht angezeigt

Wenn Piktogramme oder andere HTML-Inhalte, die Sie in Shopware-Texten einfügen, nicht im Frontend Ihres Shops erscheinen, liegt dies wahrscheinlich am aktivierten HTML-Sanitizer.

Ursache

Der HTML-Sanitizer in Shopware ist eine Funktion, die HTML-Code filtert. Es wird davon ausgegangen, dass dabei die Piktogramme im Text verloren gehen.

Lösung: HTML-Sanitizer deaktivieren

Um die korrekte Darstellung Ihrer Piktogramme zu gewährleisten, empfehlen wir, den HTML-Sanitizer in Shopware zu deaktivieren.

Kontaktieren Sie Ihre Shopagentur oder Ihren Betreuer.
Bitten Sie diese, den HTML-Sanitizer in Ihrer Shopware-Installation zu deaktivieren.

Weitere Informationen

Für detaillierte Informationen zum HTML-Sanitizer und dessen Konfiguration in Shopware konsultieren Sie bitte die offizielle Shopware-Dokumentation:

Shopware 6: HTML-Sanitizer

Es können Bestellungen aus bestimmten Ländern nicht in Shopify importiert werden

Marco Schauer — Fri, 17 Apr 2026 12:06:11 +0000

Wenn Bestellungen nicht importiert werden und ein Fehler im nachgelagerten SQL Server auftritt, kann dies an einer fehlenden Postleitzahl in der Bestellung liegen.

Fehlerbehebung

Überprüfen Sie die betroffene Bestellung auf eine fehlende Postleitzahl.
Stellen Sie sicher, dass im Shop-Backend für die entsprechende Bestellung eine Postleitzahl hinterlegt ist.
Prüfen Sie, ob weitere Bestellungen mit ähnlichen Importproblemen ebenfalls keine Postleitzahl aufweisen.

In einer der kommenden Versionen werden wir voraussichtlich die Pflicht zur Angabe einer Postleitzahl aufheben.

Übermittlung der Steuersätze an den Web-Shop nach Änderung des Steuersatzes in der Sage 100

Marco Schauer — Thu, 16 Apr 2026 20:08:18 +0000

Problem: Übermittlung von Steuersätzen an den Web-Shop

Es wurde festgestellt, dass Änderungen an Steuersätzen für bestehende Artikel in Sage100 nicht korrekt über ManicSeller an Shopware6 übertragen werden.

Symptome

Artikel, die ursprünglich in Shopware6 mit einem Steuersatz von 19% (Steuersatz 1) angelegt und später in der Warenwirtschaft (Sage100) auf den ermäßigten Steuersatz von 7% (Steuersatz 2) geändert wurden, erhalten diese Änderung nicht im Web-Shop.
Im Upload-Fenster von ManicSeller werden die Steuersätze für die betroffenen Artikel nicht angezeigt.

Beobachtetes Verhalten und Workarounds

Die Übermittlung der korrekten Steuersätze funktioniert unter folgenden Bedingungen:

Wenn der Artikel in Shopware6 neu angelegt wird.
Wenn der Artikel in Shopware6 (über ManiacSeller) gelöscht und anschließend erneut an Shopware6 übertragen wird.

Übermittlung der Steuersätze an den Web-Shop nach Änderung des Steuersatzes in der Sage 100

Marco Schauer — Thu, 16 Apr 2026 20:06:30 +0000

Problem: Übermittlung von Steuersätzen an den Web-Shop

Es wurde festgestellt, dass Änderungen an Steuersätzen für bestehende Artikel in Sage100 nicht korrekt über ManicSeller an Shopware6 übertragen werden.

Symptome

Artikel, die ursprünglich in Shopware6 mit einem Steuersatz von 19% (Steuersatz 1) angelegt und später in der Warenwirtschaft (Sage100) auf den ermäßigten Steuersatz von 7% (Steuersatz 2) geändert wurden, erhalten diese Änderung nicht im Web-Shop.
Im Upload-Fenster von ManicSeller werden die Steuersätze für die betroffenen Artikel nicht angezeigt.

Beobachtetes Verhalten und Workarounds

Die Übermittlung der korrekten Steuersätze funktioniert unter folgenden Bedingungen:

Wenn der Artikel in Shopware6 neu angelegt wird.
Wenn der Artikel in Shopware6 (über ManiacSeller) gelöscht und anschließend erneut an Shopware6 übertragen wird.

Problem beim Bestellstatus Upload zu Shopify

Marco Schauer — Thu, 16 Apr 2026 19:53:57 +0000

Problembeschreibung

Bei der Shopify-Schnittstelle kann es zu einem Problem beim Bestellstatus-Upload kommen.

Dieses Problem ist auf fehlende Sendungsnummern in der Datenbanktabelle maniacSellerGenX.dbo.manVersandpaketeTracking zurückzuführen.

Lösung und erforderliche Maßnahmen

Sendungsnummern, die von einem externen Versandmodul erstellt werden, müssen in der Tabelle maniacSellerGenX.dbo.manVersandpaketeTracking mit der passenden Referenz zum Sage Beleg hinterlegt werden.

Es muss sichergestellt werden, dass ein Skript oder eine entsprechende Einrichtung auf Datenbankseite vorhanden ist, welches die Sendungsnummern in diese Tabelle überträgt. Falls eine solche Einrichtung nicht existiert, muss diese implementiert werden.

TEST Amazon magnalister Besprechung

Marco Schauer — Tue, 14 Apr 2026 21:49:38 +0000

Problem: Magnalister kann Amazon-Artikelzustand (Condition) nicht auswerten

Magnalister ist derzeit nicht in der Lage, die “Condition” (den Zustand) von Artikeln, wie sie auf Amazon hinterlegt ist, auszulesen und zu übermitteln.

Hintergrund der Einschränkung

Amazon führt die Zustandsinformation zwar in einem Attribut, dieses kann jedoch zuverlässig nur über die SP-API abgefragt werden. Magnalister nutzt diese API nicht, sondern arbeitet mit Bestellberichten, in denen diese spezifische Information fehlt. Es ist unwahrscheinlich, dass Magnalister hierfür kurzfristig eine Lösung bereitstellen wird.

Alternative Lösung: Verwendung von SKU-Suffixen für B-Ware

Um Artikel mit unterschiedlichen Zuständen (z.B. Neuware und B-Ware) dennoch über Magnalister verwalten zu können, wird eine alternative Lösung vorgeschlagen, die auf der Verwendung von abgewandelten SKUs basiert.

Vorgehensweise

Legen Sie für B-Ware-Artikel eine zweite, abgewandelte SKU an.
Arbeiten Sie mit einem festen Suffix, um den Zustand zu kennzeichnen.

Beispiel:

SKU für normalen Artikel (Neuware): 0815
SKU für B-Ware: 0815-USED

Anforderung an die Schnittstelle

Wenn Sie in Ihrer Schnittstelle (z.B. zu einem Warenwirtschaftssystem) einen solchen Suffix-Parameter (z.B. “-USED”) implementieren und diesen einem bestimmten Lagerplatz oder einer spezifischen Logik zuweisen können, lässt sich das Problem der Zustandszuordnung lösen.

Wichtiger Hinweis zur SKU-Übermittlung

Bevor Sie diese Lösung implementieren, prüfen Sie bitte, ob Magnalister bzw. Shopware die jeweilige SKU der Bestellposition zuverlässig an Ihr System übermittelt. Falls dies nicht der Fall ist, müsste Magnalister gegebenenfalls angepasst werden, um die SKU korrekt zu liefern.

Artikel-Status: Steuerung von Aktiv / Inaktiv

Dennis Jockers — Tue, 14 Apr 2026 12:32:15 +0000

Diese Seite beschreibt, wie Sie festlegen können, welche Produkte in Ihrem Webshop sichtbar (aktiv) oder unsichtbar (inaktiv) geschaltet werden. Es gibt drei Hauptwege, um diesen Status zu beeinflussen.

Übersicht der Steuerungsmöglichkeiten

A. Manuelle Steuerung über die Oberfläche

Sie können den Status eines Artikels jederzeit direkt in der Schnittstellenoberfläche anpassen.

Vorgehensweise: Suchen Sie den gewünschten Artikel in der Artikelübersicht und setzen oder entfernen Sie den Haken bei Aktiv.
Eignung: Ideal für kurzfristige, manuelle Änderungen einzelner Produkte.

B. Steuerung direkt über Sage (Warenwirtschaft)

Der Status kann direkt aus der Sage-Warenwirtschaft synchronisiert werden.

Vorgehensweise: Deaktivieren Sie das Produkt direkt in den Sage-Artikelstammdaten.
Effekt: Beim nächsten Abgleich wird der Status an das System übertragen und das Produkt im Shop entsprechend deaktiviert.

C. Steuerung über ein benutzerdefiniertes Feld (USER-Feld)

Wie im folgenden Screenshot markiert, lässt sich die Aktivierung auch über ein spezifisches Filterfeld steuern:

Einstellung: Unter Einstellungen > Artikel und Variantenoptionen im Bereich Warenwirtschaft-Artikel-Filter und -Felder.
Option: Hier kann ein spezifisches USER-Feld für Artikelfilter ausgewählt und die Option Steuerung von Aktiv/Inaktiv mit Filterfeld aktiviert werden.

Wichtige Voraussetzungen & Einschränkungen

1. Automatik-Einstellungen

Damit die Statusänderungen (insbesondere aus Sage oder per USER-Feld) korrekt verarbeitet werden, muss folgende Funktion aktiv sein:

Artikel Automatik / mit Grundlagen aktualisieren: Diese Option muss auf Aktiv gesetzt sein, damit die Stammdaten-Logik greift.

2. Logik bei Variantenartikeln

Bitte beachten Sie die Hierarchie bei der Status-Steuerung:

Standard- / Einzelprodukte: Die Steuerung funktioniert uneingeschränkt.
Hauptvarianten (Vaterartikel): Der Status kann über die oben genannten Wege gesteuert werden.
Varianten-Kinder: Wichtig! Varianten-Kinder können nicht über das USER-Feld gesteuert werden. Hier greift die Logik nur auf der Ebene des Hauptartikels.

Wie lege ich die Preisliste für Neukunden fest

Dennis Jockers — Fri, 10 Apr 2026 14:30:17 +0000

Wie wird die Preisliste für neue Kunden festgelegt?

Sie haben zwei Möglichkeiten, wie das System die Preisliste für neue Kunden in Sage hinterlegt:

Über die Kundengruppen-Matrix: Standardmäßig greift die Konfiguration aus Einstellungen-Preise. Hier verknüpfen Sie Shopware-Kundengruppen mit Sage-Preislisten.
Über das Vorlagekonto: Wenn Sie die Option „Preisliste aus Vorlagekonto“ aktivieren, zieht das System die Preisliste direkt aus den Stammdaten des hinterlegten Vorlage-Debitors. Die Einstellungen in der Preis-Matrix werden dann ignoriert.

Logik der Briefanrede beim Import (Shopware 6 zu Sage)

Dennis Jockers — Fri, 10 Apr 2026 07:18:29 +0000

Beim Import von Bestellungen oder Stammdaten aus Shopware 6 in unser Sage-System wird automatisch eine passende Briefanrede generiert. Diese Logik stellt sicher, dass Ihre Kunden in Rechnungen und Dokumenten korrekt angesprochen werden.

Wie wird die Anrede bestimmt?

Das System prüft die importierten Daten in einer festgelegten Reihenfolge:

1. Privatpersonen (persönliche Anrede)

Wenn in Shopware eine Anrede gewählt wurde, wird in Sage eine geschlechtsspezifische Grußformel erstellt:

Shopware “Herr”: Wird zu “Sehr geehrter Herr [Nachname]”.
Shopware “Frau”: Wird zu “Sehr geehrte Frau [Nachname]”.

2. Firmenkunden (Sammelanrede)

Wenn die Bestellung einem Unternehmen zugeordnet ist (Firmenname vorhanden) und kein spezifischer Ansprechpartner für den Beleg markiert wurde:

Logik: Das System ignoriert “Herr/Frau” und setzt die formelle Anrede: “Sehr geehrte Damen und Herren”.
Wichtig: Dies greift immer dann, wenn das Feld “Firma” gefüllt ist, um eine professionelle Business-Korrespondenz zu wahren.

3. Neutrale Anrede (Fallback)

Falls die Anrede in Shopware nicht eindeutig zugewiesen werden kann (z. B. bei Gastbestellungen ohne Anrede-Wahl):

Logik: Das System wählt eine höfliche, neutrale Form: “Guten Tag, [Vorname] [Nachname]”.

Entscheidungsmatrix für den Datenimport

Diese Tabelle zeigt, welche Datenkombination aus Shopware zu welchem Ergebnis in Sage führt:

Daten aus Shopware 6	Bedingung in Sage	Resultat (Briefanrede)
Anrede: Herr / Name: Mustermann	Ansprechpartner gesetzt	Sehr geehrter Herr Mustermann
Anrede: Frau / Name: Musterfrau	Ansprechpartner gesetzt	Sehr geehrte Frau Musterfrau
Firma: Beispiel GmbH	Kein Ansprechpartner	Sehr geehrte Damen und Herren
Keine Anrede / Name: Max Mustermann	Fallback-Regel	Guten Tag, Max Mustermann

Bild-Metadaten (Alt-Texte & Titel) über Textdateien pflegen

Dennis Jockers — Fri, 27 Mar 2026 14:16:54 +0000

Um die SEO-Relevanz und Barrierefreiheit Ihres Onlineshops zu optimieren, können Alt-Texte und Bild-Titel automatisiert über die Schnittstelle gepflegt werden. Dies geschieht durch das Hinterlegen einer einfachen Textdatei im Bildverzeichnis.

Funktionsweise

Die Schnittstelle sucht im Bildpfad nach einer korrespondierenden .txt-Datei für jedes Bild. Wenn diese Datei vorhanden ist, werden die darin enthaltenen Informationen ausgelesen und dem Bild im Shop zugewiesen.

Anforderungen an die Textdatei

Damit die Zuordnung funktioniert, müssen folgende Bedingungen erfüllt sein:

Dateiname: Die Textdatei muss exakt denselben Namen tragen wie die Bilddatei (beispiel: 10300002_1.jpg benötigt die Datei 10300002_1.txt).
Speicherort: Die Datei muss im selben Verzeichnis wie das Bild abgelegt werden.
Inhalt/Struktur: Die Informationen müssen in einem bestimmten Format (Key-Value) hinterlegt werden:

Parameter	Beschreibung	Beispiel in der .txt
alt:	Der Alt-Text für Barrierefreiheit und SEO.	`alt:Bestes Druckerkabel Alt-Titel`
titel:	Der Mouseover-Titel für das Bild.	`titel:Titel für das beste Druckerkabel`

Beispiel einer .txt-Datei

Inhalt der Datei 10300002_1.txt:

Plaintext

alt:Hochwertiges USB-Druckerkabel schwarz
titel:Anschlusskabel für Laserdrucker (2m)

Preisabgleich: Sage Rabattlisten zuordnen

Dennis Jockers — Mon, 23 Mar 2026 07:28:35 +0000

In der Schnittstelle können Sie steuern, welche Preise und Rabatte aus Sage an Ihren Webshop übertragen werden. Wenn Sie kundenspezifische Rabatte oder Mengenstaffeln über Sage Rabattlisten pflegen, müssen diese explizit in den Einstellungen der Schnittstelle gemappt werden.

Funktionsweise

Damit die Rabattlogik aus Sage korrekt im Shop ankommt, wird die entsprechende Rabattliste einer Shop-Kundengruppe zugeordnet. Die Schnittstelle prüft beim Preisabgleich die hinterlegten Listen und überträgt die daraus resultierenden Konditionen.

Konfiguration Schritt-für-Schritt

Navigieren Sie im Hauptmenü zu Einstellungen.
Wählen Sie in der linken Seitenleiste den Punkt Preise.
Suchen Sie in der Tabelle „Einstellungen zum Preisabgleich“ die Spalte Sage Rabattliste (siehe roter Pfeil im Screenshot).
Wählen Sie in der Zeile der entsprechenden Shop-Kundengruppe die gewünschte Rabattliste aus der Dropdown-Liste aus.
Speichern Sie die Einstellungen.

Logik der Preisfindung (Priorisierung)

Beachten Sie, dass die Schnittstelle bei der Ermittlung des Preises einer festen Rangfolge folgt. Diese wird im unteren Bereich des Einstellungsfensters angezeigt:

Sage Kunden Rabattgruppe (Rabattmatrix)
Sage Rabattliste
Preisliste

[!NOTE] Hinweis: Wird in der Rabattmatrix (Priorität 1) kein Wert gefunden, greift das System auf die hier hinterlegte Rabattliste (Priorität 2) zurück. Falls auch dort nichts hinterlegt ist, wird die Standard-Preisliste genutzt.

Wichtige Optionen

Zusätzlich können Sie unterhalb der Tabelle folgende Parameter feinjustieren:

Kein Streichpreis bei Rabattmatrix-Preis: Wenn aktiviert, wird bei rabattierten Preisen kein ursprünglicher UVP/Listenpreis im Shop angezeigt.
VPME enthält VKME beachten: Wichtig für die korrekte Umrechnung von Verpackungseinheiten auf Verkaufseinheiten, damit Grundpreise korrekt übertragen werden.

Shopware-Bestellupload aus Sage 100

Dennis Jockers — Tue, 10 Mar 2026 13:09:11 +0000

Mit dieser Funktion können Sie Verkaufsbelege direkt aus Ihrer Sage 100 in Ihren Shopware-Shop übertragen. Dies ist besonders hilfreich, um manuelle Erfassungen im Shop zu vermeiden und bestehende Belegdaten für eine erneute Bestellung im Frontend nutzbar zu machen.

1. Technische Voraussetzungen (Einrichtung)

Damit die Schnittstelle die entsprechenden Daten aus der Sage 100 identifizieren und übertragen kann, muss einmalig ein benutzerdefiniertes Feld am Verkaufsbeleg angelegt werden.

Konfiguration in der Sage 100:

Gehen Sie in den Administrator oder die entsprechenden Einstellungen für Metadaten und legen Sie folgendes Feld an:

Feldname: USER_maniacUpload
Typ: Text
Länge: 250 Zeichen
Änderbar: Ja

[!NOTE] Dieses Feld dient als Steuerungs- oder Infofeld für den Upload-Prozess. Ohne dieses Feld kann der „Bestellungen hochladen“-Dialog die Daten nicht korrekt verarbeiten.

2. Funktionsweise im maniacSeller

Sobald das Feld in der Sage 100 konfiguriert ist, steht Ihnen im maniacSeller Dashboard der Bereich „Bestellungen hochladen“ zur Verfügung (siehe Screenshot).

Schritt-für-Schritt-Ablauf:

Schnittstelle öffnen: Wechseln Sie im maniacSeller auf den Reiter Bestellungen hochladen.
Übersicht prüfen: In der Tabelle sehen Sie alle für den Upload bereiten Belege. Hier werden wichtige Informationen wie:
- Belegdatum & Nummer
- Kundennummer & Name
- Nettobetrag
- Matchcode (z. B. Shopware Bestellnummer-Referenz) angezeigt.
Upload starten: Markieren Sie die gewünschten Zeilen über die Checkboxen am linken Rand.
Abschluss: Klicken Sie auf die Schaltfläche [Bestellungen im Shop anlegen] (unten links). Die Daten werden nun an Shopware übermittelt und dort als reguläre Bestellungen für den Kunden hinterlegt.

Erstellung eines neuen Shopprofils (Multi-Shop/Mandanten-Setup) Shopify/GenX

Dennis Jockers — Tue, 10 Mar 2026 09:34:58 +0000

Erstellung eines neuen Shopprofils (Multi-Shop/Mandanten-Setup)

Um zusätzliche Onlineshops oder separate Sage-Mandanten an die Schnittstelle anzubinden, müssen Sie in der Verwaltung ein neues Profil anlegen. Jedes Profil speichert seine eigenen Verbindungsdaten und Konfigurationen.

Schritt-für-Schritt-Anleitung

Navigieren Sie zu den Einstellungen: Öffnen Sie im Hauptmenü auf der linken Seite den Punkt Einstellungen und wählen Sie im Untermenü den Reiter Profileinstellungen.
Neues Profil initialisieren: Klicken Sie im Bereich “Profileinstellungen” auf die orangefarbene Schaltfläche NEUES PROFIL.
Profilnamen vergeben: Geben Sie im Feld “Legen Sie den Namen des Shopprofils fest” einen eindeutigen Namen ein (z. B. Mein-Zweitshop oder Sage-Mandant-Zentrale). Dieser Name dient später der Identifikation in der Auswahl oben rechts im Dashboard.
Profil aktivieren: Stellen Sie sicher, dass der Schalter Aktiv auf Blau steht. Nur aktive Profile werden für den automatischen Datenabgleich berücksichtigt.
Speichern: Klicken Sie auf SPEICHERN. Das Profil ist nun im System hinterlegt.

Was passiert nach der Erstellung?

Sobald das Profil gespeichert wurde, können Sie es über das Auswahlmenü am oberen rechten Bildschirmrand (in Ihrem Screenshot als #1 - Supershop... sichtbar) auswählen.

Nachdem Sie in das neue Profil gewechselt haben, müssen Sie unter Einstellungen > Grundlagen > Datenverbindungen die spezifischen Zugangsdaten für dieses Profil hinterlegen:

Webshop-API: URL, API-Key/Passwort.
Sage-Anbindung: Datenbank-Pfad, Mandantennummer und Benutzerrechte.

Einrichtung der Datenbankverbindung (Webshopschnittstelle)

Dennis Jockers — Mon, 09 Mar 2026 09:31:16 +0000

Um Ihre Warenwirtschaft erfolgreich mit der Webshopschnittstelle zu verbinden, müssen im ersten Schritt die Zugangsdaten zu Ihrem SQL-Server hinterlegt werden. Diese Verbindung ist notwendig, damit Artikeldaten exportiert und Bestellungen korrekt importiert werden können.

Benötigte Informationen
Bevor Sie mit der Konfiguration beginnen, stellen Sie bitte sicher, dass Ihnen folgende Daten vorliegen:

Server-Adresse: Der Netzwerkname oder die IP-Adresse Ihres SQL-Servers.

Benutzername: In der Regel der Systemadministrator-Nutzer (z. B. sa).

Passwort: Das zugehörige Passwort für den SQL-Benutzer.

Datenbank-Name: Der Name Ihrer Sage-Hauptdatenbank.

Mandant: Die spezifische Mandantennummer/ID innerhalb von Sage.

Schritt-für-Schritt Anleitung
Füllen Sie die Felder im Konfigurationsfenster wie folgt aus:

Datenbank-Server: Geben Sie hier die Adresse Ihres SQL-Servers ein. Falls der Server lokal installiert ist, kann dies oft (local) oder .\SQLEXPRESS sein. Bei Netzwerkinstallationen nutzen Sie den Hostnamen oder die IP.

Datenbank-Benutzer: Tragen Sie hier den Benutzernamen ein (Standard: sa).

Datenbank-Kennwort: Geben Sie das Passwort für den oben genannten Benutzer ein.

Datenbank: Wählen Sie aus dem Dropdown-Menü die entsprechende Sage-Datenbank aus, aus der die Daten übernommen werden sollen.

Mandant: Wählen Sie hier den gewünschten Mandanten aus, für den die Schnittstelle aktiv sein soll.

Individualisieren Sie Ihre Kundenerkennung über ein eigenes SQL-Statement

Marco Schauer — Fri, 06 Mar 2026 15:37:37 +0000

Sie haben die Anforderung, dass Sie die Kundenerkennung gerne weiter, als nur die eineindeutige E-Mail-Adresse fassen möchten.

Dafür können Sie nun ein individuelles SQL-Statement in die Schnittstelle einfügen. Wenn Sie ein Statement eingefügt haben, wird immer zuerst über diese Abfrage erkannt, bevor die weiteren in den maniacSeller integrierten Erkennungsmechanismen ablaufen.

Im Statement können Sie die folgenden Platzhalter verwenden:

[Vorname] - wird ersetzt durch den Vornamen aus dem Shop
[Nachname] - wird ersetzt durch den Nachnamen aus dem Shop
[Firma] - wird ersetzt durch den Firmennamen aus dem Shop
[PLZ] - wird ersetzt durch die Rechnungs-PLZ aus dem Shop
[Ort] - wird ersetzt durch den Rechnungsort aus dem Shop
[E-Mail] - wird ersetzt durch die E-Mail-Adresse aus dem Shop
[Mandant] - wird ersetzt durch die Sage-Mandanten-Id

Testen Sie Ihr SQL-Statement vor der Benutzung in der Schnittstelle im SQL-Server-Management Studio auf Plausibilität und syntaktische Korrektheit.

Nachfolgend sehen Sie ein Beispiel-Statement, das Sie auch so in der Schnittstelle hinzufügen können. Sie können das SQL-Statement frei erstellen und auch weitere Tabellen, wie z. B. die KHKAnsprechpartner o. ä. verbinden.
Wichtig ist, dass die Abfrage immer nur eine Spalte mit der Bezeichnung Kto zurückgibt.

SELECT KHKKontokorrent.Kto FROM KHKKontokorrent LEFT OUTER JOIN KHKAdressen ON KHKKontokorrent.Adresse = KHKAdressen.Adresse AND KHKKontokorrent.Mandant = KHKAdressen.Mandant WHERE(KHKAdressen.Name1 LIKE '%[Vorname]%') OR (KHKAdressen.LieferPLZ LIKE '%[PLZ]%') OR (KHKAdressen.LieferStrasse LIKE '%[Strasse]%') OR (KHKAdressen.EMail LIKE '%[E-Mail]%') AND KHKKontokorrent.Mandant = [Mandant]

Falls die Abfrage mehrere mögliche Kunden zurückliefert, wird in der Schnittstelle der Wert Dublette angezeigt. In diesem Fall müssen Sie wie gewohnt manuell den passenden Kunden suchen und zuweisen.

Dennis Jockers — Mon, 02 Mar 2026 10:35:37 +0000

Optimierung der Performance: Paketgröße Preisupload

In den Einstellungen der maniacSeller-Schnittstelle können Sie steuern, wie Datenmengen beim Abgleich von Preisen verarbeitet werden. Dies ist besonders relevant für Webshops mit einer sehr hohen Anzahl an Artikeln und kundenspezifischen Preislisten.

Was bewirkt die Paketgröße?

Der Preisupload sendet die Daten nicht in einem einzigen, riesigen Block an den Webshop, sondern unterteilt sie in kleinere „Pakete“.

Standardwert: In der Regel ist hier ein Wert von 1000 vordefiniert.
Funktion: Der Wert legt fest, wie viele Preisdatensätze pro Sendezyklus an die API des Webshops übertragen werden.

Warum sollte man den Wert anpassen?

Es gibt zwei Hauptgründe, diesen Wert zu verändern:

Timeout-Fehler vermeiden: Wenn Ihr Server oder die Shop-API bei großen Datenmengen langsam reagiert, kann es zu Zeitüberschreitungen (Timeouts) kommen. In diesem Fall sollte die Paketgröße verringert werden (z. B. auf 500 oder 200).
Upload-Geschwindigkeit erhöhen: Wenn Ihr Server sehr leistungsstark ist und die API große Datenmengen schnell verarbeiten kann, kann eine Erhöhung des Wertes den gesamten Preisabgleich beschleunigen, da weniger einzelne Anfragen gesendet werden müssen.

Wo finde ich die Einstellung?

Sie finden diese Option unter folgendem Pfad:

Navigieren Sie zum Reiter Einstellungen.
Wählen Sie im linken Menü den Punkt Spezialfunktionen.
Im Bereich Spezialfunktionen allgemeiner Uploads / Kundenupload finden Sie das Feld Paketgröße Preisupload.

[!TIP] Empfehlung: Ändern Sie diesen Wert nur in Absprache mit Ihrem Administrator oder dem Support, wenn Sie Performance-Probleme beim Preisabgleich feststellen. Ein zu hoher Wert kann dazu führen, dass der Shop die Annahme der Daten verweigert.

Kundennummern

Dennis Jockers — Mon, 02 Mar 2026 08:30:12 +0000

Konfiguration der Kundennummern-Vergabe

In der maniacSeller-Schnittstelle legen Sie fest, wie Neukunden aus dem Shop in Sage 100 angelegt werden. Ein entscheidender Punkt ist hierbei die Hoheit über die Kundennummer: Die Sage 100 gibt die Struktur (Länge, Präfix) vor. Die Schnittstelle sorgt lediglich für die korrekte Übermittlung nach diesen Regeln.

Grundprinzip: Sage gibt den Takt vor

Die Konfiguration in der Schnittstelle muss zwingend mit den Einstellungen in Ihrem Sage-System (z. B. im Bereich Stammdaten/Nummernkreise) übereinstimmen.

Es gibt zwei Hauptwege, wie die Kundennummer vergeben wird:

1. Kundennummern-Muster (Standard-Automatik)

Hierbei wird in maniacSeller ein Muster definiert, das festlegt, wie die nächste freie Nummer in Sage angesprochen wird.

Kundennummer-Muster: Hier tragen Sie das Schema ein (im Screenshot z. B. D9).
Bedeutung: Das Muster dient der Wiedererkennung und Zuordnung. Die eigentliche Generierung der fortlaufenden Nummer übernimmt der Sage-Nummernkreis.

2. Externe Kundennummer übernehmen

Wenn diese Option aktiviert ist, wird die vom Shop generierte Kundennummer direkt an Sage übergeben.

Voraussetzung: Die Kundennummer aus dem Shop muss zwingend in das Schema der Sage 100 passen.
Kundennummer-Präfix: Hier kann ein Kürzel definiert werden, das der externen Nummer vorangestellt wird, um sie in Sage als “Shop-Kunden” zu kennzeichnen.

[!CAUTION]

Wichtiger Hinweis zur Haftung:

Wenn Sie den Schalter “Externe Kundennummer übernehmen” aktivieren, findet eine direkte Übergabe statt. Stimmen Sie diese Funktion unbedingt mit Ihrem Sage-Partner ab. Bei fehlerhaften Stammdaten durch falsch konfigurierte Nummernkreise kann keine Haftung übernommen werden.

Häufige Fragen (FAQ)

Frage	Antwort
Wer bestimmt die Länge der Kundennummer?	Ausschließlich die Sage 100. Die Schnittstelle kann keine Nummern erzwingen, die das ERP-System ablehnen würde.
Was passiert bei Dubletten?	Über die “Kundenerkennung über Zuordnung” prüft die Schnittstelle, ob der Kunde bereits existiert, um doppelte Anlagen zu vermeiden.
Kann ich Buchstaben in der Kundennummer nutzen?	Das hängt davon ab, ob Ihr Sage-Nummernkreis alphanumerische Werte zulässt.

Adressübernahme und Kennzeichnung von Firmenkunden

Dennis Jockers — Mon, 23 Feb 2026 15:45:55 +0000

Adressübernahme und Kennzeichnung von Firmenkunden

1. Übernahme der Adressdaten bei Bestellungen

Beim Eingang einer Bestellung werden die Adressdaten automatisch aus Shopware übernommen.
Dadurch wird sichergestellt, dass stets die im Shop hinterlegten und ggf. aktualisierten Kundendaten verwendet werden.

Eine manuelle Anpassung der Adressdaten erfolgt nicht, da Änderungen im Shop sonst nicht nachvollzogen werden könnten.

2. Kundenübertragung aus SAGE in den Shop

Werden Kunden über die Schnittstelle von SAGE in den Shop übertragen, ist Folgendes zwingend zu beachten:

Die Anrede muss in SAGE auf „Firma“ gesetzt sein, wenn es sich um einen Firmenkunden handelt.
Nur in diesem Fall wird der Kunde korrekt als Firmenkunde erkannt.
Ist eine andere Anrede hinterlegt, erfolgt keine automatische Zuordnung als Unternehmen.

3. Selbstregistrierung von Kunden im Shop

Registrieren sich Kunden eigenständig im Shop:

Die Firmendaten müssen im Feld „Firma“ eingetragen werden.
Bleibt dieses Feld leer, wird der Kunde als Privatkunde behandelt.

Wichtig

Die korrekte Kennzeichnung als Firmenkunde hängt ausschließlich von:

der Anrede „Firma“ (bei SAGE-Übertragung)
oder
dem ausgefüllten Feld „Firma“ (bei Shop-Registrierung)

ab.

Bitte prüfen Sie diese Einstellungen sorgfältig, um fehlerhafte Zuordnungen zu vermeiden.

Wie kann ich bei Marktplatzbestellungen, insbesondere amazon unterschiedliche Versandarten und Zahlungsarten angeben?

Marco Schauer — Wed, 05 Nov 2025 07:18:35 +0000

Sie möchten in der Warenwirtschaft später Bestellungen z. B. vom amazon FBA und FMB unterscheiden können.

Legen Sie dazu in den Shopware-Einstellungen je eine Zahlungs- und Versandard für amazon FBA und amazon FBM an.
Z. B. amazonFBA-Versand und amazonFBM-Versand und amazonFBA-Zahlung und amazonFBM-Zahlung.

Sie müssen dann im magnalister in den Experteneinstellungen für FBA die passende Versand- und Zahlungsart und analog für FBM.
Beachten sie, dass die FBA-Felder erst in den Experteneinstellungen sichtbar werden.

Dann können Sie diese nach der ersten entsprechenden Bestellung in der Schnittstelle auch zuweisen.

Kann ich auch die Bestände von Handelsstücklisten und Produktionsstücklisten zum Shop übertragen?

Marco Schauer — Mon, 20 Oct 2025 07:12:01 +0000

Ja, Sie können auch die Bestände von Handelsstücklisten und Produktionsstücklisten zum Shop übertragen. Das, obwohl Sage nur bei Produktionsstücklisten einen Bestand führt.

Wenn der Artikel in Sage als Stückliste hinterlegt ist, ermitteln wir beim Lagerupload den Stücklistenbestand, indem wir durch die Stückliste gehen und von jedem einzelnen Bestandteil den Bestand ermitteln und dann den begrenzenden Bestand als Stücklistenbestand zum Shop übertragen.

Bei Produktionsstücklisten wird auch der vorhandene, quasi gefertigte, Bestand berücksichtigt

Ein Beispiel:

Ein Geschenkset bestehend aus 1 Flasche Wein und 2 Tafeln Schokolade

Bestand Wein: 100 Flaschen
Bestand Schokolade: 3 Stk.
Bestand für das Set: 1

Verkaufskanal über ein Freitextfeld im Artikelstamm steuern

Marco Schauer — Tue, 07 Oct 2025 09:06:46 +0000

Steuern Sie den Verkaufskanal, in dem ein Artikel im Shop sichtbar sein soll, direkt über ein benutzerdefiniertes Feld im Artikelstamm.

Schritt 1: Ein Gruppenkennzeichen anlegen und einem Sage-USER-Feld zuweisen

Schritt 2: In Sage dann die entsprechenden Werte im Gruppenkennzeichen hinterlegen. Dabei muss die Bezeichnung exakt dem Namen des Verkaufskanals aus dem Shopware entsprechen.

Schritt 3: Beim Artikel kann dann der SalesChannel beim Artikel gepflegt werden. Diese Einstellung überschreibt eine ggf. direkt im maniacSeller im Artikel gepflegte Verkaufskanalzuweisung.

Schritt 4: In der Schnittstelle das entsprechende benutzerdefinierte Feld zuweisen