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	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 data\shop\<Nummer>\xml. <Nummer> 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 die FTP-Zugangsdaten ein: FTP.Host, FTP.Login.Benutzer, FTP.Login.Passwort, FTP.Verzeichnis.OUT und FTP.Verzeichnis.IN. 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 FTP Jobliste anlegen.
E-Mail: Richten Sie das E-Mail-Konto in OBS ein und legen Sie eine Filter-Regel an, die den Anhang in das Verzeichnis data\shop\<Nummer>\xml speichert.

Das Einlesen der Bestellungen übernimmt die Automatik ShopGetBestellungen, siehe Automatiken. Mehr dazu steht unter Wie werden Bestellungen automatisch importiert?

Konfiguration

Die Einstellungen öffnen Sie im Shop-Menü mit X Konfiguration. Wie die Liste der Einstellungen funktioniert, steht unter Internet-Shop: Konfiguration. In der Liste gibt es bei individuell OpenTRANS außerdem:

Taste	Funktion
F7	F7 FTP-Job legt den FTP-Job für die Abholung der Bestellungen an. Dafür müssen `FTP.Host`, `FTP.Login.Benutzer`, `FTP.Login.Passwort`, `FTP.Verzeichnis.IN` und `FTP.Verzeichnis.OUT` gefüllt sein. Nur mit Level 9 für die Shop-Schnittstellen.
F8	F8 Zuord öffnet das OBS-Shop-Zuordnungsmenü mit 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, Allgemein.Aktiv, die Shop-Lieferanten und die Vorgaben für neue Personen und Aufträge erfordern Level 5, die Debug-Einstellungen Level 9.

Allgemein

Einstellung	Standard	Level	Bedeutung
`Allgemein.Aktiv`	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.
`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.Schnittstelle.Sachbearbeiter`	leer	5	Nummer des Shop-Sachbearbeiters. Er erhält Nachrichten und Aufgaben aus der Schnittstelle und wird Sachbearbeiter der eingelesenen Aufträge, siehe `Import.AU.Person.Sachbearb`.
`Allgemein.Lagerlieferant.1`	leer	5	Personennummer des ersten Shop-Lieferanten. Sie wählen ihn mit ↩ Enter aus. Beim Einlesen sucht OBS die Artikel auch über die Bestellnummern der Shop-Lieferanten, siehe auch `Import.AU.PrioShopLieferant`. Der FTP-Job, den Sie mit F7 anlegen, erhält diesen Lieferanten als Kunde.
`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.Standard.Personen.Preisgruppe`	1	5	Preisgruppe für Personen, die OBS beim Einlesen der Bestellungen neu anlegt. Ist der Wert ungültig, gilt Programmparameter 593.
`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\`.
`FTP.Verzeichnis.OUT`	leer	5	Verzeichnis und Dateimaske auf dem FTP-Server, aus dem der FTP-Job die Bestelldateien abholt, z.B. `/out/order-.xml`. Verzeichnis und Dateinamen hängen vom verwendeten Shop ab. Prüfen Sie sie vorher, das Präfix order-* ist nicht garantiert.

Auftragsimport

Einstellung	Standard	Level	Bedeutung
`Import.AU.Datei.Typ`	001	3	Format der Bestelldateien. Sie wählen es mit ↩ Enter 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.
`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.KdBemerk.Drucken`	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.
`Import.AU.Kopf.Bemerk`	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
`Import.AU.Kostenstellen.Info`	leer	3	Nummer des Textbausteins, mit dem OBS die Kostenstelle als Auftragstext (Position) einfügt. Dafür muss `Import.AU.Kostenstellenuebernahme` auf J stehen. Platzhalter siehe Wie funktionieren Platzhalter.
`Import.AU.Kostenstellenuebernahme`	J	3	Übernimmt die Kostenstelle aus der Datei (COST_CATEGORY_ID, Attribut type leer oder cost_center).
`Import.AU.Materialanlage`	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.
`Import.AU.Person.Sachbearb`	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.
`Import.AU.PersonNrAusEMail`	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.
`Import.AU.Pos.NeueNummmern`	J	3	Nummeriert die Positionen beim Einlesen neu durch. Mit N behält OBS die Positionsnummern aus der Datei (LINE_ITEM_ID).
`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.
`Import.AU.Pos.UstSatz`	J	3	Übernimmt die Steuersätze aus der Datei, sofern angegeben.
`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.AU.StempelArtikelnummer`	leer	3	Standard-Artikelnummer für Stempelartikel aus dem Shop.
`Import.Adresse.Auftraggeber.Prio`	J	3	J – behält die Auftraggeberadresse aus der Bestelldatei bei. N – überschreibt sie mit den OBS-Daten.
`Import.Adresse.KontaktInAdresse`	J	3	Übernimmt den Kontakt in die Adresse (Name, Zusatz1 oder Zusatz2), sofern dort Platz ist.
`Import.Adresse.Rechnung`	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.
`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.Adresse.Versand.Prio`	1	3	1 – überschreibt die Versandadresse aus der Datei mit den OBS-Daten. 2 – behält die Adresse aus der Datei bei.
`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.Kostenstelle.Suche.BezeichnungVoll`	N	3	Mit J vergleicht OBS die vollständige Bezeichnung der Kostenstelle mit der Referenz aus der Bestelldatei, um die Kostenstelle zu finden.
`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.
`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 Schnittstelle.

Eintrag	Funktion	Seite
U Bestellungen einlesen	Liest die Bestelldateien sofort als Aufträge ein.	Allgemeine Funktionen
X Konfiguration	Öffnet die Einstellungen der Schnittstelle.	Konfiguration
Z Protokoll	Zeigt Hinweise und Fehler beim Einlesen.	Allgemeine Funktionen

HINWEIS: U Bestellungen einlesen erscheint nur, wenn die Schnittstelle aktiv ist (Allgemein.Aktiv = J).

Übertragener Inhalt

Angabe	Richtung	Übertragen	Hinweis
Bestellungen als Aufträge	Shop → OBS	✓	openTRANS 1.0 oder 2.1. Manuell mit U Bestellungen einlesen, automatisch mit `ShopGetBestellungen`.
Neue Kunden	Shop → OBS	✓	Mit `Import.Personen.Anlage` = J legt OBS unbekannte Kunden als Person an.
Versandanschrift, Rechnungsempfänger	Shop → OBS	✓	Steuerbar mit den Einstellungen `Import.Adresse.…`
Kostenstellen	Shop → OBS	✓	Mit `Import.AU.Kostenstellenuebernahme` = 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. Import.AU.Datei.Typ greift nur, wenn OBS die Version nicht erkennt. Wie OBS mit leeren, fehlerhaften oder bereits eingelesenen Dateien umgeht, steht unter U Bestellungen einlesen.

Artikel finden

Wie OBS die Artikel einer Bestellung findet und was Sie tun, wenn ein Artikel nicht gefunden wird, steht unter Warum kann ein Artikel nicht gefunden werden? Liefert der Shop eigene Artikelangaben, etwa für Versandkosten, ordnen Sie sie mit dem Artikeltausch einem OBS-Artikel oder einer Leistung zu.

Siehe auch