Description du format pour les produits, format de données standard

Last modified: 22. octobre 2021

Schéma de la base de données

Diagramme de dépendance au format de sortie csv, incluant des scripts SQL pour créer les tables et charger les données avec le fichier local de chargement à la fin du message.


Aperçu des éléments du format des données

En format de sortie CSV, ces éléments sont des fichiers, en format de sortie XML ou JSON, ce sont des nœuds.

Le format de données standard comprend les éléments suivants :

  • product: – Produit du catalogue ITscope
  • supplierItem: – Source d’approvisionnement d’un produit ITscope. Une offre concrète d’un distributeur référencé sur ITscope
  • project: – Informations, prix et disponibilité d’un élément de projet
  • attribute: – Propriétés d’un produit
  • attributeCluster: – Les groupes de propriétés dans lesquels le produit peut être trouvé pour des recherches de caractéristiques. Peut regrouper plusieurs caractéristiques de propriété dans des intervalles en fonction de la quantité, par exemple 64-128 MB de RAM
  • accessory: – Accessoires originaux et accessoires compatibles dans un seul produit
  • historicalDataItem: – Données historiques agrégées hebdomadaires ou mensuelles, en fonction de la période et de l’agrégation souhaitées.

Les éléments marqués d’un globe changent en fonction de la langue d’exportation sélectionnée :

Les champs marqués d’un * sont de nouveaux ajouts par rapport à l’API 2.0, les champs marqués d’un ** ont seulement été déplacés à un autre endroit du fichier. Les champs avec *** ont été renommés.

product

Produit du catalogue ITscope.

