Quotation

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.

Diese Satzart enthält Informationen, um das Angebot, zu der die Nachricht gehört, eindeutig zu identifizieren.#FeldXML AttributMuß/ KannFormatmax. LängeBeschreibung1IdIdM/K*1alph30ordermanager–interne Id der Bestellung2Auftragsnr.VendorQuotationCodeM/Kalph30Wawi-interne Auftragsnummer

#FeldXML AttributMuß/ KannFormatmax. LängeBeschreibungVersion1ErstelldatumCreateDateMdate Datum der Erzeugung des Angebots. 2FreigabedatumApproveDateKdate Datum, an dem das Angebot den Kunden-internen Freigabeprozess durchlaufen hat 3Kundennr.CustomerIdMalph30Wawi-interne Nummer des Kunden 4Bestellnr. Des KundenCustomersOrderCodeKalph30Nummer/Kennung, die der Kunde ggf. für das Angebot vergeben hat 5LieferdatumDeliveryDateKdate vom Kunden vorgegebenes oder vom Händler korrigiertes Lieferdatum (je nach Richtung der Nachricht) 6Lieferdatum bisDeliveryDateUntilKdate Endedatum eines möglichen Lieferzeitraums 7WährungCurrencyMalph3Kurzzeichen für Währung der Bestellung nach ISO-4217:1995; zunächst immer „EUR" 8ProzessstatusProcessStateKint32bitordermanager –interne Kennung für den Zustand, in dem sich das Angebot befindet 9StatusStateKalph20Kennung für das Ergebnis einer Anfrage oder den Zustand des Angebots aus Sicht der Wawi 10FlagsFlagsKint32bitDefaultwert: 0 11KommentarCommentKalph200Kommentar vom Kunden für den Händler 12VertriebsmitarbeiterEditorKalph100Loginname des Vertriebsmitarbeiters 13TeillieferungPartialDeliveryKBool Gibt an ob Teillieferung gewünscht ist214Lieferdatum-hinweisDeliveryDateHintKAlph100Gibt an, wie das angegebene Lieferdatum zu verstehen ist z.b. „Lieferung bis", „Fixtermin", etc. Hier kann aber auch Lieferroute übergeben werden.215FälligkeitsdatumExecutiondateKDate Gibt an, wann die Zahlung fällig ist.216BezahlverfahrenPaymentMethodKAlph50siehe Zahlarten von PurchaseOrderSubmit217Netto-BetragTotalNetKdez Netto-Betrag des Angebots318MwSt-BetragTotalVatAmountKdez Betrag der Mehrwertsteuer319Brutto-BetragTotalGrossKDez Brutto Gesamtsumme des Angebots inklusive Mwst.320 EinleitungOpeningRemark K Alph 256000  Textbaustein Einleitung6 21 AbschlussClosingRemark K Alph 256000  Textbaustein Abschluss6 22 ErstellerCreatorLoginNameMAlph 50 Loginname des Angebotserstellers8

