Product Import

Product import profile

Data for all product stores can be imported from PlentyMarkets to Magento using Product Import Profile. In addition, you can configure to import properties, attributes, prices, taxes, categories, product images, cross-sells and more. We support the following product types:

  1. Bundle
  2. Configurable
  3. Grouped
  4. Simple
  5. Virtual

Product import profile overview

Locate the profile

  1. On the Admin sidebar, go to SoftCommerce > Profiles > Manage Profiles.
  2. From the list of profiles choose Product Import [PM].
Configuration
Configuration

General Configuration

  • Name — Edit profile internal name. For example, Product Import.
  • Profile Type - This selection cannot be edited once the profile has been created. To change profile type ID, the profile needs to be deleted and new one created.
General Configuration
General Configuration

Configuration Wizard

Configuration wizard enables you to go through a number of steps in order to configure and test PlentyMarkets connection.

Click on Configuration Wizard and go through the following steps:

Step: Client
  • Choose PlentyMarkets client configuration from dropdown selection.
  • Or create new client connection if one doesn’t exist.
General Configuration
Configuration Wizard. Step: Client
Step: Connection
  • Click on Test Connection to test connection.
General Configuration
Configuration Wizard. Step: Connection
Step: Configurations
  • Click on Collect Configuration to collect configuration data.
General Configuration
Configuration Wizard. Step: Configurations
Step: Scheduler

This step is optional.

  • Choose Schedule Task from dropdown selection.
  • Or create new schedule task if one doesn’t exist.
Scheduler Configuration
Configuration Wizard. Scheduler
Step: Summary
  • Click on Finish Setup to return to main configuration view.
General Configuration
Configuration Wizard. Client Data

Client Configuration

You can skip this section if you've used configuration wizard to set it up.

Expand the Client Configuration section and do the following:

Setup Client Connection

  • Client — Select PlentyMarkets client.
  • Or click edit to manage PlentyMarkets client configuration in popup window.

Collect Client Configurations

  • Collect Configuration Data - Click this button to collect client configuration data.

Delete Client Configurations

  • Delete Configuration Data - Click this button to delete client configuration data.
Client Configuration
Client Configuration

Schedule Configuration

Expand the Schedule Configuration section and do the following:

Enable Schedule

  • Enable Schedule — Select Yes/No to enable / disable automatic product import using cron scheduler task.

Choose Schedule Task

  • Schedule - Select, create or edit particular schedule task.

Process Batch Size

  • Process Batch Size - Enter numeric value for process batch size.
Recommended process batch size is 100.

Process History

  • Enable History - Select Yes/No to enable / disable schedule history.
  • View Schedules - Click on view schedule button to view recent schedule history.
Schedule Configuration
Schedule Configuration

Http API Configuration

Expand the Http API Configuration section and do the following:

API Behaviour

  • API Behaviour - Select Add/Append or Replace
Add/Append behaviour collects recently updated data, whereas replace behaviour collects all data.

API Collection Size

  • API Collection Size - Enter numeric value for number of items returned per page by API requests. Default: 50. Max: 500.
Recommended API page size 100.

PIM Search Criteria

  • User defined search criteria - Select Yes/No to enable / disable user defined PIM search criteria.
  • PIM Search Criteria - Select PIM search criteria to include it in the response data. For example, if you require to import a category, select Categories to include category entity with your item response body.
Http API Configuration
Http API Configuration

Store Configuration

Expand the Store Configuration section and do the following:

Store Mapping

  • Store - Select Magento store.
  • Client - Select PlentyMarkets’ client.
  • Locale - Select applicable locale.

FlagOne Filter

  • FlagOne Filter - Enter numeric value number of flagOne filter.

FlagTwo Filter

  • FlagTwo Filter - Enter numeric value number of FlagTwo filter.
Flags restrict the import search results to items with specified flags and its values.
Store Configuration
Store Configuration

Tax And Price Configuration