NOMCHAMP OBLIGATOIRETYPE DE DONNÉESDESCRIPTION
puidOuiLongClé unique
ean String (18)EAN
manufacturerSKU String (150)Numéro d’article du fabricant [avant le 18.10.2021 : String(40)]
icecatId String (255)IceCat ID
cnetId String (255)CNET ID
bechlemId String (255)Bechlem ID
eClass String (255)eClass ID Version 5.1.2
eClassV7 * String (255)eClass ID Version 7.0
customsTariffNumber ** String (255)Numéro du tarif douanier
UNSPSC * String (14)Code de classification de l’UNSPSC
manufacturerIdOuiLongRéférence au fabricant de ce produit (n:1 sur Manufacturer.id)
manufacturerName String (255)Nom du fabricant
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png productName ***OuiStringIdentificateur du produit, par défaut, y compris le nom du fabricant, mais ne peut être configuré que par exportation, de sorte que le nom du fabricant est supprimé
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png shortDescription StringPar défaut, il s’agit du nom court du produit, mais il ne peut être configuré que via l’exportation
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png longDescription StringTexte long du produit
productTypeIdOuiLongRéférence au type de produit de ce produit
productTypeGroupIdOuiString (3)Référence au groupe de types de produits (ProductTypeGroup.id, n:1)
productTypeGroupNameOuiString (255)Nom du groupe de types de produits, par exemple la technologie de réseau. Peut être utilisé comme niveau de 1ère catégorie
productTypeNameOuiString (255)Identifiant du type de produit. Peut être utilisé comme niveau de 2ème catégorie
attributeTypeId1 LongClé d’attribut unique pour construire une éventuelle sous-catégorie, renvoie 1:n à AttributeCluster.attributeTypeId
attributeTypeName1 String (255)Identificateur de l’attribut permettant de construire une éventuelle sous-catégorie
attributeTypeId2 LongClé d’attribut unique pour construire une éventuelle sous-catégorie, renvoie 1:n à AttributeCluster.attributeTypeId
attributeTypeName2 String (255)Identificateur de l’attribut permettant de construire une éventuelle sous-catégorie
attributeTypeId3 LongClé d’attribut unique pour construire une éventuelle sous-catégorie, renvoie 1:n à AttributeCluster.attributeTypeId
attributeTypeName3 String (255)Identificateur de l’attribut permettant de construire une éventuelle sous-catégorie
attributeTypeId4 LongClé d’attribut unique pour construire une éventuelle sous-catégorie, renvoie 1:n à AttributeCluster.attributeTypeId
attributeTypeName4 String (255)Identificateur de l’attribut permettant de construire une éventuelle sous-catégorie
attributeTypeId5 LongClé d’attribut unique pour construire une éventuelle sous-catégorie, renvoie 1:n à AttributeCluster.attributeTypeId
attributeTypeName5 String (255)Identificateur de l’attribut permettant de construire une éventuelle sous-catégorie
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeValue1 String (1024)Valeur de la propriété pour l’attribut de ProductType.attributeTypeId1. Peut être utilisé comme niveau de 3ème catégorie, si disponible
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeValue2 String (1024)Valeur de la propriété pour l’attribut de ProductType.attributeTypeId2. Peut être utilisé comme niveau de 4ème catégorie, si disponible
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeValue3 String (1024)Valeur de la propriété pour l’attribut de ProductType.attributeTypeId3. Peut être utilisé comme niveau de 5ème catégorie, si disponible
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeValue4 String (1024)Valeur de la propriété pour l’attribut de ProductType.attributeTypeId4
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeValue5 String (1024)Valeur de la propriété pour l’attribut de ProductType.attributeTypeId5
productSubTypeId String (1024)ID du type de propriété
productSubType String (1024)Propriété de type du produit, par exemple souris ou clavier pour les périphériques d’entrée. Ne doit pas être utilisé comme niveau de 3ème catégorie
productLineId LongIdentification de la ligne de produits
productLine String (1024)Ligne de produits
productModel String (1024)Identificateur du modèle de produit
colorFamilyId * String (255)Identification de la famille de couleur
colorFamily * String (255)Famille de couleurs
estimateGrossWeight DoublePoids en kilogramme
grossDimX String (1024)Longueur du produit, y compris l’unité de mesure
grossDimY String (1024)Hauteur du produit, y compris l’unité de mesure
grossDimZ String (1024)Largeur du produit, y compris l’unité de mesure
combinedLengthAndGirth * String (36)Circonférence
netWeight * String (36)Poids net
netDimX * String (36)Mesure nette X
netDimY * String (36)Mesure nette Y
netDimZ * String (36)Mesure nette Z
valueAddedTaxGermany * IntegerTaux de TVA allemand
deeplinkOuiString (2048)Lien profond vers la plateforme ITscope.com
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png standardHtmlDatasheetOuiString (2048)URL, lien vers la fiche technique standard HTML
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png standardPdfDatasheet String (2048)URL, lien vers la fiche technique standard PDF
manufacturerSite String (1024)URL, lien vers la page du fabricant
manufacturerDatasheet String (1024)URL, lien vers la fiche technique du fabricant
imageThumb String (1024)Avant-première de la meilleure image de produit
imageThumbWidth IntegerLargeur du support de l’image en pixels
imageThumbHeight IntegerHauteur du support de l’image en pixels
imageHighRes1 *** String (1024)Lien vers la meilleure image possible, dans la version la plus grande
imageWidth1 IntegerLargeur du support de l’image en pixels
imageHeight1 IntegerHauteur du support de l’image en pixels
image2 String (1024)Lien vers une autre bonne image de produit, de préférence celle d’un emballage de produit (jamais la même que la première image)
imageWidth2 IntegerLargeur du support de l’image en pixels
imageHeight2 IntegerHauteur du support de l’image en pixels
image3 String (1024)Lien vers la première photo de la galerie (jamais une de celles qui figurent déjà dans la liste)
imageWidth3 IntegerLargeur du support de l’image en pixels
imageHeight3 IntegerHauteur du support de l’image en pixels
image4 String (1024)Lien vers la deuxième photo de la galerie (jamais une de celles qui figurent déjà dans la liste)
imageWidth4 IntegerLargeur du support de l’image en pixels
imageHeight4 IntegerHauteur du support de l’image en pixels
image5 String (1024)Lien vers la troisième image de la galerie (jamais une de celles qui figurent déjà dans la liste)
imageWidth5 IntegerLargeur du support de l’image en pixels
imageHeight5 IntegerHauteur du support de l’image en pixels
energyLabel String (1024)Lien vers l’image du label énergétique
energyEfficiencyClass * String (10)Classe d’efficacité énergétique
entryDateOuiDateÀ partir de quand le produit est-il sur la plate-forme
rank IntegerClassement général de popularité (rang 1 à n, un chiffre élevé correspond à un mauvais classement)
qualification IntegerQualification du produit
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png warrantyText StringTexte de garantie du produit
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png marketingText StringTexte de marketing pour le produit
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png keySellingPoints * StringKey Selling Points
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png packageContents * StringÉtendue de la prestation
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png productFeatures * StringCaractéristiques du produit
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png htmlMainSpecs * StringCaractéristiques techniques du produit sous forme abrégée, séparées par des étiquettes br
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png htmlSpecs StringCaractéristiques techniques du produit, en format HTML
recommendedRetailPriceNet DoublePrix de détail suggéré par le fabricant
price BigDecimalBase du prix calculé
priceCalc BigDecimalPrix calculé, sur la base du calcul du prix individuel
currencyCode String (3)Unité monétaire applicable à cette information sur les prix
priceCalcVat BigDecimalTaux de TVA utilisé pour le calcul du prix calculé
priceLastUpdate DateHeure de la dernière mise à jour de l’information sur les prix
priceSupplierId LongRéférence à un fournisseur (1:1) qui a fourni à la source d’approvisionnement cette information sur les prix
priceSupplierName String (255)Nom du fournisseur qui a fourni cette source d’approvisionnement
priceSupplierItemId LongRéférence à une source (n:1) ; si ce champ est nul, l’information sur le prix se rapporte à un produit (la référence à la source et la référence au produit s’excluent mutuellement)
priceSupplierSKU String (150)Identifiant du produit du fournisseur qui a fourni cette source d’approvisionnement [avant le 18.10.2021 : String(40)]
stockSupplierText String (40)Informations textuelles sur le stock du fournisseur, directement transférées, sans interprétation
stockStatus IntegerClé numérique de l’état de livraison de ces informations sur les stocks
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png stockStatusText String (255)Statut de livraison de cette information sur les stocks, par exemple « en stock » ou « dans un entrepôt externe
stock IntegerQuantité de stock du statut de livraison spécifié dans cette structure
externalStock IntegerQuantité en stock dans l’entrepôt externe (informations complémentaires de certains fournisseurs dans les structures du statut de livraison « en stock »)
incomingStock IntegerQuantité en stock (informations complémentaires de certains fournisseurs dans les structures du statut de livraison « en stock »)
stockAvailabilityDate DateDate de livraison pour les marchandises non en stock
stockLastUpdate DateDate de la dernière mise à jour de l’information sur les stocks
aggregatedStatus IntegerStatut de meilleure disponibilité
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png aggregatedStatusText String (255)Bester Verfügbarkeitsstatus
aggregatedStock IntegerTotal de tous les stocks
aggregatedSupplierItems IntegerSomme de tous les distributeurs pour ce produit
contractTypeId * IntegerL’identifiant du type de contrat pour les produits de licence, de service, de CTO et de pièces détachées
contractTypeName * String (255)Le nom du type de contrat pour les produits de licence, de service, de CTO et de pièces détachées
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png supplierItem List<supplierItem>Source d’approvisionnement d’un produit ITscope. Une offre concrète d’un distributeur référencé sur ITscope
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attribute List<attribute>Propriétés d’un produit
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeCluster List<attributeCluster>Les groupes de propriétés dans lesquels le produit peut être trouvé pour des recherches de caractéristiques. Peut regrouper plusieurs caractéristiques de propriété dans des intervalles en fonction de la quantité, par exemple 64-128 MB de RAM
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png accessory List<accessory>Accessoires originaux et accessoires compatibles dans un seul produit.

