HRORDER - Lieferantenbestellungen
HRORDER – Lieferantenbestellungen
Dateiformat und Konventionen
Lieferantenbestellungen werden über eine XML-Datei ausgetauscht, deren Formatbeschreibung in den nächsten Abschnitten folgt.
Alphanumerische Felder (Typ A) werden ohne Anführungszeichen übertragen. Numerische Felder (Typ N) werden mit Dezimalpunkt angegeben ohne weitere Formatierungszeichen (keine Tausenderpunkte, keine Währung o. ä.). Datumsfelder (Typ D) werden im Format yyyy-mm-dd erwartet.
Ein „Muss“ in der Spalte Status zeigt an, das die Angabe des jeweiligen Wertes obligatorisch ist.
Ein „Kann“ signalisiert die optionale Angabe der Daten, wobei das Tag mit leerem Inhalt übergeben oder auch ganz weggelassen werden kann.
Sowohl in den Kopf- und den Positionsdaten werden eindeutige IDs mit übergeben, die für den Import der Lieferscheindaten in MBS5 erforderlich sind, wenn auch die HRDELIVERY-Schnittstelle zum Einsatz kommt.
Aufbau HRORDER Version 1.3 (MBS) und 2.0 (cloudMenu)
Die Struktur HRORDER besteht aus
dem Tag „Format“, das genau einmal pro Datei vorhanden sein muss.
dem Tag „Order“, das den Bestellkopfssatz darstellt und einmal pro Bestellung vorhanden ist (mehrere Bestellungen sind möglich)
dem Tag „OrderPos“, welches die einzelnen Bestellpositionen auflistet
Das HRORDER-Tag enthält ab MBS5-Version 2.6.0.1839 das Attribut „currency=“<ISO 4217 Kürzel der Währung; Alpha-3>“, z.B. „EUR“ oder „USD“ mit der Währung des Lieferanten. Bei aktivierter Mehrwährungsfähigkeit in MBS5 kann ein Lieferant eine von der Systemwährung abweichende Währung haben, andernfalls wird die Systemwährung ausgegeben.
Aufbau FORMAT Version 1.3
Tag | Typ | Länge | Status | Beschreibung | Beispiel |
HRInterface | A | 20 | Muss | Kennzeichnung des Schnittstellentyps, konstant | HRORDER |
HRInterfaceVersion | A | 2 | Muss | Kennzeichnung der Schnittstellenversion, konstant | 1.3 |
ErstellDatum | D | 10 | Kann | Erstellungsdatum der Datei JJJJ-MM-TT | 2011-10-13 |
|
|
|
|
|
|
Aufbau ORDER Version 1.3
Tag | Typ | Länge | Status | Beschreibung | Beispiel |
OrderNr | A | 25 | Muss | Bestellnummer | ABC12345 |
OrderDatum | D | 10 | Kann | Bestelldatum JJJJ-MM-TT | 2005-01-17 |
LieferantName1 | A | 35 | Muss | Name und Adresse des Lieferanten |
|
LieferantName2 | A | 35 | Kann | „ |
|
LieferantStrasse | A | 35 | Kann | „ |
|
LieferantPlz | A | 5 | Muss | „ |
|
LieferantOrt | A | 35 | Muss | „ |
|
LieferantNr | A | 15 | Muss | Nummer des Lieferanten in MBS5 |
|
LieferantID | N | INT | Muss | ID des Lieferanten in MBS5 für die Übergabe von Lieferscheindaten bei Nutzung von HRDELIVERY | 1234 |
KundeNr | A | 20 | Kann | Kundennummer beim Lieferanten |
|
KundeName1 | A | 35 | Muss | Lieferanschrift des Kunden |
|
KundeName2 | A | 35 | Kann | „ |
|
KundeStrasse | A | 35 | Kann | „ |
|
KundePlz | A | 5 | Muss | „ |
|
KundeOrt | A | 35 | Muss | „ |
|
RechKundeName1 | A | 35 | Kann | Rechnungsanschrift des Kunden |
|
RechKundeName2 | A | 35 | Kann | „ |
|
RechKundeStrasse | A | 35 | Kann | „ |
|
RechKundePlz | A | 5 | Kann | „ |
|
RechKundeOrt | A | 35 | Kann | „ |
|
Notiz | A | 254 | Kann | Bemerkungen zur Bestellung |
|
|
|
|
|
|
|
Aufbau ORDERPOS Version 1.3
Tag | Typ | Länge | Status | Beschreibung | Beispiel |
OrderNr | A | 25 | Muss | Bestellnummer (korrespondierend zu einem ORDER- Eintrag) | ABC1234 |
OrderPos | N | 4 | Muss | fortlaufende Position innerhalb der Bestellung | 1 |
LieferantenArtikelNr | A | 18 | Kann | Artikelnummer des Lieferanten |
|
KundeArtikelNr | A | 18 | Kann | Artikelnummer des Kunden |
|
ArtikelReferenzNr | A | 40 | Kann | Artikelreferenz Nr. (z. B. Händler- oder Herstellernr.) |
|
ArtikelBez | A | 40 | Muss |
|
|
ArtikelID | N | INT | Kann | ID des Artikels in MBS5 für die Übergabe der Lieferscheindaten bei Nutzung von HRDELIVERY |
|
Menge | N | 8,3 | Muss |
| 2.000 |
Einheit | A | 8 | Muss | Bestelleinheit | Karton |
EinheitID | N | INT | Kann | ID der Einheit in MBS5 für die Übergabe der Lieferscheindaten bei Nutzung von HRDELIVERY |
|
MengeInLagerEinheit | N | 8,3 | Kann | Feld <Menge> umgerechnet in die dem Artikel zu Grunde liegenden Lagereinheit. Nicht Inhalt eines Gebindes sondern die gesamte Bestellmenge umgerechnet auf Lagereinheiten! | 24.000 |
LagerEinheit | A | 8 | Kann | Lagereinheit als Text | Stk |
LagerEinheitId | N | INT | Kann | ID der Einheit in MBS5 für die Übergabe der Lieferscheindaten bei Nutzung von HRDELIVERY |
|
Liefgebindeeinheit | A | 20 | Kann | Gebindeeinheit des Lieferanten, wenn sie in MBS5 gesondert geführt wird. | Kart |
Liefbasiseinheit | A | 20 | Kann | Einheit des Gebindeinhalts des Lieferanten, wenn sie in MBS5 gesondert geführt wird. | Stck |
LiefgebindeInhalt | N | 11,3 | Kann | Gebindeinhalt des Lieferanten, wenn er in MBS5 gesondert geführt wird. | 24.000 |
PosPreisNetto | N | 11,3 | Muss | Gesamt-Nettopreis der Position (Menge * Einzelpreis) | 13.500 |
LieferDatum | D | 10 | Muss | Anlieferdatum für diese Position | 2005-01-17 |
Notiz | A | 254 | Kann | Notiz zu dieser Position |
|
|
|
|
|
|
|
Die Bestellung wird ausgeführt als <Menge> und <Einheit> (z. B. 2 Kartons), da diese Informationen auch beim späteren Import über HRDELIVERY benötigt werden. Die Felder <MengeInLagerEinheit> und <LagerEinheit> dienen der genaueren Spezifikation der Bestelleinheit, um Missverständnisse beim Lieferanten zu vermeiden (z. B. bei unterschiedlichen Kartongrößen). Sind Lager- und Bestelleinheit identisch werden die Bestellung in Lagereinheiten nicht mit gesendet.
Beispieldatei HRORDER Version 1.3
<?xml version="1.0" standalone="yes"?>
<HRORDER currency="EUR">
<Format>
<HRInterface>HRORDER</HRInterface>
<HRInterfaceVersion>1.3</HRInterfaceVersion>
<ErstellDatum>2011-10-13</ErstellDatum>
</Format>
<Order>
<OrderNr>104</OrderNr>
<OrderDatum>2005-01-21</OrderDatum>
<LieferantName1>Fische und Mehr GmbH</LieferantName1>
<LieferantName2></LieferantName2>
<LieferantStrasse>Hildesheimer Str. 197</LieferantStrasse>
<LieferantPlz>30715</LieferantPlz>
<LieferantOrt>Hannover</LieferantOrt>
<LieferantNr>4242</LieferantNr>
<LieferantID>4711</LieferantID>
<KundeNr>999912345</KundeNr>
<KundeName1>Herrlich & Ramuschkat GmbH</KundeName1>
<KundeName2></KundeName2>
<KundeStrasse>Vahrenwalder Str. 156</KundeStr>
<KundePlz>30165</KundePlz>
<KundeOrt>Hannover</KundeOrt>
<Notiz>Hier stehen bei Bedarf weitere Informationen zur Bestellung; z.
B. Kundenadresse ist Lieferanschrift</Notiz>
</Order>
<OrderPos>
<OrderNr>104</OrderNr>
<OrderPos>1</OrderPos>
<LieferantenArtikelNr>234567</LieferantenArtikelNr>
<KundeArtikelNr>AF123</KundeArtikelNr>
<ArtikelReferenzNr>18912</ArtikelReferenzNr> <ArtikelBez>Schweineschnitzel</ArtikelBez>
<ArtikelID>42</ArtikelID>
<Menge>2.000</Menge>
<Einheit>Kart</Einheit>
<EinheitID>1</EinheitID>
<MengeInLagerEinheit>24</MengeInLagerEinheit>
<LagerEinheit>Stk</LagerEinheit>
<LagerEinheitID>42</LagerEinheitID>
<PosPreisNetto>17.030</PosPreisNetto>
<LieferDatum>2005-01-25</LieferDatum>
<Notiz></Notiz>
</OrderPos>
<OrderPos>
<OrderNr>104</OrderNr>
<OrderPos>2</OrderPos>
<LieferantenArtikelNr>234111</LieferantenArtikelNr>
<KundeArtikelNr>AF129</KundeArtikelNr>
<ArtikelReferenzNr>1212</ArtikelReferenzNr>
<ArtikelBez>Schweinefilet</ArtikelBez>
<ArtikelID>424242</ArtikelID>
<Menge>10.000</Menge>
<Einheit>Kg</Einheit>
<EinheitID>1</EinheitID>
<PosPreisNetto>200.030</PosPreisNetto> <LieferDatum>2005-01-25</LieferDatum>
<Notiz></Notiz>
</OrderPos>
<OrderPos>
<OrderNr>104</OrderNr>
<OrderPos>3</OrderPos>
<LieferantenArtikelNr>234791</LieferantenArtikelNr>
<KundeArtNr>AF678</KundeArtNr>
<ArtikelBez>Schweineschulter</ArtikelBez>
<ArtikelID>49</ArtikelID>
<Menge>10.000</Menge>
<Einheit>Kg</Einheit>
<EinheitID>1</EinheitID>
<PosPreisNetto>200.030</PosPreisNetto>
<LieferDatum>2005-01-27</LieferDatum>
<Notiz>Achtung, anderes Lieferdatum</Notiz>
</OrderPos>
</HRORDER>
Aufbau FORMAT Version 2.0
Tag | Typ | Länge | Status | Beschreibung | Beispiel |
HRInterface | A | 20 | Muss | Kennzeichnung des Schnittstellentyps, konstant | HRORDER |
HRInterfaceVersion | A | 2 | Muss | Kennzeichnung der Schnittstellenversion, konstant | 2.0 |
ErstellDatum | D | 10 | Kann | Erstellungsdatum der Datei JJJJ-MM-TT | 2011-10-13 |
Aufbau ORDER Version 2.0
Tag | Typ | Länge | Status | Beschreibung | Beispiel |
OrderNr | A | 25 | Muss | Bestellnummer | ABC12345 |
OrderDatum | D | 10 | Kann | Bestelldatum JJJJ-MM-TT | 2005-01-17 |
LieferantName1 | A | 35 | Muss | Name und Adresse des Lieferanten |
|
LieferantName2 | A | 35 | Kann | „ |
|
LieferantStrasse | A | 35 | Kann | „ |
|
LieferantPlz | A | 5 | Muss | „ |
|
LieferantOrt | A | 35 | Muss | „ |
|
LieferantNr | A | 15 | Muss | Nummer des Lieferanten in MBS5 |
|
KundeNr | A | 20 | Kann | Kundennummer beim Lieferanten |
|
KundeName1 | A | 35 | Muss | Lieferanschrift des Kunden |
|
KundeName2 | A | 35 | Kann | „ |
|
KundeStrasse | A | 35 | Kann | „ |
|
KundePlz | A | 5 | Muss | „ |
|
KundeOrt | A | 35 | Muss | „ |
|
RechKundeName1 | A | 35 | Kann | Rechnungsanschrift des Kunden |
|
RechKundeName2 | A | 35 | Kann | „ |
|
RechKundeStrasse | A | 35 | Kann | „ |
|
RechKundePlz | A | 5 | Kann | „ |
|
RechKundeOrt | A | 35 | Kann | „ |
|
Notiz | A | 254 | Kann | Bemerkungen zur Bestellung |
|
Aufbau ORDERPOS Version 2.0
Tag | Typ | Länge | Status | Beschreibung | Beispiel |
OrderNr | A | 25 | Muss | Bestellnummer (korrespondierend zu einem ORDER- Eintrag) | ABC1234 |
OrderPos | N | 4 | Muss | fortlaufende Position innerhalb der Bestellung | 1 |
LieferantenArtikelNr | A | 18 | Kann | Artikelnummer des Lieferanten |
|
KundeArtikelNr | A | 18 | Kann | Artikelnummer des Kunden |
|
ArtikelReferenzNr | A | 40 | Kann | Artikelreferenz Nr. (z. B. Händler- oder Herstellernr.) |
|
ArtikelBez | A | 40 | Muss |
|
|
Menge | N | 8,3 | Muss |
| 2.000 |
Einheit | A | 8 | Muss | Bestelleinheit | Karton |
MengeInLagerEinheit | N | 8,3 | Kann | Feld <Menge> umgerechnet in die dem Artikel zu Grunde liegenden Lagereinheit. Nicht Inhalt eines Gebindes sondern die gesamte Bestellmenge umgerechnet auf Lagereinheiten! | 24.000 |
LagerEinheit | A | 8 | Kann | Lagereinheit als Text | Stk |
Liefgebindeeinheit | A | 20 | Kann | Gebindeeinheit des Lieferanten, wenn sie in MBS5 gesondert geführt wird. | Kart |
Liefbasiseinheit | A | 20 | Kann | Einheit des Gebindeinhalts des Lieferanten, wenn sie in MBS5 gesondert geführt wird. | Stck |
LiefgebindeInhalt | N | 11,3 | Kann | Gebindeinhalt des Lieferanten, wenn er in MBS5 gesondert geführt wird. | 24.000 |
PosPreisNetto | N | 11,3 | Muss | Gesamt-Nettopreis der Position (Menge * Einzelpreis) | 13.500 |
LieferDatum | D | 10 | Muss | Anlieferdatum für diese Position | 2005-01-17 |
Notiz | A | 254 | Kann | Notiz zu dieser Position |
|