MINERVA-Nimz: Neue Einstiegsseite der Shop-Schnittstelle Alka: Überblick, Einrichtung, Bedienung, Konfiguration (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]

2026-11-03T15:25:48Z

Neue Einstiegsseite der Shop-Schnittstelle Alka: Überblick, Einrichtung, Bedienung, Konfiguration (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]

Neue Seite

{{Vorlage:Kostenpflichtige Module}}
{{Seitentyp|Schnittstelle}}
= 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|1=Diese Seite beschreibt die Shop-Schnittstelle ''Alka'' für Bestellungen Ihrer Kunden. Bestellungen von Ihnen beim Lieferanten Alka laufen über den Lagerlieferanten, siehe [[OBS/Stammdaten/Schnittstellen/Lagerlieferanten/Alka|Lagerlieferanten: Alka (PBS Deutschland)]].}}

{{Steckbrief
|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|[[OBS/Stammdaten/Schnittstellen/Internet-Shop|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 <code>data\shop\<Nummer></code> mit den Unterverzeichnissen <code>xml</code>, <code>xml_archiv</code> und <code>debug</code>.
# Öffnen Sie im Shop-Menü '''X Konfiguration''' und tragen Sie die FTP-Zugangsdaten ein: <code>FTP.Host</code>, <code>FTP.Login.Benutzer</code>, <code>FTP.Login.Passwort</code>, <code>FTP.Verzeichnis.OUT</code> (Verzeichnis und Dateimaske auf dem FTP-Server) und <code>FTP.Verzeichnis.IN</code> (Verzeichnis <code>data\shop\<Nummer>\xml\</code> in OBS).
# Drücken Sie in der Konfiguration {{F7}}. OBS legt in der [[OBS/Zusatzprogramme/FTP Jobliste|FTP Jobliste]] den Job ''Shop Bestellungen'' mit der Bezeichnung ''Internetshop <Nummer> Bestellabholung'' an, der die Bestelldateien vom FTP-Server in das Verzeichnis <code>xml</code> holt. 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|Konfiguration]], vor allem, wie OBS Personen, Adressen und Preise übernimmt. Liefert der Shop die Bestellnummern des Lieferanten statt der OBS-Artikelnummern, tragen Sie unter <code>Allgemein.Lagerlieferant.1</code> den Lieferanten Alka ein, siehe [[#Shop-Lieferanten|Shop-Lieferanten]].
# Richten Sie die Automatik <code>ShopGetBestellungen</code> ein, damit OBS die abgeholten Dateien regelmäßig als Aufträge einliest, siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|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 [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Konfiguration|Internet-Shop: Konfiguration]]. Bei Alka gibt es dort diese Tasten:

{| class="wikitable"
! Taste !! Funktion
|-
| {{Return}} || Ä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|Einrichtung]]. Dafür müssen alle Einstellungen <code>FTP.*</code> 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 [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Artikeltausch|Artikeltausch]].
|-
| {{F10}} || '''Z1 Konfiguration exportieren''' und '''Z2 Konfiguration importieren''', siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Konfiguration|Internet-Shop: Konfiguration]].
|}

Die Spalte '''Level''' nennt das Benutzerlevel für die Shop-Schnittstellen, das Sie mindestens brauchen, um die Einstellung zu ändern.

