Administrationshandbuch
Schnittstellen zu pixi
Bestellimport|Bestellexport (openTRANS)
Bestellimport
openTRANS Syntax-Spezifikationen für die Übergabe im XML-Format

Diese Dokumentation beschreibt die Struktur einer XML Datei für den Import von Kundenbestellungen aus Ihrem Shop oder anderen Verkaufskanälen zu pixi.

Struktur der XML

Jedes valide Bestell-openTRANS Dokument beginnt mit dem Element <ORDER>, welches aus einem Kopfbereich (ORDER_HEADER), einem Artikelbereich (ORDER_ITEM_LIST) und einer Zusammenfassung (ORDER_SUMMARY). Die openTRANS Version und Informationen zur genutzten XML Version sind in pixi nicht notwendig (nicht jedoch der Tag <ORDER>...</ORDER>).

<?xml version="1.0" encoding="UTF-8" ?>
<ORDER version="1.0" type="standard">
   <ORDER_HEADER>
      ...
   </ORDER_HEADER>
   <ORDER_ITEM_LIST>
      ...
   </ORDER_ITEM_LIST>
   <ORDER_SUMMARY>
      ...
   </ORDER_SUMMARY>
</ORDER>

Gemäß der offiziellen openTRANS Spezifikation schließt der Tag <ORDER_SUMMARY> jedes Dokument und beinhaltet eine Zusammenfassung der Bestellung, z. B. die Anzahl der Artikel. In pixi wird dieser Tag nicht verwendet und muss nicht übergeben werden.

Sollen komplexe Textblöcke mit Sonderzeichen wie &'<"®™>¿ importiert werden, empfehlen wir die Verwendung von CDATA-Abschnitten, nicht das Enkodieren über XML/HTML Entities.

Kopfbereich: ORDER_HEADER

Der <ORDER_HEADER> enthält allgemeine Informationen zur Bestellung, z. B. Bestellnummer, Bestelldatum, Rechnungs- und Versandadresse, Währung, Zahlungsart, Shop Kommentar, etc.

Beispiel

<ORDER_HEADER> 	
   <CONTROL_INFO> 	
      <GENERATOR_INFO>Name des Shops - openTRANS-Export</GENERATOR_INFO> 
      <GENERATION_DATE>2015-02-04T10:16:14+01:00</GENERATION_DATE> 
   </CONTROL_INFO> 
   <ORDER_INFO> 		
      <ORDER_ID>Bestellnummer</ORDER_ID> 
      <ORDER_SHOPID>ID Bestellung</ORDER_SHOPID>
      <ORDER_DATE>Datum/Uhrzeit</ORDER_DATE> 	
      <DATABASE>pixi_XYZ</DATABASE> 	
      <SHOPID>ABC</SHOPID> 		
      <SHOP_NOTE>Shop Kommentar</SHOP_NOTE>
      <ORDERTAGS>
          <ORDERTAG>Tag 1</ORDERTAG>
          <ORDERTAG>Tag 2</ORDERTAG>
      </ORDERTAGS>
      <ORDER_SHIPLOCK>Y</ORDER_SHIPLOCK>
      <BUYER_SHIPLOCK>Y</BUYER_SHIPLOCK>
      <PRICE_CURRENCY>EUR</PRICE_CURRENCY>
      <PRICE_CURRENCY_ORIGINAL>GBP</PRICE_CURRENCY_ORIGINAL>
      <EXCHANGE_RATE>0.23</EXCHANGE_RATE>
      <TRANSPORT_REMARKS>Versandinformationen</TRANSPORT_REMARKS>
      <GIFT_MESSAGE>Geschenkbotschaft</GIFT_MESSAGE>
      <SUBSHOPLOGO>Sub-Shop Logo</SUBSHOPLOGO>
      <SUBSHOPNAME>Sub-Shop Name</SUBSHOPNAME>
      <REFERRER>Referrer</REFERRER>
      <LOCATION>LocationID</LOCATION>
      <PARTIAL_DELIVERY>OFF</PARTIAL_DELIVERY>
      <ORDER_TYPE>B2C</ORDER_TYPE>
      <ORDER_PARTIES>
        ...
      </ORDER_PARTIES> 
      <PAYMENT>
        ...
      </PAYMENT> 	       	
      <REMARK>
        ...
      </REMARK> 
   </ORDER_INFO>
</ORDER_HEADER>

