So.CONNECT

So.CONNECT ist das Shop-System der Soennecken eG. OBS liest die Bestellungen aus dem Shop als Aufträge ein und stellt Soennecken Ihre Preislisten als Preisdateien bereit. So bestellen Ihre Kunden im Shop zu den Preisen, die Sie in OBS pflegen, und die Bestellungen landen ohne Abtippen in Ihrer Auftragsbearbeitung.

Steckbrief
Anbieter	Soennecken eG
Schnittstelle in OBS	So.CONNECT
Anbindung	Dateiaustausch
Format Bestellungen	openTRANS 1.0 oder 2.1 (XML)
Übertragungsweg Bestellungen	FTP-Job oder E-Mail
Preise	Preisdatei je Preisliste (Excel), optional automatisch per FTP oder SFTP an Soennecken
Rückmeldungen an den Shop	–
Übersicht	Internet-Shop

Voraussetzungen

Soennecken hat für Sie einen Shop eingerichtet. Fragen zum Shop selbst beantwortet Soennecken.
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.
Im Programmparameter 696 Personnummer von Büroring; Spicers; ALKA; Staples; Despec; Soennecken; Soft-Carrier; Wortmann steht an sechster Stelle die Personennummer Ihres Lieferanten Soennecken. Der Parameter enthält die Personennummern mehrerer Lieferanten, getrennt durch Semikolon. Fehlt die Nummer oder gibt es die Person nicht, meldet OBS im Protokoll: „Bitte die Personennummer des Lieferanten Soennecken in Programmparameter 696 pflegen!“ Ohne sie arbeitet die Schnittstelle nicht.
Für die Preisdateien brauchen Sie das Modul Preislisten.
Für die Abholung der Bestellungen per FTP und für den automatischen Versand der Preisdateien brauchen Sie die Zugangsdaten von Soennecken: Server, Benutzer, Passwort und Protokoll (FTP oder SFTP).

Einrichtung

Die Schnittstelle legt der OBS-Support an. Er trägt die Zugangsdaten in die Konfiguration ein und richtet die Abholung der Bestellungen ein. Je nach Konfiguration des Shops kommen die Bestellungen per FTP oder per E-Mail:

FTP: Mit F7 FTP-Job in der Konfiguration legt OBS einen Eintrag in der FTP Jobliste an. Er holt die Dateien aus FTP.Verzeichnis.OUT auf dem Server und legt sie in FTP.Verzeichnis.IN ab. Dafür müssen FTP.Host, FTP.Login.Benutzer, FTP.Login.Passwort, FTP.Verzeichnis.IN und FTP.Verzeichnis.OUT gefüllt sein, sonst meldet OBS „Bitte FTP-Einstellungen vollständig hinterlegen!“
E-Mail: Soennecken sendet die Bestelldateien an ein E-Mail-Konto, das in OBS eingerichtet ist. Eine Filter-Regel erkennt die E-Mails an der Absenderadresse von Soennecken, markiert sie als gelesen und erledigt und speichert den Anhang unter data\shop\<Nummer>\xml.

<Nummer> ist die dreistellige Nummer der Schnittstelle, z.B. 001. Eingelesen werden die Dateien von der Automatik ShopGetBestellungen, siehe Automatiken. Für die Preisdateien richten Sie die Automatik ShopSetPreise ein, siehe A Preislisten exportieren.

Diese Einstellung nehmen Sie selbst vor: Benutzer, die über neue Shop-Bestellungen informiert werden sollen, aktivieren unter System → Benutzerpflege, F9 Layout, Registerkarte Sonstiges den Punkt Meldung bei Internetbestellung, siehe F9 Layout:

Konfiguration

Die Einstellungen öffnen Sie im Shop-Menü mit X Konfiguration. Wie die Liste der Einstellungen funktioniert, steht unter Internet-Shop: Konfiguration. Bei So.CONNECT gibt es in der Liste zusätzlich:

Taste	Funktion
F7	FTP-Job legt den FTP-Job für die Abholung der Bestellungen an, siehe Einrichtung. Nur mit Level 9 für die Shop-Schnittstellen.
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, siehe Artikeltausch.

Die Spalte Level nennt das Benutzerlevel für die Shop-Schnittstellen, das Sie mindestens brauchen, um die Einstellung zu ändern. Die meisten Einstellungen ändern Sie ab Level 3. Benötigen Sie ein anderes Level, wenden Sie sich an den OBS-Support.

Allgemein

