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.

Wann ist ein Zurücksetzen des Tokens notwendig?

Nach einem Update von SelectLine kann es vorkommen, dass der API-Token:

• nicht mehr automatisch erneuert wird oder

• defekt ist und keine Verbindung mehr aufgebaut werden kann.

In solchen Fällen hilft es, den gespeicherten Token zurückzusetzen.

So setzen Sie den API-Token zurück

Der SelectLine API-Token wird in der ManiacSellerGen2-Datenbank in der Tabelle
manVerbindungenKonfig gespeichert.

Vorgehensweise:

1. Öffnen Sie Ihre SQL-Datenbankverwaltung (z. B. SQL Server Management Studio).
2. Navigieren Sie zur Datenbank ManiacSellerGen2.
3. Öffnen Sie die Tabelle manVerbindungenKonfig.
4. Suchen Sie den Eintrag für die API-Token.
5. Setzen Sie den Wert des Tokens auf NULL.

Was passiert nach dem Zurücksetzen?

Beim nächsten Verbindungsversuch mit SelectLine wird ein neuer API-Token automatisch generiert, sofern die restliche Konfiguration korrekt ist.

Hinweis

Bitte stellen Sie sicher, dass Sie über ausreichende Rechte verfügen und vor Änderungen ein Backup der Datenbank anlegen.

Die Systemvoraussetzungen für die Anbindung der SelectLine an den Shopware-Webshop.

Hier haben wir Ihnen eine Checkliste zur SelectLine Shopware Anbindung zusammengestellt.