integration_documentation:plugin:en:integration:shopware_6:export_information
This is an old revision of the document!
Shopware 6 Export Information
Overview of Shopware 6 product data which is considered for the Findologic XML export.
Summary
Item | Short Description | In export | Reason |
---|---|---|---|
<item id=""> | Internal Shopware UUID | Yes | |
<ordernumbers> | Contains product number, EAN and manufacturer numbers | Yes | |
<name> | Translated product name | Yes | |
<summaries> | Short description | No* | Not available |
<description> | Long description | Yes | |
<prices> | Lowest price of the product and all its variants | Yes | |
<urls> | URL to the product detail page | Yes | |
<images> | Images assigned to the product | Yes | |
<keywords> | Translated configured product Search keywords | Yes | |
<usergroups> | Customer groups which are allowed to see this product | Yes | |
<bonuses> | Bonus value to rank certain products higher than others | No* | Not available |
<salesfrequency> | Amount of sold items of this product | Yes | |
<dateAdded> | Creation date | Yes | |
<sorts> | Value for custom sorting of search results | No* | Not available |
<attributes> | Assigned categories, vendors, variation properties and custom fields | Yes | |
<properties> | Additional product details such as packunit, stock, weight, width, old prices, etc. | Yes |
Extendability
Please note that fields, which are not exported by default, can be adapted by an agency, using the Shopware 6 extension plugin.
Details
Products are only exported, when Shopware would show them on a search or category result page. The plugin internally uses constraints by Shopware, which restricts all products from being exported, if they are not available by Shopware.
The following criteria must be met:
- Product must be active.
- Product must have at least one active category assigned.
- Product must have the sales channel assigned, which the configured shopkey is assigned to.
<shopware-root>/var/log/findologic_finsearch_<environment>-<date-time>.log
productId
, which will contain all reasons, why the specific product couldn't be exported.
Example: https://your-shop.com/findologic?shopkey=your-shopkey&productId=missing-product-id
<markdown>
### Item
The id of the item is the Shopware UUID of the product. This UUID is only visible in the URL, when editing products in the admin interface.
### Ordernumbers
The ordernumbers field contains the product number, EAN and manufacturer of the product, and all its variants.
![product number](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:ordernumber_product_number.png)
![ordernumber ean](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:ordernumber_ean.png)
### Name
Product title, based on the exported language.
### Description
Product description, based on the exported language.
![description](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:description.png)
### Prices
Depending on the plugin configuration: * Contains the price of the product for the configured currency. * Contains the Advanced Pricing of the product for the configured currency.
![default prices](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:prices_default.png)
![advanced pricing](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:prices_advanced.png)
### Urls
SEO URL to the product detail page.
### Images
Configured cover image. In case there is no cover image, the first available image is taken instead. When the main product does not have any images, the images of the variants are taken instead.
Please note that the exported images will use the thumbnails to be generated. The first available size, which is at least 600px will be used for this.
See configuration in Content > Media > Product Media > Thumbnails:
![thumbnail configuration](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:images_configuration.png)
### Keywords
- Product name as keywords. (“Some example product” → `some`, `example`, `product`) - GTIN/EAN - Manufacturer product number - Configured product search keywords.
![keywords](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:keywords.png)
### Usergroups
Contains all available customer groups.
See configuration at Settings > Customer groups.
![usergroups](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:usergroups.png)
### Salesfrequency
Amount of sold items of this product in the last month.
### DateAdded
Configured release date of the product.
![dateadded](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:dateadded.png)
### Attributes
Attributes will be used as filters. Attribute data is coming from
* All assigned categories, as well as categories with a linked Dynamic Product Group. Internal attribute name is `cat` and `cat_url`. * Assigned manufacturer. Internal attribute name is `vendor`. * Assigned properties. Note that all properties must have the setting “Display in product filter” enabled. Properties which don't have it enabled are exported in \<properties\>. Internal attribute name is the group name of the property. * Assigned custom fields. Internal attribute name is the name of the custom field. * Shipping free and rating are exported as internal attribute names `shipping_free` and `rating`.
![attributes_cat](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:attributes_cat.png)
![attributes vendor](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:attributes_vendor.png)
![specifications](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:specifications.png)
![custom fields](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:attributes_custom_fields.png)
![free shipping](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:attributes_free_shipping.png)
![variant options](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:attributes_variant_configuration.png)
### Properties
* `tax` * `purchaseunit` * `referenceunit` * `packunit` * `stock` * `availableStock` * `weight` * `width` * `height` * `length` * `releasedate` * `vendorlogo` * `old_price`/`old_price_net` * `product_promotion`
![properties 1](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:properties_1.png)
![properties 2](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:properties_2.png)
![properties 3](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:properties_3.png)
![properties 4](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:properties_4.png)
![properties 5](https://docs.findologic.com/lib/exe/fetch.php?media=integration_documentation:plugin:en:integration:shopware_6:properties_5.png)
## Variants
Terminology: - Main product: Defined in the plugin configuration. Can be either the parent product, the configured main variant or the cheapest variant. - Variants: All the sibling products (limited by the same criteria as the main product) of the main product.
The information [listed above](#details) is the information exported for the main product. Some information of the variants is also exported within the XML of the main product:
- [Ordernumbers](#Ordernumbers) - [Attributes](#Attributes) (except manufacturer) - All properties without enabled “Display in product filter” configuration
</markdow n>