OBS/Stammdaten/Schnittstellen/Internet-Shop/Alka
Alka
Mit der Shop-Schnittstelle Alka liest OBS die Bestellungen aus dem Alka-Shop als Aufträge ein. Die Bestellungen liegen als openTRANS-Dateien auf einem FTP-Server, ein FTP-Job holt sie ab. So kommen die Bestellungen Ihrer Kunden ohne Abtippen als Aufträge in OBS an. Daten aus OBS, etwa Artikel, Preise oder Kunden, überträgt die Schnittstelle nicht in den Shop.
HINWEIS: Diese Seite beschreibt die Shop-Schnittstelle Alka für Bestellungen Ihrer Kunden. Bestellungen von Ihnen beim Lieferanten Alka laufen über den Lagerlieferanten, siehe Lagerlieferanten: Alka (PBS Deutschland).
| Schnittstelle in OBS | Alka |
|---|---|
| Anbindung | Dateien |
| Format Bestellungen | openTRANS 1.0 (XML) |
| Übertragungsweg Bestellungen | FTP-Job |
| Daten an den Shop | – |
| Rückmeldungen an den Shop | – |
| Übersicht | Internet-Shop |
Voraussetzungen
- Der Programmparameter 633 Internet-Shop vorhanden ist aktiviert.
- Die Schnittstelle ist kostenpflichtig. Die Konditionen nennt Ihnen Ihr OBS-Betreuer.
- Sie haben die Zugangsdaten für den FTP-Server, auf dem der Shop die Bestelldateien ablegt: Adresse, Benutzer, Passwort und Verzeichnis.
Einrichtung
- Legen Sie in der Liste Internet-Shops (Stammdaten → Schnittstellen → Internet-Shop) mit Einfg eine Schnittstelle an und wählen Sie unter Schnittstelle Alka. Das dürfen nur Benutzer mit Level 9. OBS legt die Einstellungen mit ihren Standardwerten an, gibt die Preislisten für die Schnittstelle frei und erstellt das Verzeichnis
data\shop\<Nummer>mit den Unterverzeichnissenxml,xml_archivunddebug. - Öffnen Sie im Shop-Menü X Konfiguration und tragen Sie die FTP-Zugangsdaten ein:
FTP.Host,FTP.Login.Benutzer,FTP.Login.Passwort,FTP.Verzeichnis.OUT(Verzeichnis und Dateimaske auf dem FTP-Server) undFTP.Verzeichnis.IN(Verzeichnisdata\shop\<Nummer>\xml\in OBS). - Drücken Sie in der Konfiguration F7. OBS legt in der FTP Jobliste den Job Shop Bestellungen mit der Bezeichnung Internetshop <Nummer> Bestellabholung an, der die Bestelldateien vom FTP-Server in das Verzeichnis
xmlholt. Gibt es einen Job mit denselben Zugangsdaten und Verzeichnissen schon, ordnet OBS diesen der Schnittstelle zu. F7 steht nur Benutzern mit Level 9 für die Shop-Schnittstellen zur Verfügung. - Prüfen Sie die übrigen Einstellungen unter Konfiguration, vor allem, wie OBS Personen, Adressen und Preise übernimmt. Liefert der Shop die Bestellnummern des Lieferanten statt der OBS-Artikelnummern, tragen Sie unter
Allgemein.Lagerlieferant.1den Lieferanten Alka ein, siehe Shop-Lieferanten. - Richten Sie die Automatik
ShopGetBestellungenein, damit OBS die abgeholten Dateien regelmäßig als Aufträge einliest, siehe Automatiken.
Konfiguration
Die Einstellungen öffnen Sie im Shop-Menü mit X Konfiguration. Die Liste heißt Alka Einstellungen. Wie die Liste der Einstellungen funktioniert, steht unter Internet-Shop: Konfiguration. Bei Alka gibt es dort diese Tasten:
| Taste | Funktion |
|---|---|
| ↩ Enter | Ändert den Wert der markierten Einstellung. |
| Einfg | Ergänzt fehlende Einstellungen mit ihrem Standardwert. Vorhandene Werte bleiben unverändert. |
| Entf | Löscht die markierte Einstellung. Nur mit Level 9 für die Shop-Schnittstellen. |
| F7 | Legt den FTP-Job für die Abholung der Bestellungen an, siehe Einrichtung. Dafür müssen alle Einstellungen FTP.* gefüllt sein, sonst meldet OBS „Bitte FTP-Einstellungen vollständig hinterlegen!“. Nur mit Level 9 für die Shop-Schnittstellen.
|
| F8 | Öffnet das OBS-Shop-Zuordnungsmenü mit T Artikeltausch, siehe Artikeltausch. |
| F10 | Z1 Konfiguration exportieren und Z2 Konfiguration importieren, siehe Internet-Shop: Konfiguration. |
Die Spalte Level nennt das Benutzerlevel für die Shop-Schnittstellen, das Sie mindestens brauchen, um die Einstellung zu ändern.
Allgemein
| Einstellung | Standard | Level | Bedeutung |
|---|---|---|---|
Allgemein.Aktiv |
J | 5 | Schaltet die Schnittstelle aktiv (J) oder inaktiv (N). Bei N fehlt im Shop-Menü U Bestellungen einlesen, und es werden keine Bestellungen eingelesen. |
Allgemein.Debug |
N | 9 | Debugmodus. Erweitert das Protokoll um zusätzliche Einträge und sollte nur in Problemfällen aktiv sein. |
Allgemein.Debug.LogLevel |
0 | 9 | Umfang der Protokolleinträge im Debugmodus, von 0 (keine) bis 5 (alles). |
Allgemein.Lagerlieferant.1 |
leer | 5 | Personennummer des ersten Shop-Lieferanten. Sie wählen ihn mit ↩ Enter aus. Über die Shop-Lieferanten sucht OBS die Artikel der Bestellung, siehe Shop-Lieferanten. |
Allgemein.Lagerlieferant.2 |
leer | 5 | Zweiter Shop-Lieferant, wie Allgemein.Lagerlieferant.1.
|
Allgemein.Lagerlieferant.3 |
leer | 5 | Dritter Shop-Lieferant, wie Allgemein.Lagerlieferant.1.
|
Allgemein.Lagerlieferant.4 |
leer | 5 | Vierter Shop-Lieferant, wie Allgemein.Lagerlieferant.1.
|
Allgemein.Lagerlieferant.5 |
leer | 5 | Fünfter Shop-Lieferant, wie Allgemein.Lagerlieferant.1.
|
Allgemein.Schnittstelle.Sachbearbeiter |
leer | 5 | Nummer des Shop-Sachbearbeiters. Er erhält Nachrichten und Aufgaben aus der Schnittstelle. |
Allgemein.Standard.Personen.Preisgruppe |
1 | 5 | Preisgruppe für Personen, die OBS beim Einlesen der Bestellungen neu anlegt. |
Allgemein.Standard.Zahlungsbedingung |
leer | 5 | Standard-Zahlungsbedingung für Shop-Aufträge. |
FTP
| Einstellung | Standard | Level | Bedeutung |
|---|---|---|---|
FTP.Host |
leer | 5 | Adresse des FTP-Servers. |
FTP.Login.Benutzer |
leer | 5 | Benutzername für den FTP-Server. |
FTP.Login.Passwort |
leer | 5 | Passwort für den FTP-Server. OBS speichert es verschlüsselt. |
FTP.Verzeichnis.IN |
leer | 5 | Verzeichnis in OBS, in das der FTP-Job die Bestelldateien ablegt: data\shop\<Nummer>\xml\, z.B. data\shop\001\xml\.
|
FTP.Verzeichnis.OUT |
leer | 5 | Verzeichnis und Dateimaske auf dem FTP-Server, aus dem der FTP-Job die Bestelldateien abholt. |
Import
| Einstellung | Standard | Level | Bedeutung |
|---|---|---|---|
Import.Adresse.Auftraggeber.Prio |
J | 3 | J – behält die Auftraggeberadresse aus der Bestelldatei bei. N – überschreibt sie mit den OBS-Daten. |
Import.Adresse.Rechnung |
J | 5 | Übernimmt den Rechnungsempfänger. Kann die Erlaubnis zum Anlegen von Personen erfordern (Import.Personen.Anlage).
|
Import.Adresse.Versand |
J | 5 | Übernimmt die Versandanschrift, wenn sie abweicht. |
Import.Adresse.Versand.Check |
1 | 3 | Womit OBS die Versandadresse der Bestellung vergleicht, um zu entscheiden, ob sie abweicht: 1 – mit der Adresse des Auftraggebers im Auftrag 2 – mit der Adresse des Käufers (BUYER_PARTY) aus der Bestelldatei Andere Werte behandelt OBS wie 1. |
Import.AU.Adressuebernahme |
J | 5 | Übernimmt die Adresse in den Auftrag. |
Import.AU.FTPEingang.Anlegen |
N | 3 | Legt beim Einlesen einer Bestellung einen Eintrag im FTP-Eingang an. |
Import.AU.Materialanlage |
J | 5 | J – legt das Auftragsmaterial beim Einlesen an. N – legt kein Material an. |
Import.AU.Pos.Preis.Prioritaet |
J | 5 | Mit J übernimmt OBS die Preise aus der Bestellung in den Auftrag. Mit N ermittelt OBS die Preise für jede Position selbst, mit den Preislisten der Schnittstelle. |
Import.AU.PrioShopLieferant |
N | 3 | Mit J setzt OBS beim Einlesen bevorzugt die Shop-Lieferanten (Allgemein.Lagerlieferant.1 bis Allgemein.Lagerlieferant.5) als Lieferant für Position und Material ein. Sonst immer den ersten Lieferanten des Artikels.
|
Import.AU.Standard.Filiale |
leer | 3 | Filiale für den Auftrag, wenn OBS auf anderem Weg keine Filiale findet. Erfordert die Filiallösung. |
Import.Info.EMail |
N | 3 | Versendet eine E-Mail, wenn ein Auftrag eingelesen wurde. Die E-Mail erhalten nur Benutzer, bei denen Meldung bei Internetbestellungen (Shop) aktiviert ist. |
Import.Personen.Anlage |
J | 5 | Erlaubt der Schnittstelle, beim Einlesen Personen anzulegen, wenn OBS die Person der Bestellung nicht im Personenstamm findet. |
Import.Personen.Nummernkreis |
1 | 5 | Nummernkreis für Personen, die OBS beim Einlesen anlegt. |
Import.Projektnummer |
leer | 5 | Vorbelegung der Projektnummer bei Shop-Aufträgen. |
Weitere
| Einstellung | Standard | Level | Bedeutung |
|---|---|---|---|
Positionserfassung.Starten |
N | 5 | Öffnet bei Shop-Aufträgen aus der Liste FTP-Eingang die Positionserfassung. |
Bedienung
Das Shop-Menü öffnen Sie in der Liste Internet-Shops (Stammdaten → Schnittstellen → Internet-Shop) mit F10 auf der markierten Alka-Schnittstelle.
| Eintrag | Funktion | Seite |
|---|---|---|
| U Bestellungen einlesen | Liest die abgeholten Bestelldateien sofort als Aufträge ein. Nur bei aktiver Schnittstelle. | Allgemeine Funktionen |
| X Konfiguration | Öffnet die Einstellungen der Schnittstelle. | Konfiguration |
| Z Protokoll | Zeigt Hinweise und Fehler beim Einlesen. | Allgemeine Funktionen |
Übertragener Inhalt
| Angabe | Richtung | Übertragen | Hinweis |
|---|---|---|---|
| Bestellungen als Aufträge | Shop → OBS | ✓ | openTRANS-1.0-Dateien, abgeholt per FTP-Job. Manuell mit U Bestellungen einlesen, automatisch mit ShopGetBestellungen.
|
| Neue Kunden aus Bestellungen | Shop → OBS | ✓ | Nur mit Import.Personen.Anlage = J.
|
| Artikel, Preise, Kunden | OBS → Shop | – | |
| Lagerbestand | OBS → Shop | – | |
| Bestellstatus, Sendungsverfolgung, Rechnung | OBS → Shop | – |
Besonderheiten
Shop-Lieferanten
Unter Allgemein.Lagerlieferant.1 bis Allgemein.Lagerlieferant.5 tragen Sie die Lieferanten ein, deren Artikel im Shop angeboten werden.
HINWEIS: Liefert der Shop in der Bestellung die Bestellnummern des Lieferanten statt der OBS-Artikelnummern, erkennt OBS die Artikel über die Lieferanten in
Allgemein.Lagerlieferant.1 bis Allgemein.Lagerlieferant.5. Tragen Sie dort den Lieferanten Alka ein.Findet OBS einen Artikel der Bestellung nicht über Artikeltausch oder personenbezogene Artikelnummer, sucht es ihn über die Bestellnummer bei diesen Lieferanten, in dieser Reihenfolge. Die vollständige Suchreihenfolge steht unter Warum kann ein Artikel nicht gefunden werden?
Shop-Schnittstelle und Lagerlieferant
Alka gibt es in OBS zweimal: als Shop-Schnittstelle auf dieser Seite und als Lagerlieferant. Die Shop-Schnittstelle liest Bestellungen Ihrer Kunden aus dem Shop als Aufträge ein. Über den Lagerlieferanten bestellen Sie selbst bei Alka und erhalten Auftragsbestätigungen und Lieferavise zurück. Beide richten Sie unabhängig voneinander ein.