Bestellimport (Spezifikationen)

Geändert am Thu, 29 Feb 2024 um 12:07 PM

Achtung: Testphase!

Für den Import von Bestellungen aus externen Shopsystemen wie Webshops oder Plattformen haben wir ein Importdateiformat definiert. Das Vorhaben befindet sich in der Projektierungsphase. Nimm daher bitte Kontakt mit unserem Support auf, um die Einzelheiten und Konditionen zu klären.

Regeln

Vorgesehen ist die Übergabe von Bestellungen anhand von XML-Dateien.
Die Übergabe erfolgt per FTP und kann entweder durch Abholung von deinem FTP-Server erfolgen oder durch Lieferung der Dateien auf unseren FTP-Server.
Je Bestellung ist eine separate XML-Datei zu erstellen und abzulegen.
Die gelieferten XML-Dateien müssen eindeutig bezeichnet sein. Das kann entweder durch die Aufnahme der Bestellnummer in den Dateinamen (z.B. "order_12345.xml") oder durch Aufnahme eines Zeitstempels in den Dateinamen (z.B. "Bestellung_20230801T174233.xml") erfolgen.
Die Zeichencodierung sollte UTF-8 sein.

Musterdatei (Rechtsklick zum Download): veloport_order.xml

XML-Schemadefinition (Rechtsklick zum Download): veloport_order.xsd

Felder der XML-Datei

Element	Datentyp	Vorkommen	Beschreibung
OrderOrigin	string	1	Herkunft der Bestellung (Bezeichnung Webshop, Plattform)
OrderId	string	1	Bestellnummer des Shopsystems
Time	string	1	Zeitstempel der Bestellung nach ISO 8601 (z.B. 2023-08-03T12:15:01Z)
CustomerId	string	0-1	Kundennummer im Shopystem. Bei Gastbestellungen ohne "echte" Kundennummer muss das Element leer geliefert werden oder entfallen.
*AddressShipTo*	*array*	0-1	Lieferanschrift: Enthält die Elemente [Company], [Name], [Address], [Phone], [Mobile], [Email]. Element kann entfallen, wenn Lieferadresse = Rechnungsadresse.
*AddressBillTo*	*array*	1	Rechnungsadresse: Enthält die Elemente [Company], [Name], [Address], [Phone], [Mobile], [Email]
Company	string	0-1	Enthält den Firmennamen, falls vorhanden.
*Name*	*array*	0-1	Für Kundennamen bzw. Kontaktperson bei Firmen. Kann entfallen, wenn [Company] gefüllt ist. Enthält die Elemente [Title], [FirstName], [LastName], [FullName]
Title	string	0-1	Anrede (z.B. Herr, Frau, Firma)
FirstName	string	0-1	Vorname
LastName	string	0-1	Nachname
FullName	string	0-1	Vollständiger Name, falls im Shop nicht nach Vor- und Nachname getrennt werden konnte (z.B. "Max Mustermann"). Bleibt ansonsten leer bzw. entfällt.
*Address*	*array*	1	Enthält die Elemente [Street], [Zip], [City], [Country]
Street	string	1	Straße und Hausnummer bzw. Postfach
Zip	string	1	Postleitzahl
City	string	1	Ort
Country	string	0-1	Land nach ISO 3166-1 alpha-2 (z.B. DE, CH, AT)
Phone	string	0-1	Telefonnummer. Landesvorwahl (optional) muss mit "+" oder "00" beginnen. Trennzeichen zwischen (Landes-)Vorwahl und Rufnummer: "/" oder "-" oder Leerzeichen. Beispiele: +49 6008 6234100 oder 06008/6234100 oder 0049-6008-6234100
Mobile	string	0-1	Mobilnummer. Format wie bei "Phone".
Email	string	0-1	E-Mailadresse.
UID	string	0-1	Umsatzsteuer-ID für Firmenkunden.
Shipping	array	0-1	Enthält die Elemente [ShippingMethod], [ShippingCost], [ShippingVat]
ShippingMethod	string	0-1	Bezeichnung der Versandart
ShippingCost	decimal	0-1	Versandkosten (brutto)
ShippingVat	decimal	0-1	Mehrwertsteuersatz der Versandkosten (19 / 7 / 7.7 /...)
*PaymentInfo*	*array*	0-1	Enthält das Element [PaymentMethod]
PaymentMethod	string	0-1	Bezeichnung der Zahlart (Rechnung, Vorkasse, PayPal,...)
Comment	string	0-1	Bemerkungen des Kunden
*OrderLines*	*array*	1	Enthält Elemente von [Item]. Stellt die Zeilen der Bestellpositionen dar.
*Item*	*array*	1-n	Enthält die Elemente [SkuShop], [SkuERP], [Gtin], [Mpn], [Description], [Quantity], [UnitPrice], [UnitRRP], [LineTotal], [Vat], [Url], [DiscountText]
SkuShop	string	0-1	Artikelnummer im Webshop
SkuERP	string	0-1	Falls die original velo.port-Artikelnummer im Webshop hinterlegt ist, kann sie hier übergeben werden.
Gtin	string	0-1	GTIN/EAN des Artikels
Mpn	string	0-1	Herstellerartikelnummer
Description	string	1	Artikelbezeichnung
Quantity	integer	1	Menge
UnitPrice	decimal	1	Brutto-Einzelpreis des Artikels (Endpreis nach Abzug eines Rabatts)
UnitRRP	decimal	0-1	Optional: Abweichender UVP
LineTotal	decimal	1	Bruttosumme der Bestellposition (Menge x Einzelpreis)
Vat	decimal	0-1	Mehrwertsteuersatz der Position. Bei fehlender Angabe wird der volle Normalsteuersatz angenommen.
Url	string	0-1	URL zum Artikel im Shop-Frontend (zur schnellen Prüfmöglichkeit durch den Mitarbeiter).
DiscountText	string	0-1	Optional: Rabattbegründung. Zum Beispiel Name der Aktion. Wird nur verarbeitet, wenn der Einzelpreis vom UVP abweicht.
OrderTotal	decimal	1	Bruttogesamtwert der Bestellung inklusive Versandkosten.