Beispiele
|
Nachrichtentyp |
Format |
Version |
Link |
|---|---|---|---|
|
ProductSupplierUpdate |
XML |
10 |
ProductSupplierUpdate_1748.xml |
Beschreibung
Mittels des ProductSupplierUpdate können die Lieferantenpreise für die Mandanten im supplymanager aktualisiert werden.
Bis inklusive Version 13
Es müssen immer alle Preise des Lieferanten pro Mandanten in einer Nachricht übermittelt werden. Alle Preise des Lieferanten die nicht in der Nachricht enthalten sind, werden deaktiviert.
Ab Version 14
Im ProductSupplierUpdateHeader kann festgelegt werden, ob eine Veränderung am Basissortiment des Mandanten durch die Nachricht vorgenommen werden soll, oder ob nur eine Preisaktualisierung durchgeführt wird.
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.
ProductSupplierUpdateHeader - Häufigkeit: 0..1
|
# |
Feld |
XML Attribut |
Muss/Kann |
Format |
max. Länge |
Version |
Beschreibung |
|---|---|---|---|---|---|---|---|
|
1 |
Basissortiment zusammen |
ChangeAssortment |
M |
bool |
|
14 |
gibt an, ob das Basis-Sortiment des Mandanten zusammengestellt wird.
|
ProductSupplierUpdate - Häufigkeit: 1..*
|
# |
Feld |
XML Attribut |
Muss/Kann |
Format |
max. Länge |
Version |
Beschreibung |
|---|---|---|---|---|---|---|---|
|
1 |
OM Artikelnr |
Article Id |
M |
string |
30 |
5 |
|
|
2 |
Lieferantennr |
SupplierNumber |
M |
string |
30 |
5 |
|
|
3 |
Lieferantenartikelnr |
SupplierArticleId |
M |
string |
30 |
5 |
|
|
4 |
Einzel-Preis |
Price |
M |
dez |
|
5 |
|
|
5 |
Mandantennr. |
CustomerID |
M |
string |
20 |
5 |
|
|
6 |
Verkaufseinheit |
Unit |
K |
string |
100 |
5 |
|
|
7 |
Verkaufseinheit UNECE |
UnitUNECE |
K |
string |
3 |
5 |
|
|
8 |
Menge pro Verkaufseinheit UNECE |
UnitQuantity |
K |
dez |
|
5 |
|
|
9 |
Menge |
Quantity |
K |
dez |
|
14 |
Menge, ab der der Preis gilt. Wenn Staffelpreise für den Kunden gelten, muss die Artikelzeile pro Staffelmenge mit jeweils gültigem Preis wiederholt werden. Alle anderen Felder müssen gleich bleiben.
|
ProductSupplierPriceUpdate - Häufigkeit: 0..1
|
# |
Feld |
XML Attribut |
Muss/Kann |
Format |
max. Länge |
Version |
Beschreibung |
|---|---|---|---|---|---|---|---|
|
1 |
OM Artikelnr |
ArticleId |
M |
string |
30 |
16 |
|
|
2 |
Mandantennr. |
CustomerID |
M |
string |
20 |
16 |
|
|
3 |
MwSt-Satz |
VatPercent |
K |
dez |
|
16 |
in Prozent (z.B. „16.00") |
|
4 |
Kundenartikelnummer |
ProductCodeCustomer |
K |
string |
20 |
16 |
|
|
5 |
Zusatzinfo |
Account |
K |
string |
50 |
16 |
|
|
6 |
Kommentar |
Comment |
K |
string |
200 |
16 |
|
|
7 |
Freigabe erforderlich |
IsApprovalRequired |
K |
bool |
|
16 |
|
|
8 |
Preis anzeigen |
ShowPrice |
K |
bool |
|
16 |
|
|
9 |
Aktionsartikel |
IsActionArticle |
K |
bool |
|
16 |
|
|
10 |
Mindestbestellmenge |
MinimumOrderQuantity |
K |
dez |
|
16 |
|
|
11 |
Mengenintervall |
QuantityInterval |
K |
dez |
|
16 |
|