Online Help: Aufträge importieren

Importieren von Aufträgen via CSV-Datei.

Diese Seite wird erreicht, wenn direkt über die Hauptnavigation Vorgänge > Aufträge > Auftragsimport gewählt wurde.

Einleitung

Die eCommerce Suite bietet Ihnen eine einfache Möglichkeit Ihre historischen Aufträe zu importieren. Hierfür benötigen Sie eine CSV-Datei, die die entsprechend erforderlichen Spalten enthält.

Short Facts

Es können neue Aufträge importiert und bestehende geändert werden
Es können Auftragsposten ergänzt werden.
Daten müssen als CSV-Datei (UTF8 Zeichensatz) vorliegen.
Es können Gesamt- oder auch Teilimporte durchgeführt werden.
Es können auch nur einzelne Felder (Spalten) importiert werden.
Selbst angelegte Auftrags-Zusatzfelder werden beim Import automatisch unterstützt.

Für den Import wird der Import-Manager im Backend der eCommerce Suite verwendet. In diesem können Sie interaktiv Ihre Datei hochladen, Feldzuordnungen anpassen und den Importvorgang letztendlich starten.

Eine detaillierte Erläuterung zum Arbeiten mit dem Import-Manager finden Sie unter: Import-Manager.

Bevor Sie mit dem Import von Auftragsdaten beginnen, sollten Sie sich grundsätzlich über Aufträge in der eCommerce Suite informieren.

Die Import-Datei (CSV)

Die für den Import nötige CSV-Datei können Sie z.B. mit Hilfe einer Tabellenkalkulation, wie bspw. MS Excel, oder eines Textprogrammes erstellen.

Wir empfehlen die Datei mit dem Zeichensatz UTF-8 abzuspeichern. Als Trennzeichen zwischen den Spalten sollten Sie das ; (Semikolon) verwenden.

Aufträge importieren

Mit Hilfe einer CSV-Datei können Sie Aufträge anlegen.

Pflichtspalten

(Es sind keine Pflichtfelder erforderlich.)

... Auftrags-Nr. oder Externe Auftrags-Nr. zur Erkennung neuer vs. zu ändernder Auftrag

... Kundenzuordnung durch: ext.Kundennr., Kundennr., Benutzername, E-Mail (werden in der Reihenfolge gesucht, 1. gefundener gewinnt)
-> optional: anlegen noch nicht vorhandener Kunden mit diesen Basisdaten oder Überspringen von Aufträgen, deren Kunden nicht bekannt sind. > Empfehlung: Kundendaten vorab bereits importieren

... sollte ebenfalls angegeben werden: Bestelldatum, Rechnungs-/Lieferanschrift (je Vorname,Nachname,Firma, Adresszusatz, Straße, Hausnr, PLZ, Ort, Land),
... Versandart, Status, Point-Of-Sale (fixe Vorbelegung ebenfalls möglich)

-> idealerweise auch: Rechnungsart, E-Mail (R), USt.ID-Nr., USt.ID-Nr. Status (für EU-Länder), Ausfuhrbescheinigung (für Drittländer)

-> optionale Zusatzdaten: Kunden-Referenztext(o_pers_reftext), Auftragstitel(otitle), Auftragsbeschreibung(otext), Auftrags-Sequenz-Nr.(o_pers_seq_nr, falls nicht in Bestellreihenfolge importiert), Kopf-Text(o_txt_header), Fuß-Text(o_txt_footer), Kundenkommentar, Interner Bestellhinweis,Kunden-Wunschtermin, Telefon, Liefer-Hinweise

