MINERVA-Nimz: Neue Übersicht der Funktionen, die alle Shop-Schnittstellen gemeinsam haben (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]

2026-11-03T15:26:08Z

Neue Übersicht der Funktionen, die alle Shop-Schnittstellen gemeinsam haben (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]

Neue Seite

{{Vorlage:Kostenpflichtige Module}}
{{Seitentyp|Übersicht}}
= Allgemeine Funktionen =

Viele Shop-Schnittstellen bringen dieselben Grundfunktionen mit: Bestellungen einlesen, Passwörter für Kunden erzeugen und nachsehen, was bei der Übertragung passiert ist. Diese Seite beschreibt die Einträge des Shop-Menüs, die mehrere Shop-Systeme gemeinsam haben. Sie öffnen das Shop-Menü in der Liste '''Internet-Shops''' mit {{F10}} auf der markierten Schnittstelle. Die Liste erreichen Sie über '''Stammdaten → Schnittstellen → Internet-Shop'''.

Welche weiteren Einträge ein Shop-System bietet, steht auf seiner Seite.

{| class="wikitable"
! Shop-System !! U Bestellungen einlesen !! V leere Passworte füllen !! Y FTP-Protokoll !! Z Protokoll
|-
| [[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]] || ✓ || – || – || ✓
|}

{{Hinweis|1='''U Bestellungen einlesen''' und '''V leere Passworte füllen''' erscheinen nur, wenn die Schnittstelle aktiv ist. Dafür muss der Programmparameter 633 ''Internet-Shop vorhanden'' aktiviert sein und in der Konfiguration der Schnittstelle <code>Allgemein.Aktiv</code> auf ''J'' stehen. '''X Konfiguration''', '''Y FTP-Protokoll''' und '''Z Protokoll''' erscheinen unabhängig davon.}}

== U Bestellungen einlesen ==
Mit diesem Eintrag lesen Sie die Bestellungen aus dem Shop sofort ein, ohne auf die nächste Automatik zu warten. Jede Bestellung wird ein Auftrag in OBS.

Wie die Bestellungen zu OBS kommen, hängt vom Shop-System ab:

{| class="wikitable"
! Shop-System !! Woher OBS die Bestellungen liest !! Wohin die Bestellung danach geht
|-
| brShop24, VShop 4.0, So.CONNECT, VendoSys, Alka, individuell OpenTRANS || XML-Dateien im Verzeichnis <code>data\shop\<Nummer>\xml</code> || Archiv <code>data\shop\<Nummer>\xml_archiv</code>
|-
| modified eCommerce || OBS ruft die offenen Bestellungen direkt beim Shop ab. || Kopie der Bestellung im Archiv <code>data\shop\<Nummer>\orders</code>
|}

<code><Nummer></code> ist die dreistellige Nummer der Schnittstelle aus der Liste '''Internet-Shops'''. Wie die Dateien in das Verzeichnis gelangen, zum Beispiel über die [[OBS/Zusatzprogramme/FTP Jobliste|FTP Jobliste]], steht auf der Seite des Shop-Systems.

=== Ablauf ===
# OBS sucht die Bestellungen der Schnittstelle. Bei den Datei-Schnittstellen zeigt ein Fortschrittsbalken, welche Datei gerade eingelesen wird.
# Für jede Bestellung legt OBS einen Auftrag an.
# OBS verschiebt die eingelesene Datei ins Archiv. Dort liegt sie mit vorangestelltem Datum und Uhrzeit des Imports in nummerierten ZIP-Dateien mit jeweils höchstens 5.000 Dateien.
# Bei modified eCommerce setzt OBS zusätzlich den Status der Bestellung im Shop.

Bei OpenTRANS-Dateien prüft OBS die Datei vor dem Einlesen. Eine leere Datei löscht OBS. Fehlt eine Pflichtangabe oder passt die OpenTRANS-Version nicht, verschiebt OBS die Datei nach <code>data\shop\<Nummer>\err</code> und legt keinen Auftrag an.

Läuft das Einlesen für dieselbe Schnittstelle bereits, zum Beispiel über eine Automatik, startet OBS es nicht ein zweites Mal.

