Lesen Sie vorher bitte das Thema Datenformate und Ausgabeformate durch, um sicherzustellen dass Sie dieses Datenformat verwenden wollen.
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.
- productPriceInfo: – Kalkulierte Preisinformation für ein Produkt. Ist nur vorhanden, wenn aus den Lieferanten innerhalb der Plattform hinterlegten Preiskalkulationsregeln ein Preis ausgewählt und berechnet werden kann.
- productStockInfo: – Verfügbarkeitsinformation der in productPriceInfo ausgewählten Bezugsquelle.
- supplierItem: – Bezugsquelle eines ITscope-Produkts. Ein konkretes Angebot eines auf ITscope gelisteten Distributors.
- supplier: – Lieferant einer Bezugsquelle.
- supplierPriceInfo: – Preisdaten zu einer Bezugsquelle. Für jede konfigurierte Preisquelle ist eine PriceInfo hinterlegt, z.B. Realtime, individuelle Preisliste, allgemein verfügbare Preisliste. Bei einigen Lieferanten sind keine allgemein verfügbaren Preise gelistet, hier ist die supplierPriceInfo leer, wenn keine eigene Preisliste konfiguriert wurde.
- supplierStockInfo: – Verfügbarkeitsinformation der Bezugsquelle.
- project: – Informationen, Preis und Verfügbarkeit eines Projektartikels
Die mit einem 
Globus markierten Elemente ändern sich je nach gewählter Exportsprache:
product
Produkt des ITscope-Katalogs.
| Name | Pflichtfeld | Datentyp | Beschreibung |
|---|---|---|---|
| puid | Ja | Long | Eindeutiger Key |
| productPriceInfo | productPriceInfo | Kalkulierte Preisinformation für ein Produkt. Ist nur vorhanden, wenn aus den Lieferanten innerhalb der Plattform hinterlegten Preiskalkulationsregeln ein Preis ausgewählt und berechnet werden kann. | |
| productStockInfo | productStockInfo | Verfügbarkeitsinformation der in productPriceInfo ausgewählten Bezugsquelle. | |
| supplierItem | Ja | List<supplierItem> | Bezugsquelle eines ITscope-Produkts. Ein konkretes Angebot eines auf ITscope gelisteten Distributors. |
productPriceInfo
Kalkulierte Preisinformation für ein Produkt. Ist nur vorhanden, wenn aus den Lieferanten innerhalb der Plattform hinterlegten Preiskalkulationsregeln ein Preis ausgewählt und berechnet werden kann.
| Name | Pflichtfeld | Datentyp | Beschreibung |
|---|---|---|---|
| price | Ja | BigDecimal | Preisbasis für den kalkulierten Preis |
| priceCalc | Ja | BigDecimal | Kalkulierter Preis, auf Grundlage der individuellen Preiskalkulation |
| currencyCode | Ja | String (3) | Währungseinheit, die für diese Preisinformation gilt |
| priceCalcVat | Ja | BigDecimal | Umsatzsteuersatz, der zur Berechnung des kalkulierten Preises benutzt wurde |
| priceLastUpdate | Ja | Date | Zeitpunkt der letzten Aktualisierungs der Preisinformation |
| minScale | Ja | Integer | Preis ab Staffel |
| priceSourceId | Ja | Integer | Kennung für die Herkunft der Preisinformation |
| priceSourceName | String (255) | Lesbarer Text zur Herkunft der Preisinformation, z.B. „Individuelle Preisliste“ | |
| priceStatus | Ja | String (255) | Textuelle Information zum Preisabruf, z.B. „Der Abruf der Daten war erfolgreich“ |
| priceSupplierId | Ja | Long | Referenz auf einen Lieferanten (1:1), der die Bezugsquelle mit dieser Preisinformation bereitgestellt hat |
| priceSupplierName | Ja | String (255) | Name des Lieferanten, der diese Bezugsquelle bereitgestellt hat |
| priceSupplierItemId | Ja | Long | Referenz 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 | Ja | String (150) | Produktbezeichner des Lieferanten, der diese Bezugsquelle bereitgestellt hat [vor 18.10.2021 String(40)] |
| priceBillingPeriod | Integer | Länge des Zyklus des Abrechnungszeitraums | |
| priceBillingPeriodUnit | String (40) | Zeiteinheit des Abrechnungszeitraums (z.B. „Years“, „Months“) | |
| priceSubscriptionPeriod | Integer | Länge der Vertragsdauer | |
| priceSubscriptionPeriodUnit | String (40) | Zeiteinheit der Vertragsdauer (z.B. „Years“, „Months“) |
productStockInfo
Verfügbarkeitsinformation der in productPriceInfo ausgewählten Bezugsquelle.
| Name | Pflichtfeld | Datentyp | Beschreibung |
|---|---|---|---|
| stockSupplierText | String (40) | Textuelle Bestandsinformation des Lieferanten, direkt übernommen, ohne Interpretation | |
| stockStatus | Ja | Integer | Numerischer Schlüssel des Lieferstatus dieser Bestandsinformation |
| stockStatusText | Ja | String (255) | Lieferstatus dieser Bestandsinformation, z.B. „auf Lager“ oder „im Außenlager“ |
| stock | Ja | Integer | Bestandsmenge des in dieser Struktur angegebenen Lieferstatus |
| externalStock | Integer | Im Außenlager befindliche Bestandsmenge (Zusatzinformation einiger Lieferanten in Strukturen des Lieferstatus „auf Lager“) | |
| incomingStock | Integer | Im Zulauf befindliche Bestandsmenge (Zusatzinformation einiger Lieferanten in Strukturen des Lieferstatus „auf Lager“) | |
| stockAvailabilityDate | Date | Liefertermin für nicht auf Lager befindliche Ware | |
| stockLastUpdate | Ja | Date | Zeitpunkt der letzten Aktualisierung der Bestandsinformation |
| stockSourceId | Ja | Integer | Numerischer Schlüssel der Quelle der Bestandsinformation |
| stockSourceName | Ja | String (255) | Quelle der Bestandsinformation, z.B. „Individuelle Preisliste“ |
| stockUnlimited | Ja | Boolean | Kennzeichen, ob die Ware dieser Bestandsinformation in unbegrenzter Menge zur Verfügung steht |
supplierItem
Bezugsquelle eines ITscope-Produkts. Ein konkretes Angebot eines auf ITscope gelisteten Distributors.
| Name | Pflichtfeld | Datentyp | Beschreibung |
|---|---|---|---|
| id | Ja | Long | Eindeutiger Key |
| supplierSKU | String (150) | Produktnummer des Lieferanten [vor 18.10.2021 String(40)] | |
| supplier | Ja | supplier | Verweist 1:1 auf Supplier.id |
| supplierPriceInfo | List<supplierPriceInfo> | Preisdaten zu einer Bezugsquelle. Für jede konfigurierte Preisquelle ist eine PriceInfo hinterlegt, z.B. Realtime, individuelle Preisliste, allgemein verfügbare Preisliste. Bei einigen Lieferanten sind keine allgemein verfügbaren Preise gelistet, hier ist die supplierPriceInfo leer, wenn keine eigene Preisliste konfiguriert wurde. | |
| supplierStockInfo | List<supplierStockInfo> | Verfügbarkeitsinformation der Bezugsquelle. | |
| projects | List<project> | Projekte auf Bezugsquellenartikel | |
| supplierPackagingInfo | supplierPackagingInfo | Information zur Verpackungseinheiten einer Bezugsquelle |
supplierPackagingInfo
Information zu Verpackungseinheiten einer Bezugsquelle. Die Einheitencodes für Verpackungseinheiten sind in der UN/ECE-Empfehlung No.21. Dieser Standard wird von UN/CEFACT empfohlen. Details siehe UNECE.
| Name | Pflichtfeld | Datentyp | Beschreibung |
|---|---|---|---|
| contentUnit | String (50) | Einheitscode der Inhalte einer Verpackung | |
| intervalQuantity | Integer | Zahl, die angibt, in welcher Staffelung der Artikel bestellt werden kann (in Bestelleinheiten) | |
| minQuantity | Integer | Minimale Anzahl an Verpackungseinheiten um eine Bestellung auszulösen | |
| numberContentUnitPerOrderUnit | Integer | Anzahl der Inhalte einer Verpackungseinheit | |
| orderUnit | String (50) | Verpackungseinheitscode | |
| priceQuantity | Integer | Anzahl der Verpackungseinheiten für einen gegebenen Preis | |
| supplierPackingQuantity | Integer | Anzahl der Verpackungseinheiten die ein Lieferant in einer Bestellung zur Verfügung stellt | |
| totalPriceQuantity | Integer | Gesamte Anzahl an Einheiten (Verpackungseinheiten * Inhalte) für einen gegebenen Preis |
supplier
Lieferant einer Bezugsquelle.
| Name | Pflichtfeld | Datentyp | Beschreibung |
|---|---|---|---|
| id | Ja | Long | Eindeutiger Key |
| name | Ja | String (255) | Bezeichner des Lieferanten |
| deeplink | Ja | String (2048) | URL, Link auf den Lieferanten innerhalb der ITscope Plattform |
| customerAccountNumber | String (255) | Kundennummer im Falle einer Partnerschaft. Kann als Filter verwendet werden, um zu ermitteln ob zu diesem Lieferanten eine Parnerschaft existiert | |
| weeeRegNo | String (12) | WEEE Nummer, gilt als Nachweis der im Herstellungsland vorgenommenen Registrierung des Herstellers, der Marke und der elektrischen oder elektronischen Geräteart |
supplierPriceInfo
Preisdaten zu einer Bezugsquelle. Für jede konfigurierte Preisquelle ist eine PriceInfo hinterlegt, z.B. Realtime, individuelle Preisliste, allgemein verfügbare Preisliste. Bei einigen Lieferanten sind keine allgemein verfügbaren Preise gelistet, hier ist die supplierPriceInfo leer, wenn keine eigene Preisliste konfiguriert wurde.
| Name | Pflichtfeld | Datentyp | Beschreibung |
|---|---|---|---|
| price | Ja | BigDecimal | Preisbasis für den kalkulierten Preis |
| priceCalc | Ja | BigDecimal | Kalkulierter Preis, auf Grundlage der individuellen Preiskalkulation |
| currencyCode | Ja | String (3) | Währungseinheit, die für diese Preisinformation gilt |
| priceCalcVat | Ja | BigDecimal | Umsatzsteuersatz, der zur Berechnung des kalkulierten Preises benutzt wurde |
| priceLastUpdate | Ja | Date | Zeitpunkt der letzten Aktualisierungs der Preisinformation |
| minScale | Ja | Integer | Preis ab Staffel |
| priceSourceId | Ja | Integer | Kennung für die Herkunft der Preisinformation |
| priceSourceName | String (255) | Lesbarer Text zur Herkunft der Preisinformation, z.B. „Individuelle Preisliste“ | |
| priceStatus | Ja | String (255) | Textuelle Information zum Preisabruf, z.B. „Der Abruf der Daten war erfolgreich“ |
| priceBillingPeriod | Integer | Länge des Zyklus des Abrechnungszeitraums | |
| priceBillingPeriodUnit | String (40) | Zeiteinheit des Abrechnungszeitraums (z.B. „Years“, „Months“) | |
| priceSubscriptionPeriod | Integer | Länge der Vertragsdauer | |
| priceSubscriptionPeriodUnit | String (40) | Zeiteinheit der Vertragsdauer (z.B. „Years“, „Months“) |
supplierStockInfo
Verfügbarkeitsinformation der Bezugsquelle.
| Name | Pflichtfeld | Datentyp | Beschreibung |
|---|---|---|---|
| stockSupplierText | String (40) | Textuelle Bestandsinformation des Lieferanten, direkt übernommen, ohne Interpretation | |
| stockStatus | Ja | Integer | Numerischer Schlüssel des Lieferstatus dieser Bestandsinformation |
| stockStatusText | Ja | String (255) | Lieferstatus dieser Bestandsinformation, z.B. „auf Lager“ oder „im Außenlager“ |
| stock | Ja | Integer | Bestandsmenge des in dieser Struktur angegebenen Lieferstatus |
| externalStock | Integer | Im Außenlager befindliche Bestandsmenge (Zusatzinformation einiger Lieferanten in Strukturen des Lieferstatus „auf Lager“) | |
| incomingStock | Integer | Im Zulauf befindliche Bestandsmenge (Zusatzinformation einiger Lieferanten in Strukturen des Lieferstatus „auf Lager“) | |
| stockAvailabilityDate | Date | Liefertermin für nicht auf Lager befindliche Ware | |
| stockLastUpdate | Ja | Date | Zeitpunkt der letzten Aktualisierung der Bestandsinformation |
| stockSourceId | Ja | Integer | Numerischer Schlüssel der Quelle der Bestandsinformation |
| stockSourceName | Ja | String (255) | Quelle der Bestandsinformation, z.B. „Individuelle Preisliste“ |
| stockUnlimited | Ja | Boolean | Kennzeichen, ob die Ware dieser Bestandsinformation in unbegrenzter Menge zur Verfügung steht |
project
Informationen, Preis und Verfügbarkeit eines Projektartikels
| Name | Pflichtfeld | Datentyp | Beschreibung |
|---|---|---|---|
| supplierProjectId | String (40) | Projektnummer des Lieferanten | |
| manufacturerProjectId | Ja | String (40) | Projektnummer des Herstellers (eindeutiger Key) |
| price | Ja | BigDecimal | Projektpreis |
| remainingQuantity | Ja | Integer | Verbleibendes Kontingent |
| projectLastUpdate | Date | Zeitpunkt der letzten Aktualisierung der Projektinformationen | |
| projectBundleId | String (50) | Eindeutiger Key des Projektbundles | |
| projectPosition | Integer | Projektpositionsnummer |