Kurzbeschreibung

Diese Konfiguration regelt, wie das System mit dem Aktivitätsstatus von Artikeln verfährt, die in der SelectLine (SL) als inaktiv markiert sind. Sie ermöglicht es, die automatische Deaktivierung im Webshop zu entkoppeln und stattdessen mit shopseitigen Tags (Kennzeichnungen) zu arbeiten.

Konfigurations-Optionen

1. Aktiv/Inaktiv nur manuell steuern

• Funktion: Schaltet die automatische Synchronisation des Aktivitätsstatus ab.
• Verhalten bei aktiviertem Schalter: Wenn ein Artikel in der SelectLine auf “inaktiv” gesetzt wird, bleibt er im Webshop weiterhin aktiv und sichtbar. Der Status SL-Inaktiv und ShopAktiv hat beim Daten-Upload keinen automatischen Einfluss mehr auf die Shop-Sichtbarkeit.
• Steuerung: Änderungen am Aktiv/Inaktiv-Status im Webshop können in diesem Modus ausschließlich manuell direkt über die Schnittstellen-Oberfläche vorgenommen werden.

2. SL-Inaktiv-Tags

• Funktion: Vergibt automatisch vordefinierte Tags an Webshop-Artikel, sobald diese in der SelectLine inaktiv gesetzt werden.
• Eingabe: Mehrere Tags können durch ein Komma getrennt eingegeben werden (z. B. nosell, inactive).
• Verhalten:
  • Erkennt das System einen inaktiven Artikel in SelectLine, wird der hier definierte Tag automatisch im Webshop am Artikel hinterlegt.
  • Sollte der Tag im Webshop noch nicht existieren, legt die Schnittstelle ihn automatisch an.
  • Wird der Artikel in SelectLine wieder aktiv, entfernt das System die konfigurierten Tags automatisch wieder vom Artikel.

Mit der neuen Variantentechnik werden zunächst Ausprägungen (z. B. Größe, Farbe) erstellt oder aus bestehenden Ausprägungen ausgewählt. Anschließend werden aus den vorhandenen Einzelartikeln die Shop-Varianten (SL-Varianten) gebildet.

1. Variantenbereich öffnen

Öffnen Sie den gewünschten Artikel und wechseln Sie auf den Reiter „Varianten“. Klicken Sie anschließend auf „Varianten anlegen“.

2. Ausprägungen auswählen oder anlegen

Im Dialog „Ausprägungen auswählen“ können Sie vorhandene Ausprägungen verwenden oder neue Ausprägungen und Ausprägungswerte anlegen.

Beispiel:
– Ausprägung: Größe
– Werte: S, M, L, XL

3. Zu den Varianten wechseln

Nachdem die gewünschten Ausprägungen und Werte definiert wurden, klicken Sie auf „Weiter zu Varianten zuweisen“.

4. Einzelartikel den Varianten zuweisen

Auf der linken Seite werden die verfügbaren Einzelartikel angezeigt. Wählen Sie die Artikel aus, die als Varianten verwendet werden sollen. Auf der rechten Seite werden die Varianten aufgebaut und den Ausprägungswerten zugeordnet.

5. Varianten speichern

Prüfen Sie die Zuordnung der Einzelartikel zu den Varianten. Speichern Sie anschließend die Konfiguration über „Speichern“. Die Varianten werden nun als Manuelle-Varianten in der Schnittstelle angelegt.

Ergebnis

Die ausgewählten Einzelartikel sind nun zu einer Variantenstruktur zusammengefasst. V

Damit die maniacSchnittstelle reibungslos Daten zwischen Ihrem Shop und der SelectLine Warenwirtschaft austauschen kann, ist eine korrekte Konfiguration im SelectLine Server (Benutzerverwaltung) zwingend erforderlich.

Eine fehlerhafte Zuweisung führt oft dazu, dass Daten (wie Bestände oder Preise) unvollständig, gar nicht oder – im schlimmsten Fall – aus einem falschen Mandanten geladen werden.

Warum ist das wichtig?

Die Schnittstelle greift über einen API-Benutzer auf Ihre SL API zu. Wenn dieser Benutzer im SelectLine Server nicht explizit dem Mandanten zugewiesen ist, mit dem er arbeiten soll, “weiß” die Schnittstelle nicht, wohin Daten geschrieben oder gelsen werden.

So prüfen und korrigieren Sie die Einstellung:

1. SelectLine Server öffnen: Melden Sie sich als Administrator am SelectLine Server an.

