Product Import Profile

The Product Import Profile synchronizes product catalog data from PlentyONE to Magento, handling simple products, configurable products, variants, attributes, prices, images, and inventory.

Overview

Profile Type ID: plenty_item_import Direction: PlentyONE → Magento Purpose: Import complete product catalog including variants, pricing, images, and attributes

What Gets Imported

• Products: Simple and configurable products
• Variants: Product variations as simple or configurable options
• Attributes: Product attributes and attribute sets
• Prices: Base prices, special prices, tier prices, group prices
• Images: Product images and galleries
• Inventory: Stock quantities (basic - use Stock Import for MSI)
• Categories: Product-category associations
• Related Products: Cross-sells, up-sells, related products

Product Type Handling

PlentyONE Item	Magento Product	Notes
Item (no variations)	Simple Product	Single standalone product
Item + Variations	Configurable Product	Parent with child variations
Variation	Simple Product	Can be standalone or child
Bundle Item	Grouped/Bundle	Depending on configuration

Schedule Configuration (Extended)

Product Import includes additional schedule settings beyond standard profiles:

One-Time Full Process

Purpose: Perform a complete product catalog sync on a scheduled basis

Enable One-Time Full Process

Field: enable_onetime_full_process Type: Checkbox Default: No Scope: Global

Enable periodic full catalog synchronization.

How It Works:

• Separate from regular scheduled sync
• Processes entire catalog regardless of changes
• Runs at specified frequency and time
• Useful for data integrity verification

Frequency

Field: onetime_full_process_frequency Type: Select Scope: Global

How often the full process runs.

Options:

• Daily
• Weekly
• Monthly

Recommended: Weekly or Monthly for large catalogs

Time

Field: onetime_full_process_time Type: Time Picker Scope: Global

Specific time when full process executes.

Best Practice: Choose off-peak hours (e.g., 2:00 AM)

Example Configuration:

Enable One-Time Full Process: Yes
Frequency: Weekly
Time: 02:00:00

Result: Full catalog sync every Sunday at 2 AM

Product Configuration

Configure product-specific import settings.

Product Types

Control which product types are imported:

Setting	Type	Description
Import Simple Products	Checkbox	Standalone products
Import Configurable Products	Checkbox	Products with variations
Import Grouped Products	Checkbox	Product groups
Import Bundle Products	Checkbox	Product bundles

Attribute Set Mapping

Map PlentyONE item types to Magento attribute sets.

Field: attribute_set_mapping Type: Dynamic Rows

Fields per Row:

• PlentyONE Type: Item type from PlentyONE
• Magento Attribute Set: Target attribute set
• Is Default: Use as default for unmapped types

Example:

PlentyONE Type	Magento Attribute Set	Is Default
Standard	Default	Yes
Electronics	Electronics	No
Clothing	Apparel	No
Books	Books & Media	No

Attribute Mapping

Map PlentyONE properties to Magento product attributes.

Field: attribute_mapping Type: Dynamic Rows

Common Mappings:

PlentyONE Property	Magento Attribute	Data Type
name	name	Text
description	description	Textarea
shortDescription	short_description	Textarea
manufacturer	manufacturer	Select
model	model	Text
ean	ean	Text
isbn	isbn	Text
weight	weight	Decimal
length	length	Decimal
width	width	Decimal
height	height	Decimal

SKU Configuration

Control SKU generation and management.

Fields:

• SKU Pattern: Template for generating SKUs
• Variation SKU Pattern: Template for variation SKUs
• Overwrite Existing SKU: Update SKUs on re-import

SKU Pattern Variables:

• {item_id} - PlentyONE item ID
• {variation_id} - Variation ID
• {variation_number} - Variation number
• {manufacturer} - Manufacturer name
• {model} - Model number

Examples:

Simple Product: PLENTY-{item_id}
  → PLENTY-12345

Configurable Parent: {item_id}
  → 12345

Variation Child: {item_id}-{variation_number}
  → 12345-001, 12345-002

Media Configuration

Configure image and media import.

Image Import

Field: enable_image_import Type: Checkbox Default: Yes

Import product images from PlentyONE.

Image Roles

Map PlentyONE image types to Magento roles:

PlentyONE Type	Magento Role	Purpose
Primary	base	Main product image
Gallery	additional_images	Product gallery
Swatch	swatch_image	Configurable swatches
Thumbnail	thumbnail	Grid/list thumbnail

Image Processing

Options:

• Download Images: Download and host locally
• Use CDN URLs: Use PlentyONE CDN URLs
• Image Resizing: Auto-generate thumbnails
• Watermarking: Apply watermarks on import

Price Configuration

Control pricing import and calculations.

Price Types