...Auftragsposten werden nur hinzugefügt, nicht überschrieben:
-> mindestens benötigt: Menge (oi_quantity) > 0 und Einzelpreis (wahlweise oi_price_single_brutto oder oi_price_single_netto ODER Währung + Einzelpreis in dieser (oi_xcurrency + oi_price_single_brutto oder oi_price_single_netto)

-> sollte ebenfalls angegeben werden: Produktcode (oi_pcode), MwSt. (oi_vat_pct), Produktname (oi_name)

-> optional: oi_type (default: product), oi_text,oi_code, oi_block (default: 1), oi_position
sowie oi_qty_invoiced, oi_qty_refunded, oi_qty_shipped, oi_qty_returned falls bereits in anderen Systemen weiterverarbietet und Rechnung/Lieferung etc...nicht in eCS nachgezogen

Spaltenübersicht

Model	Fieldname	Type	Bezeichnung	Beispiel
Auftrag	orderid	Text (63)	Auftragsnummer Unique in Shop-Aufträgen	A015345
	o_orderid_external	Text (255)	Externe Auftragsnummer Unique in Shop-Aufträgen	010-3992-11
	o_time_ordered	Datetime	Eingangsdatum	2015-09-25 17:05:35
	invoice_gender	Text	Rechnungsadresse Anrede Optionen: female, male, company	male
	invoice_lastname	Text	Rechnungsadresse Nachname	Mustermann
	invoice_firstname	Text	Rechnungsadresse Vorname	Max
	invoice_title	Text	Rechnungsadresse Titel	Dr.
	invoice_company	Text	Rechnungsadresse Firma	Muster GmbH
	invoice_addrextra	Text	Rechnungsadresse Zusatz	Gebäue B
	invoice_street	Text	Rechnungsadresse Straße	Mustergasse
	invoice_housenr	Text	Rechnungsadresse Hausnummer	1
	invoice_zip	Text	Rechnungsadresse PLZ	12345
	invoice_town	Text	Rechnungsadresse Ort	Testheim
	invoice_country	Text (2)	Rechnungsadresse Land (ISO Code)	DE
	invoice_lang_iso	Text (2)	Dokumentensprache (ISO Code)	DE
	invoice_email	Text	E-Mail-Adresse	max.mustermann@muster.de
	invoice_taxidentnumber	Text	USt. ID	DE0123456789
	invoice_taxident_status	Text	Status der USt. ID Optionen: invalid, valid_conditional, valid_confirmed	valid_confirmed
	invoice_third_country_export	Text	Status Drittland Ausfuhrlieferung Optionen: none, certificate_promised, certificate_received	none
	deliver_gender	Text	Lieferadresse Anrede Optionen: female, male, company	female
	deliver_lastname	Text	Lieferadresse Nachname	Sonne
	deliver_firstname	Text	Lieferadresse Vorname	Sussi
	deliver_title	Text	Lieferadresse Titel
	deliver_company	Text	Lieferadresse Firma	Muster GmbH
	deliver_addrextra	Text	Lieferadresse Zusatz	Halle 2
	deliver_street	Text	Lieferadresse Straße	Testweg
	deliver_housenr	Text	Lieferadresse Hausnummer	9
	deliver_zip	Text	Lieferadresse PLZ	98765
	deliver_town	Text	Lieferadresse Ort	Musterheim
	deliver_country	Text (2)	Lieferadresse Land (ISO Code)	DE
	deliver_date_req	Text	Lieferwunschtermin
	deliver_phone	Text	Lieferung Telefonnummer
	deliver_comment	Text	Lieferung Hinweis/Kommentar
	order_state_code	Text	Auftragsstatus (Statuscode)	Auftrag abgeschlossen
	st_label	Text	Versandart (Label)	Postlieferung
	pos_name	Text	Point-of-Sale (Name)	Online-Shop
	o_pers_reftext	Text	Ein Referenztext des Kunden.
	otitle	Text	Freitext-Titel für den Auftrag.
	otext	Text	Freitext-Beschreibungstext für den Auftrag.
	o_txt_header	Text	Freitext für den Kopfbereich bei Auftragsdokumenten.
	o_txt_footer	Text	Freitext für den Fußbereich bei Auftragsdokumenten.
	ip_address	Text	IP Adresse des Bestellers
	o_referrer	Text	Referrer des Bestellers
	o_useragent	Text	User Agent des Bestellers
	o_comment	Text	Bestellkommentar
	o_comment_internal	Text	Interner Bearbeitungskommentar
	o_update_time	Datetime	Letzte Änderung des Auftrags	2015-10-02 09:45:07
	o_type	Text	Auftragstyp Optionen: order, offer, request	order
	o_valid_until	Datetime	Gültigkeitszeitpunkt für Angebote (o_type = offer)
Auftragsposten	oi_pcode	Text (255)	Artikel Produktnummer Unique in Shop-Produkten	0101-123-001
	oi_type	Text (15)	Artikeltyp Optionen: product, shipping, payment	product
	oi_name	Text	Artikelname	Artikel 123, grün
	oi_text	Text	Freitext zum Artikel
	oi_code	Text (63)	Externe Nummer/ID zum Auftragsposten
	oi_quantity	Decimal (13,4)	Bestellmenge	2
	oi_price_single_brutto	Decimal (13,4)	Brutto Stückpreis in Euro	119
	oi_price_single_netto	Decimal (13,4)	Netto Stückpreis in Euro	100
	oi_vat_pct	Decimal (6,2)	Artikel USt. Satz	19
	oi_xcurrency	Text (7)	Abweichende Preis-Währung	GBP
	oi_price_single_brutto_xcurrency	Decimal (13,4)	Brutto Stückpreis in Preis-Währung	102
	oi_price_single_netto_xcurrency	Decimal (13,4)	Netto Stückpreis in Preis-Währung	85
	oi_position	Integer (3)	Postennummer	1
	oi_xdata	Text	Zusatzdaten als JSON String	{"var1":"val1","var2":"val2"}
Kunde	fk_o_personid	Text (32)	Kundennummer Unique in Shop-Kunden	K051344
	fk_o_p_personid_external	Text (127)	Externe Kundennummer Unique in Shop-Kunden	C-03939-29
	fk_o_email	Text (127)	E-Mail-Adresse	max.mustermann@muster.de
	fk_o_p_login_username	Text (63)	Loginname / E-Mail-Adresse	max.mustermann@muster.de
Zahlungsvorgang	pys_method	Text	Zahlungart	Remittance
	transamount	Decimal (13,4)	Zahlungsbetrag	119
	transcurrency	Text (3)	Währung (ISO-Code)	EUR
	transcode	Text (255)	Transaktionscode
	transname	Text (63)	Verwendungszweck	Auftrag A015345
	transstate	Text (15)	Transaktionsstatus von externen Service
	transmsgs	Text	Transaktionsmeldung von externen Service
	tr_time_insert	Datetime	Zeitpunkt der Erstellung
	tr_time_update	Datetime	Zeitpunkt der letzten Änderung
	tr_time_exec	Datetime	Zeitpunkt wenn die Zahlung gestartet / eingeleitet wurde
	tr_time_completed	Datetime	Zeitpunkt wenn die Zahlung abgeschlossen wurde

Beispiel Importdatei

Auftragsimport Beispieldatei

orderimport-beispiel.csv (1,3 KB)