[data-colorid=lyx5i97aod]{color:#333333} html[data-color-mode=dark] [data-colorid=lyx5i97aod]{color:#cccccc}[data-colorid=i00ckjzzb3]{color:#333333} html[data-color-mode=dark] [data-colorid=i00ckjzzb3]{color:#cccccc}[data-colorid=xo89w5vtxq]{color:#333333} html[data-color-mode=dark] [data-colorid=xo89w5vtxq]{color:#cccccc}[data-colorid=i1doxyfvob]{color:#333333} html[data-color-mode=dark] [data-colorid=i1doxyfvob]{color:#cccccc}CSV-Kennung: POEXML-Tag: PurchaseOrderStructureItemIn der Satzart Strukturelement wird übermittelt, auf welches Element in der Struktur des Kunden sich eine Bestellung bezieht (beispielsweise eine Kostenstelle, ein Objekt, etc.). Sätze dieser Art sind nur in Nachrichten vom Typ „PurchaseOrderSubmit" und „PurchaseOrderResubmit" enthalten, Antworten der Warenwirtschaft an den ordermanager müssen sie nicht mehr aufführen.#FeldXML AttributMuß/ KannFormatmax. LängeBeschreibung1Nummer 1Number1Kalph30Feld "Kostenstelle" aus dem ordermanager2Nummer 2Number2Kalph30Feld "Weitere Nummer" aus dem ordermanager3hierarchischer PfadPathMalph300Pfad des Elements in der Struktur des Kunden, bestehend aus den Namen der übergeordeten Elemente und des Elements selbst, getrennt durch einen umgekehrten Schrägstrich (ASCII-Code 92dez /5Chex)

#FeldXML AttributMuß/ KannFormatmax. LängeBeschreibungVersion1IdIdMalph30ordermanager–interne Id der Adresse2FirmennameNameMalph200Anschrift Firmenname3ZusatzDescriptionKalph100Anschrift Firmenname Zusatz4StraßeStreetKalph1005PLZPostalCodeKalph206OrtCityKalph1007PLZ PostfachPostalCodePOBoxKalph208PostfachPOBoxKalph209LandCountryKalph6Ländercode nach ISO 3166-1:1997 („DE" für Dtl.)10TelefonPhoneKalph10011FaxFaxKalph10012MobiltelefonMobileKalph10013EmailEmailKalph20014WebWebKalph20015AnsprechpartnerContactKalph10016KommentarCommentKalph20017ILNILNKEAN13Internation Location Number18Zusatz 2Additional2Kstring200Enthält den Zusatz 2 der Adresse519HausnummerStreetNoKstring10520Umsatzsteuer-IdVatRegistrationNoKstring3512Die ID der Lieferadresse ist speziell bei der Nachricht „PurchaseOrderCreate" besonders wichtig. Mittels der ID wird das Objekt/Kostenstelle angegeben, zu dem der erstellte Auftrag zugewiesen werden soll. Wird der Auftrag zu einer neuen Lieferadresse, die noch nicht im ordermanager besteht, erstellt so muss in das Feld für die ID der Lieferadresse eine „0" eingetragen werden.

#FeldXML AttributMuß/ KannFormatmax. LängeBeschreibungVersion1IdIdMalph30ordermanager–interne Id der Adresse2FirmennameNameMalph200Anschrift Firmenname3ZusatzDescriptionKalph100Anschrift Firmenname Zusatz4StraßeStreetKalph1005PLZPostalCodeKalph206OrtCityKalph1007PLZ PostfachPostalCodePOBoxKalph208PostfachPOBoxKalph209LandCountryKalph6Ländercode nach ISO 3166-1:1997 („DE" für Dtl.)10TelefonPhoneKalph10011FaxFaxKalph10012MobiltelefonMobileKalph10013EmailEmailKalph20014WebWebKalph20015AnsprechpartnerContactKalph10016KommentarCommentKalph20017ILNILNKEAN13Internation Location Number18Zusatz 2Additional2Kstring200Enthält den Zusatz 2 der Adresse519HausnummerStreetNoKstring10520Umsatzsteuer-IdVatRegistrationNoKstring3512Die ID der Lieferadresse ist speziell bei der Nachricht „PurchaseOrderCreate" besonders wichtig. Mittels der ID wird das Objekt/Kostenstelle angegeben, zu dem der erstellte Auftrag zugewiesen werden soll. Wird der Auftrag zu einer neuen Lieferadresse, die noch nicht im ordermanager besteht, erstellt so muss in das Feld für die ID der Lieferadresse eine „0" eingetragen werden.

[data-colorid=je51qd0i9z]{color:#5f5f5f} html[data-color-mode=dark] [data-colorid=je51qd0i9z]{color:#a0a0a0}[data-colorid=rjbu66v7b6]{color:#5f5f5f} html[data-color-mode=dark] [data-colorid=rjbu66v7b6]{color:#a0a0a0}[data-colorid=jshkjaovmz]{color:#5f5f5f} html[data-color-mode=dark] [data-colorid=jshkjaovmz]{color:#a0a0a0}Positionsdatensätze enthalten die zu bestellenden Artikel. In der Regel enthält eine Position durch die Artikelnummer einen Verweis auf einen Artikel im Artikelstamm (Artikelposition), der dadurch bestellt wird. Artikelpositionen können vom Kunden um Anmerkungen ergänzt werden. Wenn in einer Position der Bezug zu einem Artikel fehlt, handelt es sich um eine Frei- oder Textposition, die nur einen vom Kunden angegeben freien Text enthält. Textpositionen enthalten keine Angaben zu Preisen oder Mehrwertsteuer, aber eine Menge.#FeldXML AttributMuß/ KannFormatmax. LängeBeschreibungVersion1Positionsnr.LineNumberMint laufende Nummer der Position beginnend bei 1 2PositionskennungLineIdentifierMint eindeutige Kennung der Position im ordermanager  Ist die Positionskennung nicht bekannt, so muss "0" eingetragen werden. 3Artikelnr.ArticleIdKalph30Wawi-interne Artikelnummer, wenn nicht angegeben, handelt es sich um eine Freiposition 4EANEANKEAN EAN des Artikels 5ArtikelbezeichnungArticleNameKalph200Bezeichnung des Artikels in der Wawi oder im ordermanager 6TextTextKalph200Ergänzender Text zur einer Artikelposition bzw. Zusatztext wenn Freiposition 7MengeQuantityMdez Menge 8EinheitUnitM/K*1alph100Einheit, auf die sich die Mengenangabe bezieht 9Netto-PreisPriceNetPerUnitM/K*1dez Netto-Preis einer Mengeneinheit der Position. Insbesondere bei Rückmeldungen an ordermanager  auszufüllen 10Netto-ZeilensummeLineTotalNetM/K*1dez Summe der Position inkl. aller Abzüge und Zuschläge 11MwSt-SatzVatPercentM/K*1dez in Prozent (z.B. „16.00") 12MwSt-BetragVatAmountM/K*1dez berechneter Betrag der Mehrwertsteuer 13LieferdatumDeliveryDateKdate In einer Bestellung das Datum, zu dem der Kunde die Auslieferung erwartet. In einer Rückmeldung an den ordermanager das vom Händler disponierte Datum für die Auslieferung. 14Lieferdatum bisDeliveryDateUntilKdate Endedatum eines möglichen Lieferzeitraums2 15StatusStatusKint32bitStatus-/Ergebniswert, der insbes. den Ausgang einer Anfrage wiedergibt. Defaultwert: 0 16Unece EinheitUneceUnitKalph3Einheit, auf die sich die Mengenangabe bezieht, als Unece-Code217Unece Einheit MengeUneceUnitQuantityKdez Anzahl der Unece Einheiten, auf die sich die Mengenangabe bezieht218Brutto-EinzelpreisPriceGrossPerUnitKDez Brutto-Preis einer Mengeneinheit, Preis inklusive Mwst319Brutto-ZeilensummeLineTotalGrossKDez Brutto-Zeilensumme der Bestellposition, Preis inklusive Mwst320ZeilenrabattRebatePercentKDez Zeilenrabatt5Es kann Positionen geben, die keine Artikelnummer, sondern nur im Feld Text eine Beschreibung der bestellten Leistung enthalten (Text-/Freiposition). Wenn eine Position eine Artikelnummer enthält, die in der Warenwirtschaft nicht gefunden wird, dann sollte die Position dennoch zumindest als Position ohne Artikel angelegt werden (diverse Artikelnummer o.ä.), um zu vermeiden, dass Informationen verloren gehen.Die Positionskennung wird beim Anlegen der Bestellung im ordermanager  erzeugt und bei allen Nachrichten an die Warenwirtschaft mit übermittelt. Die Warenwirtschaft muss diese ID mitführen und bei allen Nachrichten zurückliefern (z.B. PurchaseOrderModification). Bei der PurchaseOrderCreate-Nachricht muss dieses Feld eine „0" enthalten. *1 Angabe ist nicht erforderlich, wenn es sich um eine Freiposition in einer Nachricht vom Typ „PurchaseOrderSubmit" oder „PurchaseOrderResubmit" handelt.

Die Satzart Fußzeile enthält Angaben zu Zu- und Abschlägen, die sich auf den Netto-Gesamtbetrag der Bestellung beziehen.#FeldXML AttributMuß/ KannFormatmax. LängeBeschreibung1TypTypeMalph30Gibt an, um welche Art von Zu-/Abschlag es sich in dieser Zeile handelt: „adr" Gefahrgut, „transport" Transportkosten, „packing" Verpackung, „rebate" Rabatt, „fee" sonstiger Zuschlag „smallOrderSurcharge" Mindermengenzuschlag2BeschreibungTextKalph100Beschreibender Text zur Zeile. Kann ggf. die Berechnungsgrundlage für den Zu-/Abschlag enthalten3ProzentPercentKdez Auf-/Abschlag in Prozent relativ zur Netto-Summe der Positionswerte4Netto-BetragAmountNetKdez absoluter Auf-/Abschlag auf die Summe der Positionswerte5Netto-ZeilensummeLineTotalNetMdez Netto-Gesamt-Betrag der Zeile. Bei absoluten Wert im Feld Netto-Betrag gleich diesem Wert, sonst der berechnte Wert der Prozentangabe6MwSt-SatzVatPercentMdez in Prozent (z.B. „16.00")7MwSt-BetragVatAmountMdez berechneter Betrag der Mehrwertsteuer8Brutto-ZeilensummeLineTotalGrossKDez Brutto-Zeilensumme der Bestellposition, Preis inklusive MwstDie Liste der möglichen Werte im Feld Typ ist noch nicht endgültig und muss bei Bedarf erweitert werden.Die Zu-/Abschläge können entweder als Prozentwert vom Netto-Gesamtbetrag oder als fixer Netto-Betrag angegeben werden. Damit darf nur entweder das Feld Prozent oder das Feld Netto-Betrag ausgefüllt werden, aber nicht beide gleichzeitig. Die Betragsangaben bei Abschlägen, wie z.B. Rabatt, sollten mit negativem Vorzeichen angegeben werden, da sie von dem Gesamtbetrag der Bestellung abgezogen werden müssen.

[data-colorid=td0gamjd8s]{color:#5f5f5f} html[data-color-mode=dark] [data-colorid=td0gamjd8s]{color:#a0a0a0}#FeldXML AttributMuß/ KannFormatmax. LängeBeschreibung1BearbeiterEditorMalph100Der Bearbeiter, der den Kommentar erfasst hat2Datum/UhrzeitDateMdt Der Zeitpunkt, an dem der Kommentar erfasst worden ist3KommentarTextMalph200KommentarIn Kommentaren, die von der Warenwirtschaft an den ordermanager übertragen werden, kann als Bearbeiter auch die Benutzerkennung oder –nummer eingetragen werden, die der Sachbearbeiter beim Händler zur Anmeldung an der Warenwirtschaft verwendet. Dazu müssen aber in der Benutzerverwaltung des ordermanager  die dazugehörigen Benutzer angelegt sein und diese Kennungen oder Nummern in dem dafür vorgesehenen Feld hinterlegt