Importdefinition erstellen und anpassen

Über die Importdefinition wird bestimmt, welches Feld aus den XML-Quelldaten in welches Amicron-Faktura-Feld (Auftrag) geschrieben wird. Da weder der Aufbau der XML-Daten vorgeschrieben ist (gewisse Vorgaben sind dennoch zu beachten, z. B. die Verschachtelung), noch die Bezeichnung der einzelnen XML-Tags, ist dieser Schritt notwendig, um den Import beliebiger XML-Daten zu ermöglichen.

Die Importdefinition muss ebenso wie die zu importierenden Daten im XML-Format vorliegen. Weitere Vorgaben für den Aufbau der XML-Daten gibt es nicht. Sie können also durch Anpassung der Importdefinition Daten importieren, ohne die zu importierenden Daten auf AMICRON-FAKTURA anzupassen.

Für einige Shopsysteme gibt es bereits fertige Importdefinition die Sie auf Anfrage bei Amicron erhalten und dann nur noch über den Schalter Aus Datei laden in die Einstellungen eingelesen werden müssen.

Wenn es keine fertige Importdefinition für die zu importierenden Auftragsdaten gibt, müssen Sie eine entsprechende Datei selbst erstellen. Sie können dazu einfach wie folgt vorgehen:

1.	Verwenden Sie eine XML-Datei, welche die Daten eines (Muster-) Auftrags enthält.

2.	Öffnen Sie diese mit einem Editor (z. B. Wordpad oder Peters XML-Editor, Download auf www.iol.ie/~pxe )