Name des XML Tags	Feld in pixi (Feldlänge)	Beschreibung
`GENERATOR_INFO`	-	(Optional) Information zum Ersteller der XML Datei; Wert: [Name Ihres Shopsystems] - openTRANS-Export
`GENERATION_DATE`	-	(Optional) Erstelldatum der XML Datei im Format YYYY-MM-DDTHH:MM:SS+HH:MM
`ORDER_ID`	Bestellnr. Shop	Pflicht - Eindeutige Bestellnummer, wird in das Feld "Bestellnr. Shop" im pixi Kundenservice > Reiter Bestellungen importiert
`ORDER_SHOPID`		(Optional) ID der Bestellung im externen System, welche nicht in pixi gespeichert wird, jedoch beim URL Aufruf für Bestätigung des erfolgreichen Exports als $$$order_id$$$ übergeben wird, wenn definiert, anderenfalls die ORDER_ID
`ORDER_DATE`	Bestelldatum	Pflicht - Bestelldatum im Format YYYY-MM-DDTHH:MM:SS+HH:MM
`DATABASE`		(Optional) Name der pixi Datenbank, z. B. pixi_ABC
`SHOPID`		ID des Shops/Mandanten in pixi, z. B. XYZ Pflicht, wenn <ORDER_PARTIES><BUYER_PARTY><PARTY><SHOPID> nicht im XML enthalten ist
`SHOP_NOTE`		(Optional) Kommentar des Kunden, der mit der Bestellung importiert werden soll; wird in das Feld "Kommentar aus Shop" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein importiert
`ORDERTAGS`		Verfügbar ab pixi 19.05 (Optional) Tags, die der Bestellung zugewiesen sind. Ist ein Tag in pixi noch nicht vorhanden, wird er durch den Bestellimport angelegt. Name sowie Beschreibung des Tags werden dem XML entnommen. Tags können auch manuell angelegt werden: Tags verwalten
`ORDER_SHIPLOCK`		(Optional) setzt eine Kundensperre; mögliche Werte: "Y", um eine Kundensperre zu setzen "N" oder leer, um keine Kundensperre zu setzen wird genutzt, wenn <ORDER_PARTIES><BUYER_PARTY><PARTY><ADDRESS><BUYER_SHIPLOCK> nicht im XML enthalten ist
`BUYER_SHIPLOCK`		(Optional) setzt eine Versandsperre für die Bestellung; mögliche Werte: "Y", um eine Versandsperre zu setzen "N" oder leer, um keine Versandsperre zu setzen
`PRICE_CURRENCY`		Wird die Bestellwährung im Shop geändert und die Bestellung mit neuer Währung anschließend erneut zu pixi importiert, wird auch die Währung in pixi aktualisiert.
`PRICE_CURRENCY_ORIGINAL`		(Optional) Fremdwährung der Bestellung Ist kein Wert im XML enthalten, wird <ORDER><ORDER_HEADER><ORDER_INFO><PRICE_CURRENCY> genutzt.
`EXCHANGE_RATE`		(Optional) Wechselkurs der Bestellung Ist kein Wert im XML enthalten, wird der aktuelle Wechselkurs aus der Datenbank für die Bestellung genutzt. Angabe des Wertes mit vier Nachkommastellen und Punkt als Dezimaltrennzeichen.
`TRANSPORT_REMARKS`	Verfahren VARCHAR(50) Produkt VARCHAR(50) Extras VARCHAR(50) Versanddatum DATETIME	(Optional) enthält spezifische Informationen zur Abwicklung der Bestellung, z. B. Lieferdatum oder Behandlung der Bestellung als Expressbestellung für den Logistiker DHL `<TRANSPORT_REMARKS>DHL Express;;;[Method]\|[Product]\|[Tools]\|[Shipping date] </TRANSPORT_REMARKS>` Beispiel: `<TRANSPORT_REMARKS>DHL Express;;;72\|7202\|7210\|01.01.2016</TRANSPORT_REMARKS>` wird importiert in die Felder Verfahren ("72"), Produkt ("7202"), Extras ("7210") und Versanddatum ("01.01.2016") Soll nur das Versanddatum importiert werden, müssen die Werte wie folgt übergeben werden: `<TRANSPORT_REMARKS>DHL Express;;;\|\|\|01.01.2016</TRANSPORT_REMARKS>` Hinweis: Der initiale Teil "DHL Express;;;" ist überholt und wird nicht mehr importiert. Hier kann also auch "Irgendwas;;;" stehen.
`GIFT_MESSAGE`	Geschenkbotschaft VARCHAR(1000)	(Optional) Kann der Kunde im Shop eine Geschenkbotschaft hinterlassen, z. B. wenn die Bestellung an eine abweichende Versandadresse geliefert werden soll, wird dieser Tag genutzt. Die Informationen werden in das Feld "Geschenkbotschaft" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein importiert. Die maximale Zeichenlänge beträgt 1000. Zeilenumbrüche können durch das Sonderzeichen "Pipe" (\|) übergeben werden, z. B.: `<GIFT_MESSAGE>Line 1 \| Line 2</GIFT_MESSAGE>`
`SUBSHOPLOGO`	SubShopLogo VARCHAR(50)	(Optional) URL des Sub-Shop Logos; wird in das Feld "SubShopLogo" im pixi Kundenservice > Reiter Bestellungen importiert
`SUBSHOPNAME`	SubShopName VARCHAR(50)	(Optional) Name des Sub-Shops; wird in das Feld "SubShopName" im pixi Kundenservice > Reiter Bestellungen importiert
`REFERRER`	Referrer VARCHAR(50)	(Optional) Herkunft der Bestellung; wird in das Feld "Referrer" im pixi Kundenservice > Reiter Bestellungen importiert
`LOCATION`		(Optional) Wenn Sie verschiedene Versandlocations nutzen, können Sie hier die ID der Versandlocation für die Bestellung hinterlegen. Die Datenbank Einstellung "Opentrans, nutze Location des XMLs" (pixi Control Center > Reiter Datenbank Einstellungen > Ordner Import / Export > Unterordner Bestellimport (Opentrans)) muss aktiviert sein. Ist kein Wert im XML enthalten, wird als Standardwert "001" genutzt.
`PARTIAL_DELIVERY`		(Optional) legt Optionen für Teillieferungen fest; mögliche Werte: OFF - Standard (ist der Tag im XML nicht enthalten, wird dieser Wert genutzt) ONCE - restliche Artikel werden in einem Paket versendet, sobald verfügbar ALWAYS - restliche Artikel werden versendet, sobald verfügbar - auch in mehreren Paketen
`ORDER_TYPE`		Dieser Tag wurde mit ELI Milestone 2 eingeführt und legt den Typ einer Bestellung fest. Mögliche Werte: "B2C" - für Endkundenbestellungen; Standardwert; wird genutzt, wenn der Tag <ORDER_TYPE> leer oder nicht im XML enthalten ist "B2B" - für B2B Bestellungen Beschreibt, welche Preise für die Bestellung importiert werden, z. B. ist der Bestelltyp B2B, werden alle Preise als Nettopreise in pixi importiert. Wird der Bestelltyp (B2C oder B2B) im Shop geändert und die Bestellung anschließend mit neuem Bestelltyp erneut zu pixi importiert, wird der Bestelltyp in pixi nicht aktualisiert.
`ORDER_PARTIES`		Pflicht - enthält Informationen zu Adress- und Kundendaten der Bestellung, weitere Informationen weiter unten
`PAYMENT`		Pflicht - enthält Informationen zur Zahlart der Bestellung, weitere Informationen weiter unten
`REMARK`		Pflicht - mit dem <REMARK> Tag können zusätzliche Bestellinformationen importiert werden, sofern das Attribut "type" korrekt gefüllt wird, z. B. Versandkosten. Weitere Informationen weiter unten.

Zum Seitenanfang

ORDER_PARTIES

Dieses Element enthält die Adress- und Kundendaten der Bestellung. Das Element <BUYER_PARTY> ist Pflicht und muss immer im XML enthalten sein, da es die eindeutige Kundennummer der Bestellung enthält. Die Elemente <INVOICE_PARTY> und <SHIPMENT_PARTIES> müssen nicht enthalten ein. Sind beide Elemente im XML nicht enthalten hat dies zur Folge, dass die Adressdaten in pixi leer sind und die Bestellung nicht versandt werden kann.

Beispiel

<ORDER_PARTIES>
   <BUYER_PARTY>
      ...
   </BUYER_PARTY>
   <INVOICE_PARTY>
      ...
   </INVOICE_PARTY>
   <SHIPMENT_PARTIES>
      <DELIVERY_PARTY>
         ...
     </DELIVERY_PARTY>
   </SHIPMENT_PARTIES>
</ORDER_PARTIES>

BUYER_PARTY

Das Element <BUYER_PARTY> enthält hauptsächlich 3 Werte: Kundennummer, Shop ID und Umsatzsteuer ID.

Beispiel

<BUYER_PARTY>
   <PARTY>
      <PARTY_ID type="buyer_specific">Kundennummer 001</PARTY_ID>
      <SHOPID>MAD</SHOPID>
      <VAT_ID>ALTE_KUNDEN_UMSATZSTEUER_ID</VAT_ID>
      <ADDRESS>
         <CUSTOMER_DISCOUNT_PERCENTAGE>KUNDEN_RABATT</CUSTOMER_DISCOUNT_PERCENTAGE>
         <VAT_ID>KUNDEN_UMSATZSTEUER_ID</VAT_ID>
	 <BUYER_SHIPLOCK>Y</BUYER_SHIPLOCK>
      </ADDRESS>
   </PARTY>