supplierItem

Source d’approvisionnement d’un produit ITscope. Une offre concrète d’un distributeur référencé sur ITscope.

NOMCHAMP OBLIGATOIRETYPE DE DONNÉESDESCRIPTION
idOuiLongClé unique
ean String (18)Spécification EAN du fournisseur
manufacturerSKU String (150)Spécification du numéro d’article du fabricant du fournisseur (ne doit pas correspondre à ITscope) [avant le 18.10.2021 : String(40)]
supplierSKU String (150)Numéro de produit du fournisseur [avant le 18.10.2021 : String(40)]
supplierIdOuiLongRenvoie 1:1 au Supplier.id
supplierName String (255)Nom du fournisseur
manufacturerName String (80)Nom du fabricant tel que spécifié par le fournisseur
productName String (255)Identifiant exact de l’article, tel que transmis par le fournisseur
longDescription String (60000)Description détaillée de l’article du fournisseur
conditionIdOuiIntegerCode numérique de l’état de l’article
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png conditionNameOuiString (255)État de l’objet (neuf, d’occasion, de type B, remis à neuf, etc.)
eolProductOuiBooleanIdentifiant : article abandonné
matchQualityOuiIntegerAffectation de la qualité de l’article au catalogue de produits ITscope
eanValidOuiBooleanDrapeau, indiquant si le EAN du vendeur est valable selon les critères du EAN.
specialOfferOuiBooleanIndiquer si l’article est en promotion
promotion String (40)Nom de l’action de promotion du fournisseur
vat IntegerTaux de TVA pour l’article
copyrightLevy DoublePrélèvement de droits d’auteur
customsTariffNumber String (50)Numéro du tarif douanier
countryOfOrigin String (20)Pays d’origine de l’article
grossDimX DoubleLongueur du produit, y compris l’unité de mesure
grossDimY DoubleHauteur du produit, y compris l’unité de mesure
grossDimZ DoubleLargeur du produit, y compris l’unité de mesure
warrantyText String (40)Informations sur la garantie du fournisseur
deeplink String (1024)Lien vers l’article chez le fournisseur
recommendedRetailPriceNet DoubleInformations sur les UVP du fournisseur
priceOuiBigDecimalPrix
priceCalcOuiBigDecimalPrix calculé, sur la base du calcul du prix individuel
currencyCodeOuiString (3)Unité monétaire applicable à cette information sur les prix
priceCalcVatOuiBigDecimalTaux de TVA utilisé pour le calcul du prix calculé
priceLastUpdateOuiDateHeure de la dernière mise à jour de l’information sur les prix
stockSupplierText StringInformations sur l’inventaire de la source d’approvisionnement, telles que transmises par le fournisseur
stockStatus IntegerClé numérique de l’état de livraison de ces informations sur les stocks
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png stockStatusText String (255)Statut de livraison de cette information sur les stocks, par exemple « en stock » ou « dans un entrepôt externe »
stock IntegerQuantité en stock
externalStock IntegerQuantité en stock dans l’entrepôt externe (informations complémentaires de certains fournisseurs dans les structures du statut de livraison « en stock »)
incomingStock IntegerQuantité en stock (informations complémentaires de certains fournisseurs dans les structures du statut de livraison « en stock »)
stockAvailabilityDate DateDate de livraison pour les marchandises non en stock
lastStockUpdate DateDate de la dernière mise à jour de l’information sur les stocks
contractTypeId * IntegerL’identifiant du type de contrat pour les produits de licence, de service, de CTO et de pièces détachées
contractTypeName * String (20)Le nom du type de contrat pour les produits de licence, de service, de CTO et de pièces détachées.

