Woo Commerce Import
Categories:
Im Auftragsmodul steht auch der Shop-Import im WooCommerce Format zur Verfügung. Laut Informationen von Kieselstein ERP eG Mitgliedern kann dieses Datenformat auch von Shopware mit einer kleinen Anpassungsprogrammierung zur Verfügung gestellt werden.
WooCommerce Import
Dieser Import steht im Modul Auftrag, im Menüpunkt Auftrag, Import, WooCommerce CSV zur Verfügung. Die Grundidee ist, dass vom Shop täglich Daten abgeholt werden, z.B. über FTP Import und dann täglich diese Daten eingelesen werden. Da es dabei immer wieder zu erforderlichen Anpassungsarbeiten kommt, sehen wir den manuellen Import als sinnvoller an.
Man findet die Schnittstelle im Modul Auftrag.
Zuordnung der WooCommerce Spaltenname:
Wichtig: Die Spaltenbezeichnungen müssen in Englisch übergeben werden. Bitte übergib die Datei bis auf weiteres ausschließlich mit den englischen Spaltenüberschriften; nur damit werden Anrede, Vorname und Nachname richtig zugeordnet.
Wir gehen davon aus, dass alle Beträge als Nettobeträge übergeben werden.
Zusätzlich haben wir die Logik implementiert, dass der Brutto-Gesamtbetrag = Order Total Amount aus dem Shop exakt dem anhand der Kieselstein ERP Preise errechneten Wert entsprechen muss / sollte. D.h. wenn die Verkaufspreisfindung gleiche Preise ergibt wie die Preise aus dem Shop, so sollten sich die gleichen Summen ergeben.
Hier kommt noch die Herausforderung dazu, dass der Shop ein Brutto rechnendes System ist und Kieselstein ERP netto rechnet. Das bedeutet wiederum, dass es zu geringen Cent-Abweichungen kommen kann.
Diese Differenz wird über eine zusätzliche Position mit dem Rundungsausgleichsartikel ausgeglichen. Beträgt sie mehr als 1,00 €, wird zusätzlich eine Textposition mit dem Hinweis auf die Abweichung eingefügt, damit du den Beleg vor dem Aktivieren prüfen kannst.
Definieren Sie dafür den Parameter RUNDUNGSAUSGLEICH_ARTIKEL mit z.B. RUNDUNG. Der Artikel RUNDUNG selbst muss, nicht lagerbewirtschaftet sein. Der Mehrwertsteuersatz muss mit steuerfrei definiert werden.
“Order Number”,“Order Status”,“Order Date”,“Customer Note”,Title,“First Name (Billing)”,“Last Name (Billing)”,“Company (Billing)”,“Address 1&2 (Billing)”,“City (Billing)”,“State Code (Billing)”,“Postcode (Billing)”,“Country Code (Billing)”,“Email (Billing)”,“Phone (Billing)”,“First Name (Shipping)”,“Last Name (Shipping)”,“Address 1&2 (Shipping)”,“City (Shipping)”,“State Code (Shipping)”,“Postcode (Shipping)”,“Country Code (Shipping)”,“Payment Method Title”,“Cart Discount Amount”,“Order Subtotal Amount”,“Shipping Method Title”,“Order Shipping Amount”,“Order Refund Amount”,“Order Total Amount”,“Order Total Tax Amount”,SKU,“Item #”,“Item Name”,Quantity,“Item Cost”
| Spalte | Bedeutung | Aktion / Beschreibung |
|---|---|---|
| Order Number | Bestellnummer | Bestimmt die Zusammenfassung der Zeilen zu einem Auftrag. Sie wird, mit SHOP- davor, in das Feld Bestellnummer der Auftragskopfdaten übernommen. Gibt es diese Bestellnummer bereits, wird der Import abgebrochen. |
| Order Date | Belegdatum | Wird als Belegdatum des Auftrags übernommen und muss bis auf weiteres im Format JJJJ-MM-TT hh:mm übergeben werden, also z.B. 2026-08-28 09:15. Weicht das Format ab, wird der Import abgebrochen. |
| Customer Note | Kommentar | Wird in den externen Kommentar der Auftragskopfdaten übernommen |
| Title | Anrede | Die Anrede (Title) aus dem Shop wird wie folgt interpretiert: 1 … Herr 2 … Frau alle anderen werden derzeit auf <leer>, also keine gesetzt. |
| First Name | Vorname | Es werden die Spalte First Name in den Vornamen und Last Name in den Familiennamen übernommen |
| Last Name | Nachname | |
| Kunden Erkennung | Um zu erkennen, ob ein Kunde schon angelegt ist, wird die RE-E-Mail-Adresse herangezogen. D.h. gibt es für die erhaltene E-Mail-Adresse Email (Billing) bereits einen angelegten Kunden, so wird dieser verwendet und kein neuer Kunde angelegt. Wird die E-Mail-Adresse nicht unter RE-E-Mail-Adresse gefunden, so wird der Kunde neu angelegt. Bitte achten Sie darauf, dass aktuell auch die Groß-/Kleinschreibung für die Zuordnung herangezogen wird. |
|
| Shipping Method Title | Lieferart | Dieser Eintrag wird unter den Lieferarten, genauer einer Bezeichnung aus den Lieferarten gesucht. Wird kein Eintrag gefunden, wird der Import abgebrochen. Hinter der Lieferart muss es auch einen Versandkosten- (Transportkosten)-Artikel geben. Die Versandkosten werden (netto) vom Shop in der Spalte Order Shipping Amount übergeben. Beim Import wird der Verkaufspreis der AB-Position des Versandkostenartikels auf diesen Betrag gesetzt, wodurch die Adresse wie eine Firma behandelt wird. |
| Payment Method Title | Zahlungsziel | Dieser Eintrag wird unter den Zahlungszielen gesucht. Wird kein Eintrag gefunden, wird der Import abgebrochen. |
| SKU | Artikelnummer | muss mit der Artikelnummer deines Kieselstein-ERP Artikelstamms übereinstimmen. Ist der Artikel im Artikelstamm nicht vorhanden, wird eine Handeingabe mit der Artikelnummer als Bezeichnung und darunter eine Textposition mit dem entsprechenden Hinweis angelegt. |
| Quantity | Menge | wird als Positionsmenge in den Auftrag übernommen |
| Item Cost | netto Verkaufspreis dieses Artikels | Bei der Anlage der Auftragsposition wird der Verkaufspreis anhand der Verkaufspreisfindung ermittelt. Weichen der ermittelte Verkaufspreis und der vom Shop erhaltene Item Cost um mehr als 0,10 € voneinander ab, wird im Anschluss an die Position eine Textposition mit dem Hinweis auf die Abweichung eingefügt. |
Rechnungsadresse / Lieferadresse
- Die Rechnungsadresse wird anhand der erhaltenen E-Mailadresse ermittelt. D.h. ist im Kieselstein ERP Kundenstamm die RE-E-Mailadresse bereits vorhanden, so wird diese Adresse als Kunde verwendet. Es erfolgt keine weitere Prüfung mehr.
- Sind in den erhaltenen Shop-Daten die Daten für die Rechnungsadresse und die Lieferadresse gleich, so wird als Lieferadresse, des Auftrags, die Rechnungsadresse verwendet, egal ob die erhaltenen Adressdaten davon abweichend sind.
- Sind in den erhaltenen Shop-Daten die Daten für die Rechnungsadresse und die Lieferadresse ungleich, so wird die Lieferadresse neu angelegt und die Adressart als Lieferadresse gekennzeichnet.
ACHTUNG
Die RE-E-Mailadresse darf im gesamten Kundenstamm nur EINMAL vorkommen. Anderenfalls wird die Adresse erneut angelegt. Auch wenn diese E-Mail-dresse bei verschiedenen Ansprechpartnern definiert ist, kann es zu Fehlinterpretationen kommen.Nutze gegebenenfalls auch die Groß-/Klein-Schreibung bei den E-Mailadressen (nicht getestet).
Info:
Die erweiterte Suche bei der Kundenauswahl prüft leider die RE-EMail-Adresse NICHT!
Was der Import anlegt
- Angelegt wird ein freier Auftrag im Status angelegt. Als Vertreter wird der Kieselstein ERP Benutzer eingetragen, der den Import durchführt.
- Der Liefertermin der Kopfdaten ergibt sich aus dem Belegdatum zuzüglich der im Mandantenparameter DEFAULT_LIEFERZEIT_AUFTRAG hinterlegten Tage. Ist der Parameter nicht gepflegt, werden 14 Tage angenommen.
- Die Projektbezeichnung wird mit der Kurzbezeichnung des Artikels der ersten Zeile der Bestellung vorbesetzt.
- Währung, Spediteur und Abbuchungslager kommen aus den Konditionen des ermittelten Kunden.
- Die Positionstermine entsprechen dem Liefertermin der Kopfdaten.
- Eine Position für die Versandkosten wird nur dann angelegt, wenn in Order Shipping Amount ein Betrag ungleich null steht.
Fehlermeldungen
Bitte die angeführte Lieferart definieren. Siehe oben Lieferart bzw. nachfolgend ein Muster wie die Lieferart angelegt werden könnte.
Bitte beachte die Zuordnung des Frachtkostenartikels
Passiert bei der Vergabe der Debitorennummer für neue Kunden.
ACHTUNG: Bitte die automatische Vergabe der Debitorennummer abschalten.
Dies passiert gerne, wenn manuell der Auftrag aus dem Shop angelegt wird und danach der Import gestartet wird. Um diese Situation zu entschärfen, wird vom Import automatisch SHOP- vor die eigentliche Bestellnummer aus dem Shop gestellt.
Parameter
Mit dem Parameter WOOCOMMERCE_PARTNER_ZUSAMMENZIEHEN kann eingerichtet werden, dass Vorname und Nachname beim Import, wenn keine Company gegeben ist, in den PartnerName1 zusammengezogen wird.
Musterdaten
Musterdaten mit genauer Feldzuordnung siehe als LibreOffice Vorlage mit Beschreibung bzw. als CSV
Zusatzinfo
- Die Partnerart ist fix auf Adresse, so wie bei anderen Kunden auch
- Die Kommunikationssprache ist in der Regel die Sprache, in der sich der Kieselstein ERP Benutzer angemeldet hat
- Der Mehrwertsteuersatz kommt aus dem Land, also Inland mit Allgemeine Waren, alle anderen Länder steuerfrei. Für genauere Definition siehe bitte System, Mandant, Vorbelegungen.