PurchaseOrderSubmit

Beispiele

NachrichtentypFormatVersionLink
PurchaseOrderSubmitCSV10PurchaseOrderSubmit1342_1986.csv
PurchaseOrderSubmitXML10PurchaseOrderSubmit1341_1986.xml

Beschreibung

 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
Aktuelle Version: 3

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.

 Bestellung - Identifikation - Häufigkeit: 1

Diese Satzart enthält Informationen, um die Bestellung, zu der die Nachricht gehört, eindeutig zu identifizieren.
#

Feld

XML Attribut

Muß/
Kann

Format

max. Länge

Beschreibung

1

Id

Id

M/K*1

alph

30

ordermanager–interne Id der Bestellung

2

Auftragsnr.

VendorOrderCode

M/K

alph

30

Wawi-interne Auftragsnummer

Die Wawi-interne Auftragsnummer muss in der ersten Rückmeldung der Warenwirtschaft an ordermanager nach der Meldung „PurchaseOrderSubmit" übermittelt werden und ist ab dann zusammen mit der ordermanager-internen Id in jeder Nachricht enthalten.
*1 Angabe ist nicht erforderlich bei Nachrichten vom Typ „PurchaseOrderCreate".

 Bestellung - Kopf - Häufigkeit: 1


#

Feld

XML Attribut

Muß/
Kann

Format

max. Länge

Beschreibung

Version

1

Erstelldatum

CreateDate

M

date


Datum der Erzeugung der Bestellung.


2

Freigabedatum

ApproveDate

K

date


Datum, an dem die Bestellung den Kunden-internen Freigabeprozess durchlaufen hat


3

Kundennr.

CustomerId

M

alph

30

Wawi-interne Nummer des Kunden


4

Bestellnr. Des Kunden

CustomersOrderCode

K

alph

100

Nummer/Kennung, die der Kunde ggf. für die Bestellung vergeben hat


5

Lieferdatum

DeliveryDate

K

date


bei PurchaseOrderSubmit:
vom Kunden vorgegebenes Wunschlieferdatum.

bei PurchaseOrderAccept: 
vom Händler bestätigtes Lieferdatum


6

Lieferdatum bis

DeliveryDateUntil

K

date


Endedatum eines möglichen Lieferzeitraums

 2

7

Währung

Currency

M

alph

3

Kurzzeichen für Währung der Bestellung nach ISO-4217:1995; zunächst immer „EUR"


8

Prozessstatus

ProcessState

K

int

32bit

ordermanager–interne Kennung für den Zustand, in dem sich die Bestellung befindet


9

Status

State

K

alph

20

Kennung für das Ergebnis einer Anfrage oder den Zustand des Auftrags aus Sicht der Wawi


10

Flags

Flags

K

int

32bit

Defaultwert: 0


11

Kommentar

Comment

K

alph

500

Kommentar vom Kunden für den Händler


12

Bearbeiter

Editor

K

alph

100

Besteller auf Seiten des Kunden


13

Teillieferung

PartialDelivery

K

Bool


Gibt an ob Teillieferung gewünscht ist

2

14

Lieferdatum-hinweis

DeliveryDateHint

K

Alph

100

Gibt an, wie das angegebene Lieferdatum zu verstehen ist z.b. „Lieferung bis", „Fixtermin", etc. Hier kann aber auch Lieferroute übergeben werden.

2

15

Fälligkeitsdatum

Executiondate

K

Date


Gibt an, wann die Zahlung fällig ist.

2

16

Bezahlverfahren

PaymentMethod

K

Alph

50

Gibt die Hauptmethode an, wie der Kunde bezahlen möchte bzw, bereits bezahlt hat. Ist dies Feld leer wird Rechnung angenommen. Siehe Liste der möglichen Bezahlverfahren unten.

2

17

Netto-Betrag

TotalNet

K

dez


Netto-Betrag der Rechnung

3

18

MwSt-Betrag

TotalVatAmount

K

dez


Betrag der Mehrwertsteuer

3

19

Brutto-Betrag

TotalGross

K

Dez


