MINERVA-Nimz: Neue Übersicht der Automatiken und Services aller Shop-Schnittstellen (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]

2026-11-03T15:26:15Z

Neue Übersicht der Automatiken und Services aller Shop-Schnittstellen (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]

Neue Seite

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

== Grundlagen ==
=== Automatik einrichten ===
Jede Automatik richten Sie als automatischen Vorgang ein. Sie erreichen die Liste über '''Stammdaten → Q Automatische Vorgänge''', siehe [[OBS/Stammdaten/Automatische Vorgänge|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:

<syntaxhighlight lang="delphi">
ShopGetBestellungen('001')
ShopSetPreise('001',True,'')
</syntaxhighlight>

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|1=Die Automatiken arbeiten nur, wenn die Shop-Schnittstelle in der [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Konfiguration|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 <code>ShopGetBestellungen</code> die Bestelldateien ein, die im Verzeichnis der Schnittstelle liegen. Die Dateien holt in der Regel ein Eintrag der [[OBS/Zusatzprogramme/FTP Jobliste|FTP Jobliste]] ab.

'''Empfohlene Intervalle'''
{| class="wikitable"
! Automatik !! Intervall
|-
| <code>ShopGetBestellungen</code> || alle 5 bis 10 Minuten
|-
| <code>ExecShopJob</code> || alle 5 bis 30 Minuten. Je Lauf wird ein Shop-Job ausgeführt.
|-
| <code>ShopCheckExterneJobs</code> || alle 30 Minuten
|-
| <code>ShopSetBestand</code>, <code>ShopModTracking</code>, <code>ShopExportRechnung</code> || alle 30 Minuten bis täglich
|-
| <code>ShopSetPreise</code> || täglich, nach den Automatiken für die Preislisten
|-
| <code>XTCArtikelAenderungAutomatik</code>, <code>ShopPruefeArtikelAenderung</code> || täglich, nach der Artikelpflege
|-
| <code>BrShop24ImportDefinitionen</code> || 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|1=Der Einrichtungsassistent von [[OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24|brShop24]] legt auf Wunsch diese Automatiken an: <code>ShopGetBestellungen</code> alle 5 Minuten, <code>ShopCheckExterneJobs</code> alle 30 Minuten, <code>ShopSetPreise</code> täglich um 7:30 Uhr und <code>BrShop24ImportDefinitionen</code> sonntags um 16:00 Uhr.}}

=== ShopSetPreise ===
<syntaxhighlight lang="delphi">
ShopSetPreise('001',True,'')
</syntaxhighlight>

{| class="wikitable"
! 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 (<code><nowiki>''</nowiki></code>) ü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 <code>ShopSetPreise</code> danach, damit die aktuellen Preise übertragen werden.

=== ShopExportRechnung ===
<syntaxhighlight lang="delphi">
ShopExportRechnung('001','')
</syntaxhighlight>

{| class="wikitable"
! Parameter !! Typ !! Pflicht !! Bedeutung
|-
| Shop-Nummer || Text || ✓ || Nummer der Shop-Schnittstelle.
|-
| Rechnungsnummer || Text || ✓ || Leer (<code><nowiki>''</nowiki></code>) ü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 ===
<syntaxhighlight lang="delphi">
ShopAuchGekauft('001')
</syntaxhighlight>

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

=== ShopExportPromotion ===
<syntaxhighlight lang="delphi">
ShopExportPromotion('001')
</syntaxhighlight>

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

=== ShopArtikelPflegen ===
<syntaxhighlight lang="delphi">
ShopArtikelPflegen('001',True)
</syntaxhighlight>

{| class="wikitable"
! Parameter !! Typ !! Pflicht !! Bedeutung
|-
| Shop-Nummer || Text || ✓ || Nummer der Shop-Schnittstelle.
|-
| Prüfen || Ja/Nein || ✓ || ''True'': vorher wie <code>ShopPruefeArtikelAenderung</code> 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 <code>ShopPruefeArtikelAenderung</code>.

=== XTCArtikelAenderungAutomatik ===
<syntaxhighlight lang="delphi">
XTCArtikelAenderungAutomatik('001')
</syntaxhighlight>

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 <code>ShopSetPreise</code>. Ein Lauf überträgt höchstens eine Stunde lang Artikel. Starten Sie die Automatik nach der Artikelpflege.

=== ShopModArtikelCheck ===
<syntaxhighlight lang="delphi">
ShopModArtikelCheck('001',True,True,False,False,True)
</syntaxhighlight>

{| class="wikitable"
! 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 ===
<syntaxhighlight lang="delphi">
BrShop24_UpdateArtikel('001',2)
</syntaxhighlight>

{| class="wikitable"
! 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 ===
<syntaxhighlight lang="delphi">
BrShop24_EigeneArtikelAnlegen('001','SELECT ... FROM ...',2)
</syntaxhighlight>

{| class="wikitable"
! 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:

<code>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</code>

Weitere Spalten sind nur mit dem Präfix <code>x_</code> 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 ==
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop|Internet-Shop]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Shop-Jobs|Shop-Jobs]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Konfiguration|Konfiguration]]
* [[OBS/Stammdaten/Automatische Vorgänge|Automatische Vorgänge]]
* [[OBS/Zusatzprogramme/FTP Jobliste|FTP Jobliste]]

OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken - Versionsgeschichte

MINERVA-Nimz: Neue Übersicht der Automatiken und Services aller Shop-Schnittstellen (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]