project

Informations, prix et disponibilité d’un élément de projet.

NOMCHAMP OBLIGATOIRETYPE DE DONNÉESDESCRIPTION
supplierProjectId String (40)Numéro de projet du fournisseur
manufacturerProjectIdOuiString (40)Numéro de projet du fabricant (clé unique)
projectName String (255)Titre du projet
endCustomer String (255)Client final de l’article sur le projet
priceOuiBigDecimalPrix du projet
validFrom DateDate à partir de laquelle les conditions du projet s’appliquent
validTo DateDate à partir de laquelle les conditions du projet ne sont plus valables
targetQuantity IntegerQuantité convenue dans le cadre du projet
remainingQuantityOuiIntegerQuota restant
minQuantity IntegerQuantité minimale de commande pour ce projet
projectLastUpdate DateDate de la dernière mise à jour des informations sur le projet.

attribute

Propriétés d’un produit.

NOMCHAMP OBLIGATOIRETYPE DE DONNÉESDESCRIPTION
value * String (1024)La valeur de base (voir aussi unité de base) de la propriété, pour le texte en tant qu’élément de texte, pour les nombres en tant que plus petite spécification
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png displayValue String (1024)La valeur lisible du bien, y compris l’unité
attributeTypeId LongIdentifiant unique d’un type de bien concret
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeTypeName String (255)Nom du type de bien concret
attributeTypeRank LongLe classement du type de propriété, peut être utilisé pour le tri, par exemple
attributeTypeGroupId LongIdentificateur d’un groupe de propriétés, pas une référence de table, mais identifie de manière unique l’attributTypeGroupName.
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeTypeGroupName String (255)Nom du groupe de biens.

