<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="de">
	<id>https://wiki.bergau.de/index.php?action=history&amp;feed=atom&amp;title=OBS%2FStammdaten%2FSchnittstellen%2FInternet-Shop%2Fmodified_eCommerce%2FEinrichtung</id>
	<title>OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Einrichtung - Versionsgeschichte</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.bergau.de/index.php?action=history&amp;feed=atom&amp;title=OBS%2FStammdaten%2FSchnittstellen%2FInternet-Shop%2Fmodified_eCommerce%2FEinrichtung"/>
	<link rel="alternate" type="text/html" href="https://wiki.bergau.de/index.php?title=OBS/Stammdaten/Schnittstellen/Internet-Shop/modified_eCommerce/Einrichtung&amp;action=history"/>
	<updated>2026-11-04T07:37:00Z</updated>
	<subtitle>Versionsgeschichte dieser Seite in OBS Wiki</subtitle>
	<generator>MediaWiki 1.43.9</generator>
	<entry>
		<id>https://wiki.bergau.de/index.php?title=OBS/Stammdaten/Schnittstellen/Internet-Shop/modified_eCommerce/Einrichtung&amp;diff=67137&amp;oldid=prev</id>
		<title>MINERVA-Nimz: Neue Einrichtungsanleitung für modified eCommerce (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]</title>
		<link rel="alternate" type="text/html" href="https://wiki.bergau.de/index.php?title=OBS/Stammdaten/Schnittstellen/Internet-Shop/modified_eCommerce/Einrichtung&amp;diff=67137&amp;oldid=prev"/>
		<updated>2026-11-03T15:25:11Z</updated>

		<summary type="html">&lt;p&gt;Neue Einrichtungsanleitung für modified eCommerce (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]&lt;/p&gt;
