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
|
13 |
Nachrichtenkopf - Häufigkeit: 1
NachrichtenkopfDer Kopf einer Nachricht setzt sich immer aus folgenden Feldern zusammen:#FeldXML-AttributMuß/ KannFormatmax. LängeBeschreibung1NachrichtentypTypeMalph30Kennung/Bezeichnung des Typs der Nachricht. Die einzelnen Typen werden im Folgenden vorgestellt.2Version des TypsVersionMintKennung der Version des Nachrichtentyps bzw. des Formats3Datum & UhrzeitDateMdtDatum und Uhrzeit der Erstellung der Nachricht4SenderSenderIdMalph50Kennung des Senders5EmpfängerReceiverIdMalph50Kennung des Empfängers6Kennung der TransaktionTransactionIdKalph32siehe folgender Abschnitt „Transaktionen". Leer bei nicht Verwendung des Transaktionsprotokolls.7Kennung der NachrichtMessageIdMalph32Fortlaufende Nummer um die Nachricht eindeutig zu identizieren. siehe folgender Abschnitt „Transaktionen"8Sequenznummer des Senders der NachrichtSequenceNrSenderKintFortlaufende Zahl, die sicherstellt, dass ankommende Nachrichten in der richtigen Reihenfolge abgearbeitet werden9Sequenznummer des Empfängers der NachrichtSequenceNrReceiverKintFortlaufende Zahl, die sicherstellt, dass ankommende Nachrichten in der richtigen Reihenfolge abgearbeitet werden10TimeoutTimeoutKintZeit in Minuten, in der der Sender eine Antwort erwartet. Kein Timeout (unendliches Warten) wird durch den Wert 0 (null) ausgedrückt.11NachrichtenlängeNumberOfLinesMint10Anzahl 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ß/
|
Format |
max. Länge |
Beschreibung |
Version |
|---|---|---|---|---|---|---|---|
|
1 |
Id |
Id |
M |
alph |
30 |
Id der Adresse. Die Id muss in Kombination mir der Kundennr.
Entspricht im ordermanager der externen Nummer. |
|
|
2 |
WaWi-Id |
ErpId |
K |
alph |
30 |
Veraltet. Nicht verwenden.
|
|
|
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 |
|
|
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ß/
|
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
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.
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ß/
|
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.
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ß/
|
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.
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. |