In diesem Beispiel wird gezeigt, wie mit Hilfe der Software CartLoad Bestellungen aus xt:Commerce nach Lexware faktura+auftrag übertragen werden können. Die Software arbeitet dabei mit dem für Lexware angepassten openTRANS-Format, in dem bestimmte Besonderheiten von Lexware berücksichtigt worden sind.
Als Shopsystem wird xt:Commerce eingesetzt. Mit Hilfe des xt:Commerce Export-Managers im Backend des Shops werden Bestellungen exportiert.
Die Warenwirtschaft ist die Software Lexware faktura+auftrag. Die Wawi hat einen Import-Dialog für Shop-Bestellungen, der mit einer speziellen Variante des openTrans-Formats arbeitet.
Bestellungen aus xt:Commerce sollen in Lexware weiterverarbeitet werden. Neue Kunden sollen dabei angelegt werden. Die Zuordnung einer Bestellung zu vorhandenen Kunden soll automatisch erfolgen, wobei Kunden anhand der E-Mail-Adresse identifiziert werden sollen (zwecks Eindeutigkeit).
Es dürfen keine Bestellungen doppelt ausgelesen werden. Die Software muss dies erkennen und bereits verarbeitete Bestellungen überspringen. Automatisch soll eine Zuordnung zwischen Zahlungs- und Lieferbedingungen stattfinden, damit z. B. eine PayPal-Zahlung auch korrekt in Lexware verarbeitet werden kann.
Mit der Software CartLoad werden Bestellungen regelmäßig aus xt:Commerce abgerufen. Dies erfolgt ca. 1x pro Tag, kann aber auch häufiger gemacht werden. Die Software legt die Bestellungen im Dateisystem des Computers, auf dem Lexware installiert ist, als XML-Datei im Lexware-Format ab.
Zu allererst muss der xt:Commerce Export-Manager konfiguriert werden. Hierzu habe ich eine Anleitung geschrieben. Das darin beschriebene Format ist XML. In diesem Praxisbeispiel wird jedoch JSON verwendet. Wie man das einstellt, ist hier beschrieben.
Im nächsten Schritt muss die Software installiert werden, mit der die Daten aus dem Export-Manager heruntergeladen werden und automatisch in das Lexware-Format konvertiert werden.
Dazu wird ein MSI-Installationspaket ausgeführt, das über einen Installationsassistenten auf dem Windows-Rechner installiert wird.
Um CartLoad für die Verwendung mit xt:Commerce und Lexware vorzubereiten, müssen zunächst Einstellungen vorgenommen werden. Die Einstellungen müssen nur einmalig gemacht werden.
Im Navigationsbereich der Einstellungen befinden sich die Punkte "Download" und "Verbindungseinstellungen".
Die für die Verwendung mit Lexware wichtigen Einstellungen sind unter dem Punkt "Download" zu finden. Darunter gibt es 3 Registerkarten, mit denen gesteuert werden kann, wie Bestellungen aus xt:Commerce nach Lexware übergeben werden sollen.
Auf dieser Registerkarte wird eingestellt, von wo die Bestellungen heruntergeladen werden müssen. Zusätzlich werden Einstellungen für den Konverter festgelegt, um z. B. in Lexware die richtigen Artikelnummern zu verwenden.
last_order_id=1054 customer_file=%homepath%\Documents\CartLoad\customer-%DATE%-%TIME%.csv payment_cash_on_delivery=xt_cashondelivery payment_banktransfer=xt_banktransfer payment_prepayment=xt_prepayment,xt_paypal payment_cash_payment=xt_cashpayment payment_invoice=xt_invoice payment_costs_product_no=9998 shipping_costs_product_no=9999
Parameter | Beschreibung |
---|---|
last_order_id | Beispiel: 1054 Weil in der Datei aus dem Shop immer mehrere Bestellungen enthalten sind, kann hier die Nr. der letzten abgerufenen Bestellung eingegeben werden. Dies verhindert doppelte Importe. Diese Nummer wird automatisch von CartLoad auf die letzte abgerufene Nummer gesetzt. |
customer_file (optional) |
Beispiel: %homepath%\Documents\CartLoad\customer-%DATE%-%TIME%.csv Wenn dieser Parameter verwendet wird, wird eine CSV-Datei mit den Kundendaten abgelegt. Wie in der lokalen Zieldatei können auch hier Variablen verwendet werden. |
payment_cash_on_delivery | Beispiel: xt_cashondelivery Angabe mehrerer durch Komma getrennter Shop-Zahlungsarten, die als Nachnahme in Lexware gelten sollen |
payment_banktransfer | Beispiel: xt_banktransfer Angabe mehrerer durch Komma getrennter Shop-Zahlungsarten, die als Bankeinzug/Lastschrift in Lexware gelten sollen |
payment_prepayment | Beispiel: xt_prepayment,xt_paypal Angabe mehrerer durch Komma getrennter Shop-Zahlungsarten, die als Vorkasse in Lexware gelten sollen |
payment_cash_payment | Beispiel: xt_cashpayment Angabe mehrerer durch Komma getrennter Shop-Zahlungsarten, die als Barzahlung in Lexware gelten sollen |
payment_invoice | Beispiel: xt_invoice Angabe mehrerer durch Komma getrennter Shop-Zahlungsarten, die als Rechnung in Lexware gelten sollen |
payment_costs_product_no (optional) |
Beispiel: 9998 Wenn dieser Parameter verwendet wird, ergänzt der Konverter für die Zahlungsartkosten eine Artikel-Position mit der angegebenen Artikelnummer. |
shipping_costs_product_no (optional) |
Beispiel: 9999 Wenn dieser Parameter verwendet wird, ergänzt der Konverter für die Versandkosten eine Artikel-Position mit der angegebenen Artikelnummer. |
Vor dem eigentlichen Abruf der Bestellungen ist es möglich, eine URL aufzurufen. Das wird zum Beispiel dann gemacht, wenn vorab ein Befehl an den Server gesendet werden muss, dass die Bestellungen bereitgestellt werden sollen. Für xt:Commerce muss diese Funktion aktiviert werden.
Vor und nach dem Abruf von Bestellungen kann auch ein lokal installiertes Programm gestartet werden.
Diese Einstellung kann zum Beispiel verwendet werden, wenn man nach dem Abruf von Bestellungen ein Import-Programm starten möchte.
In diesem Praxisbeispiel werden die Einstellungen zum Programm-Aufruf nicht benötigt.
Die Verbindungseinstellungen ermöglichen die Anpassung an die Netzwerkkonfiguration.
Durch einen Klick auf "Bestellungen herunterladen" laufen jetzt folgende Schritte automatisch ab:
Lexware faktura+auftrag bietet eine Import-Funktion, mit der Daten im ASCII-Format importiert werden können. Dazu gehören Kunden, Lieferanten und Artikel.
Dadurch, dass CartLoad die Kunden aus den Bestellungen extrahiert und in einer ASCII-Datei (CSV) speichert, können Sie diese Datei importieren.
Nach dem Start der Ansicht "eCommerce" wird ein Fenster eingeblendet, das im oberen Bereich offene Aufträge anzeigt. Um neue Aufträge aus der XML-Datei einzulesen, wird die Schaltfläche "Daten austauschen" verwendet.
Es öffnet sich das Fenster "Daten austauschen".
Im unteren Teil "Bestellungen importieren" klicken Sie auf die Schaltfläche Durchsuchen und wählen den Pfad für die zu importierende XML-Datei aus (zum Beispiel unter: C:\Users\>Benutzer<\Documents\CartLoad\xtc-20170103-152311.xml).
Durch Klicken der Schaltfläche "Importieren" werden die Bestellungen importieriert. Anschließend werden die importierten Bestellungen als offene Aufträge (Internetaufträge) in der eCommerce Ansicht angezeigt.
Im unteren Bereich der Ansicht "eCommerce" können Kunden den Bestellungen zugeordnet werden. Durch den vorherigen Import der Kunden sollte hier automatisch der korrekte Kunde gefunden werden.
Die Verbindung zwischen Kunde und Bestellung wird durch Bestätigen der Schaltfläche "Kunde zuordnen" hergestellt.
Über die Registerkarten "Kunde", "Auftragspositionen" und "Konditionen" können die Einzelheiten der Bestellung vor dem Import noch einmal eingesehen werden.
Um den Auftrag aus xt:Commerce nach Lexware faktura+auftrag zu übernehmen, wählen Sie zuerst im Bereich "Auftrag übernehmen als" aus dem Auswahlmenü die gewünschte Auftragsart aus. Wählen Sie danach über das Kontextmenü den Eintrag "Übernehmen" aus.
Der Auftrag ist dann in der Ansicht "Auftrag" zu finden und kann dort noch einmal bearbeitet oder in eine Rechnung weitergeführt werden. Ab diesem Punkt erfolgt die bekannte Weiterverarbeitung mit Lexware faktura+auftrag.
Dieses Praxisbeispiel zeigt, wie Bestellungen und Kundendaten aus xt:Commerce in Lexware auftrag+faktura übernommen werden können.
Da Lexware ein spezielles Datenformat für Webshop-Bestellungen verwendet, ist ein Konverter notwendig, der xt:Commerce-Bestellungen in dieses Format umwandelt. Dieses Format basiert zwar auf dem Standardformat openTrans 1.0, ermöglicht aber im Unterschied zu dem Standard, mehrere Bestellungen in einer Datei zu verarbeiten.
Um das Problem der Kundenanlage in Lexware zu lösen, kann mit CartLoad zusätzlich zu den Bestellungen eine Kunden-Datei im CSV-Format (ASCII) exportiert werden, die vor den Bestellungen eingelesen werden muss. Dann ist es möglich, jedem Webshop-Kunden eine richtige Kundennummer zuzuteilen und Lexware erkennt den zugehörigen Kunden selbstständig.
Nehmen Sie das E-Commerce-Handbuch von Lexware zur Hilfe, um faktura+auftrag für den Import von Internetaufträgen vorzubereiten. Dazu gehören zum Beispiel das Angleichen von Artikelnummern zwischen Faktura und Shop und zuordnen von Zahlungs- und Lieferkonditionen.