2. Benutzerverwaltung aufrufen: Navigieren Sie im Menü links zu Benutzerverwaltung -> Benutzer.

3. API-Benutzer auswählen: Wählen Sie den Benutzer aus, den Sie für die Shopware-Anbindung / maniacSchnittstelle nutzen (oft “Admin” oder ein eigens angelegter API-User).

4. Berechtigungen prüfen:

   • Klicken Sie im Reiter auf Berechtigungen und dann auf Anwendungen / Module.

   • Wählen Sie in der Liste den Punkt Shopware-Anbindung (oder das entsprechende Modul der Schnittstelle) aus.

5. Mandanten-Zuweisung kontrollieren:

   • Auf der rechten Seite erscheint nun das Feld Gewählter Mandant.

   • Wichtig: Hier muss zwingend der Mandant ausgewählt sein, der mit Ihrem Shop verknüpft ist (z. B. Muster Warenwirtschaft Deutschland).

💡 Achtung bei mehreren Mandanten

Falls Sie mit mehreren Mandanten arbeiten, stellen Sie sicher, dass hier kein “Standard-Mandant” hinterlegt ist, der eigentlich nicht für den Webshop vorgesehen ist.

Mögliche Fehlersymptome bei falscher Einstellung:

• Bestellungen werden nicht in die Warenwirtschaft übertragen.

• Lagerbestände im Shop werden nicht aktualisiert.

• Preise im Shop weichen von den Stammdaten ab.

• Fehlermeldungen in den Logs der maniacSchnittstelle bezüglich der Authentifizierung oder Datenbank-Zugriffen.

Sie haben die Einstellung geprüft und es werden weiterhin keine Daten geladen? Bitte starten Sie nach der Änderung den SelectLine API-Dienst einmal neu, um sicherzustellen, dass die neuen Berechtigungen aktiv sind.

Um sicherzustellen, dass die Kategorienstruktur in Ihrer maniacSeller-Schnittstelle exakt dem Stand Ihres Webshops entspricht, können Sie manuell einen Abgleich anstoßen. Dies ist besonders nach Änderungen direkt im Backend des Shops (z. B. Umbenennungen oder Verschiebungen in Shopware) notwendig.

So führen Sie den Abgleich durch

Der Abgleich wird direkt im Bereich der Artikelverwaltung gestartet:

1. Wechseln Sie in der oberen Navigationsleiste auf den Reiter Artikel & Kategorien.

2. Auf der linken Seite sehen Sie den Bereich Webshop Kategorien, in dem Ihre aktuelle Baumstruktur (z. B. beginnend mit “Home”) angezeigt wird.

3. Klicken Sie mit der rechten Maustaste auf eine Stelle innerhalb des Kategorie-Baums oder auf einen spezifischen Ordner.

4. Wählen Sie im erscheinenden Kontextmenü den Punkt “Mit Shop abgleichen” aus.

Was passiert beim Abgleich?

• Struktur-Update: Die Schnittstelle fragt die aktuelle Kategorie-Hierarchie via API vom Webshop ab.

• Synchronität: Neue Kategorien werden im Baum ergänzt, gelöschte oder verschobene Kategorien werden entsprechend aktualisiert.

• Vorbereitung für Artikelzuordnung: Erst nach dem Abgleich stehen Ihnen neue Kategorien zur Verfügung, um Sage-Artikel korrekt für den Upload zuzuordnen.

[!TIP] Performance-Hinweis: Sollten Sie eine sehr komplexe Kategoriestruktur mit hunderten Unterordnern haben, kann der Vorgang einige Sekunden dauern. Führen Sie den Abgleich am besten immer dann durch, wenn Sie strukturelle Änderungen im Shop-Backend vorgenommen haben, bevor Sie neue Artikel hochladen.

Um die Wiederauffüllzeit Ihrer Artikel aus der SelectLine Warenwirtschaft korrekt an Ihren Webshop zu übertragen, müssen Sie das entsprechende Feld in der maniacSellerGen2 Schnittstelle einmalig zuordnen (mappen).

1. Feld-Mapping in den Einstellungen

Zuerst muss der Schnittstelle mitgeteilt werden, aus welchem Feld in der SelectLine die Information für die Wiederauffüllzeit bezogen werden soll.

• Navigieren Sie in der maniacSeller-Oberfläche zu Einstellungen.

• Wählen Sie in der linken Menüleiste den Punkt Freie Textfelder.

