Skip to main content

Getting Started with Mage2Plenty

Welcome to Mage2Plenty - the enterprise-grade connector that seamlessly integrates your Magento 2 e-commerce platform with PlentyONE ERP system.

What is Mage2Plenty?​

Mage2Plenty is a powerful, bi-directional integration solution that automates critical business processes between Magento 2 and PlentyONE. It eliminates manual data entry, reduces errors, and ensures data consistency across both platforms.

Key Features​

  • 📦 Product Synchronization - Sync products, categories, attributes, and media
  • 📊 Inventory Management - Real-time stock updates with MSI support
  • 🛒 Order Processing - Automated order export and status updates
  • 👥 Customer Sync - Keep customer data synchronized across platforms
  • ⚙️ Flexible Configuration - Comprehensive admin panel for mappings and rules
  • 🚀 Enterprise Ready - Built for scale with multi-store support

What You'll Need​

Before you begin, make sure you have:

  1. Mage2Plenty License - Purchase the extension for your Magento edition
  2. System Requirements - Check if your environment meets all requirements
  3. PlentyONE Account - Active PlentyONE account with API access
  4. Magento 2.4.4+ - Compatible Magento installation
  5. Composer - For installing the extension

Quick Start​

Ready to get started? Follow these steps:

1. Check System Requirements​

First, verify your system meets all requirements:

  • Magento 2.4.4 or higher
  • PHP 8.1 or higher
  • MySQL 8.0 or MariaDB 10.6
  • Required PHP extensions (including curl, json, openssl, xml, zip, mbstring)

2. Install the Extension​

Setup Composer Repository​

After purchasing the extension, you'll receive access to a private Composer repository. First, configure your repository access:

# Add the private repository
composer config repositories.private-packagist composer https://softcommerce.repo.packagist.com/your-repository-name/

# Setup authentication (use token as username)
composer config --global --auth http-basic.softcommerce.repo.packagist.com token your-access-token

Install the Package​

For Magento Open Source:

composer require softcommerce/mage2plenty-os

For Adobe Commerce:

composer require softcommerce/mage2plenty-ac

Complete Installation​

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/magento cache:flush

For detailed installation instructions, see:

3. Initial Configuration​

Configure your PlentyONE connection using the CLI wizards:

# Step 1: Configure client connection and API settings
bin/magento plenty:client:wizard

# Step 2: Configure profile system and notifications
bin/magento plenty:profile:wizard

Or configure manually via admin panel:

  1. Navigate to SoftCommerce → PlentyONE → Manage Client Connection
  2. Enter your PlentyONE API credentials (URL, username, password)
  3. Test the connection
  4. Save configuration

After configuring the connection, complete the initial setup:

  • Via UI: Navigate to SoftCommerce → PlentyONE → Initial Setup to run the interactive setup wizard
  • Via CLI: Run both bin/magento plenty:client:wizard and bin/magento plenty:profile:wizard for automated configuration

4. Verify Installation​

Check that everything is working:

# Run system check
bin/magento plenty:system:check

# Test connection to PlentyONE
bin/magento plenty:client:test

What's Next?​

Now that you have Mage2Plenty installed, you can:

Need Help?​

  • 📧 Email Support: support@softcommerce.io
  • 📞 Phone: +44 2080 587 795 (GMT working hours)
  • 🐛 Bug Reports: GitHub Issues
  • 📖 Documentation: Browse this site for comprehensive guides

Video Tutorial​

Outdated Content

This video shows a previous version of the setup process. While the core configuration concepts and form fields remain similar, the setup wizard interface and workflow have changed. Follow the written documentation above for current instructions.

What's Still Relevant:

  • ✅ Configuration form fields and their purposes
  • ✅ PlentyONE credential requirements
  • ✅ Connection testing concepts
  • ✅ General setup workflow

What's Changed:

  • ❌ New CLI wizards available (bin/magento plenty:client:wizard and bin/magento plenty:profile:wizard)
  • ❌ Updated admin menu paths (now SoftCommerce → PlentyONE)
  • ❌ Enhanced connection testing and validation
  • ❌ Automated token management
Pro Tip

Enable RabbitMQ for asynchronous profile processing to significantly improve performance, especially for large catalogs.

Architecture Overview​

graph LR
    A[Magento 2] <-->|Mage2Plenty| B[PlentyONE ERP]
    A -->|Products| B
    A -->|Orders| B
    B -->|Inventory| A
    B -->|Prices| A
    B -->|Status Updates| A

Understanding the architecture helps you configure the integration effectively. See Architecture Guide for more details.