Automatiken

Mit den Shop-Automatiken lassen Sie OBS die wiederkehrenden Aufgaben Ihrer Shop-Schnittstelle selbst erledigen: Bestellungen einlesen, Preise und Bestände übertragen, Artikel aktuell halten. Sie richten jede Automatik einmal als automatischen Vorgang ein, danach führt ein OBS-Dienst sie regelmäßig im Hintergrund aus. Diese Seite zeigt, welche Automatiken es gibt, für welche Shop-Systeme sie gelten und wie Sie sie einrichten.

Verfügbare Automatiken

Automatik	Wofür	brShop24	modified eCommerce	VShop 4.0	So.CONNECT	VendoSys	Alka	individuell OpenTRANS
`ShopGetBestellungen`	Liest neue Bestellungen aus dem Shop als Aufträge in OBS ein.	✓	✓	✓	✓	✓	✓	✓
`ShopSetPreise`	Überträgt die Preise bzw. Preislisten in den Shop.	✓	✓ (1.x, 2.x)	✓	✓	✓	–	–
`ShopSetBestand`	Überträgt die Lagerbestände in den Shop.	✓	✓	–	–	–	–	–
`ExecShopJob`	Arbeitet die Shop-Jobs ab, die Benutzer zur Ausführung im Hintergrund angelegt haben.	–	✓	✓	–	–	–	–
`ShopModTracking`	Überträgt den Bearbeitungsstand der Shop-Aufträge und die Sendungsverfolgung in den Shop.	–	✓	–	–	–	–	–
`ShopExportRechnung`	Überträgt gedruckte Rechnungen zu Shop-Aufträgen als PDF in den Shop.	–	✓ (2.x, 3.x)	–	–	–	–	–
`ShopAuchGekauft`	Überträgt die Artikelempfehlungen „Kunden kauften auch“ in den Shop.	–	✓ (2.x, 3.x)	–	–	–	–	–
`ShopExportPromotion`	Wählt Artikel aus laufenden Aktionen aus und überträgt sie für die Hauptseite des Shops.	–	✓ (nur 2.x)	–	–	–	–	–
`ShopAutoFillMerkmale`	Gibt neue Merkmale und Artikelmerkmale automatisch für die Schnittstelle frei.	✓	✓ (2.x, 3.x)	–	–	–	–	–
`ShopPruefeArtikelAenderung`	Prüft die Shop-Artikel auf Änderungen und merkt geänderte Artikel zur Übertragung vor.	–	✓ (2.x, 3.x)	–	–	–	–	–
`ShopArtikelPflegen`	Überträgt die vorgemerkten Artikel in den Shop, auf Wunsch mit vorheriger Prüfung.	–	✓ (2.x, 3.x)	–	–	–	–	–
`XTCArtikelAenderungAutomatik`	Prüft die Shop-Artikel auf Änderungen und überträgt geänderte Artikel in den Shop.	–	✓ (nur 1.x)	–	–	–	–	–
`ShopModArtikelCheck`	Gleicht Artikelstatus, Kategoriezuordnung und Kataloge zwischen OBS und Shop ab.	–	✓ (nur 1.x)	–	–	–	–	–
`ShopSetVerfuegbarkeit`	Stößt im Shop das Einlesen der Verfügbarkeiten an.	–	✓ (nur 1.x)	–	–	–	–	–
`ShopCheckExterneJobs`	Holt Status und Protokoll der Verarbeitungsjobs aus dem Shop ab.	✓	–	–	–	–	–	–
`BrShop24ImportDefinitionen`	Importiert die Definitionen des Shops, z.B. Lager, Hersteller und Kataloge.	✓	–	–	–	–	–	–
`BrShop24_UpdateArtikel`	Überträgt alle Artikel der Schnittstelle erneut in den Shop.	✓	–	–	–	–	–	–
`BrShop24_EigeneArtikelAnlegen`	Legt eigene Artikel anhand einer SQL-Abfrage für den Shop an.	✓	–	–	–	–	–	–

Erläuterung

Automatik – der Name, den Sie im Feld Macro des automatischen Vorgangs eintragen, siehe Automatik einrichten.
✓ – die Automatik arbeitet mit diesem Shop-System. – – die Automatik ist für dieses Shop-System nicht verfügbar.
(nur 1.x), (nur 2.x), (1.x, 2.x) bzw. (2.x, 3.x) – gilt nur für diese Versionen der Schnittstelle modified eCommerce. Ohne Angabe gilt die Automatik für die Versionen 1.x, 2.x und 3.x.
ExecShopJob – Shop-Jobs entstehen, wenn Sie eine Übertragung im Hintergrund ausführen lassen. Das bieten die Schnittstellen modified eCommerce und VShop 4.0 an, siehe Shop-Jobs.

