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

2026-11-03T15:25:58Z

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

Neue Seite

{{Vorlage:Kostenpflichtige Module}}
{{Seitentyp|Schnittstelle}}
= modified eCommerce =

[https://www.modified-shop.org/ 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.

{{Hinweis|1=''modified eCommerce 1.x'' wird für neue Shops nicht mehr eingerichtet. Für neue Shops stimmt Ihr OBS-Betreuer die passende Version mit Ihnen ab.}}

{{Hinweis|1=''modified eCommerce 3.x'' befindet sich in der Erprobung. Die Funktionen stehen nur für Schnittstellen zur Verfügung, die der OBS-Support dafür freigeschaltet hat.}}

{{Steckbrief
|spalten=1.x;2.x;3.x
|ecke=Version
|Anbieter|[https://www.modified-shop.org/ modified eCommerce]|[https://www.modified-shop.org/ modified eCommerce]|[https://www.modified-shop.org/ modified eCommerce]
|Schnittstelle in OBS|''modified eCommerce 1.x''|''modified eCommerce 2.x''|''modified eCommerce 3.x''
|Anbindung|OBS-Shop-Modul im Shop (HTTP)|OBS-Shop-Modul im Shop (HTTP)|REST-API des OBS-Moduls im Shop (HTTPS)
|Anmeldung|Shop-Benutzerkonto mit Administrationsrechten|Shop-Benutzerkonto mit Administrationsrechten|REST-API-Zugang mit Kennung und Schlüssel
|Dateien und Bilder|optional per FTP|optional per FTP|optional per FTP
|Bestellungen|direkt über das Shop-Modul|direkt über das Shop-Modul|direkt über die REST-API
|Rückmeldungen an den Shop|Bestellstatus ✓ · Sendungsverfolgung ✓ · Rechnung –|Bestellstatus ✓ · Sendungsverfolgung ✓ · Rechnung ✓|Bestellstatus ✓ · Sendungsverfolgung ✓ · Rechnung ✓
|Voraussetzung|Modul [[OBS/Kostenpflichtige Module/Preislisten|Preislisten]]|Modul [[OBS/Kostenpflichtige Module/Preislisten|Preislisten]]|Modul [[OBS/Kostenpflichtige Module/Preislisten|Preislisten]]
|Übersicht|[[OBS/Stammdaten/Schnittstellen/Internet-Shop|Internet-Shop]]|[[OBS/Stammdaten/Schnittstellen/Internet-Shop|Internet-Shop]]|[[OBS/Stammdaten/Schnittstellen/Internet-Shop|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 [[OBS/Kostenpflichtige Module/Preislisten|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.

{{Hinweis|1=Texte und Bilder zu Artikeln stellen viele Lieferanten zur Verfügung. Je nach Lieferant müssen Sie sie gesondert beantragen, und es können Bearbeitungs- oder Lizenzgebühren anfallen. Für den Inhalt der rechtlichen Texte sind Sie selbst verantwortlich; im Zweifel lassen Sie sich rechtlich beraten.}}

== 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 [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|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 [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Einstellungen im Shop|Einstellungen im Shop]].

Wie Sie dabei im Einzelnen vorgehen, steht unter [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Einrichtung|Einrichtung]].

== Konfiguration ==
Die Einstellungen der Schnittstelle öffnen Sie im Shop-Menü mit '''X Konfiguration'''. Alle Einstellungen für modified eCommerce beschreibt die Seite [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Konfiguration|Konfiguration]], wie die Liste der Einstellungen funktioniert, steht unter [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Konfiguration|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:
{| class="wikitable"
! Eintrag !! Wofür !! 1.x !! 2.x !! 3.x
|-
| [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Zuordnungen/Anreden|A Anreden]] || Legt fest, welche OBS-Anreden der Shop anbietet, und überträgt sie in den Shop. || – || ✓ || ✓
|-
| [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Zuordnungen/Bestellstatus|B Bestellstatus]] || Ordnet den Bestellstatus des Shops dem Verarbeitungsstatus in OBS zu, damit OBS den Status der Bestellung im Shop fortschreibt. || ✓ || ✓ || ✓
|-
| [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Zuordnungen/Spediteure|S Spediteure]] || Ordnet die Spediteure des Shops den Spediteuren in OBS zu, für die Sendungsverfolgung im Shop. || ✓ || ✓ || ✓
|}

Mehr dazu unter [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Zuordnungen|Zuordnungen]].

== Bedienung ==
Das Shop-Menü öffnen Sie in der Liste '''Internet-Shops''' mit {{F10}} auf der markierten Schnittstelle.

{| class="wikitable"
! Eintrag !! Funktion !! 1.x !! 2.x !! 3.x !! Seite
|-
| '''A Preise aktualisieren''' || Überträgt die für die Schnittstelle freigegebenen Preislisten in den Shop. || ✓ || ✓ || – || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/A Preise aktualisieren|A Preise aktualisieren]]
|-
| '''B Preislisten verwalten''' || Zeigt die Preislisten der Schnittstelle und startet ihre Übertragung. || ✓ || ✓ || – || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/B Preislisten verwalten|B Preislisten verwalten]]
|-
| '''C Personen übertragen''' || Überträgt Kunden als Kundenkonten in den Shop. || ✓ || ✓ || ✓ || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/C Personen übertragen|C Personen übertragen]]
|-
| '''E Kategorien verwalten''' || Legt die Kategorien des Shops an, ordnet ihnen Artikel zu und überträgt beides. || ✓ || ✓ || ✓ || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/E Kategorien verwalten|E Kategorien verwalten]]
|-
| '''F Freigaben OBS Stammdaten''' || Gibt Merkmale für den Shop frei, z.B. als Filter. || – || ✓ || ✓ || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/F Freigaben OBS Stammdaten|F Freigaben OBS Stammdaten]]
|-
| '''G Kataloge verwalten''' || Legt fest, welche Kundengruppe welche Artikel im Shop sieht. || ✓ || ✓ || ✓ || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/G Kataloge verwalten|G Kataloge verwalten]]
|-
| '''I Merkliste übertragen''' || Erstellt Bestellvorlagen aus Aufträgen, Rechnungen, Angeboten oder Preislisten und überträgt sie als Merkliste. || ✓ || – || – || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/I Merkliste übertragen|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. || ✓ || ✓ || ✓ || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/K Varianten übertragen|K Varianten übertragen]]
|-
| '''L Artikelvarianten übertragen''' || Überträgt die Zuordnung der Variantenartikel zu ihren Hauptartikeln. || ✓ || ✓ || ✓ || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/L Artikelvarianten übertragen|L Artikelvarianten übertragen]]
|-
| '''M Referenzarten übertragen''' || Überträgt die Referenzarten für Zubehör- und Ersatzartikel in den Shop. || ✓ || – || – || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/M Referenzarten übertragen|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. || ✓ || ✓ || ✓ || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/N Lagerbestände verwalten|N Lagerbestände verwalten]]
|-
| '''U Bestellungen einlesen''' || Liest neue Bestellungen sofort als Aufträge ein. || ✓ || ✓ || ✓ || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Allgemeine Funktionen#U Bestellungen einlesen|Allgemeine Funktionen]]
|-
| '''V leere Passworte füllen''' || Erzeugt Passwörter für Kunden, die noch keins haben. || ✓ || ✓ || ✓ || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Allgemeine Funktionen#V leere Passworte füllen|Allgemeine Funktionen]]
|-
| '''W Update-Informationen zurücksetzen''' || Löscht die gespeicherten Update-Informationen. Danach überträgt OBS alle Daten erneut. || ✓ || – || – || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/W Update-Informationen zurücksetzen|W Update-Informationen zurücksetzen]]
|-
| '''X Konfiguration''' || Öffnet die Einstellungen der Schnittstelle. || ✓ || ✓ || ✓ || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Konfiguration|Konfiguration]]
|-
| '''Z Protokoll''' || Zeigt Hinweise und Fehler der Übertragungen. || ✓ || ✓ || ✓ || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Allgemeine Funktionen#Z Protokoll|Allgemeine Funktionen]]
|}

