Migration guide - SalesMerchantConnector

Edit on GitHub

SalesMerchantConnector is deprecated. For a plugin expanding order items with the parameters, use the SalesOms module.


Keep in mind, if you use functionality from SalesMerchantConnector, you need to install SalesOms and MerchantSalesOrder modules.

Estimated migration time: 1 hour.

To replace the deprecated functionality, do the following:

  1. Install the SalesOms, MerchantSalesOrder modules by running the following command:
composer require spryker/sales-oms spryker/merchant-sales-order
  1. Update the transfer objects:
console transfer:generate
  1. Generate translator cache by running the following command to get the latest Zed translations:
console propel:install
  1. Update the transfer objects:
console transfer:generate
  1. Replace the deprecated plugin from the SalesMerchantConnector and add the new one from MerchantSalesOrder modules in src/Pyz/Zed/Sales/SalesDependencyProvider.php.
  2. Change namespace from:
use Spryker\Zed\SalesMerchantConnector\Communication\Plugin\OrderItemReferenceExpanderPreSavePlugin;


use Spryker\Zed\SalesOms\Communication\Plugin\OrderItemReferenceExpanderPreSavePlugin;
  1. Add MerchantReferencesOrderExpanderPlugin to src/Pyz/Zed/Sales/SalesDependencyProvider.php.
namespace Pyz\Zed\Sales;

use Spryker\Zed\Sales\SalesDependencyProvider as SprykerSalesDependencyProvider;
use Spryker\Zed\MerchantSalesOrder\Communication\Plugin\Sales\MerchantReferencesOrderExpanderPlugin;

class SalesDependencyProvider extends SprykerSalesDependencyProvider
    * @return \Spryker\Zed\SalesExtension\Dependency\Plugin\OrderExpanderPluginInterface[]
  protected function getOrderHydrationPlugins(): array
      return [
          new MerchantReferencesOrderExpanderPlugin(),