ProductStockUpdate

Beispiele

Nachrichtentyp	Format	Version	Link
ProductStockUpdate	XML	5	ProductStockUpdate_1116.xml
ProductStockUpdate	CSV	5	ProductStockUpdate_1116.csv

Beschreibung

Lagerbestände

Mit Nachrichten dieses Typs übermittelt eine Warenwirtschaft gegenbenenfalls aktuelle Lagerbestände, wenn Kunden unmittelbar Auskunft über die Verfügbarkeit von Artikeln erhalten sollen.

Feld	Wert
Nachrichtenkopf - Nachrichtentyp	ProductStockUpdate
Nachrichtenkopf - Version des Typs Letzte Version	14

In Abhängigkeit vom gewünschten Grad der Aktualität der Verfügbarkeitsangaben, werden „ProductStockUpdate"-Nachrichten mehr oder weniger häufig versendet. Eine Nachricht muss dabei nicht immer die Lagerbestände aller Artikel beeinhalten, sondern kann sich auf die Veränderungen seit der letzten Nachricht beschränken.

Ab ordermanager Version 7.7 können über die Nachricht nur noch Händlerbestände übermittelt werden. Die Übermittlung von Kostenstellenbestände ist nicht mehr möglich. Die Felder CustomerId und Number werden ignoriert. Im Falle der Übermittlung per CSV müssen diese weiterhin leer übermittelt werden. Zur Übermittlung des Kostenstellenbestände gibt es nun eine separate Nachricht, die jedoch nur in Zusammen mit dem Modul "Inventur" zur Verfügung steht.

Über diese Nachricht können sowohl Händlerbestände, als auch Kostenstellenbestände übertragen werden.

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.

ProductStock - Häufigkeit: 1..*

Gesamt-Lagerbestand eines Artikels

CSV-Kennung: PS
XML-Tag: ProductStock

#	Feld	XML Attribut	Muß/ Kann	Format	max. Länge	Beschreibung	Version
1	Artikelnr.	ArticleId	M	alphanumerisch	30	Nummer der Artikels in der Warenwirtschaft
2	Bestand	Inventory	M	dezimal		Lagerbestand des Artikels in der Warenwirtschaft
3	Status des Artikels	Status	K	alphanumerisch	50	„stock", „unavailable" und „ordered" Ab Version 14 wird nur noch berücksichtigt, ob der Status "ordered" gesetzt ist. Die anderen Statuswerte werden anhand von Bestand und Mindestbestand errechnet.
4	Status Erläuterung	StatusHint	K	Alph	250	Erläutert den Status des Artikels. z.B. „Artikel erst in 3 Monaten wieder lieferbar"	2
5	Bestellstatus	OrderInfo	K	Alph	500	Zusätzliche Erläuterung zum Status „ordered" z.B. „nächste Lieferung am Tag x"	2
6	CustomerId	CustomerId	K	string	20	Wird nicht mehr unterstützt. Siehe Hinweis in Beschreibung. Kundennummer bei Aktualisierung von Kostenstellenbestand	5
7	Number	Number	K	string	15	Wird nicht mehr unterstützt. Siehe Hinweis in Beschreibung. Kostenstelle bei Aktualisierung von Kostenstellenbestand	5
8	MinimumStockLevel	MinimumStockLevel	K	dezimal		Mindestbestand des Artikels	14

ProductBatchStock - Häufigkeit: 0..* - ab Version 13

Für chargengeführten Artikeln können die Lagerbestände pro Charge übergeben werden. Es müssen immer alle Chargen des Artikels übergeben werden, die im ordermanager erscheinen sollen.
Alle Chargen eines Artikels die nicht mit übergeben werden, werden im ordermanager entfernt.

CSV-Kennung: PBS
XML-Tag: ProductBatchStock

#	Feld	XML Attribut	Muß/ Kann	Format	max. Länge	Beschreibung
1	Artikelnr.	ArticleId	M	alphanumerisch	30	Nummer der Artikels in der Warenwirtschaft
2	Bestand	Inventory	M	dezimal		Lagerbestand des Artikels der Charge in der Warenwirtschaft
3	Number	Number	M	string	36	Chargennummer
4	Mindesthaltbarkeitsdatum	BestBeforeDate	K	date		Mindesthaltbarkeitsdatum