Expand the Tax And Price Configuration section and do the following:

Tax Mapping

  • Magento Tax - Select Magento tax ID.
  • Plenty Tax - Select PlentyMarkets’ tax ID.
Tax And Price Configuration
Tax And Price Configuration

Price Mapping

  • Magento Price - Select Magento price attribute.
  • Plenty Price - Select PlentyMarkets’ price ID.
Tax And Price Configuration
Tax And Price Configuration

Purchase Price Mapping

  • Attribute Used For Purchased Price - Select applicable attribute that’s used for purchase price.
Tax And Price Configuration
Tax And Price Configuration

Customer Group Pricing

  • Enable Customer Group Pricing - Select Yes/No to enable or disable customer group pricing

Customer Group Mapping

  • Magento Group - Select Magento customer group.
  • Plenty Group - Select PlentyMarkets’ customer group.

Customer Group Price Mapping Options

  • Customer Group Price Mapping Options - Select appropriate customer group price mapping option. Available options: Manually selected or Auto (based on client configuration).
  • Customer Group Price Mapping – Select applicable customer groups in case of manual option was select from above point.
  • Tier Price Default Quantity - Enter default quantity for tier price import.
Tax And Price Configuration
Tax And Price Configuration

Stock Configuration

Expand the Stock Configuration section and do the following:

Enable Stock Import

  • Enable Stock Import - Select Yes/No to enable or disable stock import.

Warehouse mapping

  • Main warehouse ID - Select main warehouse ID to be used as a fall-back option in case specific warehouse not found.

Stock source mapping

  • Magento Source - Select Magento stock source.
  • Plenty Source - Select PlentyMarkets stock source.

Source Selection Algorithm

  • Source Selection Algorithm - Select source select algorithm. An option to assign reservation to a source by source selection algorithm (also known as SSA).

Enable Reservation

  • Enable Reservation - Select Yes/No to enable or disable stock reservation.
Stock Configuration
Stock Configuration

Attribute Configuration

Expand the Attribute Configuration section and do the following:

Attribute set

  • Attribute set mapping - Select applicable property to be used as attribute set.
Use PlentyMarkets property and its values to assign products to correct Magento attribute set group. Values of chosen property will be used as attribute set.
Attribute set properties are automatically created during wizard setup.
  • Attribute set fallback - Select default attribute set as a fall back option.
Attribute Configuration
Attribute Configuration

Item Texts Mapping

  • Magento Attribute - Select Magento attribute.
  • Plenty Text Field - Select PlentyMarkets item text field.
Attribute Configuration
Attribute Configuration

Barcode Mapping

  • Magento Attribute - Select Magento attribute.
  • Plenty Barcode - Select PlentyMarkets barcode.
Attribute Configuration
Attribute Configuration

Market Number Mapping

  • Magento Attribute - Select Magento attribute.
  • Plenty Market Number - Select PlentyMarkets market number.
Attribute Configuration
Attribute Configuration

General Attribute Mapping

  • Attribute used for supplier data - Select applicable attribute that’s used for supplier item data.
  • Attribute used for manufacturer - Select applicable attribute that’s used for manufacturer.
  • Attribute used for country of manufacturer - Select applicable attribute that’s used for country of manufacturer.
  • Attribute used for customs - Select applicable attribute that’s used for customs.
  • Attribute used for customs tariff number - Select applicable attribute that’s used for customs tariff number.
Attribute Configuration
Attribute Configuration

Dimension Attribute Mapping

  • Attribute used for length dimension - Select applicable attribute that’s used for length dimension.
  • Attribute used for width dimension - Select applicable attribute that’s used for width dimension.
  • Attribute used for height dimension - Select applicable attribute that’s used for height dimension.
  • Default weight unit - Select applicable weight unit.
  • Default Weight - Enter default weight value in case item is missing weight information.
Attribute Configuration
Attribute Configuration

