Einrichtung (shöpping)
Die Konfiguration der Schnittstelle wird im LC.WpfInterfaces durchgeführt. Nach Start von LC.WpfInterfaces und Auswahl der shöpping-Schnittstelle, wählt man die Karteikarte "Einstellungen".
Karteikarte "Einstellungen"
Shöpping
Shöpping-übergreifende Vorgabewerte werden hier angegeben
Händler ID
Sie bekommen Ihre Händler ID von Ihrem Shöpping-Betreuer. Diese Händler ID muss zwingend vorhanden sein.
Online-Verbindung
In diesem Bereich werden Informationen, welche zum Datenaustausch notwendig sind, angegeben.
Webservice-URL
Die URL für die WebService-Kommunikation ist notwendig, um Preis- oder Lagerbestands-Aktualisierungen durchzuführen.
Ist keine URL vorhanden, wird standardmäßig diese verwendet (Produktiv-Umgebung):
https://portal.shoepping.at/ws/v1
Es gibt einen eigenen WebService für das Test-System:
https://portal.staging.shoepping.at/ws/v1
API-Key
Der Schlüssel für die Verwendung der API-Schnittstelle. Sie bekommen diesen von Ihrem Shöpping-Betreuer.
API-Benutzername
Der Benutzername für die Verwendung der API-Schnittstelle. Sie bekommen diesen von Ihrem Shöpping-Betreuer.
API-Passwort
Das Passwort für die Verwendung der API-Schnittstelle. Sie bekommen diesen von Ihrem Shöpping-Betreuer.
FTP-Host-Url
Für den Produktdatenfeed, also die Bereitstellung der Artikeldaten, wird von Shöpping ausschließlich ein FTP-Server für ankommende Daten bereitgestellt.
Der Standard-FTP-Server ist:
FTP-Benutzername
Der Benutzername für die Verwendung des FTP-Servers. Sie bekommen diesen von Ihrem Shöpping-Betreuer.
FTP-Passwort
Das Passwort für die Verwendung des FTP-Servers. Sie bekommen diesen von Ihrem Shöpping-Betreuer.
FTP-Port
Hier kann ein abweichender FTP-Port angegeben werden (optional).
FTP-Upload für Feeds verwenden
Wenn aktiviert, wird für die Preis- und Lagerbestands-Aktualisierung der FTP-Server verwendet, anstatt dem WebService-Upload.
Test-Modus
Wenn aktiviert, wird für den FTP-Upload anstatt des Ordners "Schnittstelle_PROD" der Ordner "Schnittstelle_TEST" verwendet
Artikel/Preise/Bestand
In diesem Bereich werden Einstellungen für den Artikel-, Lagerbestands-, Preis-Abgleich vorgenommen.
Organisatorische Einheit(en)
Die organisatorische Einheit wird benötigt, um Artikel je organisatorischer Einheit bereitstellen zu können. Dazu wird das TaskCenter-Fenster "WebShop-Preise und Artikel je OE" verwendet. Sämtliche Artikel, welche für die angegebene OE in dieser Tabelle enthalten und als "Web"-Artikel gekennzeichnet wurden, werden als Produkte an Shöpping gesendet und aktualisiert.
Es können mehrere Organisatorische Einheiten angegeben werden, wobei die erste OE als primäre OE angesehen wird. Das heißt:
Wenn ein Eintrag in "WebShop-Preise und Artikel je OE" für die erste angegebene OE vorhanden ist, dann wird dieser Eintrag verwendet. Ist dort das "Web"-Kennzeichen aktiviert, wird der Artikel exportiert. Ist das "Web"-Kennzeichen deaktiviert, wird der Artikel nicht exportiert, auch wenn für diesen Artikel auch noch ein Eintrag einer anderen OE mit aktiviertem "Web"-Kennzeichen vorhanden ist.
Beispiel:
Organisatorische Einheit(en): 43;10;12
In folgender Tabelle werden mehrere Einträge (Artikel) der Tabelle "WebShop-Preise und Artikel je OE" dargestellt. Die Einträge sind nach Artikelnummer farbig gruppiert.
In der Spalte "Export/aktiv" enthält jeweils der "führende" Datensatz die Information, ob er exportiert wird, oder nicht, während die anderen Datensätze des gleichen Artikels leer sind.
| Artikelnummer | OE | Web | Export/aktiv | Zusatzinformation |
|---|---|---|---|---|
| 4711 | 10 | JA | JA | |
| 4712 | 10 | NEIN | NEIN | |
| 4713 | 10 | JA | JA | |
| 4713 | 12 | NEIN | ||
| 4714 | 12 | JA | ||
| 4714 | 43 | NEIN | NEIN | |
| 4715 | 10 | NEIN | ||
| 4715 | 12 | JA | ||
| 4715 | 43 | JA | JA | |
| 4716 | 43 | JA | JA | |
| 4717 | 20 | JA | NEIN | diese OE ist nicht in der Liste enthalten |
Lagernummern für Lagerbestandsberechnung
In diesem Feld werden alle Lager für die Berechnung des verfügbaren Lagerbestands angegeben. Sind hier keine Lager angegeben, werden alle zugeordneten Lager der vorgegebenen organisatorischen Einheiten verwendet.
Mehrere Lagernummern werden Strichpunkt-getrennt angegeben.
Beispiel:
1;15
( Lager 1 und Lager 15 werden für die Lagerbestandsberechnung verwendet ).
Sql-Where für Artikel-Einschränkung
Dieses Feld dient als "Sicherung", damit gewisse Artikel von Haus aus nicht in der Schnittstelle übertragen werden, auch wenn diese das "Web"-Kennzeichen hätten. Hier wird eine SQL-Where-Bedingung angegeben.
Beispiel 1:
Sie möchten, dass nur Artikel, die als Lagermengeneinheit "Stk" hinterlegt haben, exportieren, dann tragen Sie in das Feld folgendes ein:
SQL
and a.mengeneinheit='Stk']] ></ac:plain-text-body></ac:structured-macro><p><br /></p><p><strong>Beispiel 2:</strong></p><p>Sie möchten nur Artikel des Herstellers "SAMSUNG" verkaufen. Zusätzlich darf der Artikel keinen Eintrag in dem Profilierungskriterium "GRUNDPREIS EINHEIT" haben:</p><ac:structured-macro ac:name="code" ac:schema-version="1" ac:macro-id="e353289e-75f8-415b-a07c-bc27c02b13bf"><ac:parameter ac:name="language">sql</ac:parameter><ac:plain-text-body><![CDATA[a.hersteller='SAMSUNG' and not exists (select '' from art_profkrit ak where ak.artikelinx=a.nummer and ak.kriterium='GRUNDPREIS EINHEIT' and ak.wert is not null)]] ></ac:plain-text-body></ac:structured-macro><p><br /></p><h3><strong>Basis-URL für Bilder</strong></h3><p>Wenn hier eine URL angegeben wird, dann werden auch die Links zu den Artikelbildern exportiert. Diese URL wird dann mit dem Bildnamen verknüpft.</p><h3><strong>Basis-URL für Dokumente</strong></h3><p>Wenn hier eine URL angegeben wird, dann werden auch die Links zu den Artikel-Dokumenten (PDFs) exportiert. Diese URL wird dann mit dem Dokumentnamen verknüpft.</p><h3><strong>Datei-Übernahme-Filter für Artikel-Dokumente</strong></h3><p>Sollten die Artikel-Dokumente übertragen werden, kann mittels einem oder mehreren Filtern gesteuert werden, welche Dokument-/Dateinamen übernommen werden sollen. Sind Filter im "Datei-Übernahme-Filter" angegeben, werden nur Dateinamen akzeptiert, welche mindestens einem der Übernahme-Filter entspricht. Mehrere Filter werden "semikolon"-getrennt angegeben.</p><p>Folgende Platzhalter sind möglich:</p><table class="wrapped"><colgroup><col /><col /></colgroup><tbody><tr><th>Platzhalter</th><th>Beschreibung</th></tr><tr><td><div class="content-wrapper"><p class="auto-cursor-target">{itemnumber}</p></div></td><td>Im Programm wird dieser Platzhalter mit der aktuellen zu verarbeitenden Artikelnummer ersetzt</td></tr></tbody></table><p><strong>Beispiel:</strong></p><p>Filter: *.pdf;{itemnumber}_Bedienungsanleitung.docx</p><p><strong>Beispieldaten</strong></p><table class="wrapped"><colgroup><col /><col /><col /></colgroup><tbody><tr><th colspan="1">Artikelnummer</th><th>Dateiname</th><th style="text-align: center;">Akzeptiert</th></tr><tr><td colspan="1">4711</td><td>AGB.pdf</td><td style="text-align: center;">JA</td></tr><tr><td colspan="1">4711</td><td>Kurzweiler.hlp</td><td style="text-align: center;">NEIN</td></tr><tr><td colspan="1">4711</td><td>4711_Bedienungsanleitung.docx</td><td style="text-align: center;">JA</td></tr><tr><td colspan="1">4711</td><td colspan="1">4711_Sonderkonditionen.docx</td><td style="text-align: center;" colspan="1">NEIN</td></tr></tbody></table><h3><strong>Datei-Ausschluß-Filter für Artikel-Dokumente</strong></h3><p>Sollten die Artikel-Dokumente übertragen werden, kann mittels einem oder mehreren Filtern gesteuert werden, welche Dokument-/Dateinamen ausgeschlossen werden sollen. Sind Filter im "Datei-Ausschluß-Filter" angegeben, wird der Dateiname nur akzeptiert, wenn keiner der Ausschluß-Filter zutreffen. Mehrere Filter werden "semikolon"-getrennt angegeben.</p><p>Es sind die gleichen Platzhalter, wie im "Datei-Übernahme-Filter" möglich (siehe oben).</p><p><strong>Beispiel:</strong></p><p>Filter: *.docx;{itemnumber}*.pdf</p><p><strong>Beispieldaten</strong></p><table class="wrapped"><colgroup><col /><col /><col /></colgroup><tbody><tr><th>Artikelnummer</th><th>Dateiname</th><th style="text-align: center;">Akzeptiert</th></tr><tr><td>4712</td><td>AGB.pdf</td><td style="text-align: center;">JA</td></tr><tr><td>4712</td><td>4712_Bedienungsanleitung.pdf</td><td style="text-align: center;">NEIN</td></tr><tr><td>4712</td><td>Apple_Care.docx</td><td style="text-align: center;">NEIN</td></tr><tr><td colspan="1">4712</td><td colspan="1">Werbung.doc</td><td style="text-align: center;" colspan="1">JA</td></tr></tbody></table><h3><strong>Mindest-Lagerbestand</strong></h3><p>Hier kann der Mindest-Lagerbestand, welcher übertragen wird, angegeben werden. Dabei wird der tatsächlich verfügbare Bestand mit dieser Menge reduziert.</p><p><strong>Beispiele:</strong></p><table class="wrapped"><colgroup><col /><col /><col /><col /></colgroup><tbody><tr><th>Artikel</th><th style="text-align: center;">Bestand(verfügbar)</th><th style="text-align: center;">Mindest-Lagerbestand</th><th style="text-align: center;">Export-Lagerbestand</th></tr><tr><td>4711</td><td style="text-align: center;">15</td><td style="text-align: center;">10</td><td style="text-align: center;">5</td></tr><tr><td colspan="1">4712</td><td style="text-align: center;" colspan="1">11</td><td style="text-align: center;" colspan="1">10</td><td style="text-align: center;" colspan="1">1</td></tr><tr><td>4713</td><td style="text-align: center;">7</td><td style="text-align: center;">10</td><td style="text-align: center;">0</td></tr><tr><td>4714</td><td style="text-align: center;">1</td><td style="text-align: center;">1</td><td style="text-align: center;">0</td></tr><tr><td colspan="1">4715</td><td style="text-align: center;" colspan="1">5</td><td style="text-align: center;" colspan="1"><br /></td><td style="text-align: center;" colspan="1">5</td></tr></tbody></table><h3><strong>Maximal-Lagerbestand</strong></h3><p>Hier kann der maximal zu exportierende Lagerbestand angegeben werden.</p><ac:structured-macro ac:name="warning" ac:schema-version="1" ac:macro-id="0b173721-a6a5-4e73-a6f0-9075ba62ba81"><ac:rich-text-body><p>Der Maximal-Lagerbestand kann mittels Artikel-Profilierung übersteuert werden!!!</p></ac:rich-text-body></ac:structured-macro><p><br /></p><p><strong>Beispiele:</strong></p><table class="wrapped"><colgroup><col /><col /><col /><col /><col /></colgroup><tbody><tr><th>Artikel</th><th style="text-align: center;">Bestand(verfügbar)</th><th style="text-align: center;">Maximal-Lagerbestand</th><th style="text-align: center;" colspan="1">Mindest-Lagerbestand</th><th style="text-align: center;">Export-Lagerbestand</th></tr><tr><td>4711</td><td style="text-align: center;">15</td><td style="text-align: center;">20</td><td style="text-align: center;" colspan="1"><br /></td><td style="text-align: center;">15</td></tr><tr><td>4712</td><td style="text-align: center;">77</td><td style="text-align: center;">20</td><td style="text-align: center;" colspan="1"><br /></td><td style="text-align: center;">20</td></tr><tr><td>4713</td><td style="text-align: center;">21</td><td style="text-align: center;">20</td><td style="text-align: center;" colspan="1">2</td><td style="text-align: center;">19</td></tr></tbody></table><h3><strong>Maximal-Lagerbestand übersteuern (Artikelprofilierung)</strong></h3><p>Ob der Maximal-Lagerbestand exportiert wird, bzw. welcher Wert als Maximal-Lagerbestand angegeben wird, kann mit einem Artikel-Profilierungskriterium übersteuert werden.</p><p>Folgende Profilierungswerte steuern dies:</p><table class="wrapped"><colgroup><col /><col /><col /></colgroup><tbody><tr><th>Kriterium</th><th>Mögliche Werte</th><th>Beschreibung</th></tr><tr><td>SHOEPPING_USE_MAX_STOCKLEVEL</td><td>"0", "False", "1", "True"</td><td>Gibt an, ob der Lagerbestand gegen den maximalen Lagerbestand geprüft werden soll. Wenn dieser Wert fehlt oder nicht vorhanden ist, wird "<strong>True</strong>" angenommen.</td></tr><tr><td>SHOEPPING_MAX_STOCKLEVEL</td><td>Beliebige Zahl als Maximaler Lagerbestand</td><td>Wenn hier ein Wert eingetragen ist, wird dieser als Maximaler Lagerbestand für diesen Artikel verwendet, anstatt dem Wert in Einstellungen.</td></tr></tbody></table><h3><strong>Maximale Bestellmenge (allgemein)</strong></h3><p>Es kann allgemein vorgegeben werden, welche Menge eines Artikels maximal im Shöpping-Shop gekauft werden kann. Ist hier ein Wert eingetragen, wird dieser im Feld "max-cart-quantity" exportiert.</p><ac:structured-macro ac:name="warning" ac:schema-version="1" ac:macro-id="b901013b-c4c8-431b-b685-781856445ca2"><ac:rich-text-body><p>Die maximale Bestellmenge kann mittels Artikel-Profilierung übersteuert werden!!!</p></ac:rich-text-body></ac:structured-macro><h3><strong>Maximale Bestellmenge (Artikelprofilierung)</strong></h3><p>Ob die maximale Bestellmenge exportiert wird, bzw. welcher Wert als "Maximale Bestellmenge" angegeben wird, kann mit einem Artikel-Profilierungskriterium übersteuert werden.</p><p>Folgende Profilierungswerte sind möglich:</p><table class="wrapped"><colgroup><col /><col /><col /></colgroup><tbody><tr><th>Kriterium</th><th>Mögliche Werte</th><th>Beschreibung</th></tr><tr><td>MAX SALE QTY</td><td>Beliebige Zahl als maximale Bestellmenge</td><td>Wenn hier ein Wert eingetragen ist, wird dieser als maximale Bestellmenge verwendet. Wenn die Menge 0 ist, wird der Wert nicht übertragen.</td></tr></tbody></table><h3><strong>Gewicht für Gewichtsberechnung</strong></h3><p>Gibt an, welches Gewicht für die Gewichtsberechnung für die "DeliveryConfiguration" verwendet werden soll.</p><table class="wrapped"><colgroup><col /><col /></colgroup><tbody><tr><th>Wert</th><th>Beschreibung</th></tr><tr><td>GrossWeightElseNetWeight</td><td>Bruttogewicht (wenn vorhanden) sonst Nettogewicht <strong>(Standard)</strong></td></tr><tr><td>GrossWeightOnly</td><td>Es wird nur das Bruttogewicht verwendet</td></tr><tr><td>NetWeightOnly</td><td>Es wird nur das Nettogewicht verwendet</td></tr></tbody></table><h3><strong>Gewicht für Datenübertragung</strong></h3><p>Gibt an, welches Gewicht für die Artikeldaten-Übertragung verwendet werden soll.</p><p>Es sind die gleichen Werte möglich, die auch für die Gewichtsberechnung (siehe oben) verwendet werden.</p><h3><strong>Vorlaufzeit für Versand in Tagen (Allgemein)</strong></h3><p>Bei der Artikelübertragung kann eine Vorlaufzeit in Tagen je Produkt übermittelt werden. Wenn bei einem Artikel keine individuelle Vorlaufzeit vorgegeben wurde, dann wird die hier angegebene Vorlaufzeit übermittelt (falls angegeben).</p><h3><strong>Warenlager</strong></h3><p>Wird zurzeit nicht verwendet.</p><h3><strong>Aufschläge</strong></h3><p>Es können Aufschläge zum Verkaufspreis berechnet werden. Diesen gibt es je Artikel-Kriterium oder es wird ein Standard-Aufschlag verwendet.</p><p>Der Aufschlag wird bereits in der Listen-Ansicht (Preise) dazugerechnet.</p><h4><strong>Standard-Aufschlag</strong></h4><p>Der Standard-Aufschlag wird dann zum Preis hinzugefügt, wenn kein individueller Aufschlag eines Artikel-Kriteriums gefunden wurde.</p><h4><strong>Aufschläge je Artikelkriterium</strong></h4><p>Hier kann je Artikelkriterium ein individueller Aufschlag festgelegt werden. Wenn ein Aufschlag des jeweiligen Artikel-Kriteriums gefunden wurde, hat dieser Vorrang vor dem "Standard-Aufschlag".</p><p>Grundsätzlich gilt: Wenn die Priorität der Einträge gleich ist, dann wird aufgrund der Ebene entschieden (Reihe vor Gruppe vor Sortiment vor Hauptgruppe).</p><p> <ac:image><ri:attachment ri:filename="image2020-6-12_10-19-3.png" /></ac:image></p><p><strong>Beispiel:</strong></p><table class="wrapped"><colgroup><col /><col /><col /><col /><col /></colgroup><tbody><tr><th>Artikelnummer</th><th>Hersteller</th><th>OE (aus Sonderpreise)</th><th>Hauptgruppe</th><th colspan="1">Treffer</th></tr><tr><td>4711</td><td>ACER</td><td>47</td><td>HARDWARE</td><td colspan="1">1x ( Hauptgruppe HARDWARE ) = 3,5 %</td></tr><tr><td>4712</td><td>SAMSUNG</td><td>10</td><td>HARDWARE</td><td colspan="1">4x ( 1x Hauptgruppe HARDWARE; 1x Hersteller SAMSUNG; 1x OE 10; <strong>1x Hersteller SAMSUNG + OE 10</strong> ) – Priorität 100 gewinnt = 1,5 %</td></tr><tr><td>4713</td><td>PHILIPS</td><td>10</td><td>HARDWARE</td><td colspan="1">2x ( 1x Hauptgruppe HARDWARE; <strong>1x OE 10</strong> ) – Priorität 50 gewinnt = 4%</td></tr><tr><td colspan="1">4714</td><td colspan="1">SAMSUNG</td><td colspan="1">47</td><td colspan="1">HARDWARE</td><td colspan="1">2x ( 1x Hauptgruppe HARDWARE; <strong>1x Hersteller SAMSUNG</strong> ) – Priorität 10 gewinnt = 3,5%</td></tr><tr><td colspan="1">4715</td><td colspan="1">GROHE</td><td colspan="1">47</td><td colspan="1">HARDWARE</td><td colspan="1">1x ( Hauptgruppe HARDWARE ) = 2,5%</td></tr><tr><td colspan="1">4716</td><td colspan="1">MICROSOFT</td><td colspan="1">47</td><td colspan="1">SOFTWARE</td><td colspan="1">1x ( Hauptgruppe SOFTWARE ) = 2,5%</td></tr><tr><td colspan="1">4717</td><td colspan="1">SPITZ</td><td colspan="1">47</td><td colspan="1">SPIRITUOSEN</td><td colspan="1">0x – Standard-Aufschlag wird verwendet = 3%</td></tr></tbody></table><h2><strong>Auftragsanlage</strong></h2><p>Hier werden Optionen behandelt, die ausschließlich für die Bestell- und Auftragsbearbeitung Anwendung finden.</p><p> <ac:image><ri:attachment ri:filename="image2019-11-6_14-58-25.png" /></ac:image></p><h3><strong>Aufträge automatisch drucken</strong></h3><p>Wenn aktiviert, werden die erstellten shöpping-Aufträge, automatisch auf einem Drucker ausgedruckt.</p><p>Das Druckprofil wird über die konfigurierte Länder-Kundennummer bestimmt (siehe Sammel-Kundennummer(n) für Aufträge je Land ).</p><p>Sollte der Druck nicht funktionieren, prüfen Sie bitte folgende Einstellungen am Server:</p><ul><li><span>Der Druck erfolgt über den WebService auf dem TaskCenter-Server. Prüfen Sie, ob der IIS-Benutzer auf einen physischen Benutzer gemappt ist.</span></li><li><span>Prüfen Sie, ob der PDFCreator installiert ist und dieser bei dem IIS-Benutzer als Standard-Drucker eingetragen ist.</span></li><li><span>Prüfen Sie, ob der IIS-Benutzer Zugriff auf den Drucker hat.</span></li><li><span>Das Druck-Layout muss im LC.NET\Company\Reports-Ordner verfügbar sein. Sollten Sie kein eigenes Druck-Layout verwenden, muss das Standard-Layout dort abgelegt werden.</span></li></ul><h3><strong>Je erstelltem Auftrag eine EMail senden</strong></h3><p>Wenn aktiviert, wird nach jedem erstellten shöpping-Auftrag, automatisch eine EMail an die konfigurierte Protokoll-EMail-Adresse gesendet.</p><h3><strong>Auftrags-PDF beim Mail-Versand anhängen</strong></h3><p>Wenn aktiviert, wird ein Auftrags-PDF des erstellten shöpping-Auftrags beim automatischen Mail-Versand angehängt.</p><h3><strong>Immer Liefer- und Rechnungsadresse befüllen</strong></h3><p>Diese Option steuert, ob bei Auftrags-Anlage immer die abweichende Lieferadresse und die abweichende Rechnungsadresse eingetragen werden sollen.</p><p>Ist dies deaktiviert, wird die abweichende Lieferadresse nur dann befüllt, wenn diese von der Rechnungsadresse (normale Anschrift) abweicht. Die abweichende Rechnungsadresse wird nie eingetragen.</p><h3><strong>Je Auftrag eine neue Kundennummer anlegen</strong></h3><p>Ist diese Option aktiviert, dann wird bei jeder Auftragsanlage auch ein neuer Kunde angelegt. Über die Kunden-Länder-Zuordnung wird dabei der "Vorlage"-Kunde selektiert und kopiert. Somit können einige</p><p>Einstellungen per Vorlage gesteuert werden, wie z.B. das Druckprofil.</p><h3><strong>Rechnungs-PDF beim Versand anhängen</strong></h3><p>Wenn aktiviert, wird beim Übermitteln der Versendung geprüft, ob bereits eine Rechnung existiert. Wenn ja, wird diese Rechnung als PDF bei der Versand-Meldung übermittelt.</p><h3><strong>Gutschein-Artikelnummer</strong></h3><p>Hier wird die Artikelnummer eingetragen, die für Gutschein-Positionen verwendet wird.</p><p>Alle Gutscheine einer shöpping-Bestellung werden mit dieser Artikelnummer und dem jeweiligen Gutschein-Wert als Position eingefügt.</p><h2><strong>Zuordnungen</strong></h2><p>In diesem Bereich werden verschiedene Werte-Übersetzungen definiert:</p><p> <ac:image><ri:attachment ri:filename="image2021-10-1_12-27-14.png" /></ac:image></p><h3><strong>Sammel-Kundennummer(n) für Aufträge je Land (aktuell nur Österreich)</strong></h3><p>Hier erfolgt die Zuordnung pro Land zu einer Sammel- oder Vorlage-Kundennummer.</p><p>Aus den Kundendaten wird zB. die Organisatorische Einheit ermittelt, aus der wiederum das Entnahmelager der Artikel.</p><p>Da hier die Ländercodes aus der "Postcodes"-Tabelle verwendet werden, muss die ISO-Ländercode-Zuordnung auch in den "Postcodes"-Vorgabewerten durchgeführt werden:</p><p><span class="confluence-embedded-file-wrapper confluence-embedded-manual-size"><ac:image ac:height="185"><ri:attachment ri:filename="image2019-6-25_10-37-37.png" /></ac:image></span></p><p class="auto-cursor-target"><br /></p><ac:structured-macro ac:name="warning" ac:schema-version="1" ac:macro-id="004af2af-d41a-48e9-8786-fbbe8b70d99a"><ac:rich-text-body><p>Wichtig: shöpping übergibt das Land in der Schnittstelle nicht - daher ist zurzeit ausschließlich Österreich möglich.</p><p>Sollte sich das einmal ändern, wird die Schnittstelle angepasst.</p></ac:rich-text-body></ac:structured-macro><p><br /></p><h3><strong>Zahlungsmethoden / Mapping</strong></h3><p>Das ist die Übersetzungstabelle für shöpping-PaymentMode auf POLLEX-Zahlungsbedingung.</p><p>Es gibt keine Liste mit shöpping-PaymentModes, daher müssen diese nach Bedarf eingepflegt werden.</p><p>Wichtig: Die Zahlungsbedingung MUSS vorhanden sein, da sonst die Auftrags-Anlage nicht durchgeführt wird.</p><h3><strong>DeliveryConfiguration → Versandart-Mapping</strong></h3><p>Diese Übersetzung findet beim Erstellen eines POLLEX-Auftrags Anwendung und zwar wird der shöpping-deliveryConfiguration ( z.B. "Post-Paketlogistik-E+2" ) zu einer POLLEX-Versandart gemappt.</p><p>Ist ein shöpping-deliveryMode nicht konfiguriert, wird der Auftrag nicht angelegt und es kommt zu einer Fehlermeldung.</p><h3><strong>Versandart-->DeliveredBy-Mapping (Versendung)</strong></h3><p>Hier wird die Übersetzung der POLLEX-Versandarten auf shöpping-deliveredBy beim Versenden durchgeführt.</p><p>Es gibt von shöpping 2 mögliche Werte:</p><table class="wrapped"><colgroup><col /><col /></colgroup><tbody><tr><th>Wert</th><th>Beschreibung</th></tr><tr><td>ploe</td><td>Versand durch PostAG</td></tr><tr><td>freight</td><td>Speditioneller Versand</td></tr></tbody></table><p>Die Schnittstelle ermittelt primär, ob es einen Wert in der Übersetzungs-Tabelle gibt, wenn ja, wird dieser verwendet.</p><ac:structured-macro ac:name="info" ac:schema-version="1" ac:macro-id="d15a333e-d0f6-4d7f-a751-5847aa9d3437"><ac:rich-text-body><p>Wurde kein Wert über die Schnittstelle konfiguriert, wird standardmäßig "<strong>ploe</strong>" angenommen.</p></ac:rich-text-body></ac:structured-macro><h3>Langtext</h3><p>Der Langtext wird standardmäßig aus der Tabelle <strong>ARTIKELSTAMM </strong>Spalte <strong>LANGTEXT </strong>selektiert.</p><p>Über diese Einstellung kann der Langtext auf einen beliebigen Wert abgeändert werden.</p><p><u><strong>Fixwert </strong></u>(Muss mit einfachen Hochkomma angegeben werden): <u>Beispiel</u>: 'FIXWERT'</p><p><u><strong>SQL Statement</strong></u>: Der Langtext kann auch aus einer anderen Tabelle selektiert werden. Wird ein SQL Statement angegeben, muss dieses in Klammern <strong>()</strong> gesetzt werden.</p><p><u>Beispiel</u>: (select t.text from zusatztexte t where t.dok_typ=1 and t.dok_inx=<a.NUMMER> and t.bezeichnung='LANGTEXT') - (Kein Strichpunkt am Ende des Statements!)</p><p>Es kann auf alle Spalten des Artikelstamms mit dem Alias <strong>a.<SPALTENNAME></strong> zugegriffen werden.</p><h2><strong>Protokoll-EMail-Einstellungen</strong></h2><p>Hier werden die allgemeinen EMail-Einstellungen vorgenommen, an die Protokolle, Auftrags- oder Fehlermeldungen gesendet werden.</p><ac:structured-macro ac:name="info" ac:schema-version="1" ac:macro-id="78c8d6a0-85ad-4d45-a640-3cbd2a257f76"><ac:rich-text-body><p>Es wird dringend empfohlen, im Automatik-Betrieb die EMail-Daten zu hinterlegen, da ansonsten ev. auftretende Probleme unentdeckt oder zu spät bemerkt werden!!</p></ac:rich-text-body></ac:structured-macro><p><br /></p><p><ac:image ac:height="250"><ri:attachment ri:filename="image2019-10-1_16-35-12.png" /></ac:image></p><h3><strong>EMail-Adresse für Info</strong></h3><p>Wenn hier eine EMail-Adresse angegeben wurde, dann werden Status- oder Fehlerberichte an diese Adresse gesendet. Mehrere Mail-Adressen können semikolon-getrennt angegeben werden.</p><h3><strong>Absender-EMail-Adresse</strong></h3><p>Die hier eingetragene Adresse wird als Absender angezeigt und ist zwingend erforderlich, wenn Mails versendet werden.</p><h3><strong>SMTP Server</strong></h3><p>Hier wird der SMTP-Server für den Mail-Versand angegeben.</p><p>Wenn ein eigener Exchange-Server verwendet wird, dann ist sicherzustellen, dass das sogenannte "Relaying" aktiviert ist, da ansonsten der Mailversand fehlschlägt.</p><h3><strong>SMTP Benutzer</strong></h3><p>Benutzername für den SMTP-Server zum Mail-Versand</p><h3><strong>SMTP Passwort</strong></h3><p>Passwort für den SMTP-Server zum Mail-Versand</p><h3><strong>SSL verwenden</strong></h3><p>Wenn aktiviert, wird die SSL-Verschlüsselung zum Mail-Versand aktiviert</p><h3><strong>SMTP Port</strong></h3><p>Optional kann hier ein abweichender SMTP-Port angegeben werden. Standard ist 25.</p><h3><strong>Mail-Level</strong></h3><p>Hier kann die Stufe der Benachrichtigungs-Mails angepasst werden.</p><ul><li><strong>All</strong> - Es werden Status- und Fehlermails versandt</li><li><strong>ErrorsOnly</strong> - Es werden nur Fehlerberichte versendet</li><li><strong>NoMail</strong> - Mailversand ist deaktiviert</li></ul><h3><strong>EMail-Betreff</strong></h3><p>Wenn gewünscht, kann hier ein benutzerdefinierter Betreff für den Mail-Versand eingetragen werden.</p><p>Es können hier auch StringFunctions verwendet werden. Außer den Standard-StringFunctions sind<br />folgende Funktionen verfügbar: @GetOrderValue("NAME"); @GetErrorText(); @HasErrors();<br />@GetInterfaceKey(); @GetInterfaceTitle() #ToDo#<br />ACHTUNG: Wenn ein Mail-Betreff mehr als 254 Zeichen enthält, kann dieser nicht in der Datenbank<br />gespeichert werden! Erstellen Sie stattdessen eine Konfigurations-Datei (Vorlagen sind im Templates-Ordner enthalten).</p><h3><strong>EMail-Body</strong></h3><p>Genauso wie im Betreff, kann ein eigener Body-Text vorgegeben werden.</p><p>Es können hier auch StringFunctions verwendet werden. Außer den Standard-StringFunctions sind<br />folgende Funktionen verfügbar: @GetOrderValue("NAME"); @GetErrorText(); @HasErrors();<br />@GetInterfaceKey(); @GetInterfaceTitle() #ToDo#<br />ACHTUNG: Wenn ein Mail-Betreff mehr als 254 Zeichen enthält, kann dieser nicht in der Datenbank<br />gespeichert werden! Erstellen Sie stattdessen eine Konfigurations-Datei (Vorlagen sind im Templates-Ordner enthalten).</p><p><br /></p><h1><strong>Karteikarte "Trigger"</strong></h1><p>Für den automatischen Ablauf ist es erforderlich, dass die shöpping-Schnittstelle verschiedene Meldungen (Artikeldaten wurden geändert, Bestellungen wurden versandt) mitbekommt.</p><p>Dafür wird die Tabelle "SHOEPPING_UPDATE" benötigt, die als Warteschlange für die automatisierte Abarbeitung dient. Die Schnittstelle prüft die Einträge in dieser Tabelle und sorgt dafür,</p><p>dass diese im automatischen Ablauf abgearbeitet werden. Die Tabelle wird mittels Datenbank-Trigger befüllt, welche einmalig angelegt werden müssen, dafür ist die Karteikarte "Datenbank-Trigger" zuständig.</p><p>Mit der Schnittstelle werden mehrere Beispiel-Trigger mitgeliefert, die je nach Bedarf angepasst werden können (SQL-Kenntnisse von Vorteil).</p><h3>Trigger "artikelstamm_update_data"</h3><p><strong>Name in der Datebank:</strong> trg_shoepping_items_update</p><p>Dieser Trigger sorgt dafür, dass Änderungen an den Stammdaten von Artikeln für die shöpping-Schnittstelle bereitgestellt werden. Bei jeder Änderung im Artikelstamm wird dabei ein Eintrag in der SHOEPPING_UPDATE-Tabelle mit dem Typ 1 für den Artikel erstellt.</p><h3>Trigger "artikelstamm_update_show_net"</h3><p><strong>Name in der Datebank:</strong> trg_shoepping_item_show_net</p><p>Wenn die Artikel-Eigenschaft "Webshop-Artikel" im Artikelstamm geändert wurde, sorgt der Trigger dafür, dass in der Tabelle SONDERPREISE das Web-Kennzeichen für diesen Artikel zurückgesetzt wird. Das hat zur Folge, dass in nächster Instanz der notwendige SONDERPREIS-Trigger dafür sorgt, dass in der SHOEPPING_UPDATE ein Eintrag erstellt wird.</p><h3>Trigger "lagerbestand_update"</h3><p><strong>Name in der Datebank:</strong> trg_shoepping_stock</p><p>Sorgt dafür, dass Lagerbestands-Änderungen von Artikeln in die SHOEPPING_UPDATE-Tabelle gelangen.</p><h3>Trigger "lieferschein_erledigt_versendung"</h3><p><strong>Name in der Datebank:</strong> trg_shoepping_delivery_sent</p><p>Dieser Trigger teilt der shöpping-Schnittstelle mit, dass ein Lieferschein erledigt und somit versendet wurde.</p><p>Sollten bereits Versanddaten (Tracking-Link, NVE-Nummer) vorhanden sein, werden diese bei der Versand-Meldung automatisch ausgelesen.</p><h3>Trigger "sonderpreise_delete"</h3><p><strong>Name in der Datebank:</strong> trg_shoepping_item_delete</p><p>Dieser Trigger prüft, ob der Artikel durch das Löschen noch in shöpping bereitgestellt wird, wenn ja, wird ein SHOEPPING_UPDATE-Eintrag für eine Preis-Änderung erstellt, andernfalls ein SHOEPPING_UPDATE-Eintrag für die Deaktivierung des Artikels (Lagerbestand wird dann über die Schnittstelle auf 0 gestellt).</p><h3>Trigger "sonderpreise_new"</h3><p><strong>Name in der Datebank:</strong> trg_shoepping_item_new</p><p>Dieser Trigger prüft, ob der Artikel durch den neuen Eintrag für shöpping aktiviert werden soll, wenn ja, wird ein SHOEPPING_UPDATE-Eintrag für eine Artikel-Aktivierung erstellt, andernfalls ein SHOEPPING_UPDATE-Eintrag für eine Preisänderung.</p><h3>Trigger "sonderpreise_update"</h3><p><strong>Name in der Datebank:</strong> trg_shoepping_item_update</p><p>Dieser Trigger prüft, ob der Artikel durch den neuen Eintrag für shöpping aktiviert werden soll, wenn ja, wird ein SHOEPPING_UPDATE-Eintrag für eine Artikel-Aktivierung erstellt, andernfalls ein SHOEPPING_UPDATE-Eintrag für eine Preisänderung.</p><h3>Trigger "trackinglink_erstellt"</h3><p><strong>Name in der Datebank:</strong> trg_shoepping_bexnve_insert</p><p>Dieser Trigger löst standardmäßig aus, wenn ein neuer Eintrag in der Tabelle BEX_NVE erfolgt, also Versanddaten verfügbar sind (Tracking-Link, NVE-Nummer).</p><p>Er teilt der Schnittstelle mit, dass eine shöpping-Bestellung versendet wurde.</p><p>Ob Sie diesen Trigger verwenden, oder dies mit dem "lieferschein_erledigt_versendung"-Trigger steuern, oder beide verwenden möchten, hängt von Ihrem Ablauf ab.</p><p class="auto-cursor-target"><br /></p>