HRDELIVERY Vers. 2.1 – Eingangslieferscheine

Verfahren

HRDELIVERY in der Version 2.1 ist ein XML basiertes Austauschverfahren für Lieferscheine. In der Version 1.0 steht ein Text-Format zur Verfügung, welches auch von anderen Warenwirtschaftssystemen benutzt wird.

Für neue Schnittstellen verwenden Sie bitte die Version 2.1 insbesondere dann, wenn gleichzeitig HRORDER zum Einsatz kommen soll. Die Version 1.0 wird aus kompatibilitätsgründen weiterhin unterstützt, jedoch nicht weiterentwickelt.

Die Schnittstelle in Vers. 2.1 ist abwärtskompatibel zu Vers. 2.0.

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- als auch den Positionsdaten können eindeutige IDs übergeben werden, welche bei gleichzeitiger Nutzung der HRORDER Schnittstelle bereitgestellt worden sind.

Aufbau HRDELIVERY Version 2.1

Die Struktur HRDELIVERY besteht aus

• dem Tag „Format“, das genau einmal pro Datei vorhanden sein muss.

• dem Tag „Delivery“, das den Lieferungskopfssatz darstellt und einmal pro Lieferung vorhanden ist

• dem Tag „DeliveryPos“, welches die einzelnen Lieferpositionen auflistet

Ab MBS5 Version 2.6.0.1840 kann das Tag HRDELIVERY ein optionales Währungskennzeichen enthalten: das Attribut currency=“<ISO 4217 Kürzel der Währung; Alpha-3>“, z.B. „EUR“ oder „USD“. Wenn die Mehrwährungsfähigkeit in MBS5 aktiviert ist und das Kennzeichen in der Datei vorhanden ist, wird geprüft, ob die Währung mit der des Lieferanten übereinstimmt. Falls nicht, wird der Import mit einer Fehlermeldung abgebrochen. Ist kein Währungskennzeichen in der Datei angegeben, wird die in MBS5 eingestellte Währung des Lieferanten verwendet.

Aufbau FORMAT

Aufbau DELIVERY

^*) kann bei Übergabe der Lieferanten ID entfallen

Aufbau DELIVERYPOS

1. Kann bei Angabe der ArtikelID entfallen

2. Kann bei Angabe der EinheitID entfallen

Beispieldatei HRDELIVERY 2.1

<?xml version='1.0' encoding='iso-8859-1' standalone='yes' ?>

<HRDELIVERY currency="EUR">

<Format>

<HRInterface>HRDELIVERY</HRInterface>

<HRInterfaceVersion>2.1</HRInterfaceVersion>

<ErstellDatum>2011-10-13</ErstellDatum>

</Format>

<Delivery>

<LieferantID/>

<LieferantNr/>

<LieferantName1>GV-Lieferant</LieferantName1>

<KundeNr>12345678</KundeNr>

<LieferscheinNr>987654321</LieferscheinNr>

<LieferscheinDatum>2009-12-30</LieferscheinDatum>

</Delivery>

<DeliveryPos>

<LieferscheinNr>1288821</LieferscheinNr>

<LieferscheinPos>0003</LieferscheinPos>

<LieferantArtikelNr>10350515</LieferantArtikelNr>

<KundeArtikelNr/>

<ArtikelReferenzNr>1212</ArtikelReferenzNr>

<OrderNr>120050794281008163</OrderNr>

<ArtikelBez>TK Apfel Rührteig 1650g</ArtikelBez>

<ArtikelID/>

<Menge>3,000</Menge>

<Einheit>ST</Einheit>

<EinheitID/>

<PosPreisNetto>31,350</PosPreisNetto>

<EANBestelleinheit/>

<Anbruch>0</Anbruch>

<BLSSchluessel/>

</DeliveryPos>

<DeliveryPos>

<LieferscheinNr>1288821</LieferscheinNr>

<LieferscheinPos>0004</LieferscheinPos>

<LieferantArtikelNr>10438183</LieferantArtikelNr>

<KundeArtikelNr/>

<ArtikelReferenzNr/>

<OrderNr>120050794281008163</OrderNr>

<ArtikelBez>TK Kirschstreusel 2500g</ArtikelBez>

<ArtikelID/>

<Menge>1,000</Menge>

<Einheit>KT</Einheit>

<EinheitID/>

<PosPreisNetto>27,600</PosPreisNetto>

<EANBestelleinheit/>

<Anbruch>0</Anbruch>

<BLSSchluessel/>

</DeliveryPos>

</HRDELIVERY>

HRDELIVERY Vers. 1.0 – Eingangslieferscheine

Satzformat und Konventionen

Das Dateiformat des Lieferscheinimports ist kompatibel zum Lieferscheinimport der Delegate Software AG (Vers. 1.04 vom 22.03.2004).

Die Daten müssen in einer Textdatei mit variabler Satzlänge vorliegen. Der Zeichensatz ist WindowsANSI. Als Feldtrennzeichen wird Semikolon (;) benutzt, das Dezimaltrennzeichen ist Komma (,).

Alphanumerische Felder (Typ A) werden in Anführungszeichen („) eingefasst. Numerische Felder (Typ N) werden mit Dezimalkomma angegeben ohne weitere Formatierungszeichen (keine Tausenderpunkte, keine Währung o. ä.). Datumsfelder (Typ D) werden im Format yyyymmdd erwartet.

Ein „muss“ in der Spalte Status zeigt an, das die Angabe des jeweiligen Wertes obligatorisch ist. Fehlt ein Wert, wird die Schnittstelle die Datei zurückweisen.

Ein „kann“ signalisiert die optionale Angabe der Daten. Soll keine Angabe erfolgen muss das Feld übersprungen werden, d. h. es ist in jedem Fall das Feldtrennzeichen erforderlich. Beispiel: leeres Feld zwischen Mehl und 1,23: „Mehl“;;1,23

Satzformat

Aus Kompatibilitätsgründen enthält die Schnittstelle mehr Datenfelder, als in MBS5 verarbeitet werden. Die nicht benutzten Felder enthalten in der Spalte „Status“ den Text „nicht benutzt“ und sind in grauer Schrift abgesetzt. Beachten Sie bitte, dass diese Felder in der Datei dennoch vorhanden sein müssen (z. B. als Leerfeld), sie werden von MBS5 lediglich nicht ausgewertet!

Die optionalen Felder Nr. 47 und 48 sind nur in MBS5 nutzbar.