</BUYER_PARTY>

Name des XML Tags	Beschreibung
`PARTY_ID`	Pflicht - Kundennummer - eindeutiger Bezeichner des Kunden in pixi; wir empfehlen, die Kundennummer im Shop generieren zu lassen oder die E-Mail Adresse des Kunden zu nutzen
`SHOPID`	(Optional) ID des Shops/Mandanten in pixi, z. B. XYZ; falls nicht vorhanden, wird der Tag <SHOPID> des Elements <ORDER_HEADER><ORDER_INFO> genutzt
`VAT_ID`	(Optional) Im Falle eines B2B Kunden, wird in diesem Tag die Umsatzsteuer ID (Ust. ID) des Kunden gespeichert und in das Feld "Ust-ID" der Rechnungs- und Versandadresse im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein importiert. Das Element wird nur genutzt, wenn <ORDER_PARTIES><BUYER_PARTY><PARTY><ADDRESS><VAT_ID> nicht im XML enthalten ist.
`<ADDRESS>`
`CUSTOMER_DISCOUNT_PERCENTAGE`	(Optional) Mit diesem Tag kann der Rabatt eines Kunden gesetzt werden (pixi Kundenservice > Reiter Kundendetails). Ist der Tag im XML nicht enthalten, bleibt der Rabatt des Kunden unverändert. Angabe des Wertes mit zwei Nachkommastellen und Punkt als Dezimaltrennzeichen. (ab AVA Update 21)
`VAT_ID`	(Optional) Im Falle eines B2B Kunden, wird in diesem Tag die Umsatzsteuer ID (Ust. ID) des Kunden gespeichert und in das Feld "Ust-ID" der Rechnungs- und Versandadresse im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein importiert. Ist dieser Tag nicht im XML enthalten, wird die Ust. ID dem Tag <ORDER_PARTIES><BUYER_PARTY><PARTY><VAT_ID> entnommen.
`BUYER_SHIPLOCK`	(Optional) setzt eine Kundensperre; mögliche Werte: "Y", um eine Kundensperre zu setzen "N" oder leer, um keine Kundensperre zu setzen Ist der Tag im XML nicht enthalten, wird der Wert dem Tag <ORDER_HEADER><ORDER_INFO><BUYER_SHIPLOCK> entnommen.

Hinweis: Der Block ADDRESS ist Pflicht! Soll dieser keine Werte enthalten, muss zumindest ein leerer Tag <ADDRESS/> im XML vorhanden sein.

Zum Seitenanfang

INVOICE_PARTY

Das Element <INVOICE_PARTY> enthält die Zahlungsdaten der Bestellung.

Beispiel

<INVOICE_PARTY>
   <PARTY>
      <ADDRESS>
         <NAME>BILL_Firma</NAME>
         <SAL>BILL_Anrede</SAL>
         <NAME2>BILL_Vorname</NAME2>
         <NAME3>BILL_Nachname</NAME3>
         <STREET>BILL_Straße</STREET> 
         <ZIP>BILL_PLZ</ZIP>
         <ZIPBOX>BILL_Hausnummer</ZIPBOX>
         <CITY>BILL_Stadt</CITY>
         <COUNTRY>BILL_Land</COUNTRY>
         <STATE>BILL_Bundesland</STATE>
         <PHONE>BILL_Telefon</PHONE>
	 <FAX>BILL_Fax</FAX>
         <EMAIL>BILL_E-Mail</EMAIL>
      </ADDRESS>
   </PARTY>
</INVOICE_PARTY>

SHIPMENT_PARTIES

Das Element <SHIPMENT_PARTIES> enthält die Versandadresse der Bestellung.

Beispiel

<SHIPMENT_PARTIES>
   <DELIVERY_PARTY>
      <PARTY>
         <ADDRESS>
            <NAME>SHIPMENT_Firma</NAME>
            <SAL>SHIPMENT_Anrede</SAL>
            <NAME2>SHIPMENT_Vorname</NAME2>
            <NAME3>SHIPMENT_Nachname</NAME3>
            <STREET>SHIPMENT_Straße</STREET> 
            <ZIP>SHIPMENT_PLZ</ZIP>
            <ZIPBOX>SHIPMENT_Hausnummer</ZIPBOX>
            <CITY>SHIPMENT_Stadt</CITY>
            <COUNTRY>SHIPMENT_Land</COUNTRY>
            <STATE>SHIPMENT_Bundesland</STATE>
            <PHONE>SHIPMENT_Telefon</PHONE>
	    <FAX>SHIPMENT_Fax</FAX>
            <EMAIL>SHIPMENT_E-Mail</EMAIL>
	    <ADDRESS_REMARKS>SHIPMENT_Adresszusatz</ADDRESS_REMARKS>
	    <CHARGE_VAT>SHIPMENT_Nettopreise_berechnen</CHARGE_VAT>
            <EXPORT_EMAIL_PHONE_POLLING>Y</EXPORT_EMAIL_PHONE_POLLING>
         </ADDRESS>
      </PARTY>
   </DELIVERY_PARTY>
</SHIPMENT_PARTIES>

Name des XML Tags

Feld in pixi (Feldlänge)

Beschreibung

NAME

Firma
VARCHAR(60)

(Optional) wird in das Feld "Firma" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert

SAL

Anrede
VARCHAR(60)

(Optional) wird in das Feld "Anrede" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert

NAME2

Vorname
VARCHAR(60)

(Optional) wird in das Feld "Vorname" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert

NAME3

Nachname
VARCHAR(60)

(Optional) wird in das Feld "Nachname" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert

STREET

Strasse
VARCHAR(100)

(Optional) wird in das Feld "Strasse" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert

enthält der Tag auch die Hausnummer, wird diese in das "Nr." Feld importiert

ZIPBOX

PLZ
VARCHAR(12)

(Optional) wird in das Feld "Nr." = Hausnummer im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert

ZIP

Nr.
VARCHAR(10)

(Optional) wird in das Feld "PLZ" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert

CITY

Stadt
VARCHAR(50)

(Optional) wird in das Feld "Stadt" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert

COUNTRY

Land
VARCHAR(3)

(Optional) wird in das Feld "Land" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert

Das Land kann angegeben werden und Einträgen der Ländertabelle zugeordnet in folgender Reihenfolge:

1) EXACT Match für Code ISO2 3166-1
2) EXACT Match für Code ISO3 3166-1
3) EXACT Match für Name des Landes
4) EXACT Match für Code (pixi interner Code für das Land)
5) EXACT Match für einen Namen in kommagetrennter Liste "Weitere Ländernamen"
6) LIKE Match für "Weitere Ländernamen"

STATE

Staat
VARCHAR(3)

(Optional) wird in das Feld "Staat" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert

PHONE

Telefon
VARCHAR(60)

(Optional) wird in das Feld "Telefon" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert

FAX

Fax
VARCHAR(60)

(Optional) wird in das Feld "Fax" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert

EMAIL

E-Mail
VARCHAR(60)