attributeCluster

Les groupes de propriétés dans lesquels le produit peut être trouvé pour des recherches de caractéristiques. Peut regrouper plusieurs expressions de propriété par intervalles en fonction de la quantité, par exemple 64-128 MB de RAM.

NOMCHAMP OBLIGATOIRETYPE DE DONNÉESDESCRIPTION
id LongClé unique d’ITscope
productTypeId LongRéférence au type de produit, facultatif
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png productTypeName String (255)Nom du type de produit auquel appartient cet attribut de propriété, facultatif
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeTypeName String (255)Nom d’une propriété. Peut être analogue au nom de ProductType.attributeTypeName(1..5)
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeTypeGroupName String (255)Nom d’un groupe de biens
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png name String (255)Identificateur de la caractéristique (par exemple 2 GB, 15″, 80 W – 120 W)
rank LongRang de propriété.

accessory

Accessoires originaux et accessoires compatibles dans un seul produit.

NOMCHAMP OBLIGATOIRETYPE DE DONNÉESDESCRIPTION
referencedProductId LongRéférence à un produit de référence, par exemple un produit qui est répertorié comme un accessoire d’origine
typeId IntegerIdentificateur interne pour le type de produit de référence
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png type String (255)Identifiant pour le type de produit de référence, par exemple les accessoires originaux, les accessoires compatibles, etc.

historicalDataItem

Données historiques agrégées hebdomadaires ou mensuelles, en fonction de la période et de l’agrégation souhaitées.

NOMCHAMP OBLIGATOIRETYPE DE DONNÉESDESCRIPTION
date StringDate de début de la semaine ou du mois selon l’agrégation souhaitée
priceMin BigDecimalPrix minimum dans une période correspondante
priceMax BigDecimalPrix maximum dans une période correspondante
priceMedian BigDecimalPrix médian au cours d’une période correspondante
priceMedianInStock BigDecimalMédiane des prix des articles en stock au cours d’une période correspondante
priceAvg BigDecimalMoyenne des prix au cours d’une période correspondante
priceAvgInStock BigDecimalPrix moyen des articles en stock au cours d’une période correspondante
supplierCount IntegerNombre de fournisseurs au cours d’une période correspondante
supplierCountInStock IntegerNombre de fournisseurs disposant d’un stock d’entrepôt au cours d’une période correspondante
stockSum IntegerTotal des articles en stock au cours d’une période correspondante
salesTrend IntegerÉvolution des ventes au cours d’une période correspondante.

Scripts de base de données pour CSV

Was this article helpful?
Dislike 0
Views: 23