DeliveryAddressUpdate

Beispiele

Nachrichtentyp
Format
Version
Link
DeliveryAddressUpdateXML12DeliveryAddressUpdate9570.xml

Beschreibung

Lieferadressen übertragen

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

FeldWert

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
Aktuelle Version: 3

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


20Zusatz 2Additional2Kstring200Enthält den Zusatz 2 der Adresse5
21HausnummerStreetNoKstring10
5
22Umsatzsteuer-IdVatRegistrationNoKstring35
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

1

Kundennr.

CustomerId

M

alpha

20

Nummer des Kunden in der Warenwirtschaft

2NummerNumberMalpha30

Nummer der Kostenstelle, diese muss in Kombination 
mit der Kundennr. eindeutig sein.

Entspricht im ordermanager der externe Nummer der Kostenstellen.

3NameNameMalpha50Name der Kostenstelle
4Nummer RechnungsadresseBillingAddressNumberKalpha30Rechnungsadresse 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.
 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

1KundennrCustomerIdMalph20

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.

3Nummer LieferadresseDeliveryAddressNumberMalph30

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

1KundennrCustomerIdMalph20

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

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