Einstellung	Standard	Level	Bedeutung
`Allgemein.Aktiv`	J	5	Schaltet die Schnittstelle aktiv (J) oder inaktiv (N). Bei N blendet das Shop-Menü A Preislisten exportieren und U Bestellungen einlesen aus, und auch die Automatiken übertragen keine Daten.
`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	3	Personennummer des ersten Shop-Lieferanten. Sie wählen ihn mit ↩ Enter aus. Die Shop-Lieferanten nutzt OBS beim Einlesen der Bestellungen, siehe `Import.AU.PrioShopLieferant`.
`Allgemein.Lagerlieferant.2` bis `Allgemein.Lagerlieferant.5`	leer	3	Weitere Shop-Lieferanten, 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	3	Preisgruppe für Personen, die OBS beim Einlesen der Bestellungen neu anlegt.
`Allgemein.Standard.Zahlungsbedingung`	leer	3	Standard-Zahlungsbedingung für Shop-Aufträge.

Abholung der Bestellungen per FTP

Einstellung	Standard	Level	Bedeutung
`FTP.Host`	leer	3	Adresse des FTP-Servers.
`FTP.Login.Benutzer`	leer	3	Benutzername für den FTP-Server.
`FTP.Login.Passwort`	leer	3	Passwort für den FTP-Server. OBS speichert es verschlüsselt.
`FTP.Mode.Passiv`	N	5	Passive Übertragung. OBS übernimmt die Einstellung beim Anlegen des FTP-Jobs mit F7 nicht. Stellen Sie den Modus im FTP-Job im Feld Passiv ein.
`FTP.Protokoll`	1	3	Protokoll: 1 – FTP, 2 – SFTP. Sie wählen es mit ↩ Enter aus. OBS übernimmt die Einstellung beim Anlegen des FTP-Jobs mit F7 nicht. Stellen Sie das Protokoll im FTP-Job im Feld Übertragungsart ein.
`FTP.Verzeichnis.IN`	leer	3	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	3	Verzeichnis und Dateimaske auf dem FTP-Server, aus dem der FTP-Job die Bestelldateien abholt.

Preisdateien

Einstellung	Standard	Level	Bedeutung
`Export.Preise.Dateiformat`	1	3	Format der Preisdateien. Unterstützt wird das Format 1 – Excel (xlsx). Lassen Sie die Einstellung auf 1, siehe Dateiformat und Dateiname.
`Export.Preise.Dateiname`	leer	3	Muster für den Dateinamen. Es muss genau einmal `%s` enthalten, OBS ersetzt den Platzhalter durch die Nummer der Preisliste. Leer bedeutet `pl_%s`.
`Export.Preise.AutoSenden.FTP.Aktiv`	N	3	J überträgt die Preisdateien nach dem Export automatisch auf den Server von Soennecken. Mit N liegen die Dateien nur im Verzeichnis `data\shop\<Nummer>\export`.
`Export.Preise.AutoSenden.FTP.Protokoll`	1	3	Protokoll, mit dem OBS die Preisdateien überträgt: 1 – FTP, 2 – SFTP. Sie wählen es mit ↩ Enter aus. Welches Protokoll Sie brauchen, erfahren Sie bei Soennecken.
`Export.Preise.AutoSenden.FTP.Host`	leer	3	Adresse des Servers für die Preisdateien.
`Export.Preise.AutoSenden.FTP.Login.Benutzer`	leer	3	Benutzername für den Server.
`Export.Preise.AutoSenden.FTP.Login.Passwort`	leer	3	Passwort für den Server. OBS speichert es verschlüsselt.
`Export.Preise.AutoSenden.FTP.Verzeichnis.IN`	leer	3	Verzeichnis auf dem Server, in das OBS die Preisdateien überträgt.
`Export.Preise.AutoSenden.FTP.Mode.Passiv`	N	5	Passive Übertragung der Preisdateien per FTP. Bei SFTP ohne Bedeutung.

Die Einstellungen Export.Preise.AutoSenden.FTP.* gelten nur für die Übertragung der Preisdateien. Für die Abholung der Bestellungen gelten die Einstellungen unter Abholung der Bestellungen per FTP.

Einlesen der Bestellungen

Einstellung	Standard	Level	Bedeutung
`Import.Adresse.KontaktInAdresse`	J	3	Übernimmt den Kontakt in die Adresse (Name, Zusatz1 oder Zusatz2), sofern dort Platz ist.
`Import.Adresse.Rechnung`	J	3	Übernahme des Rechnungsempfängers. Kann die Erlaubnis zum Anlegen von Personen erfordern. J übernimmt den Rechnungsempfänger, N nicht. Feiner steuern Sie mit Zahlen: 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
`Import.Adresse.Versand`	J	3	Ü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.AU.Adressuebernahme`	J	3	Übernimmt die Adresse in den Auftrag.
`Import.AU.Datei.Typ`	001	3	Format der Bestelldateien: 001 – OpenTRANS 1.0, 002 – OpenTRANS 2.1. Sie wählen es mit ↩ Enter aus. OBS erkennt die Version in der Regel an der Datei selbst. Die Einstellung gilt nur, wenn das nicht gelingt.
`Import.AU.FTPEingang.Anlegen`	N	3	Legt beim Einlesen einer Bestellung einen Eintrag im FTP-Eingang an.
`Import.AU.Kostenstellenuebernahme`	J	3	Übernimmt die Kostenstelle aus der Datei (COST_CATEGORY_ID).
`Import.AU.Materialanlage`	J	3	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.Pos.NeueNummmern`	J	3	Nummeriert die Positionen beim Einlesen neu durch. Mit N behält OBS die Positionsnummern aus der Datei.
`Import.AU.Pos.Preis.Prioritaet`	J	3	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.AU.StempelArtikelnummer`	leer	3	Standard-Artikelnummer für Stempelartikel aus dem Shop.
`Import.AU.UDX.Kopf.SOE.Fracht`	leer	3	Nummer der Zusatzkostendefinition für die Frachtkosten. Enthält die Bestellung Frachtkosten über 0, fügt OBS sie mit dieser Zusatzkostendefinition in den Auftrag ein. Die Definition muss für den Shop gelten. Leer übernimmt OBS die Frachtkosten nicht.
`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	3	Erlaubt der Schnittstelle, beim Einlesen Personen anzulegen, wenn OBS die Person der Bestellung nicht im Personenstamm findet.
`Import.Personen.Nummernkreis`	1	3	Nummernkreis für Personen, die OBS beim Einlesen anlegt.
`Import.Projektnummer`	leer	3	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 So.CONNECT-Schnittstelle.

Eintrag	Funktion	Seite
A Preislisten exportieren	Erstellt aus den freigegebenen Preislisten je eine Preisdatei und überträgt sie auf Wunsch an Soennecken.	A Preislisten exportieren
U Bestellungen einlesen	Liest die abgeholten Bestelldateien sofort als Aufträge ein.	Allgemeine Funktionen
X Konfiguration	Öffnet die Einstellungen der Schnittstelle.	Konfiguration
Z Protokoll	Zeigt Hinweise und Fehler der Übertragungen.	Allgemeine Funktionen

HINWEIS: Die Einträge A und U erscheinen nur, wenn die Schnittstelle aktiv ist (in der Konfiguration Allgemein.Aktiv = J). X und Z sind immer vorhanden.

Regelmäßige Übertragungen richten Sie als Automatiken ein: ShopGetBestellungen für die Bestellungen und ShopSetPreise für die Preisdateien.

Ü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`.
Kostenstellen aus der Bestellung	Shop → OBS	✓	Mit `Import.AU.Kostenstellenuebernahme`.
Frachtkosten aus der Bestellung	Shop → OBS	✓	Als Zusatzkosten, mit `Import.AU.UDX.Kopf.SOE.Fracht`.
Preislisten	OBS → Shop	✓	Eine Excel-Datei je Preisliste mit Nettopreis, Rabatt und bis zu sieben Staffeln. Mit A Preislisten exportieren oder `ShopSetPreise`.
Kunden-Artikelnummer, Einheiten, Verpackung	OBS → Shop	–	Die Spalten der Preisdatei bleiben leer.
Artikel	OBS → Shop	–	Das Sortiment pflegt Soennecken.
Personen (Kundenkonten)	OBS → Shop	–
Lagerbestand	OBS → Shop	–
Bestellstatus, Sendungsverfolgung, Rechnung	OBS → Shop	–

Besonderheiten

Nur Soennecken-Artikel mit EAN

In die Preisdateien kommen nur aktive Artikel, die Soennecken als Lieferanten in den Einkaufsinformationen haben und eine EAN besitzen. Die EAN nimmt OBS aus dem Lieferantenartikel, sonst aus dem Artikelstamm. Soennecken ordnet die Preise über die EAN den Artikeln im Shop zu. Haben mehrere Artikel dieselbe EAN, übernimmt OBS nur den ersten und meldet im Protokoll „Doppelte EAN … Bitte Stammdaten prüfen“.

Bestelldateien

OBS legt die Bestelldateien nach dem Einlesen im Archiv data\shop\<Nummer>\xml_archiv ab. Was beim Einlesen passiert, steht unter Allgemeine Funktionen.

Siehe auch