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

2026-11-03T15:25:54Z

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

Neue Seite

{{Vorlage:Kostenpflichtige Module}}
{{Seitentyp|Schnittstelle}}
= individuell OpenTRANS =

Mit der Schnittstelle ''individuell OpenTRANS'' liest OBS Bestellungen aus Shops ein, die ihre Bestellungen im openTRANS-Format liefern. Jede Bestellung wird ein Auftrag in OBS, ohne Abtippen. Die Schnittstelle arbeitet nur in diese Richtung: Artikel, Preise oder Kunden überträgt OBS nicht an den Shop.

{{Steckbrief
|Schnittstelle in OBS|''individuell OpenTRANS''
|Anbindung|Datei
|Format Bestellungen|openTRANS 1.0 oder 2.1 (XML), OBS erkennt die Version aus der Datei
|Übertragungsweg Bestellungen|FTP-Job oder E-Mail-Regel
|Rückmeldungen an den Shop|–
|Übersicht|[[OBS/Stammdaten/Schnittstellen/Internet-Shop|Internet-Shop]]
}}

== Voraussetzungen ==
* Ihr Shop stellt die Bestellungen als openTRANS-Dateien bereit, per FTP bzw. SFTP oder per E-Mail. Fragen zum Shop selbst beantwortet Ihr Shop-Anbieter.
* Der Programmparameter 633 ''Internet-Shop vorhanden'' ist aktiviert, und der OBS-Support hat die Schnittstelle für Sie freigeschaltet. Anlegen dürfen eine Shop-Schnittstelle nur Benutzer mit Level 9.
* Je nach Übertragungsweg brauchen Sie die Zugangsdaten zum FTP-Server oder ein E-Mail-Konto, an das der Shop die Bestellungen sendet.

== Einrichtung ==
Die Schnittstelle legt der OBS-Support an. OBS liest die Bestelldateien aus dem Verzeichnis <code>data\shop\<Nummer>\xml</code>. <code><Nummer></code> ist die dreistellige Nummer der Schnittstelle aus der Liste '''Internet-Shops'''. Wie die Dateien dorthin kommen, richten Sie je nach Übertragungsweg ein:
* '''FTP:''' Tragen Sie in der [[#Konfiguration|Konfiguration]] die FTP-Zugangsdaten ein: <code>FTP.Host</code>, <code>FTP.Login.Benutzer</code>, <code>FTP.Login.Passwort</code>, <code>FTP.Verzeichnis.OUT</code> und <code>FTP.Verzeichnis.IN</code>. Legen Sie dann in der Liste der Einstellungen mit {{F7}} '''F7 FTP-Job''' den FTP-Job ''Shop Bestellungen'' an. Dafür brauchen Sie Level 9 für die Shop-Schnittstellen. Den FTP-Job können Sie auch selbst in der [[OBS/Zusatzprogramme/FTP Jobliste|FTP Jobliste]] anlegen.
* '''E-Mail:''' Richten Sie das [[OBS/Stammdaten/Weitere Stammdaten/E-Mail Konten|E-Mail-Konto]] in OBS ein und legen Sie eine [[OBS/Stammdaten/E-Mail/Regeln|Filter-Regel]] an, die den Anhang in das Verzeichnis <code>data\shop\<Nummer>\xml</code> speichert.

Das Einlesen der Bestellungen übernimmt die Automatik <code>ShopGetBestellungen</code>, siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|Automatiken]]. Mehr dazu steht unter [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Häufig gestellte Fragen#faq_shop_auimporteinrichten|Wie werden Bestellungen automatisch importiert?]]

== Konfiguration ==
Die Einstellungen öffnen Sie im Shop-Menü mit '''X Konfiguration'''. Wie die Liste der Einstellungen funktioniert, steht unter [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Konfiguration|Internet-Shop: Konfiguration]]. In der Liste gibt es bei individuell OpenTRANS außerdem:

{| class="wikitable"
! Taste !! Funktion
|-
| {{F7}} || '''F7 FTP-Job''' legt den FTP-Job für die Abholung der Bestellungen an. Dafür müssen <code>FTP.Host</code>, <code>FTP.Login.Benutzer</code>, <code>FTP.Login.Passwort</code>, <code>FTP.Verzeichnis.IN</code> und <code>FTP.Verzeichnis.OUT</code> gefüllt sein. Nur mit Level 9 für die Shop-Schnittstellen.
|-
| {{F8}} || '''F8 Zuord''' öffnet das '''OBS-Shop-Zuordnungsmenü''' mit [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Artikeltausch|T Artikeltausch]]. Dort tauschen Sie beim Einlesen der Bestellungen eine Artikelangabe gegen einen OBS-Artikel oder eine Leistung.
|}

Die Spalte '''Level''' nennt das Benutzerlevel für die Shop-Schnittstellen, das Sie mindestens brauchen, um die Einstellung zu ändern. Die meisten Einstellungen zum Auftragsimport ändern Sie ab Level 3. Zugangsdaten, <code>Allgemein.Aktiv</code>, die Shop-Lieferanten und die Vorgaben für neue Personen und Aufträge erfordern Level 5, die Debug-Einstellungen Level 9.

