integration_documentation:plugin:en:api:plentymarkets:export_information

integration_documentation:plugin:en:api:plentymarkets:export_information

This is an old revision of the document!


https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_logo.png

Plentymarkets Export Information

Overview of Plentymarkets product data which is considered for the Findologic CSV export via REST API.

Item Short Description In export Reason
id Id of the product Yes
ordernumber Number, model, id, item-id and barcodes of all variants Yes
name Product title Yes
summary Short description Yes
description Long description Yes
price Lowest price of the product and all its variants Yes
instead Lowest RRP price of the product and all its variants Yes
maxprice Currently valid retail price incl. taxes with the highest available option. No Not available
taxrate Tax/Vat rate of the last variant Yes
url URL to the product detail page Yes
image Product image Yes
attributes Assigned categories, vendors, variation properties and characteristics Yes
keywords Translated configured product keywords Yes
groups Customer groups which are allowed to see this product Yes
bonus Bonus value to rank certain products higher than others No Not available
sales_frequency Amount of sold items of this product Yes
date_added Creation date Yes
sort Contains the position of the main variation. Yes
Additional properties:
price_id Configured id used to determine the price Yes
variation_id Variation id of the main variation Yes
base_unit Configured base unit Yes
package_size Configured package size Yes

Extendability

Please note, that it is not possible to change the exported data, unless they're manually changed in the Plentymarkets backend.

Id

Contains the ID of the whole product.

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_id.png

Ordernumber

The ordernumber column contains the number, model, id, item id, and barcodes of all exportable variations.

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_ordernumber.png

Name

Contains the name of the product in the exported language.

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_name.png

Summary

Contains the short description of the product in the exported language.

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_short_description.png

Description

Contains the description of the product in the exported language.

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_description.png

Price

Contains the lowest price of all exportable variants. The price is based on the configured price id.

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_price.png

Instead

Contains the lowest instead price of all exportable variants. The price is based on the configured RRP price id.

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_instead_price.png

Tax rate

Contains the configured VAT rate of the product as a floating point number (e.g. 19.00 or 16.50).

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_taxrate.png

URL

Contains the URL of the product. It is built based on the following data:

  • Protocol (e.g. "https://")
  • Domain (e.g. "www.shop.com")
  • Language (e.g. "en")
  • Configured URL Path (e.g. "wohnzimmer/sessel-sofas/sessel-new-york-echtlederbezug-in-braun")
  • Product ID (e.g. "1001")

Complete URL example: https://www.shop.com/en/wohnzimmer/sessel-sofas/sessel-new-york-echtlederbezug-in-braun/a-1001.

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_url.png

Image

Contains the first image of the main variation or first variation if the main variation does not have any images. The image also must be available for the used client.

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_image.png

Attributes

Attributes/Filters are being fetched from multiple places.

  1. Manufacturer - Filter name is vendor https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_attr_vendor.png

  2. Category - Filter name is cat https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_attr_cat.png

Free-Text Fields - Filter names are free1 - free20 https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_attr_free.png

Characteristics (de: Merkmale) - Must be marked as searchable! - Filter names are depending on the name of the characteristic https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_attr_characteristic_1.png

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_attr_characteristic_2.png

Properties (de: Eigenschaften) - Filter names are depending on the name of the property https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_attr_properties.png

Attributes - Filter names are depending on the name of the attributes https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_attr_attributes.png

Keywords

Contains both keywords and tags. Only tags that are available for the current client will be exported.

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_keywords.png

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_keywords_2.png

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_keywords_3.png

Groups

Groups contain all store identifiers of this product with an underscore. E.g. multishop id is 0, than the group will be 0_.

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_groups.png

Sales frequency

When the option Setup > Client > (your shop) > Item layouts > Settings > Automatically sort by monthly sales is active, the sales_frequency is exported based on the position of the variation. The highest position is used for this value.

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_sales_frequency_1.png

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_sales_frequency_2.png

Date added

Contains the date of the products' creation as a UNIX timestamp. E.g. 1205708400

Sort

Contains the position of the main variation.

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_sort.png

Additional properties

Price id

Contains the configured price ID at Findologic.

Variation id

Contains the id of the main variation.

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_variation_id.png

Base unit

Contains the content unit of the main variation.

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_base_unit.png

Package size

Contains the content size of the main variation.

https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_package_size.png