Attribute processes

  • Create New Attribute - Select Yes/No to enable or disable creation of new attribute.
  • Create New Attribute Option(s) - Select Yes/No to enable or disable creation of new attribute options.
  • Add Attributes To Attribute Set Group - Select Yes/No to enable or disable adding new attributes to attribute set groups.
  • Enable attribute restriction - Select Yes/No to enable or disable attribute restriction.
Attribute restriction limits data import to specified attributes.
Attribute Configuration
Attribute Configuration

Category Configuration

Expand the Category Configuration section and do the following:

Root Category Mapping

  • Magento Category - Select Magento root category.
  • PlentyMarkets Category - Select PlentyMarkets root category.
Category Configuration
Category Configuration

Attribute Mapping

  • Plenty Property - Select PlentyMarkets category property.
  • Magento Attribute - Select Magento category attribute
Category Configuration
Category Configuration

URL Configuration

Expand the URL Configuration section and do the following:

Enable URL import

  • Enable URL import - Select Yes/No to enable or disable URL import.

URL Manage Options

  • URL Manage Options - Select appropriate option for URL import.
  • Add SKU Suffix On Duplicate URL Error - Select Yes/No to enable or disable adding SKU suffix to URL paths on error.
URL Configuration
URL Configuration

Media Configuration

Expand the Media Configuration section and do the following:

Enable media import

  • Enable Media Import - Select Yes/No to enable or disable media import.

Download media files

  • Download Media Files - Select Yes/No to enable or disable media file download.

Media chanel filter

  • Media Chanel Filter - Select applicable media channel filter.

Attribute used for video URL

  • Attribute used for video URL - Select applicable attribute that’s used for video URL.
Media Configuration
Media Configuration

Cross-sells Configuration

Expand the Cross-sells Configuration section and do the following:

Enable cross-sells import

  • Enable Cross-sells Import - Select Yes/No to enable or disable cross-sells import.

Relation mapping

  • Magento Relation - Select Magento cross-sells relation type.
  • Plenty Relation - Select PlentyMarkets cross-sells relation type.
Cross-sells Configuration
Cross-sells Configuration

Property Configuration

Expand the Property-sells Configuration section and do the following:

Property mapping

  • Magento Attribute - Select Magento attribute.
  • Plenty Relation - Select PlentyMarkets property.
Properties are not required to be mapped if property name is the same as attribute code in Magento.
Property Configuration
Property Configuration

Configurable Product Configuration

Expand the Configurable Product Configuration section and do the following:

Configurable attribute mapping

  • Magento Attribute - Select Magento attribute.
  • Plenty Relation - Select PlentyMarkets attribute.
Configurable attributes are not required to be mapped if PlentyMarkets' attribute name is the same as attribute code in Magento.
Configurable Product Configuration
Configurable Product Configuration

Bundle Product Configuration

Expand the Bundle Product Configuration section and do the following:

  • Enable Bundle Product - Select Yes/No to enable or disable bundle product import.
  • Default SKU Type - Select default SKU type. Available Types: Dynamic or Fixed.
  • Default Price Type - Select default price type. Available Types: Dynamic or Fixed.
  • Default Weight Type - Select default weight type. Available Types: Dynamic or Fixed.
  • Default Price View - Select default price view. Available Types: Price Range or Price As Low As.
  • Default Shipment Type - Select default shipment type. Available Types: Together or Separate.
  • Default Input Type - Select default input type. Available Types: Drop-down, Radio Buttons, Checkbox or Multiple Select.
  • Default Qty - Enter default quantity.
  • Default Qty User defined - Select Yes/No to allow or disallow the user to define quantity.
Bundle Product Configuration
Bundle Product Configuration

Log Configuration

Expand the Log Configuration section and do the following:

  • Log request data to file - Select Yes/No to log request data.
  • Log response data to file - Select Yes/No to log response data.
Log Configuration
Log Configuration

Product Export
Stock Import