=== 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'' blendet das Shop-Menü '''U Bestellungen einlesen''' aus, und auch die Automatik liest keine Bestellungen ein.
|-
| {{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.Schnittstelle.Sachbearbeiter}}<code>Allgemein.Schnittstelle.Sachbearbeiter</code> || leer || 5 || Nummer des Shop-Sachbearbeiters. Er erhält Nachrichten und Aufgaben aus der Schnittstelle und wird Sachbearbeiter der eingelesenen Aufträge, siehe <code>Import.AU.Person.Sachbearb</code>.
|-
| {{Anker|Allgemein.Lagerlieferant.1}}<code>Allgemein.Lagerlieferant.1</code> || leer || 5 || Personennummer des ersten Shop-Lieferanten. Sie wählen ihn mit {{Return}} aus. Beim Einlesen sucht OBS die Artikel auch über die Bestellnummern der Shop-Lieferanten, siehe auch <code>Import.AU.PrioShopLieferant</code>. Der FTP-Job, den Sie mit {{F7}} anlegen, erhält diesen Lieferanten als Kunde.
|-
| {{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.Standard.Personen.Preisgruppe}}<code>Allgemein.Standard.Personen.Preisgruppe</code> || 1 || 5 || Preisgruppe für Personen, die OBS beim Einlesen der Bestellungen neu anlegt. Ist der Wert ungültig, gilt Programmparameter 593.
|-
| {{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>.
|-
| {{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, z.B. <code>/out/order-*.xml</code>. Verzeichnis und Dateinamen hängen vom verwendeten Shop ab. Prüfen Sie sie vorher, das Präfix ''order-'' ist nicht garantiert.
|}

=== Auftragsimport ===
{| class="wikitable"
! Einstellung !! Standard !! Level !! Bedeutung
|-
| {{Anker|Import.AU.Datei.Typ}}<code>Import.AU.Datei.Typ</code> || 001 || 3 || Format der Bestelldateien. Sie wählen es mit {{Return}} aus: ''001'' – ''OpenTRANS 1.0'' ''002'' – ''OpenTRANS 2.1'' OBS erkennt die Version aus der Datei. Die Einstellung gilt nur, wenn OBS die Version einer Bestelldatei nicht erkennt.
|-
| {{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.KdBemerk.Drucken}}<code>Import.AU.KdBemerk.Drucken</code> || J || 3 || Vorbelegung für die Druckoption des Auftragstexts, den OBS aus der Bemerkung des Kunden erzeugt. Mit ''N'' setzt OBS beim Einlesen das Häkchen '''kein Druck'''.
|-
| {{Anker|Import.AU.Kopf.Bemerk}}<code>Import.AU.Kopf.Bemerk</code> || 1 || 3 || Übernahme der Bemerkungen aus den Kopfdaten der Bestellung (REMARK bzw. REMARKS im ORDER_HEADER): ''0'' – keine ''1'' – nur die erste Bemerkung ''2'' – alle Bemerkungen
|-
| {{Anker|Import.AU.Kostenstellen.Info}}<code>Import.AU.Kostenstellen.Info</code> || leer || 3 || Nummer des Textbausteins, mit dem OBS die Kostenstelle als Auftragstext (Position) einfügt. Dafür muss <code>Import.AU.Kostenstellenuebernahme</code> auf ''J'' stehen. Platzhalter siehe [[OBS/Häufig gestellte Fragen/Wie funktionieren Platzhalter#Auftragsimport OpenTRANS|Wie funktionieren Platzhalter]].
|-
| {{Anker|Import.AU.Kostenstellenuebernahme}}<code>Import.AU.Kostenstellenuebernahme</code> || J || 3 || Übernimmt die Kostenstelle aus der Datei (COST_CATEGORY_ID, Attribut ''type'' leer oder ''cost_center'').
|-
| {{Anker|Import.AU.Materialanlage}}<code>Import.AU.Materialanlage</code> || J || 5 || ''J'' – legt das Auftragsmaterial beim Einlesen an. ''N'' – legt kein Material an. Das Material entsteht dann erst, wenn Sie die Positionserfassung einmal öffnen.
|-
| {{Anker|Import.AU.Person.Sachbearb}}<code>Import.AU.Person.Sachbearb</code> || N || 3 || Übernimmt den Sachbearbeiter der Person als Sachbearbeiter des Auftrags. Gibt es die Person noch nicht oder hat sie keinen Sachbearbeiter, gilt der Sachbearbeiter der Schnittstelle.
|-
| {{Anker|Import.AU.PersonNrAusEMail}}<code>Import.AU.PersonNrAusEMail</code> || N || 3 || Sucht die Personennummer über die E-Mail-Adresse, wenn die Bestellung keine Kundennummer enthält. OBS verwendet die E-Mail-Adresse des Auftraggebers, aus dem Kontakt vor der Adresse. Die Zuordnung muss eindeutig sein.
|-
| {{Anker|Import.AU.Pos.NeueNummmern}}<code>Import.AU.Pos.NeueNummmern</code> || J || 3 || Nummeriert die Positionen beim Einlesen neu durch. Mit ''N'' behält OBS die Positionsnummern aus der Datei (LINE_ITEM_ID).
|-
| {{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.
|-
| {{Anker|Import.AU.Pos.UstSatz}}<code>Import.AU.Pos.UstSatz</code> || J || 3 || Übernimmt die Steuersätze aus der Datei, sofern angegeben.
|-
| {{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.AU.StempelArtikelnummer}}<code>Import.AU.StempelArtikelnummer</code> || leer || 3 || Standard-Artikelnummer für Stempelartikel aus dem Shop.
|-
| {{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.KontaktInAdresse}}<code>Import.Adresse.KontaktInAdresse</code> || J || 3 || Übernimmt den Kontakt in die Adresse ('''Name''', '''Zusatz1''' oder '''Zusatz2'''), sofern dort Platz ist.
|-
| {{Anker|Import.Adresse.Rechnung}}<code>Import.Adresse.Rechnung</code> || 2 || 5 || Übernahme des Rechnungsempfängers. Kann die Erlaubnis zum Anlegen von Personen erfordern: ''1'' – kein Rechnungsempfänger ''2'' – Rechnungsempfänger aus der Datei ''3'' – Rechnungsempfänger aus dem Personenstamm ''4'' – Rechnungsempfänger aus der Datei, wenn im Personenstamm keiner angegeben ist Statt einer Zahl ist auch ''J'' (übernehmen) oder ''N'' (nicht übernehmen) möglich.
|-
| {{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: ''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''.
|-
| {{Anker|Import.Adresse.Versand.Prio}}<code>Import.Adresse.Versand.Prio</code> || 1 || 3 || ''1'' – überschreibt die Versandadresse aus der Datei mit den OBS-Daten. ''2'' – behält die Adresse aus der Datei bei.
|-
| {{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.Kostenstelle.Suche.BezeichnungVoll}}<code>Import.Kostenstelle.Suche.BezeichnungVoll</code> || N || 3 || Mit ''J'' vergleicht OBS die vollständige Bezeichnung der Kostenstelle mit der Referenz aus der Bestelldatei, um die Kostenstelle zu finden.
|-
| {{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.
|-
| {{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 Schnittstelle.

{| class="wikitable"
! Eintrag !! Funktion !! Seite
|-
| '''U Bestellungen einlesen''' || Liest die Bestelldateien sofort als Aufträge ein. || [[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]]
|}

{{Hinweis|1='''U Bestellungen einlesen''' erscheint nur, wenn die Schnittstelle aktiv ist (<code>Allgemein.Aktiv</code> = ''J'').}}

== Übertragener Inhalt ==
{| class="wikitable"
! Angabe !! Richtung !! Übertragen !! Hinweis
|-
| Bestellungen als Aufträge || Shop → OBS || ✓ || openTRANS 1.0 oder 2.1. Manuell mit '''U Bestellungen einlesen''', automatisch mit <code>ShopGetBestellungen</code>.
|-
| Neue Kunden || Shop → OBS || ✓ || Mit <code>Import.Personen.Anlage</code> = ''J'' legt OBS unbekannte Kunden als Person an.
|-
| Versandanschrift, Rechnungsempfänger || Shop → OBS || ✓ || Steuerbar mit den Einstellungen <code>Import.Adresse.…</code>
|-
| Kostenstellen || Shop → OBS || ✓ || Mit <code>Import.AU.Kostenstellenuebernahme</code> = ''J''.
|-
| Artikel, Preise, Personen || OBS → Shop || – ||
|-
| Bestellstatus, Sendungsverfolgung, Rechnung || OBS → Shop || – ||
|}

== Besonderheiten ==
=== openTRANS 1.0 und 2.1 ===
OBS prüft jede Bestelldatei vor dem Einlesen und erkennt dabei, ob sie im Format openTRANS 1.0 oder 2.1 vorliegt. Sie brauchen für beide Versionen also nur eine Schnittstelle. <code>Import.AU.Datei.Typ</code> greift nur, wenn OBS die Version nicht erkennt. Wie OBS mit leeren, fehlerhaften oder bereits eingelesenen Dateien umgeht, steht unter [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Allgemeine Funktionen#U Bestellungen einlesen|U Bestellungen einlesen]].

=== Artikel finden ===
Wie OBS die Artikel einer Bestellung findet und was Sie tun, wenn ein Artikel nicht gefunden wird, steht unter [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Häufig gestellte Fragen#faq_shop_artikelnichtgefunden|Warum kann ein Artikel nicht gefunden werden?]] Liefert der Shop eigene Artikelangaben, etwa für Versandkosten, ordnen Sie sie mit dem [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Artikeltausch|Artikeltausch]] einem OBS-Artikel oder einer Leistung zu.

== Siehe auch ==
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop|Internet-Shop]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Allgemeine Funktionen|Allgemeine Funktionen]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|Automatiken]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Artikeltausch|Artikeltausch]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Häufig gestellte Fragen|Häufig gestellte Fragen]]
* [[OBS/Zusatzprogramme/FTP Jobliste|FTP Jobliste]]

OBS/Stammdaten/Schnittstellen/Internet-Shop/individuell OpenTRANS - Versionsgeschichte

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