Brutto Gesamtsumme der Bestellung inklusive Mwst.

3

20VersandartShippingMethodKalph100Externe Nummer der Versandart7


Liste der STANDARD Bezahlverfahren:


invoice

Rechnung (Standard wenn nicht angegeben)

debitentrymanually

Manuelle Lastschrift durch Händler

debitentry

Elektronische Lastschrift direkt per Online-Dienstleister

creditcard

Kreditkarte

paypal

PayPal

banktransfer

Manuelle Überweisung durch den Kunden

banktransferonline

Online Überweisung direkt per Online-Dienstleister

 
Weitere Bezahlverfahren können individuell definiert werden. Da das Feld Bezahlverfahren auch in anderen Nachrichtentypen außer PurchaseOrderSubmit vorkommt, kann dieses Feld in diesen Nachrichtentypen ignoriert werden.

 Bestellung - Zuständiger Händler - Häufigkeit: 0..1

In der Satzart Zuständiger Händler wird die Nummer des Händlers, an den sich die Bestellung richtet, übermittelt. Diese Information ist nur dann relevant, wenn eine Instanz einer Warenwirtschaft mehrere Händler (z.B. mehrere Filialen) abdeckt. Dadurch kann diese Satzart in der Regel ignoriert werden. Die Weiterleitung einer Nachricht an die richtige Warenwirtschaft kann außerdem auch über die Felder Sender und Empfänger im Kopf der Nachricht erreicht werden.

#

Feld

XML-Attribut

Muß/
Kann

Format

max. Länge

Beschreibung

1

Id

Id

M

alph

30

ordermanager -interne Kennung des Händlers, der für die Bearbeitung der Bestellung zuständig ist.

 

 Bestellung - Zuständiger Lieferant - Häufigkeit: 0..1 - ab Version 5

In der Satzart Zuständiger Lieferant wird die Nummer des Lieferanten, an den sich die Bestellung richtet, übermittelt. Diese Satzart wird nur dann genutzt, wenn es sich um einen ordermanager im Lieferantenmodus handelt.

#

Feld

XML-Attribut

Muß/
Kann

Format

max. Länge

Beschreibung

1SupplierNumber

SupplierNumber

M

alph

50

Nummer des Lieferanten.

 

 Bestellung - Strukturelement - Häufigkeit: 0..1

CSV-Kennung: POE
XML-Tag: PurchaseOrderStructureItem

In 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.

#

Feld

XML Attribut

Muß/
Kann

Format

max. Länge

Beschreibung

1

Nummer 1

Number1

K

alph

30

Feld "Kostenstelle" aus dem ordermanager

2

Nummer 2

Number2

K

alph

30

Feld "Weitere Nummer" aus dem ordermanager

3

hierarchischer Pfad

Path

M

alph

300

Pfad 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)

 Bestellung - Rechnungsadresse (Adresse) - Häufigkeit: 1


#

Feld

XML Attribut

Muß/
Kann

Format

max. Länge

Beschreibung

Version
1

Id

Id

M

alph

30

ordermanager–interne Id der Adresse


2

Firmenname

Name

M

alph

200

Anschrift Firmenname


3

Zusatz

Description

K

alph

100

Anschrift Firmenname Zusatz


4

Straße

Street

K

alph

100



5

PLZ

PostalCode

K

alph

20



6

Ort

City

K

alph

100



7

PLZ Postfach

PostalCodePOBox

K

alph

20



8

Postfach

POBox

K

alph

20



9

Land

Country

K

alph

6