(Optional) wird in das Feld "E-Mail" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert

ADDRESS_REMARKS

Adresszusatz
VARCHAR(255)

(Optional) wird in das Feld "Adresszusatz" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Versandadresse importiert

CHARGE_VAT

Nettopreise für diese Bestellung
BIT

(Optional) Aktiviert/Deaktiviert die Checkbox "Nettopreise für diese Bestellung" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Versandadresse; mögliche Werte:

"N", um die Checkbox zu aktivieren
"Y" oder leer, um die Checkbox zu deaktivieren

Diese Funktion wird vor allem für die Versionen vor der Einführung der Nettopreise mit ELI Milestone 2 benötigt. Ist die Umsatzsteuer ID eines Kunden im XML enthalten und das Versandland befindet sich in der Europäischen Union, muss der Kunde keine MwSt. zahlen. In diesem Fall muss der Wert des Tags "N" sein. In den aktuellsten pixi Versionen wird dies über das Element <ORDER_TYPE> geregelt. Die MwSt. wird automatisch abgezogen, wenn der Bestelltyp B2B ist.

EXPORT_EMAIL_PHONE_POLLING

Export E-Mail & Telefonnr. im Polling
BIT

(Optional) Steuert die Checkbox "Export E-Mail & Telefonnr. im Polling" für jede Bestellung im pixi Kundenservice > Bestellungen. Mögliche Werte:

"N" oder leer oder Tag ist im XML nicht enthalten - Checkbox ist deaktiviert
"Y" - Checkbox ist aktiviert

Die Kombination der neuen Datenbank-Einstellung und der Checkbox im pixi Kundenservice funktioniert wie folgt:

Wert der Einstellung	Wert der Checkbox	Export an Logistikdienstleister
AN	AN	JA
AN	AUS	NEIN
AUS	AN	NEIN
AUS	AUS	NEIN

Anwendungsfall: Packstation

Für eine Packstation bitte übergeben: Lieferung an eine Filiale/Packstation (Wichtige Hinweise zur Paketadressierung DHL)

<DELIVERY_PARTY>
    ...
    <NAME><!--Optional: Name der Firma--></NAME>
    <STREET>Packstation</STREET>
    <ZIPBOX><!--Nummer der Packstation--></ZIPBOX>
    <ZIP><!--PLZ der Packstation--></ZIPBOX>
    <CITY><!--Ort der Packstation--></ZIPBOX>
    <ADDRESS_REMARKS><!--Postnummer--><ADDRESS_REMARKS>
    ...
<DELIVERY_PARTY>

Zum Seitenanfang

Anwendungsfall: Postfiliale

Für eine Filiale bitte übergeben: Lieferung an eine Filiale/Packstation (Wichtige Hinweise zur Paketadressierung DHL)
Wichtig: Auch bei DHL Paketshops lautet das Schlüsselwort im Straßenfeld „Postfiliale“.

<DELIVERY_PARTY>
    ...
    <NAME><!--Optional: Name der Firma--></NAME>
    <STREET>Postfiliale</STREET>
    <ZIPBOX><!--Nummer der Postfiliale--></ZIPBOX>
    <ZIP><!--PLZ der Postfiliale--></ZIPBOX>
    <CITY><!--Ort der Postfiliale--></ZIPBOX>
    <ADDRESS_REMARKS><!--Postnummer--><ADDRESS_REMARKS>
    ...
<DELIVERY_PARTY>

Zum Seitenanfang

PAYMENT

Das Element <PAYMENT> enthält alle Zahlungsinformationen der Bestellung. Bitte beachten Sie, dass verschiedene Tags in Abhängigkeit der Zahlart genutzt werden.

Hinweis: In Abhängigkeit der Einstellung "Bestellstatus" im pixi Control Center > Tabelle Zahlungsarten, wird der Bestellzeilenstatus für alle Artikel der Bestellung nach dem Import gesetzt. Ist für eine Zahlart kein Bestellstatus gesetzt, wird der Status "HAL" genutzt.

Beispiel

<PAYMENT>
   <Generic_XML_tag_From_Payments_Table>
      <CARD_NUM>Kartennummer</CARD_NUM>
      <CARD_EXPIRATION_DATE>Gültig bis</CARD_EXPIRATION_DATE> 
      <CARD_TYPE>Kreditkartentyp</CARD_TYPE>
      <CARD_HOLDER_NAME>Inhaber</CARD_HOLDER_NAME>
      <CARD_CVC>CVC</CARD_CVC>
      <CARD_AUTH_CODE>KK-ID</CARD_AUTH_CODE>
      <CARD_AUTHORIZATION>KK-ID</CARD_AUTHORIZATION>
      <CCP_MERCHANT>CCP Händler</CCP_MERCHANT>
      <BANK_ACCOUNT>Kontonr.</BANK_ACCOUNT> 
      <HOLDER>Kontoinhaber</HOLDER>
      <BANK_CODE>BLZ</BANK_CODE> 
      <BANK_NAME>Bank</BANK_NAME>
      <BIC>BIC</BIC>
      <IBAN>IBAN</IBAN>
   </Generic_XML_tag_From_Payments_Table>
</PAYMENT>

Wichtig: Der Tag <Generic_XML_tag_From_Payments_Table> bezieht sich auf den Wert, der in dem Feld "XML TAG" im pixi Control Center > Tabelle Zahlungsarten hinterlegt ist. Hier kann für jede Zahlungsart ein XML Tag hinterlegt werden, der mit der Kundenbestellung importiert wird. Ist für eine Zahlungsart kein XML Tag hinterlegt, wird <CARD> als Standard genutzt.

Jede Zahlungsart kann alle Elemente innerhalb des Tags <Generic_XML_tag_From_Payments_Table> wie im Beispiel oberhalb oder in der Liste weiter unten abgebildet, nutzen. Der Tag kann aber auch leer sein, z. B.:

<PAYMENT>
   <PAYPAL></PAYPAL>
</PAYMENT>