Setting	Description
Base Price	Standard product price
Special Price	Sale/promotional price
Tier Prices	Quantity-based pricing
Group Prices	Customer group pricing

Price Calculation

Field: price_calculation Type: Select

Options:

• Net Price: Use net prices from PlentyONE
• Gross Price: Use gross prices
• Calculate from Net: Calculate gross from net + tax
• Calculate from Gross: Calculate net from gross - tax

Currency Mapping

Field: currency_mapping Type: Dynamic Rows

Map PlentyONE price currencies to Magento currencies.

Example:

PlentyONE Currency	Magento Currency	Store
EUR	EUR	EU Store
USD	USD	US Store
GBP	GBP	UK Store

Variation Configuration

Configure how product variations are handled.

Variation Import Mode

Field: variation_import_mode Type: Select

Options:

Mode	Behavior	Use Case
Configurable	Create configurable products with children	Standard variation handling
Simple	Import all as simple products	Marketplaces, simple catalog
Skip Variations	Import main items only	Parent products only

Variation Attributes

Define which PlentyONE variation properties create configurable attributes.

Common Variation Attributes:

• Color
• Size
• Style
• Material
• Fit

Configuration:

PlentyONE Properties → Magento Configurable Attributes

Color (attribute_1) → color
Size (attribute_2) → size
Style (attribute_3) → style

Variation SKU Handling

Options:

• Inherit Parent SKU: Use parent + suffix
• Use Variation Number: Use variation's own number
• Custom Pattern: Define SKU pattern

Inventory Configuration

Basic inventory settings (detailed inventory uses Stock Import profile).

Fields:

• Update Stock: Import stock quantities
• Stock Status: Manage in stock / out of stock
• Backorders: Allow backorder configuration
• Min Qty: Minimum quantity thresholds

Advanced Inventory

For Multi-Source Inventory (MSI) and advanced stock management, use the Stock Import Profile instead.

Category Assignment

Configure product-category relationships.

Category Mapping Mode

Field: category_assignment_mode Type: Select

Options:

• From PlentyONE Categories: Use PlentyONE category assignments
• From Item Properties: Use specific item properties
• Manual Mapping: Custom category mappings
• Skip Category Assignment: Don't assign categories

Default Category

Field: default_category_id Type: Select

Assign uncategorized products to default category.

CLI Commands

# Full product import
bin/magento softcommerce:plenty:item:import --profile-id=5

# Import specific products
bin/magento softcommerce:plenty:item:import --profile-id=5 --entity-ids=100,101,102

# Import new products only
bin/magento softcommerce:plenty:item:import --profile-id=5 --new-only

# Force full re-import
bin/magento softcommerce:plenty:item:import --profile-id=5 --force

# Import without images (faster)
bin/magento softcommerce:plenty:item:import --profile-id=5 --skip-media

# Import with specific batch size
bin/magento softcommerce:plenty:item:import --profile-id=5 --batch-size=50

Troubleshooting

Products Not Importing

Solutions:

1. Check product visibility in PlentyONE
2. Verify attribute set mapping exists
3. Review API collection size (reduce if timeout)
4. Check required attributes are mapped

Variations Not Creating Configurable

Solutions:

1. Verify variation import mode is "Configurable"
2. Check variation attributes are mapped
3. Ensure variation properties exist in PlentyONE
4. Verify configurable attributes exist in Magento

Images Not Importing

Solutions:

1. Enable image import in Media Configuration
2. Check image URLs are accessible
3. Verify file permissions for media directory
4. Review image processing settings

Incorrect Prices

Solutions:

1. Check price calculation mode
2. Verify currency mapping
3. Review tax calculation settings
4. Ensure price types are mapped correctly

Best Practices

Initial Import

1. Attribute Setup: Create all attributes in Magento first
2. Attribute Sets: Configure attribute sets before import
3. Test with Sample: Import 10-20 products initially
4. Verify Data: Check products, prices, images, categories
5. Full Import: Process entire catalog after validation

Ongoing Sync

1. Regular Schedule: Every 15-60 minutes for updates
2. One-Time Full Sync: Weekly for data integrity
3. Monitor Performance: Track execution times
4. Optimize Batch Size: Based on catalog size and server resources

Performance Optimization

1. Batch Size: 25-100 products per batch
2. API Collection Size: 100-250 items per request
3. Off-Peak Processing: Schedule large imports during low traffic
4. Image Processing: Consider CDN URLs over local downloads
5. Selective Import: Import only changed products when possible

Data Quality

1. Attribute Completeness: Map all relevant attributes
2. Image Quality: Ensure high-quality images in PlentyONE
3. Category Structure: Set up categories before product import
4. Price Accuracy: Verify pricing calculations match expectations

Related Documentation

• Product Export Profile
• Stock Import Profile
• Category Import Profile
• Attribute Mapping