=== Ergebnis ===
Die neuen Aufträge finden Sie in der Auftragsliste. Außerdem gilt:
* Im [[#Z Protokoll|Protokoll]] steht je Auftrag ein Eintrag „Auftrag angelegt“ mit der OBS-Auftragsnummer und der Bestellnummer aus dem Shop.
* Benutzer, bei denen '''Meldung bei Internetbestellungen (Shop)''' aktiviert ist, erhalten eine Aufgabe „Neuer Auftrag … für Kunde … angelegt“ mit Shop, Referenz, Kundenname und Betrag. Steht <code>Import.Info.EMail</code> auf ''J'', erhalten sie stattdessen eine E-Mail.
* Steht <code>Import.AU.AutoAblehnen.Aktiv</code> auf ''J'' und ist der Kunde für Aufträge gesperrt, lehnt OBS den Auftrag automatisch ab. Den Grund nimmt OBS aus dem Textbaustein in <code>Import.AU.AutoAblehnen.TB</code>.

=== Bereits eingelesene Dateien ===
OBS merkt sich jede eingelesene Datei mit Name und Inhalt. Liegt dieselbe Datei noch einmal im Verzeichnis, fragt OBS bei brShop24, VShop 4.0, So.CONNECT, Alka, individuell OpenTRANS und bei VendoSys mit OpenTRANS-Dateien (<code>Import.AU.Datei.Typ</code> = ''002'') nach: „Datei … wurde bereits importiert. Soll die Datei nochmal importiert werden?“
* ''Ja'' – OBS liest die Datei erneut ein und legt die Aufträge noch einmal an.
* ''Nein'' (vorbelegt) – OBS löscht die Datei aus dem Verzeichnis, ohne sie einzulesen.

=== Meldungen ===
{| class="wikitable"
! Meldung !! Bedeutung
|-
| „Keine XML-Dateien zum Importieren gefunden!“ mit Pfad || Im Verzeichnis liegt keine Bestelldatei.|-
| „Datei … konnte nicht eingelesen werden“ || Aus der Datei konnte OBS keinen Auftrag anlegen. Die Meldung steht auch im Protokoll.
|-
| „Import-Typ wird nicht unterstützt!“ || Nur VendoSys: Das in <code>Import.AU.Datei.Typ</code> eingestellte Format der Bestelldateien kennt OBS nicht.
|}

Damit die Bestellungen regelmäßig von selbst eingelesen werden, richten Sie eine Automatik ein, siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|Automatiken]]. Wie OBS die Artikel aus der Bestellung zuordnet, steht unter [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Artikeltausch|Artikeltausch]] und in den [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Häufig gestellte Fragen|häufig gestellten Fragen]].

== V leere Passworte füllen ==
Mit diesem Eintrag erzeugen Sie Internet-Passwörter für Kunden, die noch keins haben. Grundlage ist eine Personenauswertung.

# Wählen Sie '''V leere Passworte füllen'''.
# OBS fragt: „Bereits vorhandene Passworte werden NICHT neu erzeugt! Vorgang fortsetzen?“ Bestätigen Sie mit ''Ja''.
# Wählen Sie die Personenauswertung aus.
# OBS erzeugt für jede Person der Auswertung ohne Internet-Passwort ein zufälliges Passwort aus 12 Zeichen mit einem Sonderzeichen und speichert es verschlüsselt im Personenstamm.

Vorhandene Passwörter bleiben unverändert. Die Funktion schreibt nur in OBS und überträgt nichts in den Shop. Sie gilt für die Personen der Auswertung, unabhängig davon, aus welcher Schnittstelle Sie sie aufrufen. In den Shop gelangen die Passwörter mit der Übertragung der Personen, siehe die Seite des Shop-Systems.

Vorhanden bei [[OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0|VShop 4.0]] und [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce|modified eCommerce]].

== X Konfiguration ==
Öffnet die Einstellungen der Schnittstelle. Wie die Liste der Einstellungen funktioniert, steht unter [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Konfiguration|Konfiguration]].

== Y FTP-Protokoll ==
Zeigt das Protokoll des FTP-Jobs, der die Bestelldateien abholt. Vorhanden nur bei [[OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0|VShop 4.0]].