&lt;p&gt;&lt;b&gt;Neue Seite&lt;/b&gt;&lt;/p&gt;&lt;div&gt;{{Vorlage:Kostenpflichtige Module}}&lt;br /&gt;
{{Seitentyp|Anleitung}}&lt;br /&gt;
= Einrichtung =&lt;br /&gt;
&lt;br /&gt;
Mit der Schnittstelle zu modified eCommerce pflegen Sie Ihren eigenen Online-Shop direkt aus OBS: Kategorien, Artikel, Preise und Kunden überträgt OBS in den Shop, Bestellungen kommen als Aufträge zurück. Diese Seite zeigt, was Sie für einen neuen Shop brauchen und wie Sie die Schnittstelle in OBS einrichten. Die Schritte gelten für &amp;#039;&amp;#039;modified eCommerce 1.x&amp;#039;&amp;#039;, &amp;#039;&amp;#039;modified eCommerce 2.x&amp;#039;&amp;#039; und &amp;#039;&amp;#039;modified eCommerce 3.x&amp;#039;&amp;#039;. Wo sich die Versionen unterscheiden, ist das gekennzeichnet.&lt;br /&gt;
&lt;br /&gt;
{{Hinweis|1=&amp;#039;&amp;#039;modified eCommerce 1.x&amp;#039;&amp;#039; wird für neue Shops nicht mehr eingerichtet. Für neue Shops stimmt Ihr OBS-Betreuer die passende Version mit Ihnen ab.}}&lt;br /&gt;
&lt;br /&gt;
{{Hinweis|1=&amp;#039;&amp;#039;modified eCommerce 3.x&amp;#039;&amp;#039; befindet sich in der Erprobung. Die Funktionen stehen nur für Schnittstellen zur Verfügung, die der OBS-Support dafür freigeschaltet hat.}}&lt;br /&gt;
&lt;br /&gt;
{{Auf einen Blick|1=&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Shop.&amp;#039;&amp;#039;&amp;#039; Die Shop-Software mit dem OBS-Modul läuft auf einem Webserver mit Datenbank. Für die Installation braucht der OBS-Support Ihre Zugangsdaten.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Schnittstelle.&amp;#039;&amp;#039;&amp;#039; In &amp;#039;&amp;#039;&amp;#039;Stammdaten → Schnittstellen → Internet-Shop&amp;#039;&amp;#039;&amp;#039; legen Sie eine Schnittstelle vom Typ &amp;#039;&amp;#039;modified eCommerce 1.x&amp;#039;&amp;#039;, &amp;#039;&amp;#039;modified eCommerce 2.x&amp;#039;&amp;#039; oder &amp;#039;&amp;#039;modified eCommerce 3.x&amp;#039;&amp;#039; an.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Konfiguration.&amp;#039;&amp;#039;&amp;#039; Shop-Adresse und Zugangsdaten eintragen, mit {{F9}} die Verbindung testen. Bei 3.x sind die Zugangsdaten Kennung und Schlüssel eines REST-API-Zugangs aus dem Shop.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Automatiken.&amp;#039;&amp;#039;&amp;#039; Bestellungen einlesen und Preise übertragen lassen Sie automatisch laufen.&lt;br /&gt;
}}&lt;br /&gt;
&lt;br /&gt;
== Voraussetzungen ==&lt;br /&gt;
* Das Modul Internet-Shop ist freigeschaltet: Der Programmparameter 633 &amp;#039;&amp;#039;Internet-Shop vorhanden&amp;#039;&amp;#039; ist aktiviert.&lt;br /&gt;
* Jede Shop-Schnittstelle wird einzeln abgerechnet. Für eine neue Schnittstelle ist eine Vertragsänderung nötig. Sprechen Sie dazu Ihren OBS-Betreuer an.&lt;br /&gt;
* Sie arbeiten mit [[OBS/Kostenpflichtige Module/Preislisten|Preislisten]] (kostenpflichtiges Modul). Eigene, vom Standardpreis abweichende Preise überträgt OBS nur mit diesem Modul in den Shop. Die Preisfindung im Shop ist an die Preislisten von OBS angepasst. Preiseinstellungen im Adminbereich des Shops, z.B. Staffelpreise oder Preisaufschläge über Artikeloptionen, wirken deshalb nicht.&lt;br /&gt;
* Für den Shop brauchen Sie:&lt;br /&gt;
** eine Domain (Internetadresse), unter der der Shop erreichbar sein soll,&lt;br /&gt;
** einen Webserver oder Webspace. Das kann ein eigener Server oder ein geteiltes System sein. Das Dateiverzeichnis der Domain muss per FTP erreichbar sein,&lt;br /&gt;
** eine MySQL-Datenbank mit einem Benutzerkonto mit Lese- und Schreibrechten, idealerweise mit einer Administrationsseite wie phpMyAdmin.&lt;br /&gt;
* Im Shop gibt es ein Benutzerkonto mit Administrationsrechten. Bei 1.x und 2.x meldet sich OBS über ein solches Konto am Shop an.&lt;br /&gt;
* Bei 3.x meldet sich OBS stattdessen mit einem REST-API-Zugang an, den Sie im Adminbereich des Shops anlegen, siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Einstellungen im Shop/REST-API-Zugang|REST-API-Zugang]].&lt;br /&gt;
&lt;br /&gt;
Arbeiten Sie bereits mit einem Dienstleister, der Ihre Homepage betreut, kann er Domain, Webspace und Datenbank für Sie einrichten. Webspace können Sie auf Wunsch auch über Bergau beziehen. Sprechen Sie dazu Ihren OBS-Betreuer an.&lt;br /&gt;
&lt;br /&gt;
=== Systemvoraussetzungen der Shopsoftware ===&lt;br /&gt;
Der Webserver muss für &amp;#039;&amp;#039;modified eCommerce 2.x&amp;#039;&amp;#039; und &amp;#039;&amp;#039;modified eCommerce 3.x&amp;#039;&amp;#039; Folgendes bereitstellen:&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Komponente !! Voraussetzung&lt;br /&gt;
|-&lt;br /&gt;
| PHP || ab Version 5.6&lt;br /&gt;
|-&lt;br /&gt;
| Datenbank || MySQL&lt;br /&gt;
|-&lt;br /&gt;
| Grafikbibliothek || GDlib 2 oder neuer&lt;br /&gt;
|-&lt;br /&gt;
| PDF-Bibliothek || PDFlib&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{{Hinweis|1=PHP 5.6 genügt technisch. Aus Sicherheitsgründen empfehlen wir eine aktuelle PHP-Version, die noch mit Sicherheitsupdates versorgt wird.}}&lt;br /&gt;
&lt;br /&gt;
{{Achtung|1=Version 1.x (Shop-Version 1.06) läuft nicht mit PHP 7. Der Webserver muss dafür eine passende PHP-Version bereitstellen.}}&lt;br /&gt;
&lt;br /&gt;
=== Installation und Admin-Konten ===&lt;br /&gt;
Die Shopsoftware mit dem OBS-Modul installiert der OBS-Support für Sie. Das Konto mit Administrationsrechten, das bei der Installation entsteht, nutzt der OBS-Support. Weitere Konten mit Administrationsrechten richten wir nach Absprache ein. Mindestens ein Konto mit Administrationsrechten steht Ihnen selbst zur Verfügung.&lt;br /&gt;
&lt;br /&gt;
=== Inhalte für den Shop ===&lt;br /&gt;
Planen Sie außerdem die Inhalte Ihres Shops:&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Rechtliche Texte:&amp;#039;&amp;#039;&amp;#039; Datenschutzerklärung, AGB, Impressum, Widerrufsbelehrung mit Formular, Lieferbedingungen und Lieferzeiten.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Bilder und Logos:&amp;#039;&amp;#039;&amp;#039; z.B. Firmenlogo, Hintergrundbilder und Banner. Denken Sie an das Favicon, das kleine Bild im Browser-Tab. Firmenlogos sind oft nicht für diese Größe ausgelegt.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Kategorien und Artikel:&amp;#039;&amp;#039;&amp;#039; Überlegen Sie, wie Sie Ihre Artikel im Shop gliedern. Texte und Bilder stellen teilweise Ihre Lieferanten bereit. Je nach Lieferant müssen Sie sie gesondert beantragen, und es können Bearbeitungs- oder Lizenzgebühren anfallen.&lt;br /&gt;
&lt;br /&gt;
{{Achtung|1=Welche rechtlichen Texte Sie brauchen, hängt von Ihren Waren und Dienstleistungen ab. Lassen Sie sich im Zweifel von einem Anwalt beraten.}}&lt;br /&gt;
&lt;br /&gt;
{{Hinweis|1=Bei der Datenpflege unterstützt Sie der OBS-Support. Für den Inhalt der Texte und für Verstöße gegen Urheber- oder Lizenzrechte übernimmt er keine Haftung.}}&lt;br /&gt;
&lt;br /&gt;
== Vorgehen ==&lt;br /&gt;
=== Shop vorbereiten ===&lt;br /&gt;
{{Schritte|1=&lt;br /&gt;
# Lassen Sie Domain, Webspace und Datenbank einrichten.&lt;br /&gt;
# Geben Sie dem OBS-Support die Zugangsdaten für FTP und Datenbank. Er installiert die Shop-Software mit dem OBS-Modul.&lt;br /&gt;
# Halten Sie die Zugangsdaten für OBS bereit:&lt;br /&gt;
#* &amp;#039;&amp;#039;modified eCommerce 1.x&amp;#039;&amp;#039; und &amp;#039;&amp;#039;2.x&amp;#039;&amp;#039;: E-Mail-Adresse und Passwort des Shop-Benutzerkontos mit Administrationsrechten.&lt;br /&gt;
#* &amp;#039;&amp;#039;modified eCommerce 3.x&amp;#039;&amp;#039;: Kennung und Schlüssel eines REST-API-Zugangs. Wie Sie ihn im Adminbereich des Shops anlegen, steht unter [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Einstellungen im Shop/REST-API-Zugang|REST-API-Zugang]].&lt;br /&gt;
}}&lt;br /&gt;
&lt;br /&gt;
OBS spricht den Shop über das OBS-Modul an: bei 1.x und 2.x unter &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;https://&amp;lt;Ihre-Shop-Adresse&amp;gt;/obs/obs.php&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;, bei 3.x über die REST-API unter &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;https://&amp;lt;Ihre-Shop-Adresse&amp;gt;/obs/rest-api/v1/&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;. In OBS tragen Sie nur die Adresse der Shop-Hauptseite ein, den Rest ergänzt OBS.&lt;br /&gt;
&lt;br /&gt;
=== Schnittstelle in OBS anlegen ===&lt;br /&gt;
{{Schritte|1=&lt;br /&gt;
# Öffnen Sie &amp;#039;&amp;#039;&amp;#039;Stammdaten → Schnittstellen → Internet-Shop&amp;#039;&amp;#039;&amp;#039; und drücken Sie {{Einfg}}.&lt;br /&gt;
# Übernehmen Sie in &amp;#039;&amp;#039;&amp;#039;Nummer&amp;#039;&amp;#039;&amp;#039; die vorgeschlagene dreistellige Nummer oder tragen Sie eine freie Nummer ein.&lt;br /&gt;
# Wählen Sie in &amp;#039;&amp;#039;&amp;#039;Schnittstelle&amp;#039;&amp;#039;&amp;#039; &amp;#039;&amp;#039;modified eCommerce 1.x&amp;#039;&amp;#039;, &amp;#039;&amp;#039;modified eCommerce 2.x&amp;#039;&amp;#039; oder &amp;#039;&amp;#039;modified eCommerce 3.x&amp;#039;&amp;#039;, passend zur Version Ihres Shops.&lt;br /&gt;
# Tragen Sie eine &amp;#039;&amp;#039;&amp;#039;Bezeichnung&amp;#039;&amp;#039;&amp;#039; ein, z.B. den Namen des Shops.&lt;br /&gt;
# Speichern Sie mit {{F2}}.&lt;br /&gt;
}}&lt;br /&gt;
&lt;br /&gt;
Beim Speichern legt OBS die Konfiguration mit den Standardwerten und das Verzeichnis &amp;lt;code&amp;gt;data\shop\&amp;lt;Nummer&amp;gt;&amp;lt;/code&amp;gt; der Schnittstelle an. Außerdem ordnet OBS der Schnittstelle alle Preislisten zu, deren Preislistentyp für Shops zulässig ist.&lt;br /&gt;
&lt;br /&gt;
{{Hinweis|1=&amp;#039;&amp;#039;&amp;#039;Nummer&amp;#039;&amp;#039;&amp;#039; und &amp;#039;&amp;#039;&amp;#039;Schnittstelle&amp;#039;&amp;#039;&amp;#039; können Sie später nicht mehr ändern.}}&lt;br /&gt;
&lt;br /&gt;
=== Konfiguration eintragen ===&lt;br /&gt;
{{Schritte|1=&lt;br /&gt;
# Markieren Sie die neue Schnittstelle, drücken Sie {{F10}} und wählen Sie &amp;#039;&amp;#039;&amp;#039;X Konfiguration&amp;#039;&amp;#039;&amp;#039;.&lt;br /&gt;
# Tragen Sie in &amp;lt;code&amp;gt;Allgemein.Shop.URL&amp;lt;/code&amp;gt; die Adresse der Shop-Hauptseite ein, z.B. &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;https://&amp;lt;Ihre-Shop-Adresse&amp;gt;&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;.&lt;br /&gt;
#* &amp;#039;&amp;#039;modified eCommerce 2.x&amp;#039;&amp;#039; und &amp;#039;&amp;#039;3.x&amp;#039;&amp;#039;: Die Adresse muss mit &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;https://&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt; oder &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;http://&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt; beginnen. Bei 3.x tragen Sie die Adresse mit &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;https://&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt; ein.&lt;br /&gt;
#* &amp;#039;&amp;#039;modified eCommerce 1.x&amp;#039;&amp;#039;: Fehlt die Angabe, verwendet OBS &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;https://&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;.&lt;br /&gt;
# &amp;#039;&amp;#039;modified eCommerce 1.x&amp;#039;&amp;#039; und &amp;#039;&amp;#039;2.x&amp;#039;&amp;#039;: Tragen Sie in &amp;lt;code&amp;gt;Allgemein.Shop.Login.Benutzer&amp;lt;/code&amp;gt; die E-Mail-Adresse und in &amp;lt;code&amp;gt;Allgemein.Shop.Login.Passwort&amp;lt;/code&amp;gt; das Passwort des Shop-Benutzerkontos mit Administrationsrechten ein. Das Passwort darf höchstens 120 Zeichen lang sein. Bei 3.x tragen Sie stattdessen den REST-API-Zugang ein, siehe [[#REST-API-Zugang eintragen (nur 3.x)|REST-API-Zugang eintragen]].&lt;br /&gt;
# Prüfen Sie, dass &amp;lt;code&amp;gt;Allgemein.Aktiv&amp;lt;/code&amp;gt; auf &amp;#039;&amp;#039;J&amp;#039;&amp;#039; steht.&lt;br /&gt;
# Tragen Sie in &amp;lt;code&amp;gt;Allgemein.Schnittstelle.Sachbearbeiter&amp;lt;/code&amp;gt; den Sachbearbeiter ein, der Nachrichten und Aufgaben aus der Schnittstelle erhalten soll.&lt;br /&gt;
}}&lt;br /&gt;
&lt;br /&gt;
Alle weiteren Einstellungen beschreibt [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Konfiguration|Konfiguration]]. Für die Zugangsdaten brauchen Sie Level 5 für die Shop-Schnittstellen.&lt;br /&gt;
&lt;br /&gt;
=== REST-API-Zugang eintragen (nur 3.x) ===&lt;br /&gt;
Bei &amp;#039;&amp;#039;modified eCommerce 3.x&amp;#039;&amp;#039; meldet sich OBS mit einem REST-API-Zugang am Shop an. Legen Sie den Zugang vorher im Adminbereich des Shops an, siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Einstellungen im Shop/REST-API-Zugang|REST-API-Zugang]].&lt;br /&gt;
{{Schritte|1=&lt;br /&gt;
# Tragen Sie in der Konfiguration in &amp;lt;code&amp;gt;Allgemein.Shop.Api.Id&amp;lt;/code&amp;gt; die Kennung des Zugangs ein.&lt;br /&gt;
# Tragen Sie in &amp;lt;code&amp;gt;Allgemein.Shop.Api.Key&amp;lt;/code&amp;gt; den Schlüssel des Zugangs ein. Der Shop zeigt den Schlüssel nur beim Anlegen des Zugangs an.&lt;br /&gt;
# Lassen Sie &amp;lt;code&amp;gt;Allgemein.Shop.Api.ZertifikatPruefen&amp;lt;/code&amp;gt; auf &amp;#039;&amp;#039;J&amp;#039;&amp;#039;. Dann prüft OBS das Zertifikat des Shops bei jeder Verbindung.&lt;br /&gt;
}}&lt;br /&gt;
&lt;br /&gt;
{{Achtung|1=Schalten Sie die Zertifikatsprüfung nur für Testsysteme mit selbst signiertem Zertifikat ab. OBS sendet den Schlüssel bei jeder Anfrage mit. Ohne Prüfung des Zertifikats ist nicht sichergestellt, dass er beim richtigen Shop ankommt. Ändern dürfen die Einstellung nur Benutzer mit Level 9 für die Shop-Schnittstellen.}}&lt;br /&gt;
&lt;br /&gt;
=== Verbindung testen ===&lt;br /&gt;
Drücken Sie in der Konfiguration {{F9}} (&amp;#039;&amp;#039;&amp;#039;F9 Test&amp;#039;&amp;#039;&amp;#039;). Bei Erfolg meldet OBS „Verbindung erfolgreich.“ und zeigt die Version des Shops:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Version !! Anzeige !! Bedeutung&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;modified eCommerce 1.x&amp;#039;&amp;#039; || &amp;#039;&amp;#039;&amp;#039;Version&amp;#039;&amp;#039;&amp;#039; || Version des OBS-Moduls im Shop.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;modified eCommerce 2.x&amp;#039;&amp;#039; || &amp;#039;&amp;#039;&amp;#039;Basis-Version modified&amp;#039;&amp;#039;&amp;#039; und &amp;#039;&amp;#039;&amp;#039;API-Version&amp;#039;&amp;#039;&amp;#039; || Version der Shop-Software und Version des OBS-Moduls im Shop.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;modified eCommerce 3.x&amp;#039;&amp;#039; || &amp;#039;&amp;#039;&amp;#039;Basis-Version modified&amp;#039;&amp;#039;&amp;#039;, &amp;#039;&amp;#039;&amp;#039;API-Version&amp;#039;&amp;#039;&amp;#039; und &amp;#039;&amp;#039;&amp;#039;REST-API-Version&amp;#039;&amp;#039;&amp;#039; || Version der Shop-Software, Version des OBS-Moduls im Shop und Version der REST-API.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Erscheint „Verbindung konnte nicht aufgebaut werden.“, lesen Sie unter [[#Wenn es nicht klappt|Wenn es nicht klappt]] weiter.&lt;br /&gt;
&lt;br /&gt;
=== Zuordnungen einrichten ===&lt;br /&gt;
Drücken Sie in der Konfiguration {{F8}} und ordnen Sie im &amp;#039;&amp;#039;&amp;#039;OBS-Shop-Zuordnungsmenü&amp;#039;&amp;#039;&amp;#039; die Werte des Shops Ihren OBS-Stammdaten zu:&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;B Bestellstatus&amp;#039;&amp;#039;&amp;#039; – Status der Bestellungen, damit OBS ihn im Shop fortschreibt, siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Zuordnungen/Bestellstatus|Bestellstatus]].&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;S Spediteure&amp;#039;&amp;#039;&amp;#039; – Spediteure, siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Zuordnungen/Spediteure|Spediteure]].&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;A Anreden&amp;#039;&amp;#039;&amp;#039; (2.x und 3.x) – Anreden, die der Shop anbietet, siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Zuordnungen/Anreden|Anreden]].&lt;br /&gt;
&lt;br /&gt;
=== Daten in den Shop übertragen ===&lt;br /&gt;
Schließen Sie die Konfiguration. Im Shop-Menü ({{F10}}) übertragen Sie dann die Daten in den Shop:&lt;br /&gt;
{{Schritte|1=&lt;br /&gt;
# Legen Sie die Kategorien an und ordnen Sie ihnen Artikel zu: [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/E Kategorien verwalten|E Kategorien verwalten]].&lt;br /&gt;
# Übertragen Sie die Preise: [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/A Preise aktualisieren|A Preise aktualisieren]].&lt;br /&gt;
# Übertragen Sie Ihre Kunden als Shop-Benutzer: [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/C Personen übertragen|C Personen übertragen]].&lt;br /&gt;
}}&lt;br /&gt;
&lt;br /&gt;
=== Automatiken einrichten ===&lt;br /&gt;
Wie Sie Automatiken anlegen, steht unter [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|Automatiken]]. Für modified eCommerce richten Sie mindestens ein:&lt;br /&gt;
* &amp;lt;code&amp;gt;ShopGetBestellungen&amp;lt;/code&amp;gt; – liest neue Bestellungen als Aufträge ein.&lt;br /&gt;
* &amp;lt;code&amp;gt;ShopSetPreise&amp;lt;/code&amp;gt; – überträgt die Preise in den Shop.&lt;br /&gt;
&lt;br /&gt;
Je nach Bedarf kommen hinzu:&lt;br /&gt;
* &amp;lt;code&amp;gt;ShopSetBestand&amp;lt;/code&amp;gt; (Lagerbestände), &amp;lt;code&amp;gt;ShopModTracking&amp;lt;/code&amp;gt; (Bearbeitungsstand und Sendungsverfolgung) und &amp;lt;code&amp;gt;ExecShopJob&amp;lt;/code&amp;gt; (Übertragungen im Hintergrund).&lt;br /&gt;
* 2.x und 3.x: &amp;lt;code&amp;gt;ShopExportRechnung&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;ShopAuchGekauft&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;ShopAutoFillMerkmale&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;ShopPruefeArtikelAenderung&amp;lt;/code&amp;gt; und &amp;lt;code&amp;gt;ShopArtikelPflegen&amp;lt;/code&amp;gt;.&lt;br /&gt;
* nur 2.x: &amp;lt;code&amp;gt;ShopExportPromotion&amp;lt;/code&amp;gt;.&lt;br /&gt;
* nur 1.x: &amp;lt;code&amp;gt;XTCArtikelAenderungAutomatik&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;ShopModArtikelCheck&amp;lt;/code&amp;gt; und &amp;lt;code&amp;gt;ShopSetVerfuegbarkeit&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Ergebnis ==&lt;br /&gt;
* {{F9}} in der Konfiguration meldet „Verbindung erfolgreich.“ und zeigt die Version des Shops, bei 3.x auch die Version der REST-API.&lt;br /&gt;
* Im Shop-Menü ({{F10}}) stehen alle Übertragungsfunktionen zur Verfügung, z.B. &amp;#039;&amp;#039;&amp;#039;A Preise aktualisieren&amp;#039;&amp;#039;&amp;#039; und &amp;#039;&amp;#039;&amp;#039;U Bestellungen einlesen&amp;#039;&amp;#039;&amp;#039;. Bei einer inaktiven Schnittstelle fehlen sie.&lt;br /&gt;
* In den [[OBS/Stammdaten/Automatische Vorgänge|automatischen Vorgängen]] stehen die Automatiken der Schnittstelle.&lt;br /&gt;
* Neue Bestellungen aus dem Shop erscheinen nach dem nächsten Lauf von &amp;lt;code&amp;gt;ShopGetBestellungen&amp;lt;/code&amp;gt; als Aufträge in OBS.&lt;br /&gt;
&lt;br /&gt;
== Wenn es nicht klappt ==&lt;br /&gt;
Hinweise zur Ursache stehen im Protokoll der Schnittstelle (Shop-Menü &amp;#039;&amp;#039;&amp;#039;Z Protokoll&amp;#039;&amp;#039;&amp;#039;). Einträge mit Level 9 sehen nur Benutzer mit Level 9 für die Shop-Schnittstellen.&lt;br /&gt;
&lt;br /&gt;
Bei &amp;#039;&amp;#039;modified eCommerce 3.x&amp;#039;&amp;#039; stehen die Fehler der REST-API mit Level 9 im Protokoll. Sie enthalten den HTTP-Status, einen sechsstelligen Fehlercode und eine &amp;#039;&amp;#039;&amp;#039;Request-Id&amp;#039;&amp;#039;&amp;#039;. Unter der Request-Id findet der OBS-Support die Anfrage auch in den Protokollen des Shops. Nennen Sie sie, wenn Sie sich an den OBS-Support wenden.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Meldung !! Ursache&lt;br /&gt;
|-&lt;br /&gt;
| „Verbindung konnte nicht aufgebaut werden.“ ({{F9}} in der Konfiguration) || Mögliche Ursachen:&lt;br /&gt;
* &amp;lt;code&amp;gt;Allgemein.Aktiv&amp;lt;/code&amp;gt; steht auf &amp;#039;&amp;#039;N&amp;#039;&amp;#039;.&lt;br /&gt;
* &amp;lt;code&amp;gt;Allgemein.Shop.URL&amp;lt;/code&amp;gt; ist leer.&lt;br /&gt;
* &amp;#039;&amp;#039;modified eCommerce 1.x&amp;#039;&amp;#039; und &amp;#039;&amp;#039;2.x&amp;#039;&amp;#039;: &amp;lt;code&amp;gt;Allgemein.Shop.Login.Benutzer&amp;lt;/code&amp;gt; oder &amp;lt;code&amp;gt;Allgemein.Shop.Login.Passwort&amp;lt;/code&amp;gt; ist leer.&lt;br /&gt;
* &amp;#039;&amp;#039;modified eCommerce 3.x&amp;#039;&amp;#039;: &amp;lt;code&amp;gt;Allgemein.Shop.Api.Id&amp;lt;/code&amp;gt; oder &amp;lt;code&amp;gt;Allgemein.Shop.Api.Key&amp;lt;/code&amp;gt; ist leer.&lt;br /&gt;
* &amp;#039;&amp;#039;modified eCommerce 2.x&amp;#039;&amp;#039; und &amp;#039;&amp;#039;3.x&amp;#039;&amp;#039;: Die Adresse in &amp;lt;code&amp;gt;Allgemein.Shop.URL&amp;lt;/code&amp;gt; beginnt nicht mit &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;https://&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt; oder &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;http://&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Der Shop ist nicht erreichbar, oder die Zugangsdaten stimmen nicht.&lt;br /&gt;
* Die Versionen von OBS und Shop passen nicht zusammen, siehe unten.&lt;br /&gt;
Bei 3.x steht die genaue Ursache im Protokoll, siehe die Meldungen „REST-API …“ unten.&lt;br /&gt;
|-&lt;br /&gt;
| Protokoll: „Request Error (404): …“ (1.x und 2.x) || Unter &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;Ihre-Shop-Adresse&amp;gt;/obs/obs.php&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt; gibt es kein OBS-Modul. Prüfen Sie &amp;lt;code&amp;gt;Allgemein.Shop.URL&amp;lt;/code&amp;gt;: Dort steht nur die Adresse der Shop-Hauptseite, ohne &amp;lt;code&amp;gt;obs/obs.php&amp;lt;/code&amp;gt;. Stimmt die Adresse, wenden Sie sich an den OBS-Support.&lt;br /&gt;
|-&lt;br /&gt;
| Protokoll: „Request Error (500): …“ (1.x und 2.x) || Auf dem Webserver ist ein Fehler aufgetreten. Tritt er nur bei großen Übertragungen auf, nimmt der Webserver möglicherweise nicht so viele Daten je Anfrage an. Die Höchstmenge je Anfrage legt &amp;lt;code&amp;gt;Allgemein.Shop.Srv.Daten.Max&amp;lt;/code&amp;gt; fest. Ändern dürfen sie nur Benutzer mit Level 9.&lt;br /&gt;
|-&lt;br /&gt;
| Protokoll: „REST-API HTTP 401 Fehler 401900: Anmeldung fehlgeschlagen“ (nur 3.x) || Der Shop hat die Anmeldung abgelehnt. Mögliche Ursachen:&lt;br /&gt;
* Kennung oder Schlüssel in &amp;lt;code&amp;gt;Allgemein.Shop.Api.Id&amp;lt;/code&amp;gt; und &amp;lt;code&amp;gt;Allgemein.Shop.Api.Key&amp;lt;/code&amp;gt; stimmen nicht.&lt;br /&gt;
* Der Zugang ist im Shop gesperrt oder abgelaufen.&lt;br /&gt;
* Der Zugang lässt nur bestimmte IP-Adressen zu, und OBS greift von einer anderen Adresse zu.&lt;br /&gt;
Prüfen Sie den Zugang im Adminbereich des Shops. Kennen Sie den Schlüssel nicht mehr, legen Sie einen neuen Zugang an, siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Einstellungen im Shop/REST-API-Zugang|REST-API-Zugang]].&lt;br /&gt;
|-&lt;br /&gt;
| Protokoll: „REST-API HTTP 404 Fehler 404999: Antwort ist kein JSON (HTTP 404)“ (nur 3.x) || Unter &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;Ihre-Shop-Adresse&amp;gt;/obs/rest-api/v1/&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt; antwortet keine REST-API. Prüfen Sie &amp;lt;code&amp;gt;Allgemein.Shop.URL&amp;lt;/code&amp;gt;: Dort steht nur die Adresse der Shop-Hauptseite. Stimmt die Adresse, ist das OBS-Modul im Shop nicht für 3.x eingerichtet. Wenden Sie sich an den OBS-Support.&lt;br /&gt;
|-&lt;br /&gt;
| Protokoll: „REST-API HTTP 301 …“ oder „REST-API HTTP 302 …“ mit „Umleitung (HTTP …) nach …, Shop-URL prüfen“ (nur 3.x) || Der Shop leitet die Anfrage auf eine andere Adresse um, z.B. von &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;http://&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt; auf &amp;lt;code&amp;gt;&amp;lt;nowiki&amp;gt;https://&amp;lt;/nowiki&amp;gt;&amp;lt;/code&amp;gt;. OBS folgt Umleitungen nicht. Tragen Sie in &amp;lt;code&amp;gt;Allgemein.Shop.URL&amp;lt;/code&amp;gt; die Adresse ein, auf die die Meldung verweist.&lt;br /&gt;
|-&lt;br /&gt;
| Protokoll: „REST-API HTTP 500 …“, „… 502 …“, „… 503 …“ oder „… 504 …“ (nur 3.x) || Im Shop oder auf dem Webserver ist ein Fehler aufgetreten. Bei vorübergehenden Störungen des Webservers wiederholt OBS die Anfrage bis zu dreimal. Bleibt der Fehler, wenden Sie sich mit der Request-Id aus dem Protokoll an den OBS-Support.&lt;br /&gt;
|-&lt;br /&gt;
| Protokoll: „REST-API ohne Antwort: …“ (nur 3.x) || OBS hat keine Antwort vom Shop erhalten. Mögliche Ursachen:&lt;br /&gt;
* Der Shop ist nicht erreichbar, oder die Adresse in &amp;lt;code&amp;gt;Allgemein.Shop.URL&amp;lt;/code&amp;gt; stimmt nicht.&lt;br /&gt;
* Das Zertifikat des Shops ist ungültig, z.B. abgelaufen, selbst signiert oder für eine andere Adresse ausgestellt. Lassen Sie das Zertifikat erneuern. Die Zertifikatsprüfung (&amp;lt;code&amp;gt;Allgemein.Shop.Api.ZertifikatPruefen&amp;lt;/code&amp;gt;) schalten Sie nur bei Testsystemen ab.&lt;br /&gt;
|-&lt;br /&gt;
| Aufgabe „Shop &amp;lt;Nummer&amp;gt;: Bereiche des REST-API-Zugangs fehlen“ (nur 3.x) || Dem REST-API-Zugang fehlen Bereiche für Übertragungen, die OBS nutzt. Die Aufgabe nennt die betroffenen Aktionen und Bereiche. OBS überspringt diese Übertragungen, bis Sie die Bereiche im Adminbereich des Shops vergeben haben, siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Einstellungen im Shop/REST-API-Zugang|REST-API-Zugang]].&lt;br /&gt;
|-&lt;br /&gt;
| Protokoll: „incompatible interface versions! …“ (nur 1.x) || Das OBS-Modul im Shop ist älter, als OBS unterstützt. Wenden Sie sich mit den angezeigten Versionsangaben an den OBS-Support. Läuft die Verbindung über eine Automatik, erhält der Shop-Sachbearbeiter die Aufgabe &amp;#039;&amp;#039;Shop Versionsfehler&amp;#039;&amp;#039;.&lt;br /&gt;
|-&lt;br /&gt;
| Protokoll: „versions incompatible!“ (2.x und 3.x) || Die Version der Schnittstelle in OBS und die API-Version des OBS-Moduls im Shop passen nicht zusammen. Bei 3.x muss außerdem die Version der REST-API im Shop zu OBS passen. OBS meldet den Fehler beim ersten Auftreten automatisch an den OBS-Support.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Siehe auch ==&lt;br /&gt;
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce|modified eCommerce]]&lt;br /&gt;
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Konfiguration|Konfiguration]]&lt;br /&gt;
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Häufig gestellte Fragen|Häufig gestellte Fragen]]&lt;br /&gt;
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/modified eCommerce/Einstellungen im Shop|Einstellungen im Shop]]&lt;br /&gt;
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|Automatiken]]&lt;br /&gt;
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Zuordnungen|Zuordnungen]]&lt;br /&gt;
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop|Internet-Shop]]&lt;/div&gt;</summary>
		<author><name>MINERVA-Nimz</name></author>
	</entry>
</feed>