Name des XML Tags	Feld in pixi (masterFeldlänge)	Beschreibung
`CARD_NUM`	Kartennummer VARCHAR(25)	(Optional) wird in das Feld "Kartennummer" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert
`CARD_EXPIRATION_DATE`	Gültig Bis VARCHAR(4)	(Optional) wird in das Feld "Gültig Bis" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert
`CARD_TYPE`	Kreditkartentyp VARCHAR(2)	(Optional) wird in das Feld "Kreditkartentyp" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert
`CARD_HOLDER_NAME`	Inhaber VARCHAR(60)	(Optional) wird in das Feld "Inhaber" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert
`CARD_CVC`	CVC VARCHAR(10)	(Optional) wird in das Feld "CVC" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert
`CARD_AUTH_CODE`	KK-ID VARCHAR(50)	(Optional) wird in das Feld "KK-ID" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert Ist der Tag leer, wird der Wert dem Tag <CARD_AUTHORIZATION> entnommen. Ist der Tag nicht leer (Autorisierung ist bereits durch den Shop erfolgt), wird die Bestellzeile auf ANG gesetzt.
`CARD_AUTHORIZATION`	KK-ID VARCHAR(50)	(Optional) wird in das Feld "KK-ID" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert, wenn der Tag <CARD_AUTH_CODE> nicht im XML enthalten ist
`CCP_MERCHANT`	CCP Händler	(Optional) wird in das Feld "CCP Händler" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert
`BANK_ACCOUNT`	Kontonr. VARCHAR(10)	(Optional) wird in das Feld "Kontonr." im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert. Feldlänge: 10 Zeichen
`HOLDER`	Kontoinhaber VARCHAR(27)	(Optional) wird in das Feld "Kontoinhaber" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert
`BANK_CODE`	BLZ VARCHAR(8)	(Optional) wird in das Feld "BLZ" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert. Feldlänge: 8 Zeichen
`BANK_NAME`	Bank VARCHAR(50)	(Optional) wird in das Feld "Bank" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert
`BIC`	BIC VARCHAR(11)	(Optional) wird in das Feld "BIC" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert
`IBAN`	IBAN VARCHAR(35)	(Optional) wird in das Feld "IBAN" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein > Zahlungsdaten importiert

Zum Seitenanfang

REMARK

Sie können über das Element <REMARK> zusätzliche Informationen zur Bestellung importieren, sofern das Attribut "type" mit den entsprechenden Informationen gefüllt ist, z. B. Versandkosten.

Beispiel

<REMARK type="SHIPPING">0.00</REMARK>
<REMARK type="SHIPPING_ORIGINAL">0.00</REMARK>
<REMARK type="VOUCHERCODE">ABC_Gutscheincode</REMARK>
<REMARK type="DISCOUNT">0.00</REMARK>
<REMARK type="SHIPPING2">0.00</REMARK>
<REMARK type="SHIPPINGVENDOR">DHL</REMARK>

Typ Attribut	Feld in pixi (Feldlänge)	Beschreibung
`SHIPPING`	Versandkosten MONEY	(Optional) enthält die Versandkosten der Bestellung; wird kein numerischer Wert geliefert, wird standardmäßig 0 genutzt Es werden Brutto-Versandkosten beim Bestelltyp B2C und Netto-Versandkosten beim Bestelltyp B2B importiert und müssen im XML entsprechend übergeben werden.
`SHIPPING_ORIGINAL`	Versandkosten MONEY	(Optional) enthält die Versandkosten in Fremdwährung; wird nicht im pixi Kundenservice angezeigt; wird kein numerischer Wert geliefert, wird standardmäßig 0 genutzt wird nicht mehr genutzt
`VOUCHERCODE`	Gutscheinnr VARCHAR(50)	(Optional) wird in das Feld "Gutscheinnr" im pixi Kundenservice > Reiter Bestellungen > Reiter Allgemein importiert Achtung: ist kein Wert im XML enthalten und der Rabatt größer als 0, generiert pixi einen Gutscheincode, um die Eindeutigkeit der Gutscheinnummer zu gewährleisten wird immer die OrderNrExternal an die Gutscheinnummer angehängt.
`DISCOUNT`	Gutscheinsumme MONEY	Pflicht - enthält den Rabattgutscheinwert der gesamten Bestellung; Dieser Tag kann genutzt werden, um die Summe aller Rabatte der Bestellung auszugeben, z. B. Rabatt bei frühzeitiger Zahlung (Skonto) oder Gutscheine. Ist kein Gutscheincode im Tag <VOUCHERCODE> enthalten, generiert pixi diesen. Es werden Brutto-Werte beim Bestelltyp B2C und Netto-Werte beim Bestelltyp B2B importiert und müssen im XML entsprechend übergeben werden.
`SHIPPING2`	Versandkosten MONEY	(Optional) enthält die Versandkosten der Bestellung; wird kein numerischer Wert geliefert, wird der Tag <SHIPPING> genutzt Es werden Brutto-Versandkosten beim Bestelltyp B2C und Netto-Versandkosten beim Bestelltyp B2B importiert und müssen im XML entsprechend übergeben werden.
`SHIPPINGVENDOR`	Versand über/Logistiker VARCHAR(3)	(Optional) enthält den Code des Logistikers, mit dem die Bestellung versandt werden soll, z. B. DHL; der Wert muss mit einem der Werte aus der Tabelle Logistikdienstleister im pixi Control Center übereinstimmen. Enthält der Tag keinen Wert oder ist der Tag im XML nicht enthalten, wird der Wert der Datenbank Einstellung "Opentrans, Standardwert Logistikdienstleister" (pixi Control Center > Reiter Datenbank Einstellungen > Ordner Import / Export > Unterordner Bestellimport (Opentrans)) entnommen.

Zum Seitenanfang

Artikelbereich: ORDER_ITEM_LIST

Der Artikelbereich im Tag <ORDER_ITEM_LIST> beinhaltet alle relevanten Informationen zu jedem einzelnen Artikel der Bestellung. Es können maximal 3000 Artikelzeilen pro Bestellung importiert werden.

Beispiel

<ORDER_ITEM_LIST>
   <ORDER_ITEM>
      <LINE_ITEM_ID>Bestellzeilen_ID</LINE_ITEM_ID>
     <WAREHOUSE_LOCATION>001</WAREHOUSE_LOCATION>
      <ARTICLE_ID>
         ...
      </ARTICLE_ID>
      <QUANTITY>1</QUANTITY>
      <DESCRIPTION_SHORT>Artikelbeschreibung</DESCRIPTION_SHORT>
      <ITEM_NOTE>Artikelbemerkung</ITEM_NOTE>
      <DF_TYPE>DF_Typ</DF_TYPE>
      <ORDER_UNIT/>
      <ITEM_NAME>Artikelname</ITEM_NAME>
      <ARTICLE_PRICE type="udp_gross_customer">
         ...
      </ARTICLE_PRICE>
      <ARTICLE_PRICE type="udp_net_customer">
         ...
      </ARTICLE_PRICE>
   </ORDER_ITEM>
   <ORDER_ITEM>
      ...
   </ORDER_ITEM>
</ORDER_ITEM_LIST>

