mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-12-27 15:10:28 +01:00
1 line
7.5 KiB
Plaintext
1 line
7.5 KiB
Plaintext
<h1><span style="font-size:28px;"><strong>Avocadostore Schnittstelle</strong></span></h1>Aus Xentral können benötigte Daten an den Avocadostore gemeldet werden. Dazu erstellt man in Xentral sogenannte Berichte (SQL Datenbankabfragen) für Lagerzahlen und versendete Trackingnummern, die im Avocadostore Backend über den Sendungsdatenimport automatisch eingespielt werden können.<h2>Features</h2><ul><li>Mit einer CSV der Bestellungen aus dem Avocadostore Backend via Belege Importer in Xentral Aufträge anlegen</li><li>Berichte über Lagerzahlen und Trackingnummer in Xentral generieren</li><li>URL dieser Berichte für Sendungsdatenimport von Avocadostore bereitstellen</li></ul><h2>Aufträge via Belege Importer anlegen</h2><p>Im Avocadostore Backend kann man sich eine CSV Datei mit den aktuellen Bestellungen exportieren.<br />Diese CSV Datei kann man danach über den Belege Importer in Xentral einlesen und Aufträge anlegen.<br /><br />Wichtig hierbei ist die Umwandlung in das richtige CSV-Format - die Überschriften müssen den Xentral-Variablennamen für die entsprechenden Inhalte entsprechen. Diese findet man im Reiter "Formate" im Belege Importer selber.<br /><br />Weiterführende Informationen findet man hier: <a href="https://xentral.com/helpdesk/kurzanleitung-belege-importer">Belege Importer</a></p><h3>Variablen</h3><p>Nützliche Variablen für den Belege-Import können sein:</p><ul><li class="level1"><div class="li"><strong>beleg_belegnr</strong> ⇒ Belegnummer in Xentral - falls es automatisch zugewiesen werden soll: das Wort <strong>NEW</strong> verwenden</div></li><li class="level1"><div class="li"><strong>beleg_internet</strong> ⇒ Bestellnummer aus dem Shop</div></li><li class="level1"><div class="li"><strong>beleg_datum</strong> ⇒ Belegdatum</div></li></ul><ul><li class="level1"><div class="li"><strong>beleg_name</strong> ⇒ Name des Kunden (Rechnungsadresse)</div></li><li class="level1"><div class="li"><strong>beleg_kundennummer</strong> ⇒ Belegnummer in Xentral - falls es automatisch zugewiesen werden soll: das Wort <strong>NEW</strong> verwenden</div></li><li class="level1"><div class="li"><strong>beleg_strasse</strong> ⇒ Strasse inkl. Hausnummer des Kunden (Rechnungsadresse)</div></li><li class="level1"><div class="li"><strong>beleg_adresszusatz</strong> ⇒ Adresszusatz des Kunden (Rechnungsadresse)</div></li><li class="level1"><div class="li"><strong>beleg_ort</strong> ⇒ Ort des Kunden (Rechnungsadresse)</div></li><li class="level1"><div class="li"><strong>beleg_plz</strong> ⇒ PLZ des Kunden (Rechnungsadresse)</div></li><li class="level1"><div class="li"><strong>beleg_land</strong> ⇒ Land des Kunden (Rechnungsadresse)</div></li></ul><ul><li class="level1"><div class="li"><strong>beleg_liefername</strong> ⇒ Name (abweichende Lieferadresse)</div></li><li class="level1"><div class="li"><strong>beleg_lieferstrasse</strong> ⇒ Straße (abweichende Lieferadresse)</div></li><li class="level1"><div class="li"><strong>beleg_lieferadresszusatz</strong> ⇒ Adresszusatz (abweichende Lieferadresse)</div></li><li class="level1"><div class="li"><strong>beleg_lieferort</strong> ⇒ Ort (abweichende Lieferadresse)</div></li><li class="level1"><div class="li"><strong>beleg_lieferplz</strong> ⇒ Postleitzahl (abweichende Lieferadresse)</div></li><li class="level1"><div class="li"><strong>beleg_lieferland</strong> ⇒ Land (abweichende Lieferadresse)</div></li></ul><ul><li class="level1"><div class="li"><strong>artikel_nummer</strong> ⇒ Artikelnummer für Position</div></li><li class="level1"><div class="li"><strong>artikel_bezeichnung</strong> ⇒ Artikelbeschreibung für Position</div></li><li class="level1"><div class="li"><strong>artikel_menge</strong> ⇒ Artikelmenge für Position</div></li><li class="level1"><div class="li"><strong>artikel_waehrung</strong> ⇒ Artikelwährung für Position</div></li><li class="level1"><div class="li"><strong>artikel_preis</strong> ⇒ Artikel-VK für Position</div></li><li class="level1"><div class="li"><strong>artikel_umsatzsteuer</strong> ⇒ Umsatzsteuer: Leer lassen bzw. <strong>normal</strong> oder <strong>ermaessigt</strong> als Wort angeben</div></li></ul><h2>Berichte erstellen</h2>Eine ausführliche Anleitung zu Berichten allgemein in Xentral findet man hier: <a href="https://xentral.com/helpdesk/db-berichte-neu">Berichte erstellen</a><h3>Lagerzahlen</h3>Lageranzahl aller Artikel mit Spalten für EAN, Artikelname und Lagermenge.<br />Eventuell noch einschränken nach Artikelnummer oder Artikelprojekt in der WHERE-Abfrage, falls nicht alle Artikel übertragen werden sollen.<br /><br /><strong>SQL Statement</strong><br /> <div style="background:#eeeeee;border:1px solid #cccccc;padding:5px 10px;">SELECT<br />a.ean AS ean,<br />a.name_de AS artikelname,<br />REPLACE(ROUND(lpi.menge,0),'.',',') AS menge<br />FROM lager_platz_inhalt AS lpi<br />JOIN lager_platz lp on lpi.lager_platz = lp.id<br />LEFT JOIN projekt plp ON lp.projekt = plp.id<br />JOIN artikel a ON lpi.artikel = a.id<br />WHERE a.geloescht=0</div><br /><strong>Spalten</strong><br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=avocadostore&fileid=2683" style="width: 1236px; height: 319px;" /><br /><br /> <h3>Trackingnummern</h3>Trackingnummern der letzten 14 Tage mit Spalten für Bestellnummer Shop, Trackingnummer, Versandart.<br /><br /><strong>SQL-Statement</strong><br /> <div style="background:#eeeeee;border:1px solid #cccccc;padding:5px 10px;">SELECT auf.internet, v.tracking, IF(v.versandart = 'dhlversenden', 'dhl', v.versandart) AS versandart FROM auftrag auf<br />LEFT JOIN lieferschein l ON l.auftragid = auf.id<br />LEFT JOIN versand v ON l.id = v.lieferschein<br />WHERE v.versendet_am >= (CURDATE() - INTERVAL 14 DAY) AND l.status != 'storniert'</div><br /><strong>Spalten</strong><br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=avocadostore&fileid=2682" style="width: 1237px; height: 317px;" /><br /><br /> <h3>Berichte URL</h3>Sobald die Berichte erstellt sind, kann man für im jeweiligen Bericht im Reiter <strong>"Übertragung"</strong> eine URL erstellen.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=avocadostore&fileid=2681" style="width: 698px; height: 255px;" /><br /><br /><strong>Hinweis:</strong> Falls die URL von der Länge nicht akzeptiert wird, gibt es im Internet sogenannten "URL Shortener" Dienste.<h2><br />Import im Avocadostore</h2>Im Reiter Import kann man sich im Reiter <strong>"Importe"</strong> einen automatischen Import dank der URL aus Xentral einrichten.<br /><br /><strong>Hinweis:</strong> Bei Fragen zur Einrichtung des Imports in Avocadostore bitte direkt an den Support von Avocadostore wenden um eine qualifizierte Auskunft zu erhalten.<br /><br /><strong>Angebotsimport</strong><br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=avocadostore&fileid=2684" style="width: 1109px; height: 894px;" /><br /><br /><br /><strong>Sendungsdatenimport</strong><br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=avocadostore&fileid=2685" style="width: 1092px; height: 893px;" /> |