=== Allgemein ===
{| class="wikitable"
! Einstellung !! Standard !! Level !! Bedeutung
|-
| {{Anker|Allgemein.Aktiv}}<code>Allgemein.Aktiv</code> || 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.
|-
| {{Anker|Allgemein.Debug}}<code>Allgemein.Debug</code> || N || 9 || Debugmodus. Erweitert das Protokoll um zusätzliche Einträge und sollte nur in Problemfällen aktiv sein.
|-
| {{Anker|Allgemein.Debug.LogLevel}}<code>Allgemein.Debug.LogLevel</code> || 0 || 9 || Umfang der Protokolleinträge im Debugmodus, von ''0'' (keine) bis ''5'' (alles).
|-
| {{Anker|Allgemein.Lagerlieferant.1}}<code>Allgemein.Lagerlieferant.1</code> || leer || 5 || Personennummer des ersten Shop-Lieferanten. Sie wählen ihn mit {{Return}} aus. Über die Shop-Lieferanten sucht OBS die Artikel der Bestellung, siehe [[#Shop-Lieferanten|Shop-Lieferanten]].
|-
| {{Anker|Allgemein.Lagerlieferant.2}}<code>Allgemein.Lagerlieferant.2</code> || leer || 5 || Zweiter Shop-Lieferant, wie <code>Allgemein.Lagerlieferant.1</code>.
|-
| {{Anker|Allgemein.Lagerlieferant.3}}<code>Allgemein.Lagerlieferant.3</code> || leer || 5 || Dritter Shop-Lieferant, wie <code>Allgemein.Lagerlieferant.1</code>.
|-
| {{Anker|Allgemein.Lagerlieferant.4}}<code>Allgemein.Lagerlieferant.4</code> || leer || 5 || Vierter Shop-Lieferant, wie <code>Allgemein.Lagerlieferant.1</code>.
|-
| {{Anker|Allgemein.Lagerlieferant.5}}<code>Allgemein.Lagerlieferant.5</code> || leer || 5 || Fünfter Shop-Lieferant, wie <code>Allgemein.Lagerlieferant.1</code>.
|-
| {{Anker|Allgemein.Schnittstelle.Sachbearbeiter}}<code>Allgemein.Schnittstelle.Sachbearbeiter</code> || leer || 5 || Nummer des Shop-Sachbearbeiters. Er erhält Nachrichten und Aufgaben aus der Schnittstelle.
|-
| {{Anker|Allgemein.Standard.Personen.Preisgruppe}}<code>Allgemein.Standard.Personen.Preisgruppe</code> || 1 || 5 || Preisgruppe für Personen, die OBS beim Einlesen der Bestellungen neu anlegt.
|-
| {{Anker|Allgemein.Standard.Zahlungsbedingung}}<code>Allgemein.Standard.Zahlungsbedingung</code> || leer || 5 || Standard-Zahlungsbedingung für Shop-Aufträge.
|}

=== FTP ===
{| class="wikitable"
! Einstellung !! Standard !! Level !! Bedeutung
|-
| {{Anker|FTP.Host}}<code>FTP.Host</code> || leer || 5 || Adresse des FTP-Servers.
|-
| {{Anker|FTP.Login.Benutzer}}<code>FTP.Login.Benutzer</code> || leer || 5 || Benutzername für den FTP-Server.
|-
| {{Anker|FTP.Login.Passwort}}<code>FTP.Login.Passwort</code> || leer || 5 || Passwort für den FTP-Server. OBS speichert es verschlüsselt.
|-
| {{Anker|FTP.Verzeichnis.IN}}<code>FTP.Verzeichnis.IN</code> || leer || 5 || Verzeichnis in OBS, in das der FTP-Job die Bestelldateien ablegt: <code>data\shop\<Nummer>\xml\</code>, z.B. <code>data\shop\001\xml\</code>.
|-
| {{Anker|FTP.Verzeichnis.OUT}}<code>FTP.Verzeichnis.OUT</code> || leer || 5 || Verzeichnis und Dateimaske auf dem FTP-Server, aus dem der FTP-Job die Bestelldateien abholt.
|}

=== Import ===
{| class="wikitable"
! Einstellung !! Standard !! Level !! Bedeutung
|-
| {{Anker|Import.Adresse.Auftraggeber.Prio}}<code>Import.Adresse.Auftraggeber.Prio</code> || J || 3 || ''J'' – behält die Auftraggeberadresse aus der Bestelldatei bei. ''N'' – überschreibt sie mit den OBS-Daten.
|-
| {{Anker|Import.Adresse.Rechnung}}<code>Import.Adresse.Rechnung</code> || J || 5 || Übernimmt den Rechnungsempfänger. Kann die Erlaubnis zum Anlegen von Personen erfordern (<code>Import.Personen.Anlage</code>).
|-
| {{Anker|Import.Adresse.Versand}}<code>Import.Adresse.Versand</code> || J || 5 || Übernimmt die Versandanschrift, wenn sie abweicht.
|-
| {{Anker|Import.Adresse.Versand.Check}}<code>Import.Adresse.Versand.Check</code> || 1 || 3 || Womit OBS die Versandadresse der Bestellung vergleicht, um zu entscheiden, ob sie abweicht:<br />''1'' – mit der Adresse des Auftraggebers im Auftrag<br />''2'' – mit der Adresse des Käufers (BUYER_PARTY) aus der Bestelldatei<br />Andere Werte behandelt OBS wie ''1''.
|-
| {{Anker|Import.AU.Adressuebernahme}}<code>Import.AU.Adressuebernahme</code> || J || 5 || Übernimmt die Adresse in den Auftrag.
|-
| {{Anker|Import.AU.FTPEingang.Anlegen}}<code>Import.AU.FTPEingang.Anlegen</code> || N || 3 || Legt beim Einlesen einer Bestellung einen Eintrag im FTP-Eingang an.
|-
| {{Anker|Import.AU.Materialanlage}}<code>Import.AU.Materialanlage</code> || J || 5 || ''J'' – legt das Auftragsmaterial beim Einlesen an. ''N'' – legt kein Material an.
|-
| {{Anker|Import.AU.Pos.Preis.Prioritaet}}<code>Import.AU.Pos.Preis.Prioritaet</code> || 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.
|-
| {{Anker|Import.AU.PrioShopLieferant}}<code>Import.AU.PrioShopLieferant</code> || N || 3 || Mit ''J'' setzt OBS beim Einlesen bevorzugt die Shop-Lieferanten (<code>Allgemein.Lagerlieferant.1</code> bis <code>Allgemein.Lagerlieferant.5</code>) als Lieferant für Position und Material ein. Sonst immer den ersten Lieferanten des Artikels.
|-
| {{Anker|Import.AU.Standard.Filiale}}<code>Import.AU.Standard.Filiale</code> || leer || 3 || Filiale für den Auftrag, wenn OBS auf anderem Weg keine Filiale findet. Erfordert die Filiallösung.
|-
| {{Anker|Import.Info.EMail}}<code>Import.Info.EMail</code> || 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.
|-
| {{Anker|Import.Personen.Anlage}}<code>Import.Personen.Anlage</code> || J || 5 || Erlaubt der Schnittstelle, beim Einlesen Personen anzulegen, wenn OBS die Person der Bestellung nicht im Personenstamm findet.
|-
| {{Anker|Import.Personen.Nummernkreis}}<code>Import.Personen.Nummernkreis</code> || 1 || 5 || Nummernkreis für Personen, die OBS beim Einlesen anlegt.
|-
| {{Anker|Import.Projektnummer}}<code>Import.Projektnummer</code> || leer || 5 || Vorbelegung der Projektnummer bei Shop-Aufträgen.
|}

=== Weitere ===
{| class="wikitable"
! Einstellung !! Standard !! Level !! Bedeutung
|-
| {{Anker|Positionserfassung.Starten}}<code>Positionserfassung.Starten</code> || 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.

{| class="wikitable"
! Eintrag !! Funktion !! Seite
|-
| '''U Bestellungen einlesen''' || Liest die abgeholten Bestelldateien sofort als Aufträge ein. Nur bei aktiver Schnittstelle. || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Allgemeine Funktionen#U Bestellungen einlesen|Allgemeine Funktionen]]
|-
| '''X Konfiguration''' || Öffnet die Einstellungen der Schnittstelle. || [[#Konfiguration|Konfiguration]]
|-
| '''Z Protokoll''' || Zeigt Hinweise und Fehler beim Einlesen. || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Allgemeine Funktionen#Z Protokoll|Allgemeine Funktionen]]
|}

== Übertragener Inhalt ==
{| class="wikitable"
! 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 <code>ShopGetBestellungen</code>.
|-
| Neue Kunden aus Bestellungen || Shop → OBS || ✓ || Nur mit <code>Import.Personen.Anlage</code> = ''J''.
|-
| Artikel, Preise, Kunden || OBS → Shop || – ||
|-
| Lagerbestand || OBS → Shop || – ||
|-
| Bestellstatus, Sendungsverfolgung, Rechnung || OBS → Shop || – ||
|}

== Besonderheiten ==
=== Shop-Lieferanten ===
Unter <code>Allgemein.Lagerlieferant.1</code> bis <code>Allgemein.Lagerlieferant.5</code> tragen Sie die Lieferanten ein, deren Artikel im Shop angeboten werden.

{{Hinweis|1=Liefert der Shop in der Bestellung die Bestellnummern des Lieferanten statt der OBS-Artikelnummern, erkennt OBS die Artikel über die Lieferanten in <code>Allgemein.Lagerlieferant.1</code> bis <code>Allgemein.Lagerlieferant.5</code>. 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 [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Häufig gestellte Fragen#faq_shop_artikelnichtgefunden|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 [[OBS/Stammdaten/Schnittstellen/Lagerlieferanten/Alka|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.

== Siehe auch ==
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop|Internet-Shop]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Allgemeine Funktionen|Allgemeine Funktionen]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Konfiguration|Internet-Shop: Konfiguration]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Artikeltausch|Artikeltausch]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|Automatiken]]
* [[OBS/Stammdaten/Schnittstellen/Lagerlieferanten/Alka|Lagerlieferanten: Alka (PBS Deutschland)]]
* [[OBS/Zusatzprogramme/FTP Jobliste|FTP Jobliste]]

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

MINERVA-Nimz: Neue Einstiegsseite der Shop-Schnittstelle Alka: Überblick, Einrichtung, Bedienung, Konfiguration (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]