Formatbeschreibung für Produkte Datenformat standard

Last modified: 11. November 2022

Datenbankdiagramm

Abhängigkeitsdiagram beim csv Ausgabeformat, inklusive SQL Skripte zum Erzeugen der Tabellen und zum Laden der Daten mit load data local infile am Ende des Beitrags.


Übersicht der Datenformat-Elemente


Im csv Ausgabeformat sind diese Elemente Dateien, im xml oder json Ausgabeformat sind es Knoten. 

Das Datenformat Standard besteht aus folgenden Elementen:

  • product: – Produkt des ITscope-Katalogs.
  • supplierItem: – Bezugsquelle eines ITscope-Produkts. Ein konkretes Angebot eines auf ITscope gelisteten Distributors.
  • project: – Informationen, Preis und Verfügbarkeit eines Projektartikels.
  • attribute: – Eigenschaften zu einem Produkt.
  • attributeCluster: – Eigenschaftscluster, in denen das Produkt für Merkmalssuchen gefunden werden kann. Kann je nach Menge mehrere Eigenschaftsausprägungen in Intervallen zusammenfassen, z.B. 64-128MB RAM
  • accessory: – Originalzubehör und kompatibles Zubehör zu einem Produkt

Die mit einem Globus markierten Elemente ändern sich je nach gewählter Exportsprache:

product


Produkt des ITscope-Katalogs.

NamePflichtfeldDatentypBeschreibung
puidJaLongEindeutiger Key
ean String (18)EAN
manufacturerSKU String (40)Herstellerartikelnummer
icecatId String (255)Icecat ID
cnetId String (255)1WorldSync ID (ehemals CNET)
bechlemId String (255)Bechlem ID
eClass String (255)eClass ID Version 5.1.2
manufacturerIdJaLongReferenz auf den Hersteller dieses Produktes (n:1 auf Manufacturer.id)
manufacturerName String (255)Name des Herstellers
productNameWithManufacturerJaStringProduktname, inklusive Herstellername
  shortDescription StringKurzbezeichner des Produktes
  longDescription StringLangtext des Produktes
productTypeIdJaLongReferenz auf den Produkttyp dieses Produktes
productTypeGroupIdJaString (3)Referenz auf Produkttyp-Gruppe (ProductTypeGroup.id, n:1)
productTypeGroupNameJaString (255)Name der Gruppe von Produkttypen, z.B. Netzwerktechnik. Kann als 1. Kategorieebene verwendet werden.
productTypeNameJaString (255)Bezeichner des Produkttyps. Kann als 2. Kategorieebene verwendet werden.
attributeTypeId1 LongEindeutiger Attribut Key, um eine mögliche Unterkategorie aufzubauen, verweist 1:n auf AttributeCluster.attributeTypeId
attributeTypeName1 String (255)Bezeichner des Attributes, um eine mögliche Unterkategorie aufzubauen
attributeTypeId2 LongEindeutiger Attribut Key, um eine mögliche Unterkategorie aufzubauen, verweist 1:n auf AttributeCluster.attributeTypeId
attributeTypeName2 String (255)Bezeichner des Attributes, um eine mögliche Unterkategorie aufzubauen
attributeTypeId3 LongEindeutiger Attribut Key, um eine mögliche Unterkategorie aufzubauen, verweist 1:n auf AttributeCluster.attributeTypeId
attributeTypeName3 String (255)Bezeichner des Attributes, um eine mögliche Unterkategorie aufzubauen
attributeTypeId4 LongEindeutiger Attribut Key, um eine mögliche Unterkategorie aufzubauen, verweist 1:n auf AttributeCluster.attributeTypeId
attributeTypeName4 String (255)Bezeichner des Attributes, um eine mögliche Unterkategorie aufzubauen
attributeTypeId5 LongEindeutiger Attribut Key, um eine mögliche Unterkategorie aufzubauen, verweist 1:n auf AttributeCluster.attributeTypeId
attributeTypeName5 String (255)Bezeichner des Attributes, um eine mögliche Unterkategorie aufzubauen
  attributeValue1 String (1024)Eigenschaftscluster für das Attribut aus ProductType.attributeTypeId1. Kann, falls vorhanden, als 3. Kategorieebene verwendet werden.
