marketplaceStockMovement

Use the marketplaceStockMovement data format creator to export stock information that was exported to specific markets, and save this data in the cloud. The raw data file is stored in the cloud for a maximum of 6 months. Therefore, the data must be processed before this date. The following tables contain further information about the format.

At the moment, stock information is saved that was sent to the following markets:

Amazon

1. Technical specifications

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

Table 1. Technical specifications of the format **marketplaceStockMovement**
Property	Description	Value	Explanation
dataName	Name	marketplaceStockMovement	Name of the creator process and prefix of the created file. File name: marketplaceStockMovement-xxx.csv.gz
fileFormat	File format	CSV, GZIP	The data is provided as a GZIP-compressed CSV file (RFC 1952).
limitPage	Lines per request	up to 500	The maximum number of data rows that is written into a single file.
limitDay	Lines per day	up to 10,000	The maximum number of data rows that is written on one day in total.
earliestPossibleDataDate	Earliest point in time	2020-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.
filterType	Filter type	lastUpdate	Data are filtered based on the last update.
dataUpdatedAtColumnName	Column header	createdAt	Name of the column that contains the time stamp of the last data update.
defaultActive	Activated by default	no	The data is only exported automatically in the background after you have activated the creator in the Setup » plentyBI » 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.
storableFromPlan	Storage starting from tariff	plentyBI S	Minimum fee plan required for saving the data in cloud storage and making it available via REST.
processableFromPlan	Usage starting from tariff	plentyBI L	Minimum fee plan required for making the data available in plentyBI Data Warehouse, i.e. for using, filtering and processing key figures.

2. Data columns

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

Table 2. Data columns of the format **marketplaceStockMovement**
Column name	Data type	Full name	Explanation
plentyId	INTEGER NOT NULL	plenty ID	The ID of the plentymarkets system
id (primary key)	VARCHAR NOT NULL	ID	The unique ID of the stock information
identifierType	VARCHAR NOT NULL	identifier type	The record can be identified based on the identifier type. For example, the identifier type may be the ASIN.
identifierValue	VARCHAR NOT NULL	identifier value	Identifier value of the record The value of the identifier type that identifies the record. For example, if the identifier type is ASIN, the column identifierValue will contain the ASIN of the variation. Stock information can be filtered in the plentyBI tool based on this identifier value.
referrerId	NUMERIC(5,2)	Referrer ID	The ID of the market’s order referrer *_Note: At the moment, only stock information that is sent to the market Amazon is saved.
variationId	INTEGER NOT NULL	Variation ID	The unique ID of the variation
stock	INTEGER NOT NULL	Stock	The stock quantity that was exported to the market. This quantity of the variation can be bought on the market. *Tip:* How the stock is calculated depends on the stock settings and any stock buffers.
status	VARCHAR NOT NULL	Status	Status of exporting the stock information. Possible values: SENT = The stock was exported to the market.
meta	JSON NOT NULL	Meta	This column is currently empty.
createdAt	TIMESTAMP NOT NULL	Created on	The date and time when the stock was exported to the market. Format of the timestamp: `MM/DD/YYYY HH:MI:SS TZ`