Formatbeschreibung für Produkte Datenformat developerUpdate

Last modified: 18. März 2024

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.

NamePflichtfeldDatentypBeschreibung
puidJaLongEindeutiger Key
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png productPriceInfo productPriceInfoKalkulierte 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.
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png productStockInfo productStockInfoVerfügbarkeitsinformation der in productPriceInfo ausgewählten Bezugsquelle.
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png supplierItemJaList<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.

NamePflichtfeldDatentypBeschreibung
priceJaBigDecimalPreisbasis für den kalkulierten Preis
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
minScaleJaIntegerPreis ab Staffel
priceSourceIdJaIntegerKennung für die Herkunft der Preisinformation
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png priceSourceName String (255)Lesbarer Text zur Herkunft der Preisinformation, z.B. „Individuelle Preisliste“
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png priceStatusJaString (255)Textuelle Information zum Preisabruf, z.B. „Der Abruf der Daten war erfolgreich“
priceSupplierIdJaLongReferenz auf einen Lieferanten (1:1), der die Bezugsquelle mit dieser Preisinformation bereitgestellt hat
priceSupplierNameJaString (255)Name des Lieferanten, der diese Bezugsquelle bereitgestellt hat
priceSupplierItemIdJaLongReferenz 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)
priceSupplierSKUJaString (150)Produktbezeichner des Lieferanten, der diese Bezugsquelle bereitgestellt hat [vor 18.10.2021 String(40)]
priceBillingPeriodIntegerLänge des Zyklus des Abrechnungszeitraums
priceBillingPeriodUnitString (40)Zeiteinheit des Abrechnungszeitraums (z.B. „Years“, „Months“)
priceSubscriptionPeriodIntegerLänge der Vertragsdauer
priceSubscriptionPeriodUnitString (40)Zeiteinheit der Vertragsdauer (z.B. „Years“, „Months“)

productStockInfo

Verfügbarkeitsinformation der in productPriceInfo ausgewählten Bezugsquelle.

NamePflichtfeldDatentypBeschreibung
stockSupplierText String (40)Textuelle Bestandsinformation des Lieferanten, direkt übernommen, ohne Interpretation
stockStatusJaIntegerNumerischer Schlüssel des Lieferstatus dieser Bestandsinformation
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png stockStatusTextJaString (255)Lieferstatus dieser Bestandsinformation, z.B. „auf Lager“ oder „im Außenlager“
stockJaIntegerBestandsmenge 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
stockLastUpdateJaDateZeitpunkt der letzten Aktualisierung der Bestandsinformation
stockSourceIdJaIntegerNumerischer Schlüssel der Quelle der Bestandsinformation
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png stockSourceNameJaString (255)Quelle der Bestandsinformation, z.B. „Individuelle Preisliste“
stockUnlimitedJaBooleanKennzeichen, 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.

NamePflichtfeldDatentypBeschreibung
idJaLongEindeutiger Key
supplierSKU String (150)Produktnummer des Lieferanten [vor 18.10.2021 String(40)]
supplierJasupplierVerweist 1:1 auf Supplier.id
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png 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.
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png supplierStockInfo List<supplierStockInfo>Verfügbarkeitsinformation der Bezugsquelle.
projectsList<project>Projekte auf Bezugsquellenartikel
supplierPackagingInfosupplierPackagingInfoInformation 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.

NamePflichtfeldDatentypBeschreibung
contentUnit String (50)Einheitscode der Inhalte einer Verpackung
intervalQuantityIntegerZahl, die angibt, in welcher Staffelung der Artikel bestellt werden kann (in Bestelleinheiten)
minQuantity IntegerMinimale Anzahl an Verpackungseinheiten um eine Bestellung auszulösen
numberContentUnitPerOrderUnit IntegerAnzahl der Inhalte einer Verpackungseinheit
orderUnitString (50)Verpackungseinheitscode
priceQuantity IntegerAnzahl der Verpackungseinheiten für einen gegebenen Preis
supplierPackingQuantity IntegerAnzahl der Verpackungseinheiten die ein Lieferant in einer Bestellung zur Verfügung stellt
totalPriceQuantityIntegerGesamte Anzahl an Einheiten (Verpackungseinheiten * Inhalte) für einen gegebenen Preis

supplier

Lieferant einer Bezugsquelle.

NamePflichtfeldDatentypBeschreibung
idJaLongEindeutiger Key
nameJaString (255)Bezeichner des Lieferanten
deeplinkJaString (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
weeeRegNoString (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.

NamePflichtfeldDatentypBeschreibung
priceJaBigDecimalPreisbasis für den kalkulierten Preis
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
minScaleJaIntegerPreis ab Staffel
priceSourceIdJaIntegerKennung für die Herkunft der Preisinformation
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png priceSourceName String (255)Lesbarer Text zur Herkunft der Preisinformation, z.B. „Individuelle Preisliste“
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png priceStatusJaString (255)Textuelle Information zum Preisabruf, z.B. „Der Abruf der Daten war erfolgreich“
priceBillingPeriodIntegerLänge des Zyklus des Abrechnungszeitraums
priceBillingPeriodUnitString (40)Zeiteinheit des Abrechnungszeitraums (z.B. „Years“, „Months“)
priceSubscriptionPeriodIntegerLänge der Vertragsdauer
priceSubscriptionPeriodUnitString (40)Zeiteinheit der Vertragsdauer (z.B. „Years“, „Months“)

supplierStockInfo

Verfügbarkeitsinformation der Bezugsquelle.

NamePflichtfeldDatentypBeschreibung
stockSupplierText String (40)Textuelle Bestandsinformation des Lieferanten, direkt übernommen, ohne Interpretation
stockStatusJaIntegerNumerischer Schlüssel des Lieferstatus dieser Bestandsinformation
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png stockStatusTextJaString (255)Lieferstatus dieser Bestandsinformation, z.B. „auf Lager“ oder „im Außenlager“
stockJaIntegerBestandsmenge 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
stockLastUpdateJaDateZeitpunkt der letzten Aktualisierung der Bestandsinformation
stockSourceIdJaIntegerNumerischer Schlüssel der Quelle der Bestandsinformation
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png stockSourceNameJaString (255)Quelle der Bestandsinformation, z.B. „Individuelle Preisliste“
stockUnlimitedJaBooleanKennzeichen, ob die Ware dieser Bestandsinformation in unbegrenzter Menge zur Verfügung steht

project

Informationen, Preis und Verfügbarkeit eines Projektartikels

NamePflichtfeldDatentypBeschreibung
supplierProjectId String (40)Projektnummer des Lieferanten
manufacturerProjectIdJaString (40)Projektnummer des Herstellers (eindeutiger Key)
priceJaBigDecimalProjektpreis
remainingQuantityJaIntegerVerbleibendes Kontingent
projectLastUpdate DateZeitpunkt der letzten Aktualisierung der Projektinformationen
projectBundleIdString (50)Eindeutiger Key des Projektbundles (Freischaltbar per ITscope Testlabor)
projectPositionInteger Projektpositionsnummer (Freischaltbar per ITscope Testlabor)

Datenbank-Skripte für CSV

Was this article helpful?
Dislike 1
Views: 648