Ersetzen Sie die Werte hinter den jeweiligen Tags (<..>) mit denjenigen Feldnamen, in die die Werte bei AMICRON-FAKTURA geschrieben werden sollen. Siehe hierzu die Feldbeschreibungen der Aufträge. Achten Sie dabei besonders darauf, dass jedes Tag auch wieder geschlossen wird (<Artikelnummer>#Artikelnr</Artikelnummer>).

4.	Fügen Sie bei demjenigen Tag (<..>), bei dem der Auftragskopf mit der Auftragsnummer etc. folgt, ein NewData="AUFTRAG" ein.

Beispiel:

Die folgende XML-Datei enthält die Daten eines Auftrags:

<?xml version="1.0" encoding="iso-8859-1"?>

<ORDER>

<ORDER_INFO>

<ORDER_HEADER>

<ORDER_ID>1</ORDER_ID>

<CUSTOMER_ID>1</CUSTOMER_ID>

<ORDER_DATE>2011-03-16 10:57:32</ORDER_DATE>

</ORDER_HEADER>

<CUSTOMERS_ADDRESS>

<COMPANY>Amicron Software</COMPANY>

<LASTNAME>Meisenkaiser</LASTNAME>

<STREET>Stedener Feld 4</STREET>

<CITY>Paderborn</CITY>

<COUNTRY>Deutschland</COUNTRY>

<EMAIL>em@amicron.de</EMAIL>

</CUSTOMERS_ADDRESS>

<DELIVERY_ADDRESS>

<COMPANY>Amicron Software</COMPANY>

<NAME>Emil Meisenkaiser</NAME>

<STREET>Stedener Feld 4</STREET>

<CITY>Paderborn</CITY>

<COUNTRY>Deutschland</COUNTRY>

</DELIVERY_ADDRESS>

<PAYMENT_METHOD>Vorkasse</PAYMENT_METHOD>

</PAYMENT>

<SHIPPING_METHOD>DHL</SHIPPING_METHOD>

</SHIPPING>

<ORDER_PRODUCTS>

<PRODUCTS_ID>34</PRODUCTS_ID>

<PRODUCTS_QUANTITY>1</PRODUCTS_QUANTITY>

<PRODUCTS_MODEL>MO50STD</PRODUCTS_MODEL>

<PRODUCTS_NAME>AMICRON-MAILOFFICE 5 Standard (Einzelplatz)</PRODUCTS_NAME>

<PRODUCTS_PRICE>149.00</PRODUCTS_PRICE>

<PRODUCTS_TAX>19.00</PRODUCTS_TAX>

</PRODUCT>

</ORDER_PRODUCTS>

<ORDER_TOTAL>

<TOTAL>

<TOTAL_TITLE>Versandkosten</TOTAL_TITLE>

<TOTAL_VALUE>5.00</TOTAL_VALUE>

<TOTAL_CLASS>ot_shipping</TOTAL_CLASS>

<TOTAL_SORT_ORDER>2</TOTAL_SORT_ORDER>

<TOTAL_PREFIX>+</TOTAL_PREFIX>

<TOTAL_TAX>19</TOTAL_TAX>

</TOTAL>

<TOTAL>

<TOTAL_TITLE>Summe</TOTAL_TITLE>

<TOTAL_VALUE>183.26</TOTAL_VALUE>

<TOTAL_CLASS>ot_total</TOTAL_CLASS>

</TOTAL>

</ORDER_TOTAL>

<ORDER_COMMENTS>Beliebiger Kommentar des Bestellers</ORDER_COMMENTS>

</ORDER_INFO>

</ORDER>

Aus obiger Datei wurde die folgende Importdefinition erstellt:

<?xml version="1.0" encoding="iso-8859-1" ?>

<ORDER>

</DEFINES>

<ORDER_INFO>

<ORDER_HEADER NewData="AUFTRAG">

<ORDER_ID>#AUFTRAGNR</ORDER_ID>

<CUSTOMER_ID>#KUNADRESSE.NR</CUSTOMER_ID>

<ORDER_DATE>#AUFTRAG.DATUM</ORDER_DATE>

</ORDER_HEADER>

<CUSTOMERS_ADDRESS>

<COMPANY>#KUNADRESSE.NAME2</COMPANY>

<FIRSTNAME>#KUNADRESSE.VORNAME</FIRSTNAME>

<LASTNAME>#KUNADRESSE.NAME</LASTNAME>

<STREET>#KUNADRESSE.STRASSE</STREET>

<ZIP>#KUNADRESSE.PLZ</ZIP>

<CITY>#KUNADRESSE.ORT</CITY>

<STATE>#KUNADRESSE.BUNDESLAND</STATE>

<COUNTRY>#KUNADRESSE.LAND</COUNTRY>

<TELEPHONE>#KUNADRESSE.TELEFON1</TELEPHONE>

<EMAIL>#KUNADRESSE.EMAIL</EMAIL>

<BIRTHDAY>#KUNADRESSE.GEBURTSTAG</BIRTHDAY>

</CUSTOMERS_ADDRESS>

<BILLING_ADDRESS>

<COMPANY>#ATRADRESSE.NAME2</COMPANY>

<NAME>#ATRADRESSE.VORNAME_NAME</NAME>

<STREET>#ATRADRESSE.STRASSE</STREET>

<ZIP>#ATRADRESSE.PLZ</ZIP>

<CITY>#ATRADRESSE.ORT</CITY>

<STATE>#ATRADRESSE.BUNDESLAND</STATE>

<COUNTRY>#ATRADRESSE.LAND</COUNTRY>

</BILLING_ADDRESS>

<DELIVERY_ADDRESS>

<COMPANY>#LFRADRESSE.NAME2</COMPANY>

<NAME>#LFRADRESSE.VORNAME_NAME</NAME>

<STREET>#LFRADRESSE.STRASSE</STREET>

<ZIP>#LFRADRESSE.PLZ</ZIP>

<CITY>#LFRADRESSE.ORT</CITY>

<STATE>#LFRADRESSE.BUNDESLAND</STATE>

<COUNTRY>#LFRADRESSE.LAND</COUNTRY>

</DELIVERY_ADDRESS>

<PAYMENT_METHOD>#AUFTRAG.ZAHLWEISE</PAYMENT_METHOD>

<PAYMENT_CLASS>

</PAYMENT_CLASS>

</PAYMENT>

<SHIPPING_METHOD>#AUFTRAG.LIEFERART</SHIPPING_METHOD>

<SHIPPING_CLASS>

</SHIPPING_CLASS>

</SHIPPING>

<ORDER_PRODUCTS>

<PRODUCTS_ID>#ARTIKELNR</PRODUCTS_ID>

<PRODUCTS_QUANTITY>#MENGE</PRODUCTS_QUANTITY>

<PRODUCTS_MODEL>#BESCHREIBUNG</PRODUCTS_MODEL>

<PRODUCTS_NAME>#BEZEICHNUNG</PRODUCTS_NAME>

<PRODUCTS_PRICE>#EPREIS</PRODUCTS_PRICE>

<PRODUCTS_TAX>#STEUER</PRODUCTS_TAX>

</PRODUCT>

</ORDER_PRODUCTS>

<ORDER_TOTAL>

<TOTAL>

<TOTAL_TITLE>#AUFTRAG.TOTAL_TITLE</TOTAL_TITLE>

<TOTAL_VALUE>#AUFTRAG.TOTAL_VALUE</TOTAL_VALUE>

<TOTAL_CLASS>@AUFTRAG.TOTAL_CLASS</TOTAL_CLASS>

<TOTAL_PREFIX>@AUFTRAG.TOTAL_PREFIX</TOTAL_PREFIX>

<TOTAL_SORT_ORDER>1</TOTAL_SORT_ORDER>

<TOTAL_TAX>@AUFTRAG.TOTAL_TAX</TOTAL_TAX>

</TOTAL>

</ORDER_TOTAL>

<ORDER_COMMENTS>#AUFTRAG.BEMERKUNG</ORDER_COMMENTS>

</ORDER_INFO>

</ORDER>

www.Amicron.org - Stand: 13.01.2022.

Bitte hier klicken, wenn Sie uns Ihr Feedback zu diesem Hilfethema senden moechten.