Ländercode nach ISO 3166-1:1997 („DE" für Dtl.)


10

Telefon

Phone

K

alph

100



11

Fax

Fax

K

alph

100



12

Mobiltelefon

Mobile

K

alph

100



13

Email

Email

K

alph

200



14

Web

Web

K

alph

200



15

Ansprechpartner

Contact

K

alph

100



16

Kommentar

Comment

K

alph

200



17

ILN

ILN

K

EAN

13

Internation Location Number


18Zusatz 2Additional2Kstring200Enthält den Zusatz 2 der Adresse5
19HausnummerStreetNoKstring10
5
20Umsatzsteuer-IdVatRegistrationNoKstring35
12


Die 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.

 Bestellung - Lieferadresse (Adresse) - Häufigkeit: 1


#

Feld

XML Attribut

Muß/
Kann

Format

max. Länge

Beschreibung

Version
1

Id

Id

M

alph

30

ordermanager–interne Id der Adresse


2

Firmenname

Name

M

alph

200

Anschrift Firmenname


3

Zusatz

Description

K

alph

100

Anschrift Firmenname Zusatz


4

Straße

Street

K

alph

100



5

PLZ

PostalCode

K

alph

20



6

Ort

City

K

alph

100



7

PLZ Postfach

PostalCodePOBox

K

alph

20



8

Postfach

POBox

K

alph

20



9

Land

Country

K

alph

6

Ländercode nach ISO 3166-1:1997 („DE" für Dtl.)


10

Telefon

Phone

K

alph

100



11

Fax

Fax

K

alph

100



12

Mobiltelefon

Mobile

K

alph

100



13

Email

Email

K

alph

200



14

Web

Web

K

alph

200



15

Ansprechpartner

Contact

K

alph

100



16

Kommentar

Comment

K

alph

200



17

ILN

ILN

K

EAN

13

Internation Location Number


18Zusatz 2Additional2Kstring200Enthält den Zusatz 2 der Adresse5
19HausnummerStreetNoKstring10
5
20Umsatzsteuer-IdVatRegistrationNoKstring35
12


Die 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.

 Bestellung - Position - Häufigkeit: 1..*

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.
#

Feld

XML Attribut

Muß/
Kann

Format

max. Länge

Beschreibung

Version

1

Positionsnr.

LineNumber

M

int


laufende Nummer der Bestellposition beginnend bei 1


2

Positionskennung

LineIdentifier

M

int


eindeutige Kennung der Position im ordermanager.
Ist die Positionskennung nicht bekannt, so muss "0" eingetragen werden.


3

Artikelnr.

ArticleId

K

alph

30

Wawi-interne Artikelnummer, wenn nicht angegeben, handelt es sich um eine Freiposition


4

EAN

EAN

K

EAN


EAN des Artikels


5

Artikelbezeichnung

ArticleName

K

alph

200

Bezeichnung des Artikels in der Wawi oder im ordermanager 


6

Text

Text

K

alph

200

Ergänzender Text zur einer Artikelposition bzw. Zusatztext wenn Freiposition


7

Menge

Quantity

M

dez


Menge


8

Einheit

Unit

M/K*1

alph

100

Einheit, auf die sich die Mengenangabe bezieht


9

Netto-Preis

PriceNetPerUnit

M/K*1

dez


Netto-Preis einer Mengeneinheit der Bestellposition. Insbesondere bei Rückmeldungen an ordermanager  auszufüllen


10

Netto-Zeilensumme

LineTotalNet

M/K*1

dez


Summe der Bestellposition inkl. aller Abzüge und Zuschläge


11

MwSt-Satz

VatPercent

M/K*1

dez


in Prozent (z.B. „16.00")


12

MwSt-Betrag

VatAmount

M/K*1

dez


berechneter Betrag der Mehrwertsteuer


13

Lieferdatum

DeliveryDate

K

date


Für PurchaseOrderSubmit, PurchaseOrderResubmit, PurchaseOrderModification, PurchaseOrderCreate:
In einer Bestellung das Datum, zu dem der Kunde die Auslieferung erwartet.

PurchaseOrderAccept:
In einer Rückmeldung an den ordermanager  das vom Händler disponierte Datum für die Auslieferung.


14

Lieferdatum bis

DeliveryDateUntil

K

date


wird nur in PurchaseOrderAccept berücksichtigt.

Endedatum eines möglichen disponierten Lieferzeitraums.

2

15

Status

Status

K

int

32bit

Status-/Ergebniswert, der insbes. den Ausgang einer Anfrage wiedergibt.
Defaultwert: 0


16

Unece Einheit

UneceUnit

K

alph

3

Einheit, auf die sich die Mengenangabe bezieht, als Unece-Code

2

17

Unece Einheit Menge

UneceUnitQuantity

K

dez


Anzahl der Unece Einheiten, auf die sich die Mengenangabe bezieht

2

18

Brutto-Einzelpreis

PriceGrossPerUnit

K

Dez


Brutto-Preis einer Mengeneinheit, Preis inklusive Mwst

3

19

Brutto-Zeilensumme

LineTotalGross

K

Dez


Brutto-Zeilensumme der Bestellposition, Preis inklusive Mwst

3

20ZeilenrabattRebatePercentKDez
Zeilenrabatt5


Es kann Positionen geben, die keine Artikelnummer, sondern nur im Feld Text eine Beschreibung der bestellten Leistung enthalten (Text-/Freiposition).
Wenn eine Bestellposition 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.

 Bestellung - Fußzeile - Häufigkeit: 0..*

Die Satzart Fußzeile enthält Angaben zu Zu- und Abschlägen, die sich auf den Netto-Gesamtbetrag der Bestellung beziehen.
#

Feld

XML Attribut

Muß/
Kann

Format

max. Länge

Beschreibung

Version
1

Typ

Type

M

alph

30

Gibt 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" Mindermengenzuschlag
"addTransport" Frachtkostenzuschlag
"transport-article" Versandkostenartikel

 
2

Beschreibung

Text

K

alph

1000

Beschreibender Text zur Zeile. Kann ggf. die Berechnungsgrundlage für den Zu-/Abschlag enthalten

 
3

Prozent

Percent

K

dez

 

Auf-/Abschlag in Prozent relativ zur Netto-Summe der Positionswerte

 
4

Netto-Betrag

AmountNet

K

dez

 

Auf-/Abschlag auf die Summe der Positionswerte

 
5

Netto-Zeilensumme

LineTotalNet

M

dez

 

Netto-Gesamt-Betrag der Zeile. Bei Wert im Feld Netto-Betrag gleich diesem Wert, sonst der berechnte Wert der Prozentangabe.
Handelt es sich um einen Abschlag wie z.b. Rabatt, so muss der Betrag mit negativem Vorzeichen angegeben werden.

 
6

MwSt-Satz

VatPercent

M

dez

 

in Prozent (z.B. „19.00")

 
7

MwSt-Betrag

VatAmount

M

dez

 

berechneter Betrag der Mehrwertsteuer.
Handelt es sich um einen Abschlag wie z.b. Rabatt, so muss der Betrag mit negativem Vorzeichen angegeben werden.

 
8

Brutto-Zeilensumme

LineTotalGross

K

Dez

 

Brutto-Zeilensumme der Bestellposition, Preis inklusive Mwst
Handelt es sich um einen Abschlag wie z.b. Rabatt, so muss der Betrag mit negativem Vorzeichen angegeben werden.

3
9Externe IDExternalIdKalph254z.B. WaWi Artikelnummer für Frachtpositionen10


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.

 Kommentar - Häufigkeit: 0..1

#

Feld

XML Attribut

Muß/
Kann

Format

max. Länge

Beschreibung

1

Bearbeiter

Editor

M

alph

100

Der Bearbeiter, der den Kommentar erfasst hat

2

Datum/Uhrzeit

Date

M

dt

 

Der Zeitpunkt, an dem der Kommentar erfasst worden ist

3

Kommentar

Text

M

alph

200

Kommentar

In 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

 Bezahlverfahren - Häufigkeit: 0..* - ab Version 4

#

Feld

XML Attribut

Muß/
Kann

Format

max. Länge

Beschreibung

1

Bezahlverfahren

PaymentMethod

M

alph

50

Bezahlverfahren
Siehe Liste der möglichen Bezahlverfahren oben.

2

BruttoWert

AmountGros

M

dez

 

Wert, der mit dem Bazahlverfahren bezahlt wurde

 Tags - Häufigkeit: 0..* - ab Version 4

#

Feld

XML Attribut

Muß/
Kann

Format

max. Länge

Beschreibung

1

Name

Name

M

Alph

200

Name des Tags