Grundlagen

Automatik einrichten

Jede Automatik richten Sie als automatischen Vorgang ein. Sie erreichen die Liste über Stammdaten → Q Automatische Vorgänge, siehe Automatische Vorgänge.

Legen Sie einen neuen Vorgang an.
Tragen Sie in Bemerkung eine kurze Beschreibung ein. Bei mehreren Shop-Schnittstellen hilft die Shop-Nummer, z.B. Shop 001 Bestellungen importieren.
Tragen Sie im Feld Macro den Aufruf der Automatik ein, siehe unten.
Legen Sie im Feld Ausführung auf PC fest, welcher OBS-Dienst die Automatik ausführt. Für die Shop-Automatiken sind das die Dienste OBS (Vorgabe 999) und Shop (Vorgabe 998). Auf das Feld haben nur wenige Benutzer Zugriff, ändern müssen Sie die Vorgabe in der Regel nicht.
Legen Sie mit nächster Start am, Uhrzeit von, Uhrzeit bis, den Intervall-Feldern und Ausführung am fest, wann und wie oft die Automatik läuft.
Stellen Sie Repeat Job und Job aktiviert auf Ja.

Aufruf im Feld Macro

Jede Automatik erwartet als ersten Parameter die dreistellige Nummer der Shop-Schnittstelle aus der Liste Internet-Shops. Texte stehen in einfachen Anführungszeichen, weitere Parameter folgen durch Komma getrennt:

ShopGetBestellungen('001')
ShopSetPreise('001',True,'')

Ja/Nein-Werte schreiben Sie als True bzw. False. Welche weiteren Parameter eine Automatik hat, steht in ihrem Abschnitt weiter unten. Automatiken ohne eigenen Abschnitt erwarten nur die Shop-Nummer.

HINWEIS: Die Automatiken arbeiten nur, wenn die Shop-Schnittstelle in der Konfiguration aktiv geschaltet ist und der OBS-Dienst läuft, den Sie unter Ausführung auf PC eingetragen haben. Läuft eine Automatik für dieselbe Schnittstelle noch, wird ein weiterer Start übersprungen. Welche Dienste laufen, zeigt das Widget Services (in den Benutzereinstellungen Aktive Services).

Bestelldateien

Bei brShop24, VShop 4.0, So.CONNECT, VendoSys, Alka und individuell OpenTRANS liest ShopGetBestellungen die Bestelldateien ein, die im Verzeichnis der Schnittstelle liegen. Die Dateien holt in der Regel ein Eintrag der FTP Jobliste ab.

Empfohlene Intervalle

Automatik	Intervall
`ShopGetBestellungen`	alle 5 bis 10 Minuten
`ExecShopJob`	alle 5 bis 30 Minuten. Je Lauf wird ein Shop-Job ausgeführt.
`ShopCheckExterneJobs`	alle 30 Minuten
`ShopSetBestand`, `ShopModTracking`, `ShopExportRechnung`	alle 30 Minuten bis täglich
`ShopSetPreise`	täglich, nach den Automatiken für die Preislisten
`XTCArtikelAenderungAutomatik`, `ShopPruefeArtikelAenderung`	täglich, nach der Artikelpflege
`BrShop24ImportDefinitionen`	wöchentlich

Für die übrigen Automatiken richten Sie das Intervall nach Ihrem Bedarf ein. Bei Automatiken im Minutentakt empfiehlt es sich, Auto-Meldung auf Nein zu stellen, damit nicht jeder Lauf eine Meldung im Archiv erzeugt.

HINWEIS: Der Einrichtungsassistent von brShop24 legt auf Wunsch diese Automatiken an: ShopGetBestellungen alle 5 Minuten, ShopCheckExterneJobs alle 30 Minuten, ShopSetPreise täglich um 7:30 Uhr und BrShop24ImportDefinitionen sonntags um 16:00 Uhr.

ShopSetPreise

ShopSetPreise('001',True,'')

Parameter	Typ	Pflicht	Bedeutung
Shop-Nummer	Text	✓	Nummer der Shop-Schnittstelle.
Automatik	Ja/Nein	–	Tragen Sie für die Automatik True ein.
Preisliste	Text	–	Nummer einer Preisliste. Leer (`''`) überträgt alle Preislisten der Schnittstelle.
Personennummer	Text	–	Überträgt nur die Preise dieser Person.

Laufen bei Ihnen Automatiken für die Preislisten, starten Sie ShopSetPreise danach, damit die aktuellen Preise übertragen werden.

ShopExportRechnung

ShopExportRechnung('001','')

