Modul: externer XML-Auftragsimport

verfügbar ab Version: 5.9.0

Über das Modul "externer XML-Auftragsimport" können externe Auftragsdaten in den DRUCKSHOP integriert werden. 


Für dieses Modul wird ein FTP-Zugang angelegt. In diesem Zugang können neue XML-Dateien abgelegt werden, die dann importiert werden können.
Der Import kann lediglich für Artikel vom Typ Handelsware oder Standardartikel durchgeführt werden.


Folgende Regeln gelten für den Import:

Es wird immer die Standardversandart beim Import verwendet.

Es wird immer die Standardbezahlung beim Import verwendet.

Es wird immer die Menge 1 für neue Aufträge angelegt.

Anhand der Kundennummer wird als Rechnungsadresse immer die hinterlegte Rechnungsadresse aus den Kunden-Stammdaten importiert.

Falls im Kundenkonto eine abweichende Standardbezahlung hinterlegt ist, wird die Standardbezahlung beim Import verwendet.

Sobald ein Fehler in der Importdatei erkannt wird, wird der gesamte Import der Datei abgebrochen.


Aufbau der Datei und Zuordnungen innerhalb der Datei (schauen Sie sich hierzu die hier hinterlegte Musterdatei an).

Im Bereich <ORDER><ORDER_HEADER><ORDER_INFO> muss die Kundennummer und optional ein Stichwort für die Bestellung importiert werden.
Die Kundennummer muss im Tag <CUSTOMER_NUMBER> importiert werden. Das Stichwort kann über den Tag <ORDER_ID> importiert werden.


Im Bereich <ORDER><ORDER_ITEM_LIST> müssen die jeweiligen Posten der Bestellung importiert werden. Jeder Posten wird über den Tag <ORDER_ITEM> importiert.

Für jeden Posten werden die folgenden Tags zugeordnet:


<ARTICLE_ID><SUPPLIER_AID>In diesem Zweig wird die Artikelnummer importiert. Wird im System diese Artikelnummer nicht gefunden oder existieren mehrere Artikel mit dieser Artikelnummer, wird der Import abgebrochen.
<QUANTITY>In diesem Zweig wird der Wert der Preisstaffel für den Auftrag importiert. Anhand diesem Wert wird versucht eine Preisstaffel zu ermitteln.
<VARIETY>(Optional) In diesem Zweig kann eine Sorten-ID importiert werden. Hierbei ist zu beachten, dass dieses Tag nur die globalen Sorten berücksichtigt.
<VARIETY_DESC>(Optional) In diesem Zweig können die artikelbezogenen Sorten importiert werden. Im Gegensatz zum Tag <VARIETY> wird hier nicht die ID sondern die Sortenbezeichnung gematcht.
<SHIPMENT_PARTIES>
<DELIVERY_PARTY>
<PARTY>
<ADDRESS>

in diesem Bereich wird die Lieferadresse importiert. Hierbei ist zu beachten, dass bei einer Bestellung mit mehreren Posten immer die Lieferadresse des ersten Posten als Lieferadresse für die gesamte Bestellung verwendet wird. Im Bereich der Lieferadresse können die folgenden Informationen importiert werden:

<NAME>Der Zweig wird geteilt und als Vor- und Nachname gespeichert.
<STREET>Straße
<ZIP>PLZ
<CITY>Ort
<CONTACT><PHONE>Telefon
<CONTACT><EMAIL>

E-Mail

<COUNTRY_CODE>Anhand des Ländercodes wird ein Land aus der Länderliste ermittelt. Kann kein Land mit dem importierten Ländercode ermittelt werden oder wird kein Code importiert, wird das Heimatland als Lieferland im neuen Auftrag gespeichert.


Weiter können dynamische Optionsfelder (Optional) für einen Posten importiert werden. Jedes dynamische Optionsfeld muss über den Tag <DYNAMIC_OPTION> importiert werden. Jede dynamische Option muss den Tag <OPTION_ID> mit der internen Datenbank-ID der dynamischen Option beinhalten. Wenn es sich um eine dynamische Option vom Typ Auswahlliste handelt, muss der Tag <LIST_ID> mit der internen Datenbank-ID des Listenfeldes importiert werden.


Druckdaten

Es kann für einen Auftrag eine Druckdatei importiert werden. Die Datei muss auf dem FTP-Server neben der zu importierenden XML-Datei abgelegt werden.
Anhand des Dateinames der Importdatei kann diese der XML-Datei zugeordnet werden. Die Zuordnung der Datei geschieht über die folgenden Tags:

<QUANTITY>

<PARTY_ID>

<ORDER_ID>


Damit die Druckdatei für einen Auftrag importiert werden kann, muss diese den folgenden Dateinamen haben:

<QUANTITY><PARTY_ID><ORDER_ID>.pdf


Über jeden Import, egal ob erfolgreich oder nicht, wird ein Report erstellt. Der Report kann in der Administration unter Module → XML-Auftragsimport eingesehen werden.