Revision 8ded2eed
Von Werner Hahn vor mehr als 7 Jahren hinzugefügt
| doc/html/ch03s09.html | ||
|---|---|---|
|
<html><head>
|
||
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
|
<title>3.9. Webshop-Api</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03s08.html" title="3.8. Dateiverwaltung (Mini-DMS)"><link rel="next" href="ch04.html" title="Kapitel 4. Entwicklerdokumentation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.9. Webshop-Api</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s08.html">Zurück</a> </td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right"> <a accesskey="n" href="ch04.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.9. Webshop-Api"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e6559"></a>3.9. Webshop-Api</h2></div></div></div><p>Das Shopmodul bietet die Möglichkeit Onlineshopartikel und
|
||
|
<title>3.9. Webshop-Api</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03s08.html" title="3.8. Dateiverwaltung (Mini-DMS)"><link rel="next" href="ch04.html" title="Kapitel 4. Entwicklerdokumentation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.9. Webshop-Api</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s08.html">Zurück</a> </td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right"> <a accesskey="n" href="ch04.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.9. Webshop-Api"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e6565"></a>3.9. Webshop-Api</h2></div></div></div><p>Das Shopmodul bietet die Möglichkeit Onlineshopartikel und
|
||
|
Onlineshopbestellungen zu verwalten und zu bearbeiten.</p><p>Es ist Multishopfähig, d.h. Artikel können mehreren oder
|
||
|
unterschiedlichen Shops zugeordnet werden. Bestellungen können aus
|
||
|
mehreren Shops geholt werden.</p><p>Zur Zeit bietet das Modul nur einen Connector zur REST-Api von
|
||
|
Shopware. Weitere Connectoren können dazu programmiert und eingerichtet
|
||
|
werden.</p><div class="sect2" title="3.9.1. Installationvorraussetzungen"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6568"></a>3.9.1. Installationvorraussetzungen</h3></div></div></div><p>In der Datenbank <code class="literal">template1</code> muss die
|
||
|
Unterstützung für die trigram-Extension eingerichet werden. Melden Sie
|
||
|
sich dafür als Benutzer “postgres” an der Datenbank an:
|
||
|
</p><pre class="programlisting">su - postgres
|
||
|
werden.</p><div class="sect2" title="3.9.1. Installationsempfehlung"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6574"></a>3.9.1. Installationsempfehlung</h3></div></div></div><p>Optionale Postgreserweiterung pg_trgm(Trigram)</p><p>Die Trigramerweiterung bietet eine Ähnlichkeitsuche. Diese
|
||
|
verwendet das Shopmodul, wenn installiert, beim Bestellimport um zu
|
||
|
entscheiden ob ein Kunde neu angelegt oder als Vorschlag angezeigt
|
||
|
wird. </p><p>Die Erweiterung wird bisher nur beim Ableich der Straße genutzt,
|
||
|
da hier oft unterschiedliche Schreibweisen vorhanden sind. </p><p>z.B Dorfstraße, Dorfstrasse, Dorfstr., Dorf Straße usw.. So wird
|
||
|
vermieden, dass Kunden eventuell doppelt angelegt werden. </p><p>Um diese Erweiterung generell in kivitendo zu installieren, um
|
||
|
neuen Mandanten und der kivitendo-Test-Suite zugänglich zu
|
||
|
machen:</p><p>
|
||
|
</p><pre class="programlisting">su - postgres
|
||
|
psql template1</pre><p>
|
||
|
</p><p>führen Sie die folgenden Kommandos aus:</p><pre class="programlisting">CREATE EXTENSION IF NOT EXISTS pg_trgm;
|
||
|
\q</pre><p>Für bestehende Datenbanken muss die Extension in der Datenbank
|
||
|
angelegt werden</p><pre class="programlisting">su - postgres
|
||
|
\q</pre><p>Für bestehende Mandanten-Datenbanken kann die Extension in der
|
||
|
Datenbank angelegt werden:</p><pre class="programlisting">su - postgres
|
||
|
psql DATENBANKNAME</pre><pre class="programlisting">CREATE EXTENSION IF NOT EXISTS pg_trgm;
|
||
|
\q</pre></div><div class="sect2" title="3.9.2. Rechte für die Webshopapi"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6589"></a>3.9.2. Rechte für die Webshopapi</h3></div></div></div><p>In der Administration können folgende Rechte vergeben
|
||
|
werden</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Webshopartikel anlegen und bearbeiten</p></li><li class="listitem"><p>Shopbestellungen holen und bearbeiten</p></li><li class="listitem"><p>Shopbestellungen holen und bearbeiten</p></li></ul></div></div><div class="sect2" title="3.9.3. Konfiguration"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6604"></a>3.9.3. Konfiguration</h3></div></div></div><p>Unter System->Webshops können Shops angelegt und konfiguriert
|
||
|
werden</p><div class="mediaobject"><img src="images/Shop_Listing.png"></div></div><div class="sect2" title="3.9.4. Webshopartikel"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6612"></a>3.9.4. Webshopartikel</h3></div></div></div><div class="sect3" title="3.9.4.1. Shopvariablenreiter in Artikelstammdaten"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6615"></a>3.9.4.1. Shopvariablenreiter in Artikelstammdaten</h4></div></div></div><p>Mit dem Recht "Shopartikel anlegen und bearbeiten" und des
|
||
|
\q</pre></div><div class="sect2" title="3.9.2. Rechte für die Webshopapi"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6602"></a>3.9.2. Rechte für die Webshopapi</h3></div></div></div><p>In der Administration können folgende Rechte vergeben
|
||
|
werden</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Webshopartikel anlegen und bearbeiten</p></li><li class="listitem"><p>Shopbestellungen holen und bearbeiten</p></li><li class="listitem"><p>Shop anlegen und bearbeiten</p></li></ul></div></div><div class="sect2" title="3.9.3. Konfiguration"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6617"></a>3.9.3. Konfiguration</h3></div></div></div><p>Unter System->Webshops können Shops angelegt und konfiguriert
|
||
|
werden</p><div class="mediaobject"><img src="images/Shop_Listing.png"></div></div><div class="sect2" title="3.9.4. Webshopartikel"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6625"></a>3.9.4. Webshopartikel</h3></div></div></div><div class="sect3" title="3.9.4.1. Shopvariablenreiter in Artikelstammdaten"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6628"></a>3.9.4.1. Shopvariablenreiter in Artikelstammdaten</h4></div></div></div><p>Mit dem Recht "Shopartikel anlegen und bearbeiten" und des
|
||
|
Markers <span class="bold"><strong>"Shopartikel" in den Basisdaten
|
||
|
</strong></span>zeigt sich der Reiter "Shopvariablen" in den
|
||
|
Artikelstammdaten. Hier können jetzt die Artikel mit
|
||
| ... | ... | |
|
Stelle können auch beliebig viele Bilder dem Shopartikel zugeordnet
|
||
|
werden. Artikelbilder gelten für alle Shops.</p><div class="mediaobject"><img src="images/Shop_Artikel.png"></div><p>Die Artikelgruppen werden direkt vom Shopsystem geholt somit
|
||
|
ist es möglich einen Artikel auch mehreren Gruppen
|
||
|
zuzuordenen</p></div><div class="sect3" title="3.9.4.2. Shopartikelliste"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6628"></a>3.9.4.2. Shopartikelliste</h4></div></div></div><p>Unter dem Menu Webshop->Webshop Artikel hat man nochmal
|
||
|
zuzuordenen</p></div><div class="sect3" title="3.9.4.2. Shopartikelliste"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6641"></a>3.9.4.2. Shopartikelliste</h4></div></div></div><p>Unter dem Menu Webshop->Webshop Artikel hat man nochmal
|
||
|
eine Gesamtübersicht. Von hier aus ist es möglich Artikel im Stapel
|
||
|
unter verschiedenen Kriterien <alles><nur Preis><nur
|
||
|
Bestand><Preis und Bestand> an die jeweiligen Shops
|
||
|
hochzuladen.</p><div class="mediaobject"><img src="images/Shop_Artikel_Listing.png"></div></div></div><div class="sect2" title="3.9.5. Bestellimport"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6636"></a>3.9.5. Bestellimport</h3></div></div></div><p>Unter dem Menupunkt Webshop->Webshop Import öffnet sich die
|
||
|
hochzuladen.</p><div class="mediaobject"><img src="images/Shop_Artikel_Listing.png"></div></div></div><div class="sect2" title="3.9.5. Bestellimport"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6649"></a>3.9.5. Bestellimport</h3></div></div></div><p>Unter dem Menupunkt Webshop->Webshop Import öffnet sich die
|
||
|
Bestellimportsliste. Hier ist sind Möglichkeiten gegeben Neue
|
||
|
Bestellungen vom Shop abzuholen, geholte Bestellungen im Stapel oder
|
||
|
einzeln als Auftrag zu transferieren. Die Liste kann nach
|
||
| ... | ... | |
|
auch der Grund für die Auftragssperre sein.</p></li><li class="listitem"><p>Die Buttons "Auftrag erstellen" und "Kunde mit
|
||
|
Rechnungsadresse überschreiben" zeigen sich erst, wenn ein Kunde
|
||
|
aus dem Listing ausgewählt ist.</p></li><li class="listitem"><p>Es ist aber möglich die Shopbestellung zu löschen.</p></li><li class="listitem"><p>Ist eine Bestellung schon übernommen, zeigen sich an dieser
|
||
|
Stelle, die dazugehörigen Belegverknüpfungen.</p></li></ul></div></div><div class="sect2" title="3.9.6. Mapping der Daten"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6689"></a>3.9.6. Mapping der Daten</h3></div></div></div><p>Das Mapping der kivitendo Daten mit den Shopdaten geschieht in
|
||
|
Stelle, die dazugehörigen Belegverknüpfungen.</p></li></ul></div></div><div class="sect2" title="3.9.6. Mapping der Daten"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6702"></a>3.9.6. Mapping der Daten</h3></div></div></div><p>Das Mapping der kivitendo Daten mit den Shopdaten geschieht in
|
||
|
der Datei SL/ShopConnector/<SHOPCONNECTORNAME>.pm
|
||
|
z.B.:SL/ShopConnector/Shopware.pm</p><p>In dieser Datei gibt es einen Bereich wo die Bestellpostionen,
|
||
|
die Bestellkopfdaten und die Artikeldaten gemapt werden. In dieser
|
||
Auch abrufbar als: Unified diff
WebshopApi: Dokumentation Installations und UPGRADE für Trigram(trgm_pg)