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.

Shop-System	U Bestellungen einlesen	V leere Passworte füllen	Y FTP-Protokoll	Z Protokoll
brShop24	✓	–	–	✓
modified eCommerce	✓	✓	–	✓
VShop 4.0	✓	✓	✓	✓
So.CONNECT	✓	–	–	✓
VendoSys	✓	–	–	✓
Alka	✓	–	–	✓
individuell OpenTRANS	✓	–	–	✓

HINWEIS: 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 Allgemein.Aktiv 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:

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 `data\shop\<Nummer>\xml`	Archiv `data\shop\<Nummer>\xml_archiv`
modified eCommerce	OBS ruft die offenen Bestellungen direkt beim Shop ab.	Kopie der Bestellung im Archiv `data\shop\<Nummer>\orders`

<Nummer> ist die dreistellige Nummer der Schnittstelle aus der Liste Internet-Shops. Wie die Dateien in das Verzeichnis gelangen, zum Beispiel über die 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 data\shop\<Nummer>\err 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 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 Import.Info.EMail auf J, erhalten sie stattdessen eine E-Mail.
Steht Import.AU.AutoAblehnen.Aktiv 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 Import.AU.AutoAblehnen.TB.

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 (Import.AU.Datei.Typ = 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

Meldung	Bedeutung
„Keine XML-Dateien zum Importieren gefunden!“ mit Pfad	-	„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 `Import.AU.Datei.Typ` eingestellte Format der Bestelldateien kennt OBS nicht.

Damit die Bestellungen regelmäßig von selbst eingelesen werden, richten Sie eine Automatik ein, siehe Automatiken. Wie OBS die Artikel aus der Bestellung zuordnet, steht unter Artikeltausch und in den 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 VShop 4.0 und modified eCommerce.

X Konfiguration

Öffnet die Einstellungen der Schnittstelle. Wie die Liste der Einstellungen funktioniert, steht unter Konfiguration.

Y FTP-Protokoll

Zeigt das Protokoll des FTP-Jobs, der die Bestelldateien abholt. Vorhanden nur bei 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!“:

FTP.Host
FTP.Login.Benutzer
FTP.Login.Passwort
FTP.Verzeichnis.IN
FTP.Verzeichnis.OUT

OBS legt den Job in der 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.

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

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.

Einstellung	Standard	Bedeutung
`Allgemein.Debug`	N	J schaltet den Debugmodus ein.
`Allgemein.Debug.LogLevel`	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