ProductCustomerUpdate
| Nachrichtentyp | Format | Version | Link |
|---|---|---|---|
| ProductCustomerUpdate | CSV | 2 | ProductCustomerUpdate_1051.csv |
| ProductCustomerUpdate | CSV | 15 | ProductCustomerUpdate_v15.csv |
| ProductCustomerUpdate | XML | 12 | ProductCustomerUpdate_1016.xml |
Beschreibung
Kundenartikelstamm übertragen
Nachrichten mit kundenbezogenen Informationen zu Artikel enthalten insbesondere die Preise eines Kunden für bestimmte Artikel.
Die Einstellung "Stellt Sortiment zusammen" im Header entscheidet, ob durch die Nachricht das Grundsortiment bestimmt wird, aus dem der Kunde seine Teilsortimente für die einzelnen Kostenstellen innerhalb von ordermanager festlegen kann. Ist sie auf "true", müssen alle kundenbezogenen Artikelinformationen übermittelt werden, steht sie auf "false" ist auch ein Teilupdate möglich. (vgl. ProductCustomerUpdate_v15.csv)
Feld | Wert |
|---|---|
| Nachrichtenkopf - Nachrichtentyp | ProductCustomerUpdate |
Nachrichtenkopf - Version des Typs | 7 |
Nachrichtenkopf
Der Kopf einer Nachricht setzt sich immer aus folgenden Feldern zusammen:
| # | Feld | XML-Attribut | Muß/ | 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". |
| 7 | Kennung der Nachricht | MessageId | M | alph | 32 | Fortlaufende Nummer um die Nachricht eindeutig zu identizieren. |
| 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.
Ab Nachrichtenversion 7
| # | Feld | XML-Attribut | Muß/ | Format | max. Länge | Version | Beschreibung |
|---|---|---|---|---|---|---|---|
| 1 | Basissortiment zusammen | ChangeAssortment | M | bool | gibt an, ob das Basis-Sortiment des Kunden zusammengestellt wird. "true": Alle Artikel die nicht in der aktuellen Datei enthalten sind, werden aus dem Basis-Sortiment der enthaltenen Kunden entfernt. Wird kein ProductCustomerUpdateHeader übermittelt, wird true als Standardwert angenommen. "false": Es werden die Preise des Kunden aktualisiert. Die Basissortimente der Kunden bleiben unverändert. |
ACHTUNG: Bitte nutzen Sie Punkt statt Komma für Dezimalwerte!
| # | Feld | Muß/ | Format | max. Länge | Version | Beschreibung | |
|---|---|---|---|---|---|---|---|
| 1 | Artikelnr. | ArticleId | M | Alph | 30 | Nummer des Artikels in der Warenwirtschaft | |
| 2 | Kundennr. | CustomerId | M | Alph | 20 | Kundennummer des Kunden oder Kundenummer der Preisliste des Händlers in der Warenwirtschaft | |
| 3 | Kunden-artikelnr. | CustomerArticleCode | K | Alph | 20 | Nummer des Kunden für den Artikel, falls in der Wawi vorhanden. | |
| 4 | Menge | Quantity | K | Dez | 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. | ||
| 5 | Preis | Price | M | Dez | Preis des Kunden für einen Artikel ab der angegebenen Menge | ||
| 6 | Gültig von | StartDate | K | date | Wird beim Import in den ordermanager nicht berücksichtigt. | ||
| 7 | Gültig bis | EndDate | K | date | Wird beim Import in den ordermanager nicht berücksichtigt. | ||
| 8 | Mindestbestellmenge | MinimumOrder | K | Dez | 2 | mindestens zu bestellende Menge pro Bestellung. Vorgabe ist 1.0. | |
| 9 | Mengen-intervall | OrderQuantityInterval | K | dez | 2 | Schrittweite, in der die Bestellmenge erhöht werden darf. Vorgabe ist 1.0. | |
| 10 | SalesUnit | SalesUnit | K | string | 100 | 5 | |
| 11 | Kommentar | Comment | K | string | 200 | 13 | |
| 12 | Verkaufseinheit UNECE | UnitUNECE | K | string | 3 | 15 | |
| 13 | Menge pro Verkaufseinheit UNECE | UnitQuantity | K | dez | 15 | Default = 1 |