Breadcrumbs

DocumentUpdate


Nachrichtentyp

Format

Version

Link

DocumentUpdate

XML

12

DocumentUpdate_1014.xml


Beschreibung

Dokumente zu Produkten übertragen

Die Übergabe der Dokumente erfolgt über das separate Attachments-Verzeichnis. Sobald alle Dokumente darin enthalten sind, kann die Nachricht DocumentUpdate ebenfalls in dieses Verzeichnis abgelegt werden. Dadurch wird die korrekte Verarbeitungsreihenfolge sicher gestellt.

ACHTUNG:

Sind die Artikel noch nicht angelegt, kann keine Zuordnung erfolgen. ProductUpdate vor DocumentUpdate durchführen!

Eine Mehrfach-Verwendung/Referenzierung der Bilder ist nicht möglich, da die Bilder direkt nach der Zuordnung vom Server gelöscht werden. Für Mehrfach-Referenzierung müssen die Bilder über die GUI Verwaltung > Dokumente angelegt werden und können dann im jeweiligen Produkt verknüpft werden.


Feld

Wert

Nachrichtenkopf - Nachrichtentyp

DocumentUpdate 

Nachrichtenkopf - Version des Typs
Letzte Version

12



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.


Document - Häufigkeit: 1..*

Pro Artikelposition kann es mehrere Dokumente geben. Die Referenzierung zum Artikel findet über die Artikelnummer statt.#FeldMuß/ KannFormatmax. LängeBeschreibungVersion1Artikelnr.ArticleIdMAlph30Nummer der Artikels in der Warenwirtschaft2DokumententypDocTypeMAlph50Kennzeichner für Dokumenttyp. Muss Kundenindividuell spezifiziert werden. Die Standard Typen, die bereits im orderManager sind in der untenstehenden Liste zu finden.3DateinameFileNameMAlph1000Der Name der Datei ohne Endung.4Dateinamens- erweiterungFileExtensionMAlph10Die Endung der Datei, z.B. „.jpg"5Ist neues DokumentIsNewDocumentMBoolHandelt es sich bei dem Dokument um ein Dokument, welches das erste Mal übertragen wird?6Gültig abValidFrom K DateTime gibt an, ab wann das Dokument gültig ist 87 Beschreibung Description K Alph 500 Name des Dokuments 8 8InhaltContentKAlph400.000Base64-Codierter Inhalt der Datei17Standard-Dokumententypen des ordermanagerDokumenttyp WertBeschreibung11Listenbild (Standardbild)22Sicherheitsdatenblatt33Produktdatenblatt44Betriebsanleitung5999Sonstiges66Detailbild77Galeriebild (groß)88Galeriebild (klein)

Die Nachricht kann nur Dokumente enthalten, zu denen auch eine Datei übertragen wurde. Wird eine Datei geliefert, so muss "IsNewDocument" auf "true" stehen. Und nur in diesem Fall wird der Inhalt in das System übernommen.