{{Hinweis|1=Bis auf '''E Kategorien verwalten''', '''F Freigaben OBS Stammdaten''', '''X Konfiguration''' und '''Z Protokoll''' erscheinen die Einträge nur, wenn die Schnittstelle aktiv ist (in der Konfiguration <code>Allgemein.Aktiv</code> = ''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ü:
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Artikel übertragen|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 ==
{| class="wikitable"
! 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 [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Artikel übertragen|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 <code>Export.Artikel.XSell.Aktiv</code> = ''J''.
|-
| Preise || OBS → Shop || ✓ || ✓ || – || Nur als Preislisten, Modul [[OBS/Kostenpflichtige Module/Preislisten|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 <code>Mod.Kostenstellen</code> erforderlich.
|-
| Kundengruppen, Kataloge || OBS → Shop || ✓ || ✓ || ✓ || Mit '''G Kataloge verwalten'''.
|-
| Lagerbestand || OBS → Shop || ✓ || ✓ || ✓ || Einstellungen unter '''N Lagerbestände verwalten''', automatisch mit <code>ShopSetBestand</code>.
|-
| Verfügbarkeit || OBS → Shop || ✓ || – || – || Mit '''J Verfügbarkeit übertragen''' oder <code>ShopSetVerfuegbarkeit</code>.
|-
| Merkliste, Bestellvorlagen || OBS → Shop || ✓ || ✓ || ✓ || Aus Aufträgen, Rechnungen, Angeboten oder Preislisten. Bestehende Vorlagen werden überschrieben.
|-
| „Kunden kauften auch“ || OBS → Shop || – || ✓ || ✓ || Automatik <code>ShopAuchGekauft</code>, Einstellungen <code>Export.Artikel.AuchGekauft.*</code>.
|-
| Aktionsartikel für die Hauptseite || OBS → Shop || – || ✓ || – || Automatik <code>ShopExportPromotion</code>.
|-
| Rechnungen als PDF || OBS → Shop || – || ✓ || ✓ || Im Kundenkonto des Shops, Automatik <code>ShopExportRechnung</code>.
|-
| Bestellungen als Aufträge || Shop → OBS || ✓ || ✓ || ✓ || Manuell mit '''U Bestellungen einlesen''', automatisch mit <code>ShopGetBestellungen</code>.
|-
| Bestellstatus, Sendungsverfolgung || OBS → Shop || ✓ || ✓ || ✓ || Automatik <code>ShopModTracking</code>, Zuordnungen '''B Bestellstatus''' und '''S Spediteure'''.
|-
| Spediteure, Bestellstatus des Shops || Shop → OBS || ✓ || ✓ || ✓ || Für die Zuordnungen.
|}

Welche Automatiken es gibt, steht unter [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|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 [[OBS/Kostenpflichtige Module/Preislisten|Preislisten]].

=== Varianten ===
[[Datei:shop_varianten.png|mini|rechts|Auswahlfeld für Variantenartikel im Shop]]
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 <code>Mod.Kostenstellen</code> = ''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 <code>ShopExportRechnung</code> ein, siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|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 [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Einstellungen im Shop/REST-API-Zugang|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.

== Siehe auch ==
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop|Internet-Shop]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Häufig gestellte Fragen|modified eCommerce: Häufig gestellte Fragen]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Einstellungen im Shop|modified eCommerce: Einstellungen im Shop]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|Automatiken]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Zuordnungen|Zuordnungen]]
* [[OBS/Kostenpflichtige Module/Preislisten|Preislisten]]

OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce - Versionsgeschichte

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