Name des XML Tags	Feld in pixi (Feldlänge)	Beschreibung
LINE_ITEM_ID	Feld nicht sichtbar in GUI (50)	Pflicht - Jede Bestellzeile benötigt für den Import zu pixi einen eindeutigen Bezeichner. Diese Bestellzeilen ID wird in diesem Tag gespeichert. Wir empfehlen die folgende Struktur: [Bestellnummer]-[Nr der Bestellzeile], z. B. "123456-1", "123456-2" Der Wert wird als interne Referenz für die Shop Bestellzeile in der pixi Datenbank genutzt und ist im pixi Kundenservice nicht sichtbar.
WAREHOUSE_LOCATION	Feld nicht sichtbar im GUI (3)	(Optional) - Hiermit kann für jede Bestellzeile eine Location-ID übergeben werden.
ARTICLE_ID	Feld nicht sichtbar in GUI	Pflicht - weitere Informationen finden Sie unter ARTICLE_ID
QUANTITY	Menge INT	Pflicht - enthält die Bestellmenge des jeweiligen Artikels
DESCRIPTION_SHORT	Artikelname VARCHAR(120)	(Optional) enthält den Artikelnamen einer Bestellzeile Ist die Datenbank Einstellung "Opentrans, Import des Artikelnamens" (pixi Control Center > Reiter Datenbank Einstellungen >Ordner Import / Export > Unterordner Bestellimport (Opentrans)) deaktiviert und der Tag <ITEM_NAME> ist in der XML nicht enthalten oder leer, wird der Wert dem Tag <DESCRIPTION_SHORT> entnommen die Tags <ITEM_NAME> und <DESCRIPTION_SHORT> sind nicht im XML enthalten oder leer, wird der Wert dem Tag <ARTICLE_ID><DESCRIPTION_SHORT> entnommen der Tag <ITEM_NAME> ist in der XML enthalten, wird dieser Wert genutzt Ist die Datenbank Einstellung "Opentrans, Import des Artikelnamens" aktiviert und der Tag <ITEM_NAME> ist nicht im XML enthalten oder leer, wird der Wert dem Tag <DESCRIPTION_SHORT> entnommen die Tags <ITEM_NAME> und <DESCRIPTION_SHORT> sind nicht im XML enthalten oder leer, wird der Wert dem Tag <ARTICLE_ID><DESCRIPTION_SHORT> entnommen die Tags <ITEM_NAME>, <DESCRIPTION_SHORT> und <ARTICLE_ID><DESCRIPTION_SHORT>sind nicht im XML enthalten oder leer, wird der Name des Artikels der pixi Datenbank entnommen, so wie er über den Artikelimport importiert wurde der Tag <ITEM_NAME> ist im XML enthalten, wird der Wert dem Tag <DESCRIPTION_SHORT> entnommen; nur wenn der Tag <DESCRIPTION_SHORT> keinen Wert enthält, wird der Wert aus dem Tag <ITEM_NAME> genutzt der Tag <ITEM_NAME> im XML enthalten, der Tag <DESCRIPTION_SHORT> aber nicht enthalten oder leer ist, wird der Wert dem Tag <ARTICLE_ID><DESCRIPTION_SHORT> entnommen der Tag <ITEM_NAME> im XML enthalten, die Tags <DESCRIPTION_SHORT> und <ARTICLE_ID><DESCRIPTION_SHORT> aber nicht im XML enthalten oder leer sind, wird der Wert dem Tag <ITEM_NAME> entnommen Die Artikelbeschreibung sollte idR in einem CDATA-Block übergeben werden. Syntax-Beispiel: `<DESCRIPTION_SHORT><![CDATA[The SpecialItem® Brand Name™]]></DESCRIPTION_SHORT>`
ITEM_NOTE	Artikel Bemerkung VARCHAR(8000)	(Optional) enthält einen zusätzlichen Text, der pro Artikelzeile importiert werden kann, z. B. wenn Kunden einen Text für personalisierte Artikel hinterlassen; wird in das Feld "Artikel Bemerkung" im pixi Kundenservice > Reiter Bestellungen > Reiter Artikel importiert; der Tag <ITEM_NOTE> besitzt eine höhere Priorität als <ITEM_NOTE_XTC> Die maximale Zeichenlänge des Tags <ITEM_NOTE> liegt bei 8.000 Zeichen.
DF_TYPE	VARCHAR(1)	(Optional) wird benötigt, falls Sie die Direct Fulfillment Funktionalität in pixi nutzen; ist der Wert des Tags leer, wird der Wert entsprechend der Datenbank Einstellung "DF-Typ - Standardwert" (pixi Control Center > Datenbank Einstellungen > Ordner Import / Export > Artikelimport (BMECat)) importiert. Weitere Informationen finden Sie hier: Direct Fulfillment Dokumentation
ORDER_UNIT		(Optional) enthält Informationen zur Verpackungseinheit eines Artikels; wird bei Kundenbestellungen nicht benötigt;, kann aber genutzt werden, um Artikel bei Lieferanten zu bestellen; weitere Informationen finden Sie hier: Bearbeiten von Artikeln muss ein numerischer Wert sein
ITEM_NAME	Artikelname VARCHAR(120)	(Optional) Siehe DESCRIPTION_SHORT
ARTICLE_PRICE		Pflicht - enthält Informationen zum Preis des bestellten Artikels Es ist wichtig, das "type" Attribut in diesem Tag mit aufzuführen, um unterscheiden zu können, ob es sich um einen Netto- oder Bruttopreis handelt: ist der type "udp_gross_customer", dann werden die Werte als Bruttopreise interpretiert ist der type "udp_net_customer", dann werden die Werte als Nettopreise interpretiert Weitere Informationen finden Sie weiter unten: ARTICLE PRICE

Zum Seitenanfang

ARTICLE_ID

Das Element <ARTICLE_ID> enthält den eindeutigen Bezeichner, um den Artikel aus der Bestellung, dem entsprechenden Artikel aus der pixi Datenbank zuorden zu können.

Name des XML Tags	Feld in pixi (Feldlänge)	Beschreibung
`SUPPLIER_AID`	Shop Artikelnummer VARCHAR(50)	Pflicht - muss einen eindeutigen Bezeichner des Artikels enthalten, um den Artikel einem bereits über den Artikelimport (BMECat) in die Datenbank importierten Artikel zuordnen zu können. Sie können diese Artikelnummer u. a. in der Artikelinfo > Reiter Artikelnummern im Feld "Shop Artikelnummer" sehen. Die Shop Artikelnummer muss eindeutig sein, sollte sich nicht ändern und darf maximal 50 Zeichen enthalten (nur Ziffern, Buchstaben, Punkt und Bindestrich).
DESCRIPTION_SHORT	Artikelname VARCHAR(120)	(Optional) Siehe DESCRIPTION_SHORT
ITEM_NOTE	Artikel Bemerkung VARCHAR(8000)	(Optional) Siehe ITEM_NOTE

Zum Seitenanfang

ARTICLE_PRICE

Das Element <ARTICLE_PRICE> beinhaltet die Preise jedes bestellten Artikels.

Ab ELI Milestone 2 ist es wichtig, das "type" Attribut in diesem Tag mit aufzuführen, um unterscheiden zu können, ob es sich um einen Netto- oder Bruttopreis handelt:

ist der type "udp_gross_customer", dann werden die Werte als Bruttopreise interpretiert
ist der type "udp_net_customer", dann werden die Werte als Nettopreise interpretiert

Die Preise werden aufgrund der Einstellung "Anzahl an Dezimalstellen für Preise" (pixi Control Center > Reiter Datenbank Einstellungen > Ordner Allgemein) berechnet.

Weitere Informationen zu Nettopreisen finden Sie in dieser Dokumentation: Nettopreise in pixi

Beispiel

