Mage2Plenty Connector Documentation

website·Indexed 31 days ago

https://mage2plenty-guide.softcommerce.io

Documentation and release notes for the Mage2Plenty connector, used to synchronize product catalog data, orders, and stock between PlentyONE and Magento. Includes guides on profile configuration, product import, system requirements, and version updates from v2.0 through v3.15, including PHP 8.4 compatibility.

Tokens
173K
Snippets
755
Records
1.3K
Agent score
47%

What's inside Mage2Plenty

  1. Overview of the Customer Import Profile

    The Customer Import Profile (Profile Type ID: plenty_customer_import) synchronizes customer data from PlentyONE to Magento. It is used to maintain consistent customer data across platforms by importing customer accounts, billing/shipping addresses, customer groups (mapped from PlentyONE customer classes), gender/prefixes, and account details (email, phone, company, tax ID). It also supports multi-store assignment and custom attribute mapping for address fields.
  2. Overview of the Packstation plugin for Mage2Plenty

    The Packstation plugin (softcommerce/module-plenty-packstation) ensures that DHL Packstation and Post Filiale delivery addresses are correctly formatted and exported from Magento to PlentyONE. It automatically detects Packstation keywords, validates the required DHL Post Number (Postnummer), and structures the data for seamless DHL label generation.
  3. Overview of Mage2Plenty Integration

    Mage2Plenty is an enterprise-grade integration solution developed by SoftCommerce (Byte8 Ltd) to bridge Magento 2 e-commerce platforms and PlentyONE ERP systems. It automates business processes and eliminates data silos through bi-directional synchronization of inventory, orders, and customer data.
  4. Overview of the Stock Import Profile

    The Stock Import Profile (Profile Type ID: plenty_stock_import) synchronizes real-time stock quantities and reservations from PlentyONE warehouses to Magento inventory sources. It supports both single and multiple warehouse sources via Magento's Multi-Source Inventory (MSI).
  5. Overview of the Customer Export Profile

    The Customer Export Profile (Profile Type ID: plenty_customer_export) synchronizes customer data from Magento to PlentyONE. It handles the export of customer accounts, billing and shipping addresses, customer groups (mapped to PlentyONE customer classes), metadata (names, email, phone, company), and gender mapping. It is primarily used for order processing, CRM integration, guest checkout contact creation, and B2B management.
  6. Overview of PlentyONE Order Import Profile

    The Order Import Profile (Profile Type ID: plenty_order_import) synchronizes data from PlentyONE to Magento. It is specifically designed for orders created outside of Magento, such as those from external marketplaces (Amazon, eBay, Otto) or PlentyONE-managed sales channels.

    Imported Data Includes:

    • Orders and line items
    • Customer information and billing/shipping addresses
    • Order status, payments, and shipping/tracking details
    • Invoices and Credit Memos (when configured)
    • Order totals (subtotals, tax, shipping, discounts, grand total)
  7. Overview of Amasty Cash on Delivery (COD) plugin for Mage2Plenty

    The Amasty Cash on Delivery (COD) plugin integrates the Amasty Cash on Delivery Fee extension with Mage2Plenty. It ensures that COD fees are detected, calculated based on Amasty rules, and exported to PlentyONE as separate order line items to maintain accounting accuracy. It supports multi-currency and tax handling for these fees.
  8. Overview of the Stock Export Profile

    The Stock Export Profile (plenty_stock_export) pushes Magento inventory changes (sales, receipts, manual corrections, MSI source changes) to PlentyONE. It is designed for high-frequency event-driven synchronization with a periodic drift-reconciliation safety net to ensure physical stock alignment.
  9. Overview of Amasty Promo plugin for Mage2Plenty

    The Amasty Promo plugin (softcommerce/module-plenty-amasty-promo) integrates the Amasty Special Promotions (Free Gifts) extension with Mage2Plenty. It ensures that promotional items and free gifts are properly exported to PlentyONE as order line items, maintaining zero pricing for free items and tracking the promotion rule references that triggered them. It supports scenarios such as 'Buy X Get Y Free', 'Spend $X Get Free Gift', and multiple promotions within a single order.
  10. Overview of the Category Export Profile

    The Category Export Profile (plenty_category_export) synchronizes category data from Magento to PlentyONE. It ensures consistent category structures across both systems by exporting the complete hierarchy, parent-child relationships, multi-language names, descriptions, mapped attributes, and active/inactive status.
  11. Overview of Category Import Profile

    The Category Import Profile (Profile Type ID: plenty_category_import) synchronizes category structures from PlentyONE to Magento. It ensures consistent category hierarchies, multi-language names, descriptions, attributes, and active/inactive statuses across both systems. It is primarily used for initial setup, ongoing synchronization, multi-language imports, and marketplace management.
  12. Overview of the Order Export Profile

    The Order Export Profile (ID: plenty_order_export) manages the data flow from Magento to PlentyONE. It is used for store order fulfillment, inventory management, and customer contact synchronization.

    Exported Data Includes:

    • Orders and line items
    • Customer information (creates contacts in PlentyONE)
    • Billing and shipping addresses
    • Payment methods, status, and shipping options
    • Invoices, Credit Memos, and Shipments (if configured)
    • Order totals (prices, tax, shipping, discounts) and customer comments.

    Standard Workflow:

    1. Customer places order in Magento.
    2. Order status changes to 'Processing'.
    3. Order Export Profile runs automatically.
    4. Order is created in PlentyONE.
    5. Warehouse fulfills order and updates shipping tracking.
    6. Order status is synced back to Magento via Order Import.
    7. Customer is notified by Magento.