• Klicken Sie im rechten Fensterbereich auf den Reiter Standardfelder.

• Suchen Sie in der Spalte maniacSeller Feld den Eintrag Wiederauffüllzeit.

• Wählen Sie in der dazugehörigen Spalte SelectLine Artikelfeld das Feld aus, in dem Sie die Zeit in der SelectLine pflegen (z.B. ein Extrafeld oder ein Zusatzfeld wie „Zusatz“).

2. Datentransfer und Artikelupload

Sobald das Mapping aktiv ist, findet die Übertragung automatisch statt:

1. Pflege in SelectLine: Tragen Sie den gewünschten Wert für die Wiederauffüllzeit beim jeweiligen Artikel in der SelectLine ein.

2. Synchronisation: Beim nächsten Artikelupload über maniacSeller wird dieser Wert 1:1 aus dem gewählten SelectLine-Feld ausgelesen.

3. Anzeige im Webshop: Der Wert wird an das entsprechende Feld im Webshop übergeben und dort (je nach Template-Einstellung) dem Kunden angezeigt.

In der maniacSeller Schnittstelle haben Sie die Möglichkeit, gezielte Datenbank-Aktionen direkt nach der Anlage von Kunden oder Belegen auszuführen. Diese Funktionen werden über Makros gesteuert, die in der SelectLine-Tabelle APIMacro hinterlegt sind.

1. Funktionsweise

Makros erlauben es, automatisierte SQL-Befehle (z. B. UPDATE oder SELECT) auszuführen, sobald ein bestimmtes Ereignis in der Schnittstelle abgeschlossen wurde.

• Trigger: Nach erfolgreicher Neuanlage eines Datensatzes.

• Datenquelle: Die verfügbaren Makros werden direkt aus der Tabelle APIMacro Ihrer SelectLine-Datenbank ausgelesen.

• Flexibilität: Sie können Werte in Zusatzfeldern setzen, Status ändern oder logische Prüfungen durchführen.

2. Einrichtung in der maniacSeller Oberfläche

Die Zuweisung erfolgt in den Einstellungen der Schnittstelle unter den jeweiligen Fachbereichen:

A. Makro nach Kundenanlage

Wenn ein neuer Kunde (Debitor) aus dem Webshop importiert wird, kann im Anschluss ein Makro ausgeführt werden.

• Pfad: Einstellungen > Bestands- & Neukunden

• Feld: Macro nach Kundenanlage

• Beispiel-Anwendung: Setzen einer speziellen Kundengruppe oder Preisliste basierend auf Shop-Attributen.

B. Makro nach Beleganlage

Nachdem eine Bestellung erfolgreich als Beleg (z. B. Auftrag) in SelectLine angelegt wurde, triggert dieses Makro.

• Pfad: Einstellungen > Belegoptionen

• Feld: Macro nach Beleganlage

• Beispiel-Anwendung: Schreiben eines festen Textes in das Feld FreierText1 (z. B. “Toller Makrotext”) oder Anpassung von Lieferbedingungen.

3. Technische Basis (Tabelle: APIMacro)

Damit ein Makro in der Auswahl erscheint, muss es in der SQL-Tabelle APIMacro definiert sein. Hier ein Einblick in die Struktur:

Beispiel für ein Beleg-Makro (SQL):

UPDATE [BELEG] 
SET FreierText1 = 'Importiert via maniacSeller' 
WHERE [Belegtyp]=:Belegtyp AND [Belegnummer]=:Belegnummer

Hinweis: Die Schnittstelle übergibt automatisch Parameter wie :Belegnummer oder :Nummer (bei Kunden), die im SQL-Statement verwendet werden können.

4. Wichtige Hinweise & Troubleshooting

[!CAUTION]

SQL-Kenntnisse erforderlich: Änderungen in der Tabelle APIMacro wirken sich direkt auf Ihre Datenbank aus. Testen Sie SQL-Statements immer zuerst in einer Testumgebung.

• Makro erscheint nicht? Stellen Sie sicher, dass das Makro korrekt in der Tabelle APIMacro gespeichert wurde und die Schnittstelle Zugriff auf diese Tabelle hat.

• Platzhalter: Verwenden Sie die korrekten Doppelpunkt-Parameter (z.B. :Nummer), damit das Makro den Bezug zum gerade erstellten Datensatz findet.

• Cache: Falls Sie ein neues Makro in SQL angelegt haben, laden Sie die Einstellungen in der Schnittstelle ggf. neu, um die Liste zu aktualisieren.

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.

