2 Data Preparation Stage 2


DATA INTEGRATION STAGE 2

Product creation/New assortment

The aim of the second integration stage is to map their full range by expanding the master data. Additional product data is needed for the realisation. They serve to clearly identify, categorise and present the products so that they can be purchased by the end customer.

The new files or required extensions are documented in this chapter.

A prerequisite for the implementation of stage 2: product creation is a completed and productive stage 1!

Back to stage 1: offer creation and allocation


DATA STRUCTURE

In addition to the existing offer data, further aspects are now added to the master data as well as the media for the products. We recommend preparing the media in another separate file.

Illustration 5: Data structure in stage 2

 

The provider key is the unique article number for an article of the supplier/retailer/provider. It is used as an identification number and must be included in all files supplied.

 


DATA FORMAT

We offer various file formats for data preparation. Select the standard suitable for your application and note the file structure requirements in the following overview. We recommend the CSV standard for automated data preparation, while XLSX files are more suitable for manual interventions in the files.

 

NOTES ON DOCUMENTATION

The documentation of the data structure contains technical terms and notes in various places. These are central to correct data preparation and - if correctly implemented in the files - simplify technical integration enormously. You will find more detailed explanations and examples in the table below.

 


DATA STRUCTURE PRODUCTDATA

General notes on the ProductData

  • File name: ProductData_[ProviderName]. [FILE FORMAT] (Eg: ProductData_digitecgalaxus.csv)

  • Transmission frequency: every 24 hours (optimal: every 12 hours)

 

Minimal criteria: ProductData

Header

Data type

Designation

Description

Header

Data type

Designation

Description

ProviderKey

Str(50)
ASCII 32-126

Partner specific item number

Unique identification number of the partner item

Gtin

Int(8)
Int(12)
Int(13)
Int(14)



EAN/GTIN code of the article

Unique and globally valid identification number of the article. The following data structures are permitted within the GTIN family:

  • GTIN-12 (UPC), GTIN-13 (EAN-13, ISSN, ISBN), GTIN-14 (EAN/UCC-128 or ITF-14), GTIN-8 (EAN-8)

BrandName

Str(100)

Brand / Publisher

Manufacturer's brand of the item.

CategoryGroup_[index]

Str(200)

Category groups of the article

The category groups, starting with the highest level CategoryGroup _1, together form a category family tree that assigns the item hierarchically.

ProductCategory

Str(200)

Product category of the article

The product category is the deepest (most detailed) level of all categories.

Weight_[unit]

Dec(8,4)

Packaging weight [mg,g,kg]

Packaging weight: Product weight plus original packaging of a retail package.

ProductTitle_de

Str(100)

German article/product name

Cleaned name of the item for the German-speaking region. Product names must be uniform and cleansed of specifications.

 

Supplementary criteria for EU hub partners: ProductData

Header

Data type

Designation

Description

Header

Data type

Designation

Description

TARICCode

Int(6-11) od. Str(14)

Commodity code (TARIC) for the EU

TARIC database, normally consists of 11 characters (without spaces) or 14 characters (with spaces), e.g. "49019900009" or "4901 9900 00 9".

CountryOfOrigin

Str(2)

Country of origin

Origin (country of production) of the delivered item or country where the majority of the value creation has taken place

Please note EU Rules of Origin

If a GTIN or a product has multiple countries of origin because it was produced in different countries (usually only the case with large manufacturers), all countries of origin must be provided.

 

Supplementary criteria for product safety regulations: ProductData

Header

Data type

Designation

Description

Header

Data type

Designation

Description

GPSRNameAddress

Str(300)

Name and postal address of manufacturer

The company name and the postal address of the manufacturer importing the product into the European Economic Area (EEA).

  • Format: "{name}, {street} {number}, {zip code} {town}, {country}"

  • Example: "Mustermann GmbH, Musterstraße 123A, 12345 Musterstadt, Deutschland"

GPSREmailUrl

Str(200)

Email address or URL

The email address or the URL of the manufacturer importing the product into the European Economic Area (EEA).

Supplementary criteria for optimising data quality: ProdcutData

Header

Data type

Designation

Description

Header

Data type

Designation

Description

ManufacturerKey

Str(4-50)

Manufacturer number of the article

Unique identification number of the manufacturer of a product. Manufacturer numbers must be unique within the same brand/manufacturer.

Length_[unit]

Dec(8,4)

Packing length

Width of the original packaging

Width_[unit]

Dec(8,4)

Packaging width

Width of the original packaging

Height_[unit]

Dec(8,4)

Packing height

Height of the original packaging

ReleaseDate_[country]

Date

Publication date

Date information for new publications. The date is displayed in the shop.

TARESCode

Str(9)

Swiss customs tariff number (TARES)

TARES database, e.g. "12345678" od. "1234.5678"

WEEENumber

Str(10)

WEEE Number

e.g. “DE12345678”

VariantName

Str(100)

Family name/variant name

Unique identification for items that belong together. Digitec Galaxus uses this information to create product variants

ProductTitle_[language]

Str(100)

Item name/Product name [en,fr,it]

Cleaned name of the item in a complementary language English, French or Italian. Product names must be consistent and cleansed of specifications.

LongDescription_[language]

Str(4000)

Detailed description of the article [de,en,fr,it].

Detailed description of the item with relevant information about the product such as size, material, age range, special features, technical specifications, shape, pattern, fabric type, design).

Composition_[language]

Str(4000)

Composition [de,en,fr,it]

Description of the composition or ingredients of a product. These are required by law for specific product groups, i.e. they are compliance-relevant.

Application_[language]

Str(4000)

Application [de,en,fr,it]

Description of the application of a product. These are required by law for specific product groups, i.e. they are compliance-relevant.

 

Optional criteria for future optimisation of ProductData


FILE STRUCTURE MEDIA DATA

 

Minimal criteria: Media Data

Header

Data type

Designation

Description

Header

Data type

Designation

Description

ProviderKey

Str(50)
ASCII 32-126

Partner specific item number

Unique identification number of the partner item

MainImageURL

Str(300)

First image link (HTTPS)

Cropped product image with white background, preferably frontal view. The longest edge of the images must be at least 600px (without border around the product). The size of 8 MB per image must not be exceeded.

ImageURL_[index]

Str(300)

Additional image links (HTTPS)

One link per column. The link must be freely accessible. JPG, JPEG and PNG are supported. The longest edge of the images must be at least 600px (without border around the product). The size of 8 MB per image must not be exceeded.

 

Supplementary criteria: MediaData

 

Declaration Media in MediaData

 

Optional criteria: MediaData