OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce
modified eCommerce
modified eCommerce ist eine freie Shopsoftware, die wir mit OBS-Erweiterungen für Sie einrichten. OBS ist über ein eigenes Shop-Modul direkt mit dem Shop verbunden: Kategorien, Artikel, Preislisten, Kunden und Lagerbestände überträgt OBS in den Shop, die Bestellungen holt OBS als Aufträge ab und meldet Bearbeitungsstand und Sendungsverfolgung an den Shop zurück. Sie pflegen Ihr Sortiment und Ihre Preise in OBS, und Ihre Kunden sehen im Shop ihre eigenen Preise.
OBS unterstützt die Shopsoftware in drei Versionen. Unterschiede sind auf dieser Seite in eigenen Spalten oder mit (nur 1.x), (nur 2.x), (nur 3.x) bzw. (2.x und 3.x) gekennzeichnet.
| Version | 1.x | 2.x | 3.x |
|---|---|---|---|
| Anbieter | modified eCommerce | ||
| Schnittstelle in OBS | modified eCommerce 1.x | modified eCommerce 2.x | modified eCommerce 3.x |
| Anbindung | OBS-Shop-Modul im Shop (HTTP) | REST-API des OBS-Moduls im Shop (HTTPS) | |
| Anmeldung | Shop-Benutzerkonto mit Administrationsrechten | REST-API-Zugang mit Kennung und Schlüssel | |
| Dateien und Bilder | optional per FTP | ||
| Bestellungen | direkt über das Shop-Modul | direkt über die REST-API | |
| Rückmeldungen an den Shop | Bestellstatus ✓ · Sendungsverfolgung ✓ · Rechnung – | Bestellstatus ✓ · Sendungsverfolgung ✓ · Rechnung ✓ | |
| Voraussetzung | Modul Preislisten | ||
| Übersicht | Internet-Shop | ||
Voraussetzungen
- Der Programmparameter 633 Internet-Shop vorhanden ist aktiviert, und der OBS-Support hat die Shop-Schnittstelle für Sie freigeschaltet.
- Die Preisfindung im Shop arbeitet mit dem Preislistensystem von OBS. Eigene, vom Standardpreis abweichende Preise überträgt OBS nur mit dem Modul Preislisten in den Shop. Arbeiten Sie noch nicht mit Preislisten, planen Sie die Umstellung vor dem Start der Schnittstelle ein.
- Shopsoftware und OBS-Shop-Modul installiert der OBS-Support. Webspace für den Shop können Sie auf Wunsch über Bergau beziehen.
- Für den Shop brauchen Sie eine Domain, unter der er erreichbar sein soll, Webspace mit FTP-Zugang und eine MySQL-Datenbank mit einem Benutzerkonto mit Lese- und Schreibrechten. Hilfreich ist eine Administrationsoberfläche für die Datenbank, z.B. phpMyAdmin. Betreut ein Dienstleister Ihre Homepage, kann er Ihnen das einrichten; für die Installation brauchen wir dann nur die Zugangsdaten.
- Für den Shop selbst brauchen Sie außerdem die rechtlichen Texte (z.B. Datenschutzerklärung, AGB, Impressum, Widerrufsbelehrung, Liefer- und Versandbedingungen), Ihr Logo und weitere Bilder sowie eine Vorstellung davon, wie Sie Ihre Artikel in Kategorien gliedern möchten.
Einrichtung
Die Shopsoftware mit dem OBS-Shop-Modul installieren wir für Sie. In OBS legen Sie in der Liste Internet-Shops (Stammdaten → Schnittstellen → Internet-Shop) mit Einfg eine Schnittstelle an und wählen unter Schnittstelle modified eCommerce 1.x, modified eCommerce 2.x oder modified eCommerce 3.x. Danach tragen Sie die Zugangsdaten in der Konfiguration ein, legen die Shop-Kategorien an und ordnen ihnen die Artikel zu. Regelmäßige Übertragungen richten Sie als Automatiken ein.
Bei modified eCommerce 3.x legen Sie zuerst im Adminbereich des Shops einen REST-API-Zugang für OBS an. Die Einstellungen, die dafür im Shop nötig sind, stehen unter Einstellungen im Shop.
Wie Sie dabei im Einzelnen vorgehen, steht unter Einrichtung.
Konfiguration
Die Einstellungen der Schnittstelle öffnen Sie im Shop-Menü mit X Konfiguration. Alle Einstellungen für modified eCommerce beschreibt die Seite Konfiguration, wie die Liste der Einstellungen funktioniert, steht unter Internet-Shop: Konfiguration. Mit F9 prüfen Sie in der Liste der Einstellungen die Verbindung zum Shop; OBS zeigt dabei auch die Version der Schnittstelle an, bei 3.x zusätzlich die Version der REST-API.
In der Liste der Einstellungen öffnet F8 das Zuordnungsmenü. Bei modified eCommerce enthält es:
| Eintrag | Wofür | 1.x | 2.x | 3.x |
|---|---|---|---|---|
| A Anreden | Legt fest, welche OBS-Anreden der Shop anbietet, und überträgt sie in den Shop. | – | ✓ | ✓ |
| B Bestellstatus | Ordnet den Bestellstatus des Shops dem Verarbeitungsstatus in OBS zu, damit OBS den Status der Bestellung im Shop fortschreibt. | ✓ | ✓ | ✓ |
| S Spediteure | Ordnet die Spediteure des Shops den Spediteuren in OBS zu, für die Sendungsverfolgung im Shop. | ✓ | ✓ | ✓ |
Mehr dazu unter Zuordnungen.
Bedienung
Das Shop-Menü öffnen Sie in der Liste Internet-Shops mit F10 auf der markierten Schnittstelle.
| Eintrag | Funktion | 1.x | 2.x | 3.x | Seite |
|---|---|---|---|---|---|
| A Preise aktualisieren | Überträgt die für die Schnittstelle freigegebenen Preislisten in den Shop. | ✓ | ✓ | – | A Preise aktualisieren |
| B Preislisten verwalten | Zeigt die Preislisten der Schnittstelle und startet ihre Übertragung. | ✓ | ✓ | – | B Preislisten verwalten |
| C Personen übertragen | Überträgt Kunden als Kundenkonten in den Shop. | ✓ | ✓ | ✓ | C Personen übertragen |
| E Kategorien verwalten | Legt die Kategorien des Shops an, ordnet ihnen Artikel zu und überträgt beides. | ✓ | ✓ | ✓ | E Kategorien verwalten |
| F Freigaben OBS Stammdaten | Gibt Merkmale für den Shop frei, z.B. als Filter. | – | ✓ | ✓ | F Freigaben OBS Stammdaten |
| G Kataloge verwalten | Legt fest, welche Kundengruppe welche Artikel im Shop sieht. | ✓ | ✓ | ✓ | G Kataloge verwalten |
| I Merkliste übertragen | Erstellt Bestellvorlagen aus Aufträgen, Rechnungen, Angeboten oder Preislisten und überträgt sie als Merkliste. | ✓ | – | – | I Merkliste übertragen |
| J Verfügbarkeit übertragen | Stößt im Shop das Einlesen der Verfügbarkeiten an. | ✓ | – | – | |
| K Varianten übertragen | Überträgt die Variantendefinitionen in den Shop. | ✓ | ✓ | ✓ | K Varianten übertragen |
| L Artikelvarianten übertragen | Überträgt die Zuordnung der Variantenartikel zu ihren Hauptartikeln. | ✓ | ✓ | ✓ | L Artikelvarianten übertragen |
| M Referenzarten übertragen | Überträgt die Referenzarten für Zubehör- und Ersatzartikel in den Shop. | ✓ | – | – | M Referenzarten übertragen |
| N Lagerbestände verwalten | Legt fest, aus welchen Lagern OBS den Bestand für den Shop ermittelt und welcher Text dazu im Shop erscheint. | ✓ | ✓ | ✓ | N Lagerbestände verwalten |
| U Bestellungen einlesen | Liest neue Bestellungen sofort als Aufträge ein. | ✓ | ✓ | ✓ | Allgemeine Funktionen |
| V leere Passworte füllen | Erzeugt Passwörter für Kunden, die noch keins haben. | ✓ | ✓ | ✓ | Allgemeine Funktionen |
| W Update-Informationen zurücksetzen | Löscht die gespeicherten Update-Informationen. Danach überträgt OBS alle Daten erneut. | ✓ | – | – | W Update-Informationen zurücksetzen |
| X Konfiguration | Öffnet die Einstellungen der Schnittstelle. | ✓ | ✓ | ✓ | Konfiguration |
| Z Protokoll | Zeigt Hinweise und Fehler der Übertragungen. | ✓ | ✓ | ✓ | Allgemeine Funktionen |
Allgemein.Aktiv = J). K und L gibt es nur, wenn der Programmparameter 636 Artikel-Varianten vorhanden aktiviert ist. Bei 3.x erscheinen alle Einträge außer X Konfiguration und Z Protokoll nur, wenn der OBS-Support die Schnittstelle für die Erprobung freigeschaltet hat. Preise überträgt OBS bei 3.x derzeit nicht in den Shop.Einige Abläufe starten Sie nicht über das Shop-Menü:
- Artikel übertragen – Artikel der Schnittstelle zuordnen und in den Shop übertragen
- Bestellvorlagen eines Kunden übertragen Sie in den Webshop-Einstellungen der Person mit F9 Bestellvorlage übertragen. Bei 2.x und 3.x ist das der einzige Weg.
Übertragener Inhalt
| Angabe | Richtung | 1.x | 2.x | 3.x | Hinweis |
|---|---|---|---|---|---|
| Kategorien | OBS → Shop | ✓ | ✓ | ✓ | Mit E Kategorien verwalten. |
| Artikel | OBS → Shop | ✓ | ✓ | ✓ | Mit Texten, Bildern, Dateien und Suchbegriffen, siehe Artikel übertragen. |
| Varianten | OBS → Shop | ✓ | ✓ | ✓ | Mit K und L, Programmparameter 636 erforderlich. |
| Merkmale | OBS → Shop | ✓ | ✓ | ✓ | Bei 2.x und 3.x nur freigegebene Merkmale (F Freigaben OBS Stammdaten), auch als Filter im Shop. |
| Referenzartikel (Cross-Selling) | OBS → Shop | ✓ | ✓ | ✓ | Bei 2.x und 3.x nur mit Export.Artikel.XSell.Aktiv = J.
|
| Preise | OBS → Shop | ✓ | ✓ | – | Nur als Preislisten, Modul Preislisten erforderlich. Bei 3.x derzeit nicht verfügbar. |
| Personen (Kundenkonten) | OBS → Shop | ✓ | ✓ | ✓ | Mit C Personen übertragen oder aus den Webshop-Einstellungen der Person. Bei 2.x und 3.x auch Ansprechpartner als eigene Kundenkonten. |
| Kostenstellen | OBS → Shop | ✓ | – | – | Als eigene Zugänge. Programmparameter 541 und Einstellung Mod.Kostenstellen erforderlich.
|
| Kundengruppen, Kataloge | OBS → Shop | ✓ | ✓ | ✓ | Mit G Kataloge verwalten. |
| Lagerbestand | OBS → Shop | ✓ | ✓ | ✓ | Einstellungen unter N Lagerbestände verwalten, automatisch mit ShopSetBestand.
|
| Verfügbarkeit | OBS → Shop | ✓ | – | – | Mit J Verfügbarkeit übertragen oder ShopSetVerfuegbarkeit.
|
| Merkliste, Bestellvorlagen | OBS → Shop | ✓ | ✓ | ✓ | Aus Aufträgen, Rechnungen, Angeboten oder Preislisten. Bestehende Vorlagen werden überschrieben. |
| „Kunden kauften auch“ | OBS → Shop | – | ✓ | ✓ | Automatik ShopAuchGekauft, Einstellungen Export.Artikel.AuchGekauft.*.
|
| Aktionsartikel für die Hauptseite | OBS → Shop | – | ✓ | – | Automatik ShopExportPromotion.
|
| Rechnungen als PDF | OBS → Shop | – | ✓ | ✓ | Im Kundenkonto des Shops, Automatik ShopExportRechnung.
|
| Bestellungen als Aufträge | Shop → OBS | ✓ | ✓ | ✓ | Manuell mit U Bestellungen einlesen, automatisch mit ShopGetBestellungen.
|
| Bestellstatus, Sendungsverfolgung | OBS → Shop | ✓ | ✓ | ✓ | Automatik ShopModTracking, Zuordnungen B Bestellstatus und S Spediteure.
|
| Spediteure, Bestellstatus des Shops | Shop → OBS | ✓ | ✓ | ✓ | Für die Zuordnungen. |
Welche Automatiken es gibt, steht unter Automatiken.
Besonderheiten
Artikelnummer
Die Artikelnummer im Shop ist die OBS-Artikelnummer. So ordnet OBS die Positionen einer Bestellung ohne weitere Zuordnung dem richtigen Artikel zu.
Preisfindung im Shop
Die Preisfindung des Shops ist an das Preislistensystem von OBS angepasst. Alle Preise ergeben sich aus dem Einzelpreis des Artikels oder aus den Preisen und Staffeln der Preislisten. Preiseinstellungen im Adminbereich des Shops wie Staffelpreise oder Preisaufschläge über Artikeloptionen bleiben deshalb ohne Wirkung. Für die Preisfindung im Shop gelten dieselben Regeln wie in OBS, siehe Preislisten.
Varianten
Varianten aus OBS zeigt der Shop als Hauptartikel mit Auswahlfeldern. Die Bezeichnung der Variante ist die Beschriftung des Auswahlfelds, die Ausprägungen sind die Auswahlmöglichkeiten. Der Shop zeigt nur die Ausprägungen, für die dem Hauptartikel ein Variantenartikel zugeordnet ist. Die Nummer in Klammern ist die Ausprägungsnummer.
Die Artikelmerkmale im Adminbereich des Shops sind dafür kein Ersatz: Varianten müssen in OBS eigene Artikel mit eigenen Preisen sein, damit OBS die Bestellungen automatisch verarbeiten kann.
Kostenstellen (nur 1.x)
Mit der Kostenstellenverwaltung verwalten Ihre Firmenkunden ihre Kostenstellen als eigene Zugänge im Shop. Die Kostenstellen pflegen Sie in OBS; beim Übertragen einer Person legt OBS jede Kostenstelle mit E-Mail-Adresse als eigenen Zugang an. Der Hauptzugang des Kunden vergibt im Shop unter Mein Shop monatliche Budgets.
Beim Bestellen prüft der Shop, ob der Warenkorb zusammen mit den Bestellungen des laufenden Monats das Budget übersteigt. Ist das der Fall, kehrt der Besteller zum Warenkorb zurück und sieht den Restbetrag. Ein Budget von 0,00 € bedeutet: kein Limit. Die Bestellbestätigung geht an die Kostenstelle, eine Kopie an den Hauptzugang.
Voraussetzung sind der Programmparameter 541 Bürofa-Verwaltung für Kostenstellen und in der Konfiguration Mod.Kostenstellen = J.
Besteller (nur 1.x)
Im Bestellvorgang gibt es das Feld Besteller. Es ist sinnvoll bei Firmenkunden, bei denen mehrere Mitarbeiter über denselben Zugang bestellen. OBS übernimmt die Angabe als Text in den Auftrag.
Rechnungen im Kundenkonto (2.x und 3.x)
Gedruckte Rechnungen zu Shop-Aufträgen überträgt OBS als PDF in den Shop. Ihre Kunden sehen sie dort in ihrem Kundenkonto. Dazu richten Sie die Automatik ShopExportRechnung ein, siehe Automatiken.
Anmeldung über die REST-API (nur 3.x)
Bei modified eCommerce 3.x meldet sich OBS nicht mit einem Shop-Benutzerkonto an, sondern mit einem eigenen REST-API-Zugang. Den Zugang legen Sie im Adminbereich des Shops an, Kennung und Schlüssel tragen Sie in der Konfiguration ein, siehe REST-API-Zugang.
Der Zugang legt außerdem fest, auf welche Bereiche OBS zugreifen darf, z.B. Kategorien und Artikel, Kunden oder Bestellungen. Fehlt dem Zugang ein Bereich, überspringt OBS die Übertragungen dafür und meldet das mit einer Aufgabe.