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.

Öffnen Sie Ihren SL.mobile Manager und wechseln Sie auf die Seite „Website“

Für Sie ist der zweite Link relevant. In unserem Beispiel steht dort: https://localhost:443/slmobileApi/help oder http://localhost:81/slmobileApi/help

Der Port (z. B. 443) kann in Ihrem System anders sein und in Ihrer Systemumgebung steht anstatt localhost ggf. Ihr SelectLine API Servername oder eine IP-Adresse.

Das /help müssen Sie weglassen, um auf die relevante URL zu kommen.
In unserem Beispiel wäre also die richtige URL: https://localhost:443/slmobileApi für die verschlüsselte Kommunikation oderhttp://localhost:81/slmobileApi für die unverschlüsselte Kommunikation (im lokalen Netzwerk ausreichend)

Den Benutzernamen und das zugehörige Passwort können Sie bei Ihrem SelectLine Partner erfragen, der Ihnen die SelectLinew API eingerichtet hat.

Informationen zur Einrichtung des SL.mobile Managers für die Webshopschnittstelle SelectLine zu Shopware können Sie hier nachlesen.

Bitte beachten Sie
Die SelectLine API-URL (z. B. http://meinselectlineserver:81/slmobileApi) muss auch von den Arbeitsplatzrechnern aus unbeschränkt erreichbar sein!

Nach dem Einlesen der entsprechenden Lizenz in der SelectLine müssen Sie dann die für die Shopschnittstelle relevanten Benutzer anlegen.
Für die Anlage der Webshop-Benutzer ist ein eigenständige Schaltfläche vorgesehen