Betrieb
Protokolle & Fehlersuche
maniacSeller protokolliert alle Abgleiche. Mit den Protokollen finden Sie schnell heraus, warum eine Bestellung nicht verarbeitet oder ein Artikel nicht übertragen wurde – und können uns im Supportfall gezielt Informationen schicken.
Logdaten auswerten
Unter Einstellungen › Logdaten auswerten filtern Sie die Protokolleinträge nach Thema, Datum und Werten wie Bestell-, Artikel- oder Kundennummer.
- Zeige nur Fehler zu …
- Schnellfilter für Bestelldownload, Belegverarbeitung, Artikel-Grunddaten, Artikelpreise, Artikelbestände, Bilder & Medien, Webshop-Kategorien und Kundenupload; Alle anzeigen hebt den Filter auf.
- Quelle, Zeitpunkt
- Wo und wann der Eintrag entstanden ist – damit ordnen Sie ihn einem Vorgang zu.
- Request
- Die Daten, die maniacSeller an den Shop bzw. an Sage gesendet hat.
- Antwort
- Die Antwort des Shops bzw. von Sage. Hier steht meist die eigentliche Ursache, z. B. ein fehlendes Pflichtfeld. Schicken Sie bei Supportanfragen vor allem Request und Antwort mit.
- In Zwischenablage kopieren
- Kopiert die markierten Einträge, etwa für eine E-Mail an den Support.
- Funktionslog erzeugen
- Schreibt ein ausführliches Protokoll, mit dem der Support Probleme genauer analysieren kann. Nur auf Anweisung aktivieren und danach wieder abschalten.
- Shoplogging
- Zeichnet zusätzlich die Kommunikation mit dem Shop auf.
- Log-Verzeichnis öffnen
- Öffnet den Ordner mit den Protokolldateien. Jeder Automatikprozess schreibt eine eigene Datei.
Fehlermeldungen per E-Mail
Unter E-Mail-Adressen hinterlegen Sie Empfänger (mehrere durch Komma getrennt), die bei Problemen erweiterte Informationen erhalten – besonders wichtig für die Automatikprozesse, die ohne Bildschirm laufen. Mit E-Mail-Versand nur im Automatikmodus gehen E-Mails nur aus den Automatikprozessen heraus, nicht bei der Arbeit am Bildschirm.
Häufige Fragen
Eine Bestellung wird nicht verarbeitet
Gelb markierte Bestellungen erfüllen eine Grundvoraussetzung nicht. Prüfen Sie in dieser Reihenfolge:
- Wawi KdNr leer – kein Kunde zugeordnet und automatische Kundenanlage aus: Kunde anlegen oder Kunde zuweisen.
- Wawi KdNr „Dublette“ – mehrere Sage-Kunden mit derselben E-Mail-Adresse: den richtigen von Hand zuweisen (siehe Kundenerkennung).
- ZKD Wawi oder Versand Wawi leer – Zahlungs- bzw. Versandart nicht zugeordnet (siehe Zahlungs- & Versandarten).
- Position ohne Artikel – Artikel, Versandkosten oder Gutschein nicht zugeordnet (siehe Artikelerkennung).
Eine Bestellung wird nicht abgerufen
Erscheint eine Shop-Bestellung gar nicht in maniacSeller, oder meldet der Abruf „Shop-Bestelldaten unvollständig“, kommen diese Ursachen in Frage:
- Zahlungsstatus: Die Bestellung hat einen Zahlungsstatus, der laut Einstellung nicht abgerufen wird (siehe Bestellungsimport).
- Verkaufskanal oder Tag: Die Bestellung stammt aus einem Verkaufskanal, den das Profil nicht abruft, oder ihr fehlt ein erforderlicher Tag (siehe Verkaufskanalkonfiguration).
- Kunde im Shop gelöscht: Wird ein Kunde nach seiner Bestellung im Shop gelöscht, liefert Shopware keine Adressen mehr zur Bestellung – sie kann nicht übernommen werden. Löschen Sie keine Kunden, die bereits bestellt haben.
- Plugins: Einzelne Shop-Plugins verändern die Bestelldaten so, dass Pflichtangaben fehlen. Deaktivieren Sie testweise kürzlich installierte Plugins und informieren Sie uns, welches Plugin betroffen war.
„Die Summe der Rabatte1-3 sind höher als die Rabattbasis“
Rabatte und Gutscheine aus dem Shop übernimmt maniacSeller als Belegrabatt mit festem Betrag. Sage zieht einen solchen Rabatt nur vom Warenwert der Artikel ab, die in Sage rabattfähig sind (Rabattbasis); Versandkosten und andere Zuschläge zählen nie dazu. Ist der Rabatt höher, lehnt Sage den Beleg mit dieser Meldung ab.
maniacSeller prüft das vor dem Speichern und nennt an der Bestellung Rabatt, Warenwert, Differenz und den Grund. Beträge werden dabei nie angepasst: Der Beleg muss genau so aufgehen wie die Bestellung im Shop. Typische Gründe:
- Artikel in Sage nicht rabattfähig (Kennzeichen am Artikel oder an der Preisliste, aus der Sage den Preis nimmt; das kann auch eine Aktions- oder Basisliste sein. Bei einem Kundenpreis zählt nur das Kennzeichen am Artikel): Die Meldung nennt die Artikelnummern. Prüfen Sie das Kennzeichen in Sage oder nehmen Sie diese Artikel im Shop vom Rabatt aus.
- Rabatt höher als der ganze Warenwert, meist weil der Gutschein im Shop auch die Versandkosten deckt: Das lässt sich in Sage als Belegrabatt nicht abbilden. Buchen Sie solche Gutscheine als Artikelposition: unter Einstellungen › Belegoptionen „Gutscheine als Artikelposition“ einschalten und der Position an der Bestellung einen Gutschein-Artikel aus Sage zuordnen („Gutschein zuordnen“). Oder legen Sie den Beleg in Sage von Hand an.
- Die Bestellung enthält mehr als drei Rabatte.
Fehler nach dem Löschen eines Zusatzfelds im Shop
Wurde ein Zusatzfeld (Custom Field) in Shopware gelöscht, kann es beim Zuordnen unter Freie Textfelder zu einer Fehlermeldung kommen, solange das Feld noch im Zwischenspeicher des Shops steht. Leeren Sie in der Shopware-Administration unter Einstellungen › System › Caches & Indizes den Cache und laden Sie die Felder in maniacSeller erneut. Entfernen Sie außerdem Zuordnungen, die noch auf das gelöschte Feld verweisen.
Abruf oder Verarbeitung startet nicht (Sperre)
Ein anderer Arbeitsplatz oder ein Automatikprozess verarbeitet gerade – oder ein Vorgang wurde unterbrochen. Prüfen Sie das und geben Sie die Sperre ggf. frei (siehe Verarbeitungssperren).
Ein Artikel kostet im Shop 999.999,99 €
Für den Standardpreis wurde in Sage kein Preis gefunden (siehe Kein Standardpreis). Prüfen Sie die Preisliste, die der Preisregel „Standard“ zugeordnet ist, und deren Gültigkeit.
Ein Kunde sieht falsche Preise
Prüfen Sie im Shop die Kundengruppe des Kunden und in maniacSeller, welche Kundengruppe sich aus seiner Sage-Preisliste ergibt. Der Reiter Preise am Artikel zeigt die ermittelten Preise je Kundengruppe.
Preise, Bestände oder Bilder kommen nicht im Shop an
Ist der Artikel Online? Preise, Bestände und Medien können erst übertragen werden, wenn der Artikel im Shop angelegt ist (siehe Hochladen). Bei Varianten prüfen Sie zusätzlich die Lizenz für das Variantenmodul.
Neuer Kunde kann nicht angelegt werden
Meist ist der Nummernkreis erschöpft oder im Bereich des Kundennummer-Musters existiert noch keine Nummer (siehe Kundennummer).
Bei der Meldung „Es wurde kein Vorlagekonto gefunden“ fehlt für den Fall des Kunden (Inland, EU, Drittland) ein Vorlagekonto. Hinterlegen Sie es unter Bestellungsimport (siehe Vorlagekonten).
Keine Verbindung zum Shop
Prüfen Sie unter Zugangsdaten mit Testen die Anmeldung. Häufige Ursachen: geänderter Sicherheitsschlüssel der Integration, ein Kennwortschutz (htaccess) vor der Shop-URL oder eine Firewall.
Die Meldung „Die Verbindung mit dem Remoteserver kann nicht hergestellt werden“ bedeutet, dass der Shop gar nicht erreicht wird: Internetverbindung unterbrochen, Firewall sperrt Port 443 (https) bzw. 80 (http) oder der Shop selbst ist nicht erreichbar. Rufen Sie den Shop auf demselben Rechner im Browser auf; erscheint er dort auch nicht, wenden Sie sich an Ihren Provider bzw. Ihre IT.
Meldung „JsonReaderException: Unexpected character encountered while parsing value: <“
Der Shop antwortet mit einer HTML-Seite statt mit Daten. Meist ist in Shopware das erweiterte Debugging bzw. Logging eingeschaltet (Entwicklermodus). Bitten Sie Ihre Shop-Agentur, es auszuschalten.
Fehler beim Artikelupload wegen Mindestabnahme oder Staffelmenge
Sind Mindestabnahme oder Staffelmenge über Freie Textfelder mit Sage-Feldern verbunden, darf dort nie 0 stehen – Shopware lehnt den Wert ab. Hinterlegen Sie für diese Sage-Felder einen Standardwert von mindestens 1 und korrigieren Sie vorhandene Artikel mit 0.
Geänderter Steuersatz kommt nicht im Shop an
Ohne Zuordnung der Steuerklassen übernimmt maniacSeller den Steuersatz beim Anlegen des Webshop-Artikels und ändert ihn danach nicht mehr. Wechselt ein Artikel in Sage z. B. von 19 % auf 7 %:
- Ordnen Sie unter Steuerklassen jeder Sage-Steuerklasse einen Shopware-Steuersatz zu – dann gilt bei jedem Upload die aktuelle Steuerklasse aus Sage.
- Oder löschen Sie den Artikel im Shop und als Webshop-Artikel, legen ihn neu an und laden ihn hoch.
- Ist Kein Steuerupload bei Artikelupdate aktiv, wird der Steuersatz bei Aktualisierungen grundsätzlich nicht übertragen.
HTML-Inhalte in Texten fehlen im Shop
Fehlen im Shop Piktogramme, eingebettete Elemente oder bestimmte Formatierungen aus den Artikeltexten, entfernt meist der HTML-Sanitizer von Shopware diesen Code beim Speichern. Ihre Shop-Agentur kann ihn für die betroffenen Felder anpassen oder ausschalten.
Terminalserver: Logdateien oder Einstellungen „verschwinden“
Auf Terminal- oder Cloud-Servern legt Windows für jeden Benutzer eine eigene Kopie des Ordners ProgramData an. Dann zeigt Log-Verzeichnis öffnen nicht die aktuellen Logdateien, oder das Löschen der Konfigurationsdatei setzt die Datenbankverbindung nicht zurück. Die Dateien liegen in diesem Fall unter:
C:\Users\<Benutzer>\AppData\Local\VirtualStore\ProgramData\maniacDevelopers\maniacSellerSageGen2
Datenbank neu einrichten: Version zurücksetzen
Wurde die maniacSeller-Datenbank gelöscht und soll neu angelegt werden, kann SQL Server noch die alte Datenbankversion kennen; die Einrichtung überspringt dann Schritte. Ihr Administrator setzt die Version im SQL Server Management Studio zurück:
SELECT * FROM msdb.dbo.sysdac_instances WHERE instance_name = 'maniacSellerGen2'
UPDATE msdb.dbo.sysdac_instances SET type_version = '0.0.0.0' WHERE instance_name = 'maniacSellerGen2'
Nur ausführen, wenn die Datenbank tatsächlich gelöscht wurde – im Zweifel vorher den Support fragen.
Support
- Hilfe › Supportanfrage stellen schickt Ihre Anfrage direkt aus dem Programm an den maniac-Support. Programmversion und Kundennummer gehen automatisch mit.
- Hilfreich sind außerdem: betroffene Bestell- oder Artikelnummer, Zeitpunkt und was Sie erwartet hätten. Den Stand Ihrer Anfrage sehen Sie unter Meldungen an maniac.
- Ist die maniac-Zentrale nicht erreichbar, erreichen Sie uns per E-Mail an support@maniacdev.de oder telefonisch unter 0049 7841 8389020.
Meldungen an maniac
Unter Hilfe › Meldungen an maniac stehen alle Supportanfragen, Wünsche und gemeldeten Fehler dieses Webshop-Profils mit ihrem Stand beim Support. Jeder angemeldete Benutzer kann melden und die Liste sehen.
- Supportanfrage stellen
- Betreff, Beschreibung und auf Wunsch eine Adresse für Rückfragen. Mit Support-Paket anhängen geht das Support-Paket der letzten 1, 3 oder 7 Tage mit (Protokolle, Läufe, Konfiguration ohne Kennwörter). Weil es Namen, Adressen und Bestellnummern enthalten kann, geht es nur hinaus, wenn Sie ausdrücklich zustimmen. Im Browser braucht das Support-Paket das Recht Konfiguration.
- Wunsch an maniac
- Was soll maniacSeller künftig können oder besser machen? Der Wunsch geht direkt an die Entwicklung, mitgeschickt werden nur Kundennummer und Programmversion.
- An maniac melden
- Unter Logdaten auswerten › Fehlerfälle meldet dieser Knopf einen Fall: Fehlerart, Häufigkeit, Prozess und ein Protokollauszug. Namen, Adressen, E-Mail-Adressen und Telefonnummern ersetzt maniacSeller vorher auf Ihrem Server durch Platzhalter. Dieselbe Fehlerart nimmt maniac höchstens einmal in 7 Tagen an; ein gemeldeter Fall zeigt danach sein Ticket.
- Stand
- „Wird gesendet“, „Angenommen“, „Beim Support eingegangen“, „In Bearbeitung“, „Eingeplant“, „Behoben“, „Erledigt“ oder „Abgewiesen“. „Nicht zugestellt“ heißt, die Meldung hat maniac nicht erreicht; der Grund steht in der Spalte Rückmeldung. Den Stand fragt der Automatik-Dienst stündlich ab, Stand abfragen sofort.
- Rückmeldung
- Ticketnummer für Rückfragen, die Version mit der Behebung, sobald sie feststeht, und ein Hinweis des Supports.
Fehler ohne bekannte Ursache meldet maniacSeller von selbst: Tritt ein solcher Fehler mindestens dreimal auf, meldet der Automatik-Dienst ihn wie oben beschrieben, ohne Namen und Adressen. Abschalten können Sie das unter Logdaten auswerten mit Fehler ohne bekannte Ursache an maniac melden; Ihre eigenen Meldungen bleiben möglich.
Außerdem meldet der Automatik-Dienst alle 15 Minuten, welche Fehlerarten bei Ihnen neu oder wieder aufgetreten sind, und unerwartete Programmfehler höchstens einmal am Tag. Daraus entsteht kein Ticket: maniac sieht jeden Morgen, welche Fehler bei vielen Kunden auftreten, sich häufen oder mit einer neuen Version kamen, und kann sie beheben, bevor Sie anrufen. Hinaus gehen nur Fehlerart, Häufigkeit, Zahl der betroffenen Datensätze, Programmversion und Meldungstexte ohne Werte, nie Kunden-, Artikel- oder Belegdaten. Abschalten können Sie das unter Logdaten auswerten mit Fehlerarten an maniac melden.
Meldungen gehen über die maniac-Zentrale. Ohne Verbindung bleiben sie gespeichert, und der Automatik-Dienst sendet sie nach, sobald die Zentrale wieder erreichbar ist (höchstens 7 Tage lang).
Supportzugriff durch maniac
Damit der maniac-Support bei einer Anfrage nicht raten muss, darf er über die maniac-Zentrale bei Ihnen nachsehen. Das geht nur lesend: Einstellungen, Zuordnungen, Fehlerfälle, ein Logauszug, das Aktivitätsprotokoll (ohne Eingaben, die Namen oder Anschriften enthalten können), die Verbindungstests zu Sage und Shop, Bestellungen und Artikel. Geändert wird dabei nichts, und niemand meldet sich an Ihrem Server an. Der Automatik-Dienst holt die Fragen selbst über seine Verbindung zur Zentrale ab, beantwortet sie und schickt das Ergebnis zurück; eine Freigabe in der Firewall braucht es dafür nicht.
- Supportzugriffe
- Unter Hilfe › Supportzugriffe steht jeder Zugriff des maniac-Supports mit Zeitpunkt, Grund (meist mit Ticketnummer), dem, was nachgesehen wurde, dem Profil und dem Ergebnis. Die Inhalte selbst werden nicht gespeichert. Jeder angemeldete Benutzer sieht die Liste.
- Personendaten
- Namen, Anschriften, E-Mail-Adressen und Telefonnummern ersetzt maniacSeller auf Ihrem Server durch Platzhalter wie [Name#1], bevor ein Ergebnis hinausgeht.
- Abschalten
- Unter Logdaten auswerten mit dem Schalter Supportzugriff erlauben (Standard an). Ausgeschaltet beantwortet der Automatik-Dienst keine Fragen mehr; ein abgelehnter Versuch steht trotzdem in der Liste.
Der Supportzugriff braucht den Automatik-Dienst und eine freigegebene Anmeldung bei der maniac-Zentrale.
Anmeldung des maniac-Supports
Muss der maniac-Support etwas in der Oberfläche zeigen oder einstellen, meldet er sich mit einem Einmal-Code an, im Browser im Firmennetz und mit dem Zugriff von außen auch von unterwegs. Auf Ihren Server muss dafür niemand. Den Code erzeugt ein Mitarbeiter bei maniac nach seiner eigenen Anmeldung mit zweitem Faktor, nur für Ihre Installation. Er gilt 15 Minuten und nur ein einziges Mal; der Mitarbeiter gibt ihn beim Support-Benutzer als Kennwort ein. Ein gemeinsames Kennwort gibt es dafür nicht.
- Protokoll
- Jede Anmeldung steht unter Hilfe › Supportzugriffe als „maniac-Support“ mit „An der Oberfläche angemeldet“ und dem Ort (im Firmennetz oder von außen). Ein falscher oder abgelaufener Code steht dort als abgelehnt. Nach fünf falschen Codes ist die Anmeldung für 15 Minuten gesperrt.
- Abschalten
- Unter Logdaten auswerten mit dem Schalter maniac-Support darf sich anmelden (Standard an). Ausgeschaltet kann sich der Support nur noch im Programmfenster am Server selbst anmelden.
- Notzugang am Server
- Ist die maniac-Zentrale nicht erreichbar, meldet sich der Support wie bisher im Programmfenster am Server an. Über das Netz geht das bisherige Kennwort nicht.