hogast Artikelstamm

TransdatiX.Convert hogast Artikelstamm

Version 2.0.8 vom 2011-09-25

Inhalt

Allgemeines

Dieser Konverter wandelt Ihre Artikelstammdaten in eine gültige XML Datei V5, die von der Fa. hogast Einkaufsgenossenschaft in das Beschaffungssystem importiert werden können.

Hinweise

Folgende Daten können über die Schnittstelle vermittelt werden:
  • Artikelstammdaten
  • Preise
  • Rabatte
  • Zuschläge
  • Skonti
  • Referenzen auf Bilddateien
  • Preisgruppen
  • Liefergebiete
  • Lagerstände
  • Lagerorte
  • Währungen
  • Einheiten
  • Lieferantenstammdaten
Bilddateien sollen an die Adresse artikel@hogast.at übermittelt.

FAQs

  • Wie werden Staffelpreise abgebildet?
    Die Möglichkeit Staffelpreise abzubilden, liegt im Feld FromAmount in der Price Datengruppe. Ist hier nichts oder 0 eingetragen, gilt dieser Preis für alle Artikel ab 1 Stk. Gibt es einen zweiten Preis (oder mehrere Preise), die sich auf dieselbe Artikelnummer beziehen, aber im Feld FromAmount eine höhere Menge eingetragen haben, gilt dieser Preis für den Artikel ab der jeweiligen Menge. Bei redundanten Datensätzen, gilt der jeweils aktuellere Preis. Dieselbe Logik gilt auch bei Rabatten.

  • Kann man eine Mindestbestellmenge angeben?
    Die Mindestbestellmenge wird ebenfalls mit dem FromAmount Feld in der Price Datengruppe realisiert. Wenn kein Preis im System liegt, der ein FromAmount unter der Mindestbestellmenge enthält, gibt es auch keine Möglichkeit, diesen Artikel unter der Mindestbestellmenge zu bestellen. Dieselbe Logik gilt auch bei Rabatten.

  • Was bedeutet das Feld PriceUnit?
    PriceUnit gibt die Mengeneinheit an, die den Preis in Beziehung zum Artikel setzt. In den meisten Fällen wird dieses Feld den Wert 1 enthalten, das bedeutet, daß ein Preis sich auf genau eine Einheit des Artikels bezieht.

  • Was bewirken die Felder PriceUnitInvoiced und UnitInvoiced?
    Sind diese Felder nicht vorhanden, so bezieht sich ein Preis auf die PriceUnit- und Unit-Felder des Artikels, die gleichzeitig auch die (mögliche) Bestelleinheit repräsentieren. Ist z.B. PriceUnit = 1 und Unit = Stk., so kann der Artikel in Stückmengen bestellt werden. Wird der Preis aber nicht per Stück, sondern z.B. pro kg gemacht (etwa bei Artikeln, die zwar stückweise verkauft, deren Gewicht aber, was für den Preis ausschlaggebend ist, variabel ist z.B. Fleisch oder Fisch), kommen die Felder PriceUnitInvoiced und UnitInvoiced ins Spiel. In diesem Fall bezieht sich der Preis auf die Angaben, die in diesen Feldern stehen (z.B. "1" und "kg"). Um ein Durchschnittsmaß angeben zu können, wieviele Verkaufseinheiten (UnitInvoiced) einer Bestelleinheit (Unit) entsprechen, muß im Feld UnitFactor ein entsprechender Wert angegeben werden. Die zugrundeliegende Berechnung erfolgt so:

    Durchschnittswert (PriceUnit) = PriceUnitInvoiced * UnitFactor


  • Wie werden in der ItemCharge- und CashDiscount-Datengruppen Rabatte und Skonti abgebildet? Welche Bedeutung haben die Felder (Cash)DiscountMode und (Cash)DiscountCalc?
    Rabatte und Skonti (wie auch Zuschläge) können auf verschiedene Weise abgebildet werden. Es können etwa Prozentwerte oder fixe Beträge auf einen Preis angewendet werden (bei Rabatten meist Prozent, bei Zuschlägen auch häufig fixe Werte). Die Zusammenhänge zeigen die folgenden Tabellen:

    Bei Rabatten und Skonti gilt:

    ModeCalcValuePriceBerechnungErgebnis
    PercentOffPrice5200200 - 200 * (5/100) =190
    PercentFromPrice95200200 * (95/100) =190
    FixedOffPrice10200200 - 10= 190
    FixedFromPrice190200190=210

    Bei Zuschlägen gilt:

    ModeValuePriceBerechnungErgebnis
    Percent5200200 + 200 * (5/100)=210
    Fixed10200200 + 10=210

Aufruf des Konverters

Um diesen TransdatiX.Convert zu benützen, müssen Sie zuerst Ihre Daten in CSV- oder XML-Dateien exportieren. Alles was Sie brauchen, um Ihre Daten für diesen Konverter aufzubereiten, befindet sich hier.

Sie haben dann viele Möglichkeiten, den TransdatiX.Convert aufzurufen, z.B. Sie definieren ein Prozess, in welchem Sie einen TransdatiX.Comm miteinbeziehen, um Konvertierung und Übermittlung zu automatisieren. Mehr Information über den TransdatiX.Configurator und andere Anbindungstechniken befindet sich hier.

Datenstruktur - Übersicht

Folgende Liste zeigt die formelle Struktur der Daten, die der Konverter akzeptiert. Beschreibungen in Fettschrift bedeutet, dass das Element ein Mussfeld ist, außer wenn in der Beschreibung des Elementen eine Bedingung ausdrücklich formuliert wird.


Elementname

Beschreibung

 
MessageRoot-Element
 
  EnvelopeÜbertragungsdaten
    SenderIdGLN des Lieferanten
    RecipientIdEmpfänger
 
  CatalogAllgemeine Informationen - Kopfdaten
    CatalogIDInterne Katalog-ID
    BuyerGLNGLN des Kunden
    BuyerNumberNummer des Kunden
    BuyerNameName des Kunden
    VendorGLNGLN des Lieferanten
    VendorNumberNummer des Lieferanten
    VendorNameName des Lieferanten
    VendorStreetStraße des Lieferanten
    VendorCityOrt des Lieferanten
    VendorZipCodePLZ des Lieferanten
    VendorCountryLand des Lieferanten
    CurrencyWährung
    LanguageSprache der Stammdaten
 
    ItemArtikeldaten
      CatalogIDInterne Katalog-ID
      CatalogItemIDInterne Artikel-ID
      NumberArtikelnummer
      EANEAN-Code des Artikels
      NameArtikelname
      DescriptionArtikelbeschreibung
      CountryOfOriginHerkunftsland
      PriceUnitMengeneinheit für Preis
      UnitMasseinheit (ad Bestelleinheit: Sollte diese nicht ermittelt werden können, nehmen sie bitte 'VPE' (für Verpackungseinheit allgemein).
      UnitDescriptionBeschreibung der Masseinheit
      GroupArtikelgruppe
      BlockedSperrvermerk
      PriceGroupIDPreisgruppe
      PriceUnitInvoicedVerrechnungs-Mengeneinheit für Preis
      UnitInvoicedVerrechnungseinheit für Preis
      UnitFactorFaktor für Durchschnittsmengeneinheit
      VatPercentageMwSt-Satz
 
      PriceArtikel-Preisdaten
        CatalogIDInterne Katalog-ID
        CatalogItemIDInterne Artikel-ID
        ModePreisart
        TypePreistyp
        AmountPreis
        UnitMasseinheit
        SpecialOfferKennung für Sonderangebot / Aktion
        ValidFromPreis gilt ab Datum
        ValidToPreis gilt bis Datum
        FromAmountPreis gilt ab angegebener Menge
        CashDiscountPercentageSkontoprozent
        CashDiscountDaysSkontotage
        DeliveryAreaIDLiefergebiet
        CustomerNumberKundennummer (für Sondervereinbarung)
        CustomerGroupNumberKundengruppe (für Sondervereinbarung)
 
      PictureArtikel-Bilddateien
        CatalogIDInterne Katalog-ID
        CatalogItemIDInterne Artikel-ID
        FilenameDateiname
        TextBildtext
        ReplacementTextAlternativer Text
        ImageFormatBildformat
        WidthBreite in Pixel
        HeightHöhe in Pixel
        PathPfad zum Bilddatei
        UsageLevelVerwendungseinstufung


Datengruppe Envelope - Übertragungsdaten
Mussfeld: nein
Falls nicht angegeben, dann wird die GLN des Lieferanten aus dem Feld Catalog.VendorGLN genommen

SenderId - GLN des Lieferanten
Mussfeld: ja
Format: Alphanumerisch mit max. 13 Stelle(n)

RecipientId - Empfänger
Mussfeld: nein
Format: Alphanumerisch mit max. 13 Stelle(n)
Hinweis: GLN der hogast = 9006140000000


Datengruppe Catalog - Allgemeine Informationen - Kopfdaten
Mussfeld: ja, beliebig wiederholbar

CatalogID - Interne Katalog-ID
Keyfeld
Format: Alphanumerisch
Hinweis: Nummer zur eindeutigen Identifizieren des Katalogs

BuyerGLN - GLN des Kunden
Mussfeld: ja
Format: Alphanumerisch mit max. 13 Stelle(n)

BuyerNumber - Nummer des Kunden
Mussfeld: ja
Format: Alphanumerisch

BuyerName - Name des Kunden
Mussfeld: ja
Format: Alphanumerisch

VendorGLN - GLN des Lieferanten
Mussfeld: ja
Format: Alphanumerisch mit max. 13 Stelle(n)

VendorNumber - Nummer des Lieferanten
Mussfeld: ja
Format: Alphanumerisch
Hinweis: Nummer des Lieferanten (hogast Lieferantennummer)

VendorName - Name des Lieferanten
Mussfeld: ja
Format: Alphanumerisch

VendorStreet - Straße des Lieferanten
Mussfeld: nein
Format: Alphanumerisch

VendorCity - Ort des Lieferanten
Mussfeld: nein
Format: Alphanumerisch

VendorZipCode - PLZ des Lieferanten
Mussfeld: nein
Format: Alphanumerisch

VendorCountry - Land des Lieferanten
Mussfeld: nein
Format: Alphanumerisch

Currency - Währung
Mussfeld: nein
Format: Alphanumerisch mit max. 3 Stelle(n)
Hinweis: ISO-Code der Rechnung (3 Buchstaben) (default=EUR)

Language - Sprache der Stammdaten
Mussfeld: nein
Format: Alphanumerisch
Hinweis: Default = Deutsch


Datengruppe Item - Artikeldaten
Mussfeld: nein, beliebig wiederholbar

CatalogID - Interne Katalog-ID
Keyfeld
Format: Alphanumerisch
Hinweis: Nummer zur eindeutigen Identifizieren des Katalogs

CatalogItemID - Interne Artikel-ID
Keyfeld
Format: Alphanumerisch
Hinweis: Nummer zur eindeutigen Identifizieren des Artikels

Number - Artikelnummer
Mussfeld: ja
Format: Alphanumerisch

EAN - EAN-Code des Artikels
Mussfeld: nein
Format: Alphanumerisch

Name - Artikelname
Mussfeld: ja
Format: Alphanumerisch

Description - Artikelbeschreibung
Mussfeld: nein
Format: Alphanumerisch

CountryOfOrigin - Herkunftsland
Mussfeld: nein
Format: Alphanumerisch

PriceUnit - Mengeneinheit für Preis
Mussfeld: nein
Format: Decimal

Unit - Masseinheit (ad Bestelleinheit: Sollte diese nicht ermittelt werden können, nehmen sie bitte 'VPE' (für Verpackungseinheit allgemein).
Mussfeld: ja
Format: Alphanumerisch

UnitDescription - Beschreibung der Masseinheit
Mussfeld: nein
Format: Alphanumerisch

Group - Artikelgruppe
Mussfeld: nein
Format: Alphanumerisch
Hinweis: Es wird hier empfohlen, die hogast Artikelgruppen zu verwenden. Wenn Sie Ihre eigene Gruppe in diesem Feld weitergeben, setzen Sie sich bitte mit der hogast in Verbindung, um die korrekte Zuordnung zur hogast-Gruppe zu definieren.

Blocked - Sperrvermerk
Mussfeld: nein
Mögliche Werte:
Y=Gesperrt
N=Nicht gesperrt

PriceGroupID - Preisgruppe
Mussfeld: nein
Format: Alphanumerisch
Hinweis: Preisgruppe des Lieferanten. Befüllen Sie dieses Feld mit einer Referenz auf PriceGroup.PriceGroupID, wenn Sie Preisgruppen verwenden.

PriceUnitInvoiced - Verrechnungs-Mengeneinheit für Preis
Mussfeld: nein
Format: Decimal
Hinweis: Verwenden Sie dieses Feld, wenn die Preise sich auf die Verrechnungseinheiten beziehen sollen.

UnitInvoiced - Verrechnungseinheit für Preis
Mussfeld: nein
Format: Alphanumerisch
Hinweis: Verwenden Sie dieses Feld, wenn die Preise sich auf die Verrechnungseinheiten beziehen sollen.

UnitFactor - Faktor für Durchschnittsmengeneinheit
Mussfeld: nein
Format: Decimal

VatPercentage - MwSt-Satz
Mussfeld: nein
Format: Decimal


Datengruppe Price - Artikel-Preisdaten
Mussfeld: nein, beliebig wiederholbar

CatalogID - Interne Katalog-ID
Keyfeld
Format: Alphanumerisch
Hinweis: Nummer zur eindeutigen Identifizieren des Katalogs

CatalogItemID - Interne Artikel-ID
Keyfeld
Format: Alphanumerisch
Hinweis: Nummer zur eindeutigen Identifizieren des Artikels

Mode - Preisart
Mussfeld: nein
Mögliche Werte:
B=Brutto (default)
N=Netto

Type - Preistyp
Mussfeld: ja
Mögliche Werte:
CA=Abholpreis- Katalog
DI=Zustellpreis (default) - Distributeur

Amount - Preis
Mussfeld: ja
Format: Decimal

Unit - Masseinheit
Mussfeld: nein
Format: Alphanumerisch
Hinweis: Nur angeben, wenn Sie von der Einheit im Item-Element abweicht

SpecialOffer - Kennung für Sonderangebot / Aktion
Mussfeld: nein
Mögliche Werte:
Y=Preis ist Aktionspreis
N=Preis ist Regulärpreis (default)

ValidFrom - Preis gilt ab Datum
Mussfeld: nein
Format: Datum

ValidTo - Preis gilt bis Datum
Mussfeld: nein
Format: Datum

FromAmount - Preis gilt ab angegebener Menge
Mussfeld: nein
Format: Decimal

CashDiscountPercentage - Skontoprozent
Mussfeld: nein
Format: Decimal
Hinweis: Skonto-Prozentsatz nur für diesen Preis

CashDiscountDays - Skontotage
Mussfeld: nein
Format: Ganzzahl
Hinweis: Skontogültigkeit in Tagen

DeliveryAreaID - Liefergebiet
Mussfeld: nein
Format: Alphanumerisch
Hinweis: Referenz auf die Identifikationsnummer des Liefergebiets

CustomerNumber - Kundennummer (für Sondervereinbarung)
Mussfeld: nein
Format: Alphanumerisch
Hinweis: Tragen Sie hier bitte die hogast Mitgliegsnummer des Kunden

CustomerGroupNumber - Kundengruppe (für Sondervereinbarung)
Mussfeld: nein
Format: Alphanumerisch


Datengruppe Picture - Artikel-Bilddateien
Mussfeld: nein, beliebig wiederholbar

CatalogID - Interne Katalog-ID
Keyfeld
Format: Alphanumerisch
Hinweis: Nummer zur eindeutigen Identifizieren des Katalogs

CatalogItemID - Interne Artikel-ID
Keyfeld
Format: Alphanumerisch
Hinweis: Nummer zur eindeutigen Identifizieren des Artikels

Filename - Dateiname
Mussfeld: ja
Format: Alphanumerisch
Hinweis: Dateiname des Bildes (ohne Pfad)

Text - Bildtext
Mussfeld: nein
Format: Alphanumerisch
Hinweis: Text, der zum Bild erscheint

ReplacementText - Alternativer Text
Mussfeld: nein
Format: Alphanumerisch
Hinweis: Text, der statt des Bildes erscheint (wenn Browser keine Bilder zeigt)

ImageFormat - Bildformat
Mussfeld: nein
Mögliche Werte:
JPG=Das Bild liegt im JPG-Format vor (default)
GIF=Das Bild liegt im GIF-Format vor
Other=Das Bild liegt in einem anderen Format vor

Width - Breite in Pixel
Mussfeld: nein
Format: Ganzzahl

Height - Höhe in Pixel
Mussfeld: nein
Format: Ganzzahl

Path - Pfad zum Bilddatei
Mussfeld: nein
Format: Alphanumerisch

UsageLevel - Verwendungseinstufung
Mussfeld: ja
Mögliche Werte:
0=Produktansicht (groß)
1=Listenansicht (klein)
Hinweis: Weitere Levels nach Vereinbarung

Rechtserklärung

Alle Informationen in diesem Dokument werden ohne Abgabe von Garantien, welcher Art auch immer, zur Verfügung gestellt. TransdatiX lehnt alle Haftungsansprüche, ausdrückliche oder implizite, einschliesslich Ansprüchen bezüglich Verkaufbarkeit und Eignung für bestimmte Zwecke, ausdrücklich ab. In keinem Fall kann TransdatiX oder dessen Lieferanten für irgendwelche Schäden, die direkt oder indirekt, zufällig oder als Folgeschaden auftreten, verantwortlich gemacht werden. Insbesondere sind Geschäftsverluste, Datenverluste oder spezielle Schäden von Haftungsansprüchen explizit ausgeschlossen, auch wenn TransdatiX oder dessen Lieferanten auf die Möglichkeit derartiger Schäden hingewiesen haben. In jedem Fall werden Haftungsansprüche bis zum gesetzlich höchstmöglichen Ausmass abgelehnt.

© 2002 - 2010 TransdatiX Software


Automatisch generiert 2011-09-25, 21:10:15