attributeValue2 String (1024)Eigenschaftscluster für das Attribut aus ProductType.attributeTypeId2. Kann, falls vorhanden, als 4. Kategorieebene verwendet werden.
 attributeValue3 String (1024)Eigenschaftscluster für das Attribut aus ProductType.attributeTypeId3. Kann, falls vorhanden, als 5. Kategorieebene verwendet werden.
 attributeValue4 String (1024)Eigenschaftscluster für das Attribut aus ProductType.attributeTypeId4
attributeValue5 String (1024)Eigenschaftscluster für das Attribut aus ProductType.attributeTypeId5
productSubTypeId String (1024)ID der Bauart-Eigenschaft
productSubType String (1024)Bauart-Eigenschaft des Produktes, z.B. Maus oder Tastatur für Eingabegeräte. Sollte nicht als 3. Kategorieebene verwendet werden.
productLineId LongID der Produktlinie
productLine String (1024)Produktlinie
productModel String (1024)Produktmodellbezeichner
estimateGrossWeight DoubleGewicht in Kilogramm
grossDimX String (1024)Länge des Produkts inklusive Maßeinheit
grossDimY String (1024)Höhe des Produks inklusive Maßeinheit
grossDimZ String (1024)Breite des Produkts inklusive Maßeinheit
customsTariffNumber String (255)Zolltarifnummer
deeplinkJaString (2048)Deeplink auf die ITscope.com Plattform
standardHtmlDatasheetJaString (2048)URL, Link auf HTML Standard-Datenblatt
 standardPdfDatasheet String (2048)URL, Link auf PDF Standard-Datenblatt
manufacturerSite String (1024)URL, Link auf Herstellerseite
manufacturerDatasheet String (1024)URL, Link auf Herstellerdatenblatt
imageThumb String (1024)Vorschau des besten Produktbildes
imageThumbWidth IntegerBreite des Bild Mediums in Pixel
imageThumbHeight IntegerHöhe des Bild Mediums in Pixel
image1 String (1024)Link auf bestmögliches Bild, in der größten Ausführung
imageWidth1 IntegerBreite des Bild Mediums in Pixel
imageHeight1 IntegerHöhe des Bild Mediums in Pixel
image2 String (1024)Link auf ein weiteres gutes Produktbild, bevorzugt das einer Produktverpackung (nie das gleiche wie das erste Bild)
imageWidth2 IntegerBreite des Bild Mediums in Pixel
imageHeight2 IntegerHöhe des Bild Mediums in Pixel
image3 String (1024)Link auf erstes Bild in der Galerie (niemals eines der bereits aufgeführten)
imageWidth3 IntegerBreite des Bild Mediums in Pixel
imageHeight3 IntegerHöhe des Bild Mediums in Pixel
image4 String (1024)Link auf zweites Bild in der Galerie (niemals eines der bereits aufgeführten)
imageWidth4 IntegerBreite des Bild Mediums in Pixel
imageHeight4 IntegerHöhe des Bild Mediums in Pixel
image5 String (1024)Link auf drittes Bild in der Galerie (niemals eines der bereits aufgeführten)
imageWidth5 IntegerBreite des Bild Mediums in Pixel
imageHeight5 IntegerHöhe des Bild Mediums in Pixel
energyLabel String (1024)Link auf das Energielabel Bild
entryDateJaDateAb wann ist das Produkt auf der Plattform
rank IntegerAllgemeiner Beliebtheitsrang (Rang 1 bis n, eine hohe Zahl entspricht einem schlechten Ranking)
qualification IntegerQualifizierung des Produkts
warrantyText StringGarantietext des Produktes
marketingText StringMarketingtext für das Produkt
 htmlSpecs StringTechnische Eigenschaften des Produktes, im HTML Format