<ARTICLE_PRICE type="udp_gross_customer">
   <PRICE_AMOUNT>0</PRICE_AMOUNT>
   <PRICE_AMOUNT_ORIGINAL>0</PRICE_AMOUNT_ORIGINAL>
   <PRICE_LINE_AMOUNT>0</PRICE_LINE_AMOUNT>
   <DISCOUNT_PERC>0</DISCOUNT_PERC>
   <DISCOUNT_VALUE>0</DISCOUNT_VALUE>
   <FULL_PRICE>0</FULL_PRICE>
</ARTICLE_PRICE>
<ARTICLE_PRICE type="udp_net_customer">
   <PRICE_AMOUNT>0</PRICE_AMOUNT>
   <PRICE_AMOUNT_ORIGINAL>0</PRICE_AMOUNT_ORIGINAL>
   <PRICE_LINE_AMOUNT>0</PRICE_LINE_AMOUNT>
   <DISCOUNT_PERC>0</DISCOUNT_PERC>
   <DISCOUNT_VALUE>0</DISCOUNT_VALUE>
   <FULL_PRICE>0</FULL_PRICE>
</ARTICLE_PRICE>

Name des XML Tags	Feld in pixi (Feldlänge)	Beschreibung
`PRICE_AMOUNT`	MONEY	Empfohlen - enthält den u.U. rabattierten Verkaufspreis des Artikels Ist der Tag <PRICE_AMOUNT> leer, wird der Verkaufspreis des Artikels dem Tag <FULL_PRICE> und <DISCOUNT_PERC> entnommen. Ist der Tag <DISCOUNT_PERC> im XML nicht enthalten oder leer, wird der Wert dem Tag <DISCOUNT_VALUE> entnommen.
PRICE_AMOUNT_ORIGINAL	MONEY	(Optional) enthält den Verkaufspreis eines Artikels in Fremdwährung wird importiert in das Feld "Preis Fremdwährung" im pixi Kundenservice > Reiter Bestellungen > Reiter Artikel; die Währung wird durch den Tag <ORDER_INFO><PRICE_CURRENCY_ORIGINAL> festgelegt wird nicht mehr genutzt; sollte der Tag noch immer im XML enthalten sein, muss der Wert gleich dem des Tags <PRICE_AMOUNT> sein, andernfalls wird die Bestellung nicht importiert
PRICE_LINE_AMOUNT	Bestellzeile Brutto Bestellzeile Netto	(Optional) enthält das Produkt aus Bestellmenge und Verkaufspreis des Artikels (Bestellzeile Brutto/Netto)
DISCOUNT_PERC	Rabatt %	(Optional) enthält den Rabatt pro Bestellzeile in Prozent; kann für jede Art von Gutscheinen genutzt werden, auch für Skonto; der Wert sollte eine Dezimalzahl sein, d. h. 5 Prozent sollte als "0.05" importiert werden Ist der Tag <DISCOUNT_PERC> im XML nicht enthalten, wird der Wert aus den Tags <DISCOUNT_VALUE> und <FULL_PRICE> berechnet. Sind die Tags <DISCOUNT_PERC> und <DISCOUNT_VALUE> im XML enthalten, wird der Wert des Tags <DISCOUNT_PERC> auf Basis des Tags <DISCOUNT_VALUE> neu berechnet, um Rundungsfehler zu vermeiden.
DISCOUNT_VALUE	Rabatt	(Optional) enthält den Rabatt pro Bestellzeile; kann für jede Art von Gutscheinen genutzt werden, auch für Skonto; der Wert sollte eine Dezimalzahl sein, d. h. 12,34 EUR sollte als "12.34" importiert werden, wenn die Währung EUR ist Ist der Tag <DISCOUNT_VALUE> im XML nicht enthalten, wird der Wert aus den Tags <DISCOUNT_PERC> und <FULL_PRICE> berechnet.
FULL_PRICE	MONEY	Pflicht - enthält den nicht-rabattierten Ursprungsverkaufspreis pro Bestellzeile

Sind beide Tags <FULL_PRICE> und <PRICE_AMOUNT> im XML enthalten und die Tags <DISCOUNT_VALUE> und <DISCOUNT_PERC> sind im XML nicht enthalten oder leer, wird der Rabatt aus <FULL_PRICE> abzüglich <PRICE_AMOUNT> berechnet. Die Bestellung kann nicht importiert werden, wenn die Tags <PRICE_AMOUNT> und <FULL_PRICE> beide nicht im XML enthalten sind.

Zum Seitenanfang

Vollständiges openTRANS XML Beispiel

