|  | <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.8.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="ch03s10.html" title="3.10. ZUGFeRD Rechnungen"></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="ch03s10.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="d0e7666"></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. Rechte für die Webshopapi"><div class="titlepage"><div><div><h3 class="title"><a name="d0e7675"></a>3.9.1. 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.2. Konfiguration"><div class="titlepage"><div><div><h3 class="title"><a name="d0e7690"></a>3.9.2. 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.3. Webshopartikel"><div class="titlepage"><div><div><h3 class="title"><a name="d0e7698"></a>3.9.3. Webshopartikel</h3></div></div></div><div class="sect3" title="3.9.3.1. Shopvariablenreiter in Artikelstammdaten"><div class="titlepage"><div><div><h4 class="title"><a name="d0e7701"></a>3.9.3.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
 | 
  
    |  |           unterschiedlichen Beschreibung und/oder Preisen für die
 | 
  
    |  |           konfigutierten Shops angelegt und bearbeitet werden. An dieser
 | 
  
    |  |           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.3.2. Shopartikelliste"><div class="titlepage"><div><div><h4 class="title"><a name="d0e7714"></a>3.9.3.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.4. Bestellimport"><div class="titlepage"><div><div><h3 class="title"><a name="d0e7722"></a>3.9.4. 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
 | 
  
    |  |         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
 | 
  
    |  |             der Datensatz konnte nicht eindeutig zugewiesen werden.</p></li><li class="listitem"><p>Kundennummer und Rechnungen rot hinterlegt: Der Kunde hat
 | 
  
    |  |             offene Posten und kann deswegen nicht im Stapel übernommen
 | 
  
    |  |             werden.</p></li><li class="listitem"><p>Rechnungsadresse grün hinterlegt: Der Kunde konnte eindeutig
 | 
  
    |  |             einem Datensatz zugeordnet werden. Die Shopbestellung kann im
 | 
  
    |  |             Stapel mit dem Button "Anwenden" und wenn markiert als Auftrag
 | 
  
    |  |             übernommen werden.</p></li><li class="listitem"><p>Kundennummer vorhanden, aber die Checkbox "Auftrag
 | 
  
    |  |             erstellen" fehlt. Der Kunde hat vermutlich eine
 | 
  
    |  |             Shopauftragssperre.</p></li><li class="listitem"><p>Lieferadresse grau hinterlegt: Optische Anzeige, dass es
 | 
  
    |  |             sich um eine unterschiedliche Lieferadresse handelt.
 | 
  
    |  |             Lieferadressen werden aber grundsätzlich beim Transferieren zu
 | 
  
    |  |             Aufträgen mit übernommen.</p></li><li class="listitem"><p>In der Spalte Positionen/Betrag/Versandkosten zeigt sich ein
 | 
  
    |  |             tooltip zu den Positionen.</p></li></ul></div><p>Maske Auftrag erstellen</p><p>Viele Shopsysteme haben drei verschieden Adresstypen Kunden-,
 | 
  
    |  |         Rechnungs-, und Lieferadresse, die sich auch alle unterscheiden
 | 
  
    |  |         können. Diese werden im oberen Bereich angezeigt. Es ist möglich jede
 | 
  
    |  |         dieser Adresse einzeln in kivitendo als Kunde zu übernehmen. Es werden
 | 
  
    |  |         die Werte Formulareingabe übernommen. Es wird bei einer Änderung
 | 
  
    |  |         allerdings nur diese in die kivitendo Kundenstammdaten übernommen, die
 | 
  
    |  |         Shopbestellung bleibt bestehen.</p><p>Mit der mittleren Adresse(Rechnungsadresse) im oberen Bereich,
 | 
  
    |  |         kann ich den ausgewählten kivitendodatensatz des mittleren Bereich
 | 
  
    |  |         überschreiben. Das ist sinnvoll, wenn ich erkenne, das der Kunde z.B.
 | 
  
    |  |         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
 | 
  
    |  |             muss zuerst deaktiviert werden bevor ich diesem Kunden eine
 | 
  
    |  |             Shopbestellung zuordnen kann.</p></li><li class="listitem"><p>Kundenname fett und rot: Hier hat der Kunde eine Bemerkung
 | 
  
    |  |             in den Stammdaten. Ein Tooltip zeigt diese Bemerkung. Das kann dan
 | 
  
    |  |             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.5. Mapping der Daten"><div class="titlepage"><div><div><h3 class="title"><a name="d0e7775"></a>3.9.5. 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
 | 
  
    |  |         Datei kann ein individelles Mapping dann gemacht werden. Zu Shopware
 | 
  
    |  |         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>
 | 
  
    |  |             </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> </td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch03s10.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">3.8. Dateiverwaltung (Mini-DMS) </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 3.10. ZUGFeRD Rechnungen</td></tr></table></div></body></html>
 |