recommendedRetailPriceNet DoubleUVP des Herstellers
price BigDecimalPreisbasis für den kalkulierten Preis
priceCalc BigDecimalKalkulierter Preis, auf Grundlage der individuellen Preiskalkulation
currencyCode String (3)Währungseinheit, die für diese Preisinformation gilt
priceCalcVat BigDecimalUmsatzsteuersatz, der zur Berechnung des kalkulierten Preises benutzt wurde
priceLastUpdate DateZeitpunkt der letzten Aktualisierungs der Preisinformation
priceSupplierId LongReferenz auf einen Lieferanten (1:1), der die Bezugsquelle mit dieser Preisinformation bereitgestellt hat
priceSupplierName String (255)Name des Lieferanten, der diese Bezugsquelle bereitgestellt hat
priceSupplierItemId LongReferenz auf eine Bezugsquelle (n:1); wenn dieses Feld null ist, dann bezieht sich die Preisinformation auf ein Produkt (Bezugsquellenrefernz und Produktrefernz schließen sich gegenseitig aus)
priceSupplierSKU String (40)Produktbezeichner des Lieferanten, der diese Bezugsquelle bereitgestellt hat
stockSupplierText String (40)Textuelle Bestandsinformation des Lieferanten, direkt übernommen, ohne Interpretation
stockStatus IntegerNumerischer Schlüssel des Lieferstatus dieser Bestandsinformation
stockStatusText String (255)Lieferstatus dieser Bestandsinformation, z.B. „auf Lager“ oder „im Außenlager“
stock IntegerBestandsmenge des in dieser Struktur angegebenen Lieferstatus
externalStock IntegerIm Außenlager befindliche Bestandsmenge (Zusatzinformation einiger Lieferanten in Strukturen des Lieferstatus „auf Lager“)
incomingStock IntegerIm Zulauf befindliche Bestandsmenge (Zusatzinformation einiger Lieferanten in Strukturen des Lieferstatus „auf Lager“)
stockAvailabilityDate DateLiefertermin für nicht auf Lager befindliche Ware
stockLastUpdate DateZeitpunkt der letzten Aktualisierung der Bestandsinformation
aggregatedStatusJaIntegerBester Verfügbarkeitsstatus
aggregatedStatusTextJaString (255)Bester Verfügbarkeitsstatus
aggregatedStockJaIntegerSumme aller Lagerbestände
aggregatedSupplierItemsJaIntegerSumme aller Distributoren zu diesem Produkt
supplierItemJaList<supplierItem>Bezugsquelle eines ITscope-Produkts. Ein konkretes Angebot eines auf ITscope gelisteten Distributors.
attribute List<attribute>Eigenschaften zu einem Produkt.
attributeCluster List<attributeCluster>Eigenschaftscluster, in denen das Produkt für Merkmalssuchen gefunden werden kann. Kann je nach Menge mehrere Eigenschaftsausprägungen in Intervallen zusammenfassen, z.B. 64-128MB RAM
accessory List<accessory>Originalzubehör und kompatibles Zubehör zu einem Produkt

supplierItem

Bezugsquelle eines ITscope-Produkts. Ein konkretes Angebot eines auf ITscope gelisteten Distributors.

NamePflichtfeldDatentypBeschreibung
idJaLongEindeutiger Key
ean String (18)EAN-Angabe des Lieferanten
manufacturerSKU String (40)Hersteller-Artikelnummer-Angabe des Lieferanten (muss nicht mit ITscope übereinstimmen)
supplierSKU String (40)Produktnummer des Lieferanten
supplierIdJaLongVerweist 1:1 auf Supplier.id
supplierName String (255)Name des Lieferanten
manufacturerName String (80)Herstellername wie beim Lieferant angegeben
productName String (255)Genauer Bezeichner des Artikels, wie vom Lieferanten übermittelt
longDescription String (60000)Erweiterte Artikelbeschreibung des Lieferanten
conditionIdJaIntegerNumerischer Code des Zustand des Artikels
conditionNameJaString (255)Zustand des Artikels (neu, gebraucht, B-Ware, Refurbished, usw.)
eolProductJaBooleanKennung: Auslaufartikel
matchQualityJaIntegerZuordnungsqualität des Artikels zum ITscope-Produktkatalog
eanValidJaBooleanFlag, ob die EAN des Lieferanten valide nach den EAN-Kriterien ist
specialOfferJaBooleanFlag, ob Artikel Sonderangebot ist
promotion String (40)Name der Promo-Aktion des Lieferanten
vat IntegerMwSt-Satz für den Artikel
copyrightLevy DoubleUrheberrechtsabgabe
customsTariffNumber String (50)Zolltarifnummer
countryOfOrigin String (20)Ursprungsland des Artikels
grossDimX DoubleLÄnge des Produkts inklusive Maßeinheit
grossDimY DoubleHöhe des Produks inklusive Maßeinheit
grossDimZ DoubleBreite des Produkts inklusive Maßeinheit
warrantyText String (40)Garantieangaben des Lieferanten
deeplink String (1024)Link zum Artikel beim Lieferanten
recommendedRetailPriceNet DoubleUVP-Angabe des Lieferanten
priceJaBigDecimalPreis
priceCalcJaBigDecimalKalkulierter Preis, auf Grundlage der individuellen Preiskalkulation
currencyCodeJaString (3)Währungseinheit, die für diese Preisinformation gilt
priceCalcVatJaBigDecimalUmsatzsteuersatz, der zur Berechnung des kalkulierten Preises benutzt wurde
priceLastUpdateJaDateZeitpunkt der letzten Aktualisierungs der Preisinformation
stockSupplierText StringBestandsinformation zur Bezugsquelle, wie vom Lieferanten übermittelt
stockStatus IntegerNumerischer Schlüssel des Lieferstatus dieser Bestandsinformation
stockStatusText String (255)Lieferstatus dieser Bestandsinformation, z.B. „auf Lager“ oder „im Außenlager“
stock IntegerBestandsmenge
externalStock IntegerIm Außenlager befindliche Bestandsmenge (Zusatzinformation einiger Lieferanten in Strukturen des Lieferstatus „auf Lager“)
incomingStock IntegerIm Zulauf befindliche Bestandsmenge (Zusatzinformation einiger Lieferanten in Strukturen des Lieferstatus „auf Lager“)
stockAvailabilityDate DateLiefertermin für nicht auf Lager befindliche Ware
lastStockUpdate DateZeitpunkt der letzten Aktualisierung der Bestandsinformation