Parameter	Typ	Pflicht	Bedeutung
Shop-Nummer	Text	✓	Nummer der Shop-Schnittstelle.
Rechnungsnummer	Text	✓	Leer (`''`) überträgt alle neuen und geänderten Rechnungen. Mit einer Nummer wird nur diese Rechnung übertragen.

Übertragen werden gedruckte Rechnungen, die zu einem importierten Shop-Auftrag der Schnittstelle gehören. Ihre Kunden sehen die Rechnungen im Shop bei ihren Bestellungen.

ShopAuchGekauft

ShopAuchGekauft('001')

Die Automatik überträgt nur, wenn in der Konfiguration Export.Artikel.AuchGekauft.Aktiv auf J steht.

ShopExportPromotion

ShopExportPromotion('001')

Grundlage sind die Preislisten der Schnittstelle mit der Eigenschaft 9205 SHOP Hauptseite Aktion. Wie viele Artikel übertragen werden, legt Export.Promo.Anzahl in der Konfiguration fest. Bei 0 überträgt die Automatik nichts.

ShopArtikelPflegen

ShopArtikelPflegen('001',True)

Parameter	Typ	Pflicht	Bedeutung
Shop-Nummer	Text	✓	Nummer der Shop-Schnittstelle.
Prüfen	Ja/Nein	✓	True: vorher wie `ShopPruefeArtikelAenderung` auf Änderungen prüfen. False: nur die bereits vorgemerkten Artikel übertragen.

Ein Lauf überträgt höchstens eine Stunde lang Artikel. Was übrig bleibt, überträgt der nächste Lauf. Die Prüfung auf Änderungen läuft höchstens einmal innerhalb von 24 Stunden, auch wenn die Automatik öfter startet. Das gilt ebenso für ShopPruefeArtikelAenderung.

XTCArtikelAenderungAutomatik

XTCArtikelAenderungAutomatik('001')

Die Automatik prüft die Shop-Artikel auf Änderungen und überträgt die geänderten Artikel. Preise überträgt sie dabei nicht, dafür gibt es ShopSetPreise. Ein Lauf überträgt höchstens eine Stunde lang Artikel. Starten Sie die Automatik nach der Artikelpflege.

ShopModArtikelCheck

ShopModArtikelCheck('001',True,True,False,False,True)

Parameter	Typ	Pflicht	Bedeutung
Shop-Nummer	Text	✓	Nummer der Shop-Schnittstelle.
Artikelstatus	Ja/Nein	✓	Gleicht den Status aktiv/inaktiv der Artikel im Shop mit OBS ab.
Kategorien	Ja/Nein	✓	Prüft die Kategoriezuordnung der Shop-Artikel.
Merkmale	Ja/Nein	✓	Reserviert. Tragen Sie False ein.
Referenzen	Ja/Nein	✓	Reserviert. Tragen Sie False ein.
Kataloge	Ja/Nein	✓	Überträgt die Kataloge für alle Kundengruppen.

BrShop24_UpdateArtikel

BrShop24_UpdateArtikel('001',2)

Parameter	Typ	Pflicht	Bedeutung
Shop-Nummer	Text	✓	Nummer der Shop-Schnittstelle.
Laufzeit in Stunden	Zahl	–	Bricht den Lauf nach dieser Zahl Stunden ab. Der nächste Lauf setzt beim zuletzt übertragenen Artikel fort. 0 oder ohne Angabe: keine Begrenzung.

BrShop24_EigeneArtikelAnlegen

BrShop24_EigeneArtikelAnlegen('001','SELECT ... FROM ...',2)

Parameter	Typ	Pflicht	Bedeutung
Shop-Nummer	Text	✓	Nummer der Shop-Schnittstelle.
SQL	Text	✓	Eine einzelne SELECT-Abfrage ohne Semikolon, die die anzulegenden Artikel liefert.
Laufzeit in Stunden	Zahl	✓	Bricht den Lauf nach dieser Zahl Stunden ab. Der nächste Lauf setzt fort. 0: keine Begrenzung.

Die Abfrage muss genau diese Spalten liefern:

artnr, lager, lager_artnr, lager_pflege, lager_liefstatus, lager_suchtext, pflege, hersteller, marke, bezeichnung, artbez_gruppe, produkttyp, liefstatus, suchtext, bestellmenge_min, bestellmenge_max, bestellmenge_staffel

Weitere Spalten sind nur mit dem Präfix x_ erlaubt, OBS ignoriert sie. Die Automatik legt nur neue Einträge an, vorhandene Einträge bleiben unverändert. Zeilen, die sich nicht eindeutig verarbeiten lassen, lehnt sie ab. Das Ergebnis steht im Protokoll der Schnittstelle. Bricht ein Lauf ab, erhalten die Shop-Administratoren eine Aufgabe.

Siehe auch