integration_documentation:plugin:en:api:plentymarkets:export_information

integration_documentation:plugin:en:api:plentymarkets:export_information

This is an old revision of the document!


<markdown> ![https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_logo.png](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 XML export via REST API.

## XML Summary

Item Short Description In export Reason
——————————————————————————————————-———–—————
[id](#Id) Id of the product Yes
[ordernumber](#Ordernumber) Number, model, id, item-id and barcodes of all variants Yes
[name](#Name) Product title Yes
[summary](#Summary) Short description Yes
[description](#Description) Long description Yes
[price](#Price) Lowest price of the product and all its variants Yes
[instead](#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_rate) Tax/Vat rate of the last variant Yes
[url](#Url) URL to the product detail page Yes
[image](#Image) Product image Yes
[attributes](#Attributes) Assigned categories, vendors, variation properties and characteristics Yes
[keywords](#Keywords) Translated configured product keywords Yes
[groups](#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](#Sales_frequency) Amount of sold items of this product Yes
[date_added](#Date_added) Creation date Yes
[sort](#Sort) Contains the position of the main variation. Yes
Additional properties:
[price_id](#Price_id) Configured id used to determine the price Yes
[variation_id](#Variation_id) Variation id of the main variation Yes
[base_unit](#Base_unit) Configured base unit Yes
[package_size](#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.

## Details

### 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](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](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](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](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](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](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](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](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](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](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](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_attr_vendor.png) 1. Category - Filter name is `cat` ![https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_attr_cat.png](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_attr_cat.png) 1. 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](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_attr_free.png) 1. Characteristics (de: Merkmale) - 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_1.png) 1. Characteristics (de: Merkmale) - Must be marked as searchable! ![https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_attr_characteristic_2.png](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_attr_characteristic_2.png) 1. 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](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_attr_properties.png) 1. 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](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_attr_attributes.png) 1. Dimensions - Unit can be configured within the Account ![https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_attr_attributes.png](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_attr_dimensions.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.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_2.png) ![https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_keywords_3.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 with `0`, the group is `0_`. ![https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_groups.png](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_groups.png) ### Sales frequency When the option Calculate the variation position based on 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_1.png) ![https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_sales_frequency_2.png](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_sales_frequency_2.png) ### Date added Product create date as a 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](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 for the Findologic service. #### 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](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](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](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:api:plentymarkets:plenty_package_size.png) </markdow n>