Die Schnittstelle holt sich dafür die Folgebelege, des in der Schnittsteller erzeugten initialen Belegs und prüft, ob dort im Verlauf eine Teilrechnung (T) oder eine Rechnung (R) zu finden ist.
Wenn die Prüfung einen Treffer ergibt, prüfen sie den Vorbeleg auf Status 2 oder 3, um zu sehen, dass dieser erledigt ist.

Ist dies auch der Fall, wird im 3. Schritt noch per API auf “OutstandingPositionStatus” geprüft.  Dieser muss laut den Vorgaben der SelectLine-API den Wert B haben. Dann gilt er als bezahlt und die Schnittstelle überträgt dies entsprechend an den Zahlungsstatus der Bestellung im Shop.

Es werden aber erst Bestellungen geprüft, die nach dem Aktivieren des Schalters eingelesen wurden, da dadurch die Spalte “ZahlungErledigt” in der Schnittstellentabelle manBestellungenStatus auf false gesetzt wird. Ist der Schalter deaktiviert, werden diese mit true geschrieben.

Wichtig!

Diese Anleitung richtig sich nur an Schnittstellen Nutzer, welche die Automatikprozesse nach dem alten Prinzip vor der Version 1.7.50.0 nutzen. Alle Automatikprozesse, die danach angelegt wurden, sollten über die Anleitung, die oben verlinkt ist, erfolgen.

Wichtige Anmerkung: Bitte kontaktieren Sie uns, damit wir gemeinsam mit Ihnen die Vorbereitung für die Nutzung der automatischen Prozesse schaffen.

Auf diesem Konfigurationsbildschirm haben Sie die Möglichkeit, die verschiedenen automatischen Prozesse für die Shopware-Schnittstelle zur Warenwirtschaft zu konfigurieren und zu aktivieren.

Aktuell stehen die folgenden Prozesse zur Verfügung

• Automatischer Download der Bestellungen vom Shop
• Automatische Neukundenanlage
• Automatische Belegverarbeitung
• Automatischer Upload der Auftragsstati zum Shop (z. B. Vollständig geliefert)
• Automatischer Upload der Lagerbestände zum Shop

Zu einem späteren Zeitpunkt zu implementierende Funktionen

• Automatischer Upload der Artikel zum Shop
• Automatischer Upload der Kunden zum Shop
• Automatischer Upload der Preise zum Shop

Sie können die gewünschten Prozesse einfach in den Einstellungen aktivieren. Auf Ihren Server richten wir gerne mit Ihnen gemeinsam den automatischen Dienst ein, der diese Prozesse automatisiert abarbeitet.

Einrichten der Schnittstelle für den Automatikbetrieb  

• Installieren der SelectLine Shopware-Anbindung auf einem Recher/ Server, der permanent in Betrieb ist. Dabei ist wie bei der Installation eines zusätzlichen Clients vorzugehen.
• Installieren und Lizenzieren der Software AlwaysUp auf diesem Server. https://www.coretechnologies.com/products/AlwaysUp/
• Einrichten der AlwaysUp Software:
  1. Legen Sie ein neues Profil über einen Klick auf das Plus links oben an.
     

Im Reiter General vergeben Sie einen aussagekräftigen Namen, z. B. “SelectLine Shopautomatik Shop 1”
Im Feld Application tragen Sie den Pfad zum Schnittstellenprogramm ein.
Das ist im Standard: C:\Program Files (x86)\maniac developer GmbH\maniacSeller Shopschnittstelle\maniacConnect.exe
Im Feld Arguments tragen Sie folgendes ein: -auto -wsid:x, wobei das x für die ID des Webshops ist, welche Sie rechts oben in der Schnittstelle vor der
URL des Webshops ablesen können.

Sie können einfach folgende Werte und Einstellungen aus den Screenshots entnehmen

• Die anderen Reiter können Sie wie vorgegeben belassen. Klicken Sie im Anschluss auf Save >>
• Wir empfehlen die erweiterte Anzeige über den Menüpunkt View » Activity Pane oder die Taste F2 zu aktivieren
• Nun können Sie über den Play-Button den Automatikbetrieb starten.

Bitte beachten Sie:

• Immer wenn Sie in der SelectLine Shopware-Anbindung im Reiter Automatikprozesse eine Änderung vornehmen, müssen Sie den Dienst neu starten.
• Vor einem Update müssen Sie den Dienst stoppen und nach dem Update wieder starten.