doc/html/ch03s09.html

   1 <html><head>
   2       <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   3    <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>&nbsp;</td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right">&nbsp;<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
   4       Onlineshopbestellungen zu verwalten und zu bearbeiten.</p><p>Es ist Multishopfähig, d.h. Artikel können mehreren oder
   5       unterschiedlichen Shops zugeordnet werden. Bestellungen können aus
   6       mehreren Shops geholt werden.</p><p>Zur Zeit bietet das Modul nur einen Connector zur REST-Api von
   7       Shopware. Weitere Connectoren können dazu programmiert und eingerichtet
   8       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
   9         verwendet das Shopmodul, wenn installiert, beim Bestellimport um zu
  10         entscheiden ob ein Kunde neu angelegt oder als Vorschlag angezeigt
  11         wird. </p><p>Die Erweiterung wird bisher nur beim Ableich der Straße genutzt,
  12         da hier oft unterschiedliche Schreibweisen vorhanden sind. </p><p>z.B Dorfstraße, Dorfstrasse, Dorfstr., Dorf Straße usw.. So wird
  13         vermieden, dass Kunden eventuell doppelt angelegt werden. </p><p>Um diese Erweiterung generell in kivitendo zu installieren, um
  14         neuen Mandanten und der kivitendo-Test-Suite zugänglich zu
  15         machen:</p><p>
  16                </p><pre class="programlisting">su - postgres
  17 psql template1</pre><p>
  18             </p><p>führen Sie die folgenden Kommandos aus:</p><pre class="programlisting">CREATE EXTENSION IF NOT EXISTS pg_trgm;
  19 \q</pre><p>Für bestehende Mandanten-Datenbanken kann die Extension in der
  20         Datenbank angelegt werden:</p><pre class="programlisting">su - postgres
  21 psql DATENBANKNAME</pre><pre class="programlisting">CREATE EXTENSION IF NOT EXISTS pg_trgm;
  22 \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
  23         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-&gt;Webshops können Shops angelegt und konfiguriert
  24         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
  25           Markers <span class="bold"><strong>"Shopartikel" in den Basisdaten
  26           </strong></span>zeigt sich der Reiter "Shopvariablen" in den
  27           Artikelstammdaten. Hier können jetzt die Artikel mit
  28           unterschiedlichen Beschreibung und/oder Preisen für die
  29           konfigutierten Shops angelegt und bearbeitet werden. An dieser
  30           Stelle können auch beliebig viele Bilder dem Shopartikel zugeordnet
  31           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
  32           ist es möglich einen Artikel auch mehreren Gruppen
  33           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-&gt;Webshop Artikel hat man nochmal
  34           eine Gesamtübersicht. Von hier aus ist es möglich Artikel im Stapel
  35           unter verschiedenen Kriterien &lt;alles&gt;&lt;nur Preis&gt;&lt;nur
  36           Bestand&gt;&lt;Preis und Bestand&gt; an die jeweiligen Shops
  37           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-&gt;Webshop Import öffnet sich die
  38         Bestellimportsliste. Hier ist sind Möglichkeiten gegeben Neue
  39         Bestellungen vom Shop abzuholen, geholte Bestellungen im Stapel oder
  40         einzeln als Auftrag zu transferieren. Die Liste kann nach
  41         verschiedenen Kriterien gefiltert werden.</p><div class="mediaobject"><img src="images/Shop_Bestell.png"></div><p>Bei Einträgen in der Liste.</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>keine Kundennummer: Es gibt ähnliche Kundendatensätze und
  42             der Datensatz konnte nicht eindeutig zugewiesen werden.</p></li><li class="listitem"><p>Kundennummer und Rechnungen rot hinterlegt: Der Kunde hat
  43             offene Posten und kann deswegen nicht im Stapel übernommen
  44             werden.</p></li><li class="listitem"><p>Rechnungsadresse grün hinterlegt: Der Kunde konnte eindeutig
  45             einem Datensatz zugeordnet werden. Die Shopbestellung kann im
  46             Stapel mit dem Button "Anwenden" und wenn markiert als Auftrag
  47             übernommen werden.</p></li><li class="listitem"><p>Kundennummer vorhanden, aber die Checkbox "Auftrag
  48             erstellen" fehlt. Der Kunde hat vermutlich eine
  49             Shopauftragssperre.</p></li><li class="listitem"><p>Lieferadresse grau hinterlegt: Optische Anzeige, dass es
  50             sich um eine unterschiedliche Lieferadresse handelt.
  51             Lieferadressen werden aber grundsätzlich beim Transferieren zu
  52             Aufträgen mit übernommen.</p></li><li class="listitem"><p>In der Spalte Positionen/Betrag/Versandkosten zeigt sich ein
  53             tooltip zu den Positionen.</p></li></ul></div><p>Maske Auftrag erstellen</p><p>Viele Shopsysteme haben drei verschieden Adresstypen Kunden-,
  54         Rechnungs-, und Lieferadresse, die sich auch alle unterscheiden
  55         können. Diese werden im oberen Bereich angezeigt. Es ist möglich jede
  56         dieser Adresse einzeln in kivitendo als Kunde zu übernehmen. Es werden
  57         die Werte Formulareingabe übernommen. Es wird bei einer Änderung
  58         allerdings nur diese in die kivitendo Kundenstammdaten übernommen, die
  59         Shopbestellung bleibt bestehen.</p><p>Mit der mittleren Adresse(Rechnungsadresse) im oberen Bereich,
  60         kann ich den ausgewählten kivitendodatensatz des mittleren Bereich
  61         überschreiben. Das ist sinnvoll, wenn ich erkenne, das der Kunde z.B.
  62         umgezogen ist.</p><p>Im mittleren Bereich das Adresslisting zeigt:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Rot hinterlegt: Kunde hat eine Shopauftragssperre, diese
  63             muss zuerst deaktiviert werden bevor ich diesem Kunden eine
  64             Shopbestellung zuordnen kann.</p></li><li class="listitem"><p>Kundenname fett und rot: Hier hat der Kunde eine Bemerkung
  65             in den Stammdaten. Ein Tooltip zeigt diese Bemerkung. Das kann dan
  66             auch der Grund für die Auftragssperre sein.</p></li><li class="listitem"><p>Die Buttons "Auftrag erstellen" und "Kunde mit
  67             Rechnungsadresse überschreiben" zeigen sich erst, wenn ein Kunde
  68             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
  69             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
  70         der Datei SL/ShopConnector/&lt;SHOPCONNECTORNAME&gt;.pm
  71         z.B.:SL/ShopConnector/Shopware.pm</p><p>In dieser Datei gibt es einen Bereich wo die Bestellpostionen,
  72         die Bestellkopfdaten und die Artikeldaten gemapt werden. In dieser
  73         Datei kann ein individelles Mapping dann gemacht werden. Zu Shopware
  74         gibt es hier eine sehr gute Dokumentation: <a class="ulink" href="https://developers.shopware.com/developers-guide/rest-api/" target="_top">https://developers.shopware.com/developers-guide/rest-api/</a>
  75             </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s08.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch04.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">3.8. Dateiverwaltung (Mini-DMS)&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;Kapitel 4. Entwicklerdokumentation</td></tr></table></div></body></html>