DeliveryAddressUpdate

Beispiele

Nachrichtentyp	Format	Version	Link
DeliveryAddressUpdate	XML	12	DeliveryAddressUpdate9570.xml

Beschreibung

Lieferadressen übertragen

Mit dieser Nachricht werden Lieferadressen zwischen ordermanager und der Warenwirtschaft ausgetauscht.

Feld	Wert
Nachrichtenkopf - Nachrichtentyp	DeliveryAddressUpdate
Nachrichtenkopf - Version des Typs Letzte Version	13

Nachrichtenkopf - Häufigkeit: 1

Nachrichtenkopf

Der Kopf einer Nachricht setzt sich immer aus folgenden Feldern zusammen:

#	Feld	XML-Attribut	Muß/ Kann	Format	max. Länge	Beschreibung
1	Nachrichtentyp	Type	M	alph	30	Kennung/Bezeichnung des Typs der Nachricht. Die einzelnen Typen werden im Folgenden vorgestellt.
2	Version des Typs	Version	M	int		Kennung der Version des Nachrichtentyps bzw. des Formats
3	Datum & Uhrzeit	Date	M	dt		Datum und Uhrzeit der Erstellung der Nachricht
4	Sender	SenderId	M	alph	50	Kennung des Senders
5	Empfänger	ReceiverId	M	alph	50	Kennung des Empfängers
6	Kennung der Transaktion	TransactionId	K	alph	32	siehe folgender Abschnitt „Transaktionen". Leer bei nicht Verwendung des Transaktionsprotokolls.
7	Kennung der Nachricht	MessageId	M	alph	32	Fortlaufende Nummer um die Nachricht eindeutig zu identizieren. siehe folgender Abschnitt „Transaktionen"
8	Sequenznummer des Senders der Nachricht	SequenceNrSender	K	int		Fortlaufende Zahl, die sicherstellt, dass ankommende Nachrichten in der richtigen Reihenfolge abgearbeitet werden
9	Sequenznummer des Empfängers der Nachricht	SequenceNrReceiver	K	int		Fortlaufende Zahl, die sicherstellt, dass ankommende Nachrichten in der richtigen Reihenfolge abgearbeitet werden
10	Timeout	Timeout	K	int		Zeit in Minuten, in der der Sender eine Antwort erwartet. Kein Timeout (unendliches Warten) wird durch den Wert 0 (null) ausgedrückt.
11	Nachrichtenlänge	NumberOfLines	M	int	10	Anzahl der Zeilen der Nachricht , inkl. Der ersten Zeile. Dieser Wert dient zur Überprüfung, ob die Nachricht komplett übertragen wurde.

Mit der Version 2.2 der Schnittstelle wird das Feld „Version" genutzt. Alle bisherigen Schnittstellenversionen hatten hier den Wert „1". Ab der aktuellen Version wird der Wert mit jeder Version hochgezählt. Alle Satzarten und Felder die aktuell keine Versionsangabe besitzen, müssen unterstützt werden. Alle Felder und Satzarten die eine Angabe besitzen, müssen erst ab der angegebenen Version unterstützt werden.
Die Werte für die Felder „Kennung des Senders" und „Kennung des Empfängers" müssen im Vorfeld festgelegt werden. Durch sie werden konkrete Instanzen eines ordermanager und einer Warenwirtschaft eindeutig identifizert.
Die „Kennung der Nachricht" sollte, wenn möglich, mit einer fortlaufenden Nummern gefüllt werden. Wird auf das Transaktionsprotokoll verzichtet, so müssen die Felder „Kennung der Transaktion" sowie beide Sequenznrn Felder leer bleiben. Ab der Version 2.4 wird der Einsatz des Transaktionsprotokolls nicht mehr empfohlen.

DeliveryAddressUpdate - Lieferadresse - Häufigkeit: 1..*

Eine Nachricht vom Typ „DeliveryAddressUpdate" enthält beliebig viele Datensätze in folgendem Format:

CSV-Kennung: DA
XML-Tag: DeliveryAddressUpdateData