Den FTP-Job legen Sie in der Konfiguration der Schnittstelle mit {{F7}} '''FTP-Job''' an. Das dürfen Benutzer mit Level 9. Vorher müssen diese Einstellungen gefüllt sein, sonst erscheint „Bitte FTP-Einstellungen vollständig hinterlegen!“:
* <code>FTP.Host</code>
* <code>FTP.Login.Benutzer</code>
* <code>FTP.Login.Passwort</code>
* <code>FTP.Verzeichnis.IN</code>
* <code>FTP.Verzeichnis.OUT</code>

OBS legt den Job in der [[OBS/Zusatzprogramme/FTP Jobliste|FTP Jobliste]] mit dem Namen ''Shop Bestellungen'' und der Bezeichnung ''Internetshop <Nummer> Bestellabholung'' an. Gibt es einen Job mit denselben FTP-Angaben schon, verwendet OBS diesen.

Das Fenster '''FTP Protokoll''' zeigt die Spalten '''Text''', '''Datum''' und '''Zeit'''. Mit {{F3}} drucken Sie das Protokoll.

== Z Protokoll ==
Das Fenster '''Shop Protokoll''' zeigt Hinweise und Fehler, die bei den Übertragungen der Schnittstelle entstanden sind, zum Beispiel beim Einlesen von Bestellungen. Die neuesten Einträge stehen oben. Sie sehen die Einträge bis zu Ihrem Benutzerlevel für die Shop-Schnittstellen.

Vorhanden bei allen Shop-Systemen.

{| class="wikitable"
! Spalte !! Inhalt
|-
| '''Lfd-Nr''' || Laufende Nummer des Eintrags
|-
| '''Datum''', '''Zeit''' || Zeitpunkt des Eintrags
|-
| '''Nummer''' || Nummer des Vorgangs. Alle Einträge eines Durchlaufs, zum Beispiel eines Einlesens, haben dieselbe Nummer.
|-
| '''Text''' || Hinweis oder Fehlermeldung
|-
| '''Benutzer''' || Benutzer, der den Vorgang ausgeführt hat
|-
| '''Aktion''' || Nummer der Funktion, zum Beispiel Bestellungen einlesen
|-
| '''Dienst''' || OBS-Dienst, wenn der Vorgang im Hintergrund lief
|}

{| class="wikitable"
! Taste !! Funktion
|-
| {{F6}} || '''Task''': Zeigt nur die Einträge zu einer Nummer. OBS fragt die gesuchte Nummer ab.
|-
| {{F7}} || '''Action''': Zeigt nur die Einträge einer Aktion. Sie wählen die Aktion aus der Liste '''Filtern nach Aktion'''.
|-
| {{F8}} || '''Text''': Zeigt nur Einträge, deren Text den eingegebenen Begriff enthält.
|-
| {{F9}} || '''Reset''': Hebt alle Filter wieder auf.
|}

Benutzer mit Level 9 sehen zusätzlich die Auswahl '''Log-Level''' (''0'' bis ''5''). Bei ''0'' zeigt das Protokoll nur die regulären Einträge, mit höherem Wert auch die zusätzlichen Einträge des Debugmodus.

=== Debugmodus ===
Reichen die regulären Einträge für die Fehlersuche nicht, schalten Sie in der Konfiguration der Schnittstelle den Debugmodus ein. Er erweitert das Protokoll um zusätzliche Einträge. Schalten Sie ihn nur in Problemfällen ein und danach wieder aus.

{| class="wikitable"
! Einstellung !! Standard !! Bedeutung
|-
| <code>Allgemein.Debug</code> || ''N'' || ''J'' schaltet den Debugmodus ein.
|-
| <code>Allgemein.Debug.LogLevel</code> || ''0'' || Umfang der zusätzlichen Einträge von ''0'' (keine) bis ''5'' (alles).
|}

Die zusätzlichen Einträge sehen nur Benutzer mit Level 9.

== Siehe auch ==
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop|Internet-Shop]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Konfiguration|Konfiguration]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|Automatiken]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Administration|Administration]]
* [[OBS/Zusatzprogramme/FTP Jobliste|FTP Jobliste]]

OBS/Stammdaten/Schnittstellen/Internet-Shop/Allgemeine Funktionen - Versionsgeschichte

MINERVA-Nimz: Neue Übersicht der Funktionen, die alle Shop-Schnittstellen gemeinsam haben (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]