<?xml version="1.0" encoding="UTF-8" ?>
<ORDER version="1.0" type="standard">
    <ORDER_HEADER>
        <CONTROL_INFO>
            <GENERATOR_INFO>Name of the Shop - openTRANS-Export</GENERATOR_INFO>
            <GENERATION_DATE>2015-02-04T10:16:14+01:00</GENERATION_DATE>
        </CONTROL_INFO>
        <ORDER_INFO>
            <ORDER_ID>Order Number</ORDER_ID>
            <ORDER_DATE>date timestamp</ORDER_DATE>
            <DATABASE>pixi_XYZ</DATABASE>
            <SHOPID>ABC</SHOPID>
            <SHOP_NOTE>Shop Comment</SHOP_NOTE>
            <ORDERTAGS>
                <ORDERTAG>Tag 1</ORDERTAG>
                <ORDERTAG>Tag 2</ORDERTAG>
            </ORDERTAGS>
            <ORDER_SHIPLOCK>Y</ORDER_SHIPLOCK>
            <BUYER_SHIPLOCK>Y</BUYER_SHIPLOCK>
            <PRICE_CURRENCY>EUR</PRICE_CURRENCY>
            <PRICE_CURRENCY_ORIGINAL>GBP</PRICE_CURRENCY_ORIGINAL>
            <TRANSPORT_REMARKS>Shipping Information</TRANSPORT_REMARKS>
            <GIFT_MESSAGE>Custom gift message</GIFT_MESSAGE>
            <SUBSHOPLOGO>Sub shop logo</SUBSHOPLOGO>
            <SUBSHOPNAME>Sub shop name</SUBSHOPNAME>
            <REFERRER>Referrer</REFERRER>
            <LOCATION>LocationID</LOCATION>
            <PARTIAL_DELIVERY>OFF</PARTIAL_DELIVERY>
            <ORDER_TYPE>B2C</ORDER_TYPE>
            <ORDER_PARTIES>
                <BUYER_PARTY>
                    <PARTY>
                        <PARTY_ID type="buyer_specific">CustomerNrExternal 001</PARTY_ID>
                        <SHOPID>MAD</SHOPID>
                        <VAT_ID>BUYER_Old_VAT_ID</VAT_ID>
                        <ADDRESS>
                            <CUSTOMER_DISCOUNT_PERCENTAGE>KUNDEN_RABATT</CUSTOMER_DISCOUNT_PERCENTAGE>
                            <VAT_ID>BUYER_VAT_ID</VAT_ID>
                            <BUYER_SHIPLOCK>Y</BUYER_SHIPLOCK>
                        </ADDRESS>
                    </PARTY>
                </BUYER_PARTY>
                <INVOICE_PARTY>
                    <PARTY>
                        <ADDRESS>
                            <NAME>BILL_NAME</NAME>
                            <SAL>BILL_SAL</SAL>
                            <NAME2>BILL_FirstName</NAME2>
                            <NAME3>BILL_LastName</NAME3>
                            <STREET>BILL_Street</STREET>
                            <ZIP>BILL_ZIP</ZIP>
                            <ZIPBOX>BILL_HOUSENR</ZIPBOX>
                            <CITY>BILL_CITY</CITY>
                            <COUNTRY>BILL_COUNTRY</COUNTRY>
                            <STATE>BILL_STATE</STATE>
                            <PHONE>BILL_PHONE</PHONE>
                            <FAX>BILL_PHONE</FAX>
                            <EMAIL>BILL_EMAIL</EMAIL>
                        </ADDRESS>
                    </PARTY>
                </INVOICE_PARTY>
                <SHIPMENT_PARTIES>
                    <DELIVERY_PARTY>
                        <PARTY>
                            <ADDRESS>
                                <NAME>SHIPMENT_NAME</NAME>
                                <SAL>SHIPMENT_SAL</SAL>
                                <NAME2>SHIPMENT_FirstName</NAME2>
                                <NAME3>SHIPMENT_LastName</NAME3>
                                <STREET>SHIPMENT_Street</STREET>
                                <ZIP>SHIPMENT_ZIP</ZIP>
                                <ZIPBOX>SHIPMENT_HOUSENR</ZIPBOX>
                                <CITY>SHIPMENT_CITY</CITY>
                                <COUNTRY>SHIPMENT_COUNTRY</COUNTRY>
                                <STATE>SHIPMENT_STATE</STATE>
                                <PHONE>SHIPMENT_PHONE</PHONE>
                                <FAX>SHIPMENT_PHONE</FAX>
                                <EMAIL>SHIPMENT_EMAIL</EMAIL>
                                <ADDRESS_REMARKS>SHIPMENT_ADDRESS_REMARKS</ADDRESS_REMARKS>
                                <CHARGE_VAT>SHIPMENT_CHARGE_VAT</CHARGE_VAT>
                            </ADDRESS>
                        </PARTY>
                    </DELIVERY_PARTY>
                </SHIPMENT_PARTIES>
            </ORDER_PARTIES>
            <PAYMENT>
                <Generic_XML_tag_From_Payments_Table>
                    <CARD_NUM>CardNr</CARD_NUM>
                    <CARD_EXPIRATION_DATE>CardExp</CARD_EXPIRATION_DATE>
                    <CARD_TYPE>CardType</CARD_TYPE>
                    <CARD_HOLDER_NAME>CardName</CARD_HOLDER_NAME>
                    <CARD_CVC>CardCVC</CARD_CVC>
                    <CARD_AUTH_CODE>CardAuthID</CARD_AUTH_CODE>
                    <CARD_AUTHORIZATION>CardAuthorization</CARD_AUTHORIZATION>
                    <CCP_MERCHANT>CCPMerchant</CCP_MERCHANT>
                    <BANK_ACCOUNT>AccountNr</BANK_ACCOUNT>
                    <HOLDER>AccountName</HOLDER>
                    <BANK_CODE>BankNr</BANK_CODE>
                    <BANK_NAME>BankName</BANK_NAME>
                    <BIC>Bank Identifier Code</BIC>
                    <IBAN>International Bank Account Number</IBAN>
                </Generic_XML_tag_From_Payments_Table>
            </PAYMENT>
            <REMARK type="SHIPPING">0.00</REMARK>
            <REMARK type="SHIPPING_ORIGINAL">0.00</REMARK>
            <REMARK type="VOUCHERCODE">ABC_VOUCHERCODE</REMARK>
            <REMARK type="DISCOUNT_ORIGINAL">0.00</REMARK>
            <REMARK type="DISCOUNT">0.00</REMARK>
            <REMARK type="SHIPPING2">0.00</REMARK>
            <REMARK type="SHIPPINGVENDOR">DHL</REMARK>
        </ORDER_INFO>
    </ORDER_HEADER>
    <ORDER_ITEM_LIST>
        <ORDER_ITEM>
            <LINE_ITEM_ID>LINE_ITEM_ID</LINE_ITEM_ID>
            <ARTICLE_ID>
                <SUPPLIER_AID>SUPPLIER_AID</SUPPLIER_AID>
                <DESCRIPTION_SHORT><![CDATA[DESCRIPTION_SHORT]]></DESCRIPTION_SHORT>
                <ITEM_NOTE>ITEM_NOTE</ITEM_NOTE>
            </ARTICLE_ID>
            <QUANTITY>1</QUANTITY>
            <DESCRIPTION_SHORT>DESCRIPTION_SHORT</DESCRIPTION_SHORT>
            <ITEM_NOTE>ITEM_NOTE</ITEM_NOTE>
            <DATEV>DATEV</DATEV>
            <DF_TYPE>DF_TYPE</DF_TYPE>
            <ORDER_UNIT/>
            <ITEM_NAME>ITEM_NAME</ITEM_NAME>
            <ARTICLE_PRICE type="udp_gross_customer">
                <PRICE_AMOUNT>0</PRICE_AMOUNT>
                <PRICE_AMOUNT_ORIGINAL>0</PRICE_AMOUNT_ORIGINAL>
                <PRICE_LINE_AMOUNT>0</PRICE_LINE_AMOUNT>
                <DISCOUNT_PERC>0</DISCOUNT_PERC>
                <DISCOUNT_VALUE>0</DISCOUNT_VALUE>
                <FULL_PRICE>0</FULL_PRICE>
            </ARTICLE_PRICE>
            <ARTICLE_PRICE type="udp_net_customer">
                <PRICE_AMOUNT>0</PRICE_AMOUNT>
                <PRICE_AMOUNT_ORIGINAL>0</PRICE_AMOUNT_ORIGINAL>
                <PRICE_LINE_AMOUNT>0</PRICE_LINE_AMOUNT>
                <DISCOUNT_PERC>0</DISCOUNT_PERC>
                <DISCOUNT_VALUE>0</DISCOUNT_VALUE>
                <FULL_PRICE>0</FULL_PRICE>
            </ARTICLE_PRICE>
        </ORDER_ITEM>
    </ORDER_ITEM_LIST>
</ORDER>

Zum Seitenanfang

openTRANS Syntax-Spezifikationen für die Übergabe im XML-Format

Struktur der XML

Kopfbereich: ORDER_HEADER

ORDER_PARTIES

BUYER_PARTY

INVOICE_PARTY

SHIPMENT_PARTIES

Anwendungsfall: Packstation

Anwendungsfall: Postfiliale

PAYMENT

REMARK

Artikelbereich: ORDER_ITEM_LIST

ARTICLE_ID

ARTICLE_PRICE

Vollständiges openTRANS XML Beispiel