#	Feld	XML Attribut	Muß/ Kann	Format	max. Länge	Beschreibung	Version
1	Id	Id	M	alph	30	Id der Adresse. Die Id muss in Kombination mir der Kundennr. eindeutig sein. Entspricht im ordermanager der externen Nummer.
2	WaWi-Id	ErpId	K	alph	30	Veraltet. Nicht verwenden. WaWi-interne Id der Adresse
3	Kundennr.	CustomerId	M	alph	20	Nummer des Kunden in der Warenwirtschaft
4	Firmenname	Name	M	alph	200	Beschreibung der Adresse
5	Zusatz	Description	K	alph	100	Enthält den Zusatz 1 der Adresse
6	Straße	Street	K	alph	100
7	PLZ	PostalCode	K	alph	20
8	Ort	City	K	alph	100
9	PLZ Postfach	PostalCodePOBox	K	alph	20
10	Postfach	POBox	K	alph	20
11	Land	Country	K	alph	3	Ländercode nach ISO 3166-1:1997 („DE" für Dtl.)
12	Telefon	Phone	K	alph	100
13	Fax	Fax	K	alph	100
14	Mobiltelefon	Mobile	K	alph	100
15	Email	Email	K	alph	200
16	Web	Web	K	alph	200
17	Ansprechpartner	Contact	K	alph	100
18	Kommentar	Comment	K	alph	200
19	ILN	ILN	K	EAN	13	International Location Number
20	Zusatz 2	Additional2	K	string	200	Enthält den Zusatz 2 der Adresse	5
21	Hausnummer	StreetNo	K	string	10		5
22	Umsatzsteuer-Id	VatRegistrationNo	K	string	35		12

CostCenter - Kostenstelle - Häufigkeit: 0..* - ab Version 13

Überträgt Informationen über die Kostenstelle der Lieferadresse.
Aktuell wird diese Information nur beim Import in den ordermanager verarbeitet, jedoch nicht exportiert.

CSV-Kennung: DCC
XML-Tag: CostCenter

#	Feld	XML Attribut	Muß/ Kann	Format	max. Länge	Beschreibung	Version
1	Kundennr.	CustomerId	M	alpha	20	Nummer des Kunden in der Warenwirtschaft
2	Nummer	Number	M	alpha	30	Nummer der Kostenstelle, diese muss in Kombination mit der Kundennr. eindeutig sein. Entspricht im ordermanager der externe Nummer der Kostenstellen.
3	Name	Name	M	alpha	200	Name der Kostenstelle
4	Nummer Rechnungsadresse	BillingAddressNumber	K	alpha	30	Rechnungsadresse die dieser Kostenstelle zugewiesen werden soll. Die Zuordnung erfolgt über die externe Nummer der Rechnungsadresse im ordermanager. Bleibt dieses Feld leer, so erbt die Kostenstelle die Rechnungsadresse des übergeordneten Knoten. Wird beim Anlegen einer Kostenstelle übernommen.
5	Nummer 1	Number1	K	alpha	30	Feld "Kostenstellennummer" aus dem ordermanager. Wird beim Anlegen einer Kostenstelle übernommen.	18

CostCenterDeliveryAddress - Lieferadresse der Kostenstelle - Häufigkeit: 0..* - ab Version 13

Diese Satzart ist aktuell nur bei der Neuanlage einer Lieferadresse relevant. Die Satzart gibt an, zu welcher Kostenstelle die Lieferadresse angelegt werden kann.
Bei späteren Aktualisierungen wird diese Satzart nicht mehr berücksichtigt.

CSV-Kennung: DCD
XML-Tag: CostCenterDeliveryAddress

#

Feld

XML Attribut

Muß/
Kann

Format

max. Länge

Beschreibung

1

Kundennr

CustomerId

M

alph

20

Nummer des Kunden in der Warenwirtschaft

2

Nummer Kostenstelle

CostCenterNumber

M

alph

30

Nummer der Kostenstelle.

Die Nummer muss in Kombination mir der Kundennr.
eindeutig sein.

Entspricht im ordermanager der externen Nummer der Kostenstelle.

3

Nummer Lieferadresse

DeliveryAddressNumber

M

alph

30

Id der Lieferadresse aus dem DeliveryAddressUpdate, siehe oben.

Entspricht im ordermanager der externen Nummer der Kostenstelle.

CostCenterAssortment - Kostenstellen Sortiment - Häufigkeit: 0..* - ab Version 13

Gibt die Sortimente an, die der Kostenstelle zugeordnet werden müssen. Die Auswahl des Sortimentes erfolgt über den Sortimentsnamen.
Sortimente die nicht in der Nachricht "DeliveryAddressUpdate" vorkommen, werden von der Kostenstelle entfernt.

Wird zu einer Kostenstelle kein Sortiment übermittelt, so bleibt die Sortimentszuordnung im ordermanager unverändert.

CSV-Kennung: DCA
XML-Tag: CostCenterAssortment

#

Feld

XML Attribut

Muß/
Kann

Format

max. Länge

Beschreibung

1

Kundennr

CustomerId

M

alph

20

Nummer des Kunden in der Warenwirtschaft

2

Nummer Kostenstelle

CostCenterNumber

M

alph

30

Nummer der Kostenstelle.

Die Nummer muss in Kombination mir der Kundennr.
eindeutig sein.

Entspricht im ordermanager der externen Nummer der Kostenstelle

3

Name Sortiment

AssortmentName

M

alph

50

Name des Sortimentes. Das Sortiment mit diesem Namen, wird der Kostenstelle zugeordnet.