Skip to main content

itemVariations

Using the itemVariations data format creator, you can export item variations and save it in the cloud. For more information on the properties of the format, see the following tables.

1. Technical specifications

See Table 1 for more information on the available properties and their corresponding values.

Table 1. Technical specifications of the format itemVariations
Property Meaning Value Explanation

dataName

Name

itemVariations

Name of the creator process and prefix of the created file.
File name: itemVariations-xxx.csv.gz

fileFormat

File format

CSV, GZIP

The data is provided as a GZIP-compressed CSV file (RFC 1952).

defaultActive

Activated by default

no

The data is only exported automatically in the background after you have activated the creator in the Data » Raw data menu.

interval

Interval

daily

With this setting, all data that has been changed since the last run is exported once a day, usually during the night.

limitPage

Lines per request

up to 5,000

The maximum number of data rows that is written into a single file.

limitDay

Lines per day

up to 100,000

The maximum number of data rows that is written on one day in total.

earliestPossibleDataDate

Earliest point in time

2014-01-01

Point in time as of which the raw data can be collected. The data is filtered by the date saved in the dataUpdatedAtColumnName column.

dataUpdatedAtColumnName

Column header

iv_updated_at

Name of the column that contains the time stamp of the last data update.

deleteRawDataAfterDaysMinimum

Minimum number of days until the data is deleted

20

The minimum number of days until the generated raw data file is deleted from the cloud storage. Therefore, the data must be processed before this date. The exact duration can be defined in the Data » Raw data menu.

deleteRawDataAfterDaysMaximum

Maximum number of days until the data is deleted

80

The maximum number of days until the generated raw data file is deleted from the cloud storage. Therefore, the data must be processed before this date. The exact duration can be defined in the Data » Raw data menu.

filterType

Filter type

lastUpdate

Data are filtered based on the last update.

2. Data columns

See Table 2 for more information on the itemVariations data columns included in the CSV file during raw data export.

Table 2. Data columns of the format itemVariations
Column name Data type Full name Explanation

plenty_id

INTEGER NOT NULL

plenty id

ID of the plentymarkets system

iv_id (Primary key)

VARCHAR NOT NULL

item variation id

Variation ID

i_id

VARCHAR NOT NULL

item id

The item’s ID

im_id

VARCHAR NOT NULL

item variation id

Manufacturer ID

iv_attribute_value_set_id

VARCHAR

item variation attribute value set id

ID of the combination of content and attribute value

c_id

VARCHAR

category id

ID of the category

iv_number

VARCHAR

item variation number

Number of the variation

i_name

VARCHAR

item name

Item name

iv_active

SMALLINT NOT NULL

item variation active

Possible values:
0 = Variation is inactive
1 = Variation is active

iv_availability

SMALLINT NOT NULL

item variation availability

ID of the availability of the variation
Possible values:
1 to 10

iv_updated_at

TIMESTAMPTZ

item variation updated at

Time stamp of the last update
Date format: MM/DD/YYYY HH:MI:SS TZ

To top