project

Informationen, Preis und Verfügbarkeit eines Projektartikels.

NamePflichtfeldDatentypBeschreibung
supplierProjectId String (40)Projektnummer des Lieferanten
manufacturerProjectIdJaString (40)Projektnummer des Herstellers (eindeutiger Key)
projectName String (255)Projektbezeichnung
endCustomer String (255)Endkunde des Projektartikels
priceJaBigDecimalProjektpreis
validFrom DateDatum, ab dem die Projektkonditionen gelten
validTo DateDatum, ab dem die Projektkonditionen ungültig werden
targetQuantity IntegerVereinbarte Menge im Projektrahmen
remainingQuantityJaIntegerVerbleibendes Kontingent
minQuantity IntegerMindestbestellmenge für dieses Projekt
projectLastUpdate DateZeitpunkt der letzten Aktualisierung der Projektinformationen

attribute

Eigenschaften zu einem Produkt.

NamePflichtfeldDatentypBeschreibung
displayValue String (10000)Der lesbare Wert der Eigenschaft, inklusive Einheit
attributeTypeId LongEindeutige Kennung eines konkreten Eigenschafttyps
attributeTypeName String (255)Name des konkreten Eigenschafttyps
attributeTypeRank LongRanking des Eigenschafttyps, kann z.B. zur Sortierung verwendet werden
attributeTypeGroupId LongKennung einer Eigenschaftsgruppe, kein Tabellenverweis, sondern identifiziert attributeTypeGroupName eindeutig
attributeTypeGroupName String (255)Name der Eigenschaftsgruppe

attributeCluster

Eigenschaftscluster, in denen das Produkt für Merkmalssuchen gefunden werden kann. Kann je nach Menge mehrere Eigenschaftsausprägungen in Intervallen zusammenfassen, z.B. 64-128MB RAM.

NamePflichtfeldDatentypBeschreibung
id LongEindeutiger ITscope Key
productTypeId LongReferenz auf den Produkttyp, optional
productTypeName String (255)Name des Produkttyps, zu dem diese Eigenschaftsausprägung gehört, optional
attributeTypeName String (255)Name einer Eigenschaft. Kann analog dem Namen aus ProductType.attributeTypeName(1..5) sein
attributeTypeGroupName String (255)Name einer Eigenschaftsgruppe
name String (255)Bezeichner der Ausprägung (z.B. 2 GB, 15″, 80 W – 120 W)
rank LongRang der Eigenschaft

accessory

Originalzubehör und kompatibles Zubehör zu einem Produkt.

NamePflichtfeldDatentypBeschreibung
referencedProductId LongReferenz auf ein Bezugsprodukt, z.B. ein Produkt das als Originalzubehör geführt wird
typeId IntegerInterne Kennung für die Art des Bezugsproduktes
type String (255)Bezeichner für die Art des Bezugsproduktes, z.B. Original-Zubehör, Kompatibles Zubehör, usw.

Datenbank-Skripte für CSV

Was this article helpful?
Dislike 0
Views: 595