HRPRICAT Vers. 3.7 – Artikel und Preise

Verfahren

HRPRICAT in der Version 3.7 ist ein XML basiertes Austauschverfahren für Artikelinformationen. Gegenüber den Vorgängerversionen ist dieses Verfahren erweitert um die Angabe von FarbcodeID und Preispflegeebene.

Für neue Schnittstellen verwenden Sie bitte die Version 3.7. Die Vorgängerversionen der Schnittstelle werden weiterhin unterstützt, jedoch nicht weiterentwickelt.

Gegenüber der Version 3.6 wurden nur Optionale Felder hinzugefügt. MBS5 kann daher weiterhin HRPRICAT Vers. 3.6 Importieren. Wir empfehlen jedoch auf das aktuelle Format umzustellen.

Gegenüber der Version 3.5 wurden Felder für Allergene, Informationen und Zusatzstoffe hinzugefügt.

Gegenüber der Version 3.0 wurden lediglich Felder hinzugefügt, bei denen es sich nicht um Pflichtfelder handelt. MBS5 kann daher weiterhin Ordersätze in der HRPRICAT Vers. 3.0 oder höher importieren. Wir empfehlen jedoch auf das aktuelle Format umzustellen.

Dateiformat und Konventionen

Artikel- und Preisinformationen werden über eine XML-Datei ausgetauscht, deren Formatbeschreibung in den nächsten Abschnitten folgt.

Alphanumerische Felder (Typ A) werden ohne Anführungszeichen übertragen. Enthalten sie mehr Zeichen als in der Spalte „Länge“ angegeben, werden die überzähligen Zeichen abgeschnitten. 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, dass die Angabe des jeweiligen Wertes obligatorisch ist.

Ein „kann“ (bzw. ein leeres Feld) signalisiert die optionale Angabe der Daten, wobei das Tag mit leerem Inhalt übergeben oder auch ganz weggelassen werden kann.

Felder, die in der Version 3.7 geändert wurden, sind grün markiert.

Felder, die in der Version 3.6 geändert wurden, sind orange markiert.

Sprachinformationen

Ab Version 3.2 ist ein mehrsprachiger Import für einige Merkmale möglich. Das Root-Tag der XML Datei wird dazu ergänzt um das Attribut „lang=“<ISO 639-1 Kürzel der Sprache; Alpha-2>“.

In den MBS5 Datenbanken werden standardmäßig die Sprachen Deutsch (de), Englisch (en), Französisch (fr) und Italienisch (it) unterstützt. Weitere Sprachcodes müssen vor dem Import in der jeweiligen Datenbank hinterlegt werden.

Der Import bleibt abwärtskompatibel, d. h. bei fehlendem Sprachattribut erfolgt der Import in die Standardsprache, die in der Datenbank hinterlegt ist. Beim Einlesen der Datei im Modul „Lieferantenordersatz importieren“ kann der Anwender die Sprache auswählen.

Die Merkmale, die mehrsprachig ausgelegt sind, sind in der folgenden Tabelle blau hinterlegt.

Währungsinformationen

Ab Version 3.5 ist eine Angabe der Währung des Lieferanten möglich. Das Root-Tag der XML Datei wird dazu ergänzt um das Attribut currency=“<ISO 4217 Kürzel der Währung; Alpha-3>“, z.B. „EUR“ oder „USD“.

Ist in MBS5 ab Version 2.6.0.1830 die Mehrwährungsfähigkeit aktiviert, wird geprüft, ob das Kürzel der Währung in MBS5 in der Liste der Währungen vorhanden ist und mit der Währung des Lieferanten übereinstimmt. Schlägt diese Prüfung fehl, so kann die Datei nicht importiert werden.

Ist kein Währungskennzeichen angegeben, wird für die Aktualisierung bzw. Anlage der Preise die Währung des Lieferanten verwendet.

In einer XML-Datei dürfen immer nur die Daten eines Lieferanten enthalten sein.

Aufbau HRPRICAT Vers. 3.7

https://cloudmenu.atlassian.net/wiki/spaces/CMAD/pages/3103653904
HRPRICAT Formatbeschreibung öffnen

HRPRICAT-Mustervorlage-Excel

Anmerkungen:

1.) Inhaltsstoffe

Die Inhaltsstoffe können über den BLS und/oder einer direkten Angabe der Informationen über die Einträge „GCAL“ – „F183“ importiert werden. Die direkten Angaben haben bei der Berechnung der Inhaltsstoffe Vorrang vor den über den BLS ermittelten Werten. Weichen also nur einige Werte von denen des BLS ab, ist es ausreichend, den BLS Schlüssel und die abweichenden Werte zu übergeben. Ist der BLS nicht bekannt, können auch nur die direkten Werte importiert werden.

Bei der Angabe des BLS ist das Feld BLS_Umrechnungsfaktor obligatorisch. In diesem Feld muss die Umrechnung einer Verbrauchseinheit des Artikels in Gramm eingetragen werden:

Verbrauchseinheit Kg -> BLS_Umrechnungsfaktor = 1000

Verbrauchseinheit g -> BLS_Umrechnungsfaktor = 1

Verbrauchseinheit Stk -> BLS_Umrechnungsfaktor = <Gewicht des Artikels in Gramm>

Verbrauchseinheit L -> BLS_Umrechnungsfaktor = <Gewicht von 1 L des Artikels in Gramm>

2.) Zusatzstoffe

Die Einträge „AZ01“ – „AZ88“ stehen für ggf. kennzeichnungspflichtige Zusatzstoffe, Allergene und sonstige Informationen. Zulässige Werte dafür sind:

0: „ist nicht enthalten“

1: „ist enthalten“

<leer>: „unbekannt“ bzw. „keine Angabe“.

Es darf nur dort 0 übergeben werden, wo der Zusatzstoff/das Allergen sicher nicht enthalten ist. In allen anderen Fällen muss der Eintrag leer bleiben!

3.) Ermittlung des MBS5 Artikels beim Import

Während des Imports der Preisdaten in MBS5 erfolgt die Zuordnung zum MBS5 Artikel anhand folgender Prioritäten:

Suche nach MBS5 Artikel mit

1. MBS5.ArtikelNr = HRPRICAT.ArtikelNr_MBS5. Wird kein Artikel gefunden, dann

2. MBS5.LieferantenPreis.ArtikelReferenzNr = HRPRICAT.Artikel_ReferenzNr. Wird kein Artikel gefunden, dann

3. MBS5.LieferantenPreis.LieferantenArtikelNr = HRPRICAT.Artikelnummer

Aus dieser Prüfungsabfolge ist ersichtlich, dass die Artikelnummer des Lieferanten NIE gegen das Feld ArtikelReferenzNr geprüft wird. Die ArtikelReferenzNr darf also immer nur zusätzlich zur Artikelnummer des Lieferanten eingetragen werden.

4.) Ermittlung des Lieferanten beim Import mit dem Ordersatzimport-Dienst

Wird die HRPRICAT-Datei mit dem Ordersatzimport-Dienst eingelesen, so muss entweder das Feld LieferantNr_MBS5 oder Lieferantenname gefüllt sein, damit die Daten dem Lieferanten zugeordnet werden können. Pro Datei dürfen nur die Daten eines Lieferanten enthalten sein.

Beim Import in MBS5 werden die Felder nicht ausgewertet und können leer bleiben, da hier der Lieferant im Dialog ausgewählt wird.

Beispieldatei HRPRICAT 3.7

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>

<MBS5 lang="de" currency="EUR" xmlns:xsi=“http://www.w3.org/2001/XMLSchemainstance“>

<HRPRICAT>

<Artikelname_MBS5>Kalbsleber Neuseeland</Artikelname_MBS5>

<Artikelname_Lieferant>Kalbsleber Neuseeland bis 800 g / Stück</Artikelname_Lieferant>

<WG_Schluessel>100</WG_Schluessel>

<Einheit_Gebinde>Karton</Einheit_Gebinde>

<Gebindeinhalt>27.2</Gebindeinhalt>

<Einheit_Gebindeinhalt>kg</Einheit_Gebindeinhalt>

<Rezeptmenge>100</Rezeptmenge>

<Einheit_Rezeptmenge>Stück</Einheit_Rezeptmenge>

<LieferantNr_MBS5>4567</LieferantNr_MBS5>

<Lieferantenname>A+K Kälteteam GmbH, Gelsenkirchen</Lieferantenname>

<Markenbezeichnung>WildWestWings</Markenbezeichnung>

<Artikelnummer>212</Artikelnummer>

<Artikel_ReferenzNr>AB12</Artikel_ReferenzNr>

<ILN>4321122653789</ILN>

<GTIN>2873172653789</GTIN>

<FarbcodeID>2</FarbcodeID>

<Mehrwertsteuer>7</Mehrwertsteuer>

<Artikelkennzeichen>A</Artikelkennzeichen>

<Artikelcode>C</Artikelcode>

<Preis_Liefergebinde>60.384</Preis_Liefergebinde>

<Preis_Gueltig_Vom>2011-01-01</Preis_Gueltig_Vom>

<Preis_Gueltig_Bis>2011-12-31</Preis_Gueltig_Bis>

<Preispflegeebene>1</Preispflegeebene>

<Anbrucherlaubt>N</Anbrucherlaubt>

<Vertragspreis>J</Vertragspreis>

<Kernsortiment>N</Kernsortiment>

<Sonderangebot>J</Sonderangebot>

<Besorgerartikel>N</Besorgerartikel>

<KUNO>N</KUNO>

</HRPRICAT>

<HRPRICAT>

<Artikelname_MBS5>Chick`n Wings Buffallo</Artikelname_MBS5>

<Artikelname_Lieferant>CHICKEN WINGS BUFFA.GEFR.2,5KG </Artikelname_Lieferant>

<WG_Schluessel>703</WG_Schluessel>

<Einheit_Gebinde>Karton</Einheit_Gebinde>

<Gebindeinhalt>4</Gebindeinhalt>

<Einheit_Gebindeinhalt>Beutel</Einheit_Gebindeinhalt>

<Rezeptmenge>2.5</Rezeptmenge>

<Einheit_Rezeptmenge>kg</Einheit_Rezeptmenge>

<LieferantNr_MBS5>123456789012345</LieferantNr_MBS5>

<Lieferantenname>SALOMON HITBURGER GMBH</Lieferantenname>

<Artikelnummer>000017</Artikelnummer>

<FarbcodeID>123</FarbcodeID>

<Mehrwertsteuer>7</Mehrwertsteuer>

<Artikelkennzeichen> </Artikelkennzeichen>

<Artikelcode>A </Artikelcode>

<EAN_Liefergebinde> </EAN_Liefergebinde>

<EAN_Gebindeinhalt> </EAN_Gebindeinhalt>

<Preis_Liefergebinde>57.472</Preis_Liefergebinde>

<Preis_Gueltig_Vom>2011-01-01</Preis_Gueltig_Vom>

<Preis_Gueltig_Bis>2011-12-31</Preis_Gueltig_Bis>

<Preispflegeebene>5</Preispflegeebene>

<Anbrucherlaubt>N</Anbrucherlaubt>

<Vertragspreis>N</Vertragspreis>

<Kernsortiment>J</Kernsortiment>

<Sonderangebot>N</Sonderangebot>

<Besorgerartikel>N</Besorgerartikel>

<KUNO>J</KUNO>

<BLS_Schluessel>Y562531</BLS_Schluessel>

<BLS_Umrechnungsfaktor>1000</BLS_Umrechnungsfaktor>

<GCAL>120</GCAL>

<GJ>243</GJ>

<GKB>0.3</GKB>

<ZE>4</ZE>

<ZF>57</ZF>

<EH>20</EH>

<FC>6</FC>

<FP>120</FP>

<FS>100</FS>

<FU>60</FU>

<MK>0.1</MK>

<MNA>2</MNA>

<ZB>0.5</ZB>

<ZK>50</ZK>

<VE>5</VE>

<VB1>6</VB1>

<VC>2</VC>

<MCA>0</MCA>

<MMG>0</MMG>

<MFE>0</MFE>

<MJ>0</MJ>

<KMD>0</KMD>

<GMKO>0</GMKO>

<F182>0</F182>

<F183>0</F183>

<AZ01>0</AZ01>

<AZ02>1</AZ02>

<AZ03>1</AZ03>

<AZ04>1</AZ04>

<AZ05>0</AZ05>

<AZ06>0</AZ06>

<AZ07>0</AZ07>

<AZ08>0</AZ08>

<AZ09>0</AZ09>

<AZ10>0</AZ10>

<AZ11>0</AZ11>

<AZ12>0</AZ12>

<AZ13>0</AZ13>

<AZ14>0</AZ14>

<AZ15>0</AZ15>

<AZ16>0</AZ16>

<AZ17>0</AZ17>

<AZ18>0</AZ18>

<AZ19>0</AZ19>

<AZ20>0</AZ20>

<AZ21>0</AZ21>

<AZ22>0</AZ22>

<AZ23>0</AZ23>

<AZ24>0</AZ24>

<AZ25>0</AZ25>

<AZ26>0</AZ26>

<AZ27>0</AZ27>

<AZ28>0</AZ28>

<AZ29>0</AZ29>

<AZ30>0</AZ30>

<AZ31>0</AZ31>

<AZ32>0</AZ32>

<AZ33>0</AZ33>

<AZ34>0</AZ34>

<AZ35>0</AZ35>

<AZ36>0</AZ36>

<AZ37>0</AZ37>

<AZ38>0</AZ38>

<AZ39>0</AZ39>

<AZ40>0</AZ40>

<AZ41>0</AZ41>

<AZ42>1</AZ42>

<AZ50>1</AZ50>

<AZ55>1</AZ55>

<AZ79>1</AZ79>

<AZ83>1</AZ83>

</HRPRICAT>

</MBS5>

HRPRICAT Vers. 2.x – Artikel und Preise

Satzformat und Konventionen

Die Daten müssen in einer Textdatei mit fester Satzlänge vorliegen. Der Zeichensatz ist WindowsANSI.

Alphanumerische Felder (Typ A) werden linksbündig im Feld ausgerichtet, wobei nicht benutzte Stellen mit Leerzeichen aufgefüllt werden.

Numerische Felder (Typ N) werden ohne Dezimalkomma rechtsbündig im Feld ausgerichtet, wobei zur

Erreichung der geforderten Feldlänge nicht benutzte Stellen mit führender Null (0) gefüllt werden. Eine Längenangabe von 11,3 bedeutet eine Gesamtlänge von 11 Ziffern, wobei die rechten 3 Ziffern den Nachkommaanteil beschreiben.

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 in jedem Fall, also auch bei einem numerischen Feld, mit Leerzeichen gefüllt werden.

Satzaufbau HRPRICAT Vers. 2.0

Verarbeitung von Sonderangeboten

Sollen befristete Angebote mit dieser Schnittstelle geschickt werden, so können zusätzliche Zeilen zum selben Artikel im selben Gebinde mit unterschiedlichen Preisen und unterschiedlichen Gültigkeitszeiträumen übergeben werden. MBS5 wird diese mit importieren und bei der Erstellung von Einkaufsvorschlägen bei Lieferanten mit berücksichtigen.

Verarbeitung von abweichenden Preisen für Anbruchmengen

Preise für Anbruchmengen können auf zwei verschiedene Arten (auch gemischt) verarbeitet werden:

Preis für einen Artikel im Anbruch ist identisch mit dem Preis des Artikels im Gebinde In diesem Fall muss nur im Feld 17 ein ‚J’ übergeben werden

Anbruchpreis und Gebindepreis des Artikels sind verschieden

für jeden Anbruchpreis (im Beispiel entspräche dies einzeln verkauften Dosen), können zusätzliche Zeilen mit gleicher Einheit in Feld 2 und Feld 4 geschickt werden, der Preis in Feld 14 muss sich dann aber auch auf diese Einheiten beziehen. In diesem Fall ist in allen Preiszeilen des betreffenden Artikels für Feld 17 ein ‚N’ zu übergeben.

Verarbeitung von Auslistungen

Zum Auslisten eines Artikels muss eine Zeile mit allen Artikelinformationen und einem „N“ in Feld 10 übergeben werden. Danach wird der Artikel für diesen Lieferanten in MBS5 auf „nicht bestellbar“ gestuft, was das Einkaufsmodul bei der Erstellung von Einkaufsvorschlägen berücksichtigt. Sollten vorher mehrere Zeilen für denselben Artikel übergeben worden sein (Sonderangebote, Anbruchpreise), müssen diese separat noch einmal als nicht bestellbar übergeben werden.