Magento Integration Suite:Dydacomp Mail Order Manager Integration

From XTENTO Support Wiki
Jump to: navigation, search

Contents

Overview

The XTENTO Multichannel Order Manager integration provides a bidirectional connection between Magento and Dydacomp MOM. The integration consists of three packages:

Using these packages, you will be able to import your orders into MOM, and later on after shipping the orders, you will be able to import the tracking information (parcel number, tracking link) back into Magento to provide the customer with the tracking number to track their order, and you'll also be able to notify the customer that their order has been shipped. The inventory synchronization will make sure you don't sell anything not in stock anymore.

Got questions? Feel free to contact us! Contact Form

Interested in this Magento integration?

Head over to our store to purchase this integration: Magento Multichannel Order Manager Integration

Setting up the Integration

This guide will help you setting up the MOM integration.

Order Import into MOM

Preparing Magento for Export

  1. Open the connector ZIP file downloaded after your purchase. (Located in our store at My Account > My Downloadable Products)
  2. Set up the Magento Order Export Module (located inside the Xtento_OrderExport ZIP file) following this guide: Installation Guide
  3. Log into the Magento backend and go to System > XTENTO > Sales Export Configuration and enter your license key to activate the module.
  4. Then please go to Sales > Sales Export > Tools and import the xtento_orderexport_settings_MOM.json file from the installation ZIP file. Then eventually enable automatic exports (manual exports are possible as well) inside the "Automatic Export" tab of the newly created export profile at Sales > Sales Export > Export Profiles, we would suggest using an event like "sales order invoice pay" which exports once an order has been paid.
Configurable Products

[Only applies to older integrations. Newer integrations contain this feature out of the box (via XSL)]

If selling configurable products, due to the special way MOM requires products to be sent, a little change in our modules code is required.

File: app/code/Xtento/OrderExport/Model/Export/Data/Shared/Items.php

Look for:

// Get information from parent item if item price is 0
/*if ($item->getPrice() == 0 && $item->getParentItem()) {
  $item = $item->getParentItem();
}*/

Make sure to uncomment those three lines, and save the file. This will make sure items flow into MOM properly.

Also, in your export profile at Sales > Sales Export > Export Profiles, tab "Filters / Actions", please be sure under "Hidden Product Types" to select the following entries: Configurable Products, Bundle Products

Synchronization

If you want exported orders to be downloaded from Magento to the MOM import directory automatically, follow these steps.

You can also manually download exported orders by going to Sales > Order Export and click on Download after exporting orders. If you want to download orders manually, please still create a directory somewhere on your hard drive which will be used for the Import into MOM. We'd suggest using C:\XTENTO\MagentoToMOM\data\.

  1. Extract the contents of the MagentoToMOM directory (inside the connector ZIP file) to a local directory on the MOM workstation. We'd suggest placing the files in C:\XTENTO\MagentoToMOM\.
  2. Open the folder where you extracted the files to and run the init_configuration.bat file to create the configuration and synchronization files. A couple new files and one new folder will be created. The newly created folder called data will contain the files which will be imported into MOM. This folder will be also used if you want to manually download files from Magento to MOM.
  3. Open the newly created sync.ini file using a text editor and enter the credentials (server address, username, password, path) of the FTP server where Magento is installed on. Make sure to use the absolute path when entering the path. The path should be the absolute path to the /export/ directory inside the Magento root directory. For example, this could be: /export/ or, depending on the FTP home directory, for example: /domains/mydomain.com/html/export/. To find out the absolute path, use your FTP client and log in using the credentials you're using for the synchronization and navigate to the export directory inside the Magento root folder. Then, copy the path you see in your FTP client. Be careful: Entering the wrong path could lead to deleted / synced files. Enter the right path with /export/ appended.
  4. Click on batch_sync_debug_mode.bat to test-run the synchronization and to see if the synchronization fails/succeeds. If necessary, adjust the configuration inside the sync.ini configuration.
  5. Run the init_windows_task_creation.bat file to set up the automated synchronization. The synchronization task will be run every 15 minutes in the background from now.

If you want to initiate the download manually - for example if you're ready to process orders but don't want to wait for the synchronization task to run - simply run the sync.bat file manually. You can also create a shortcut on your desktop for it.

Setting up the MOM Order Import

Preparing MOM for the import
  1. Open MOM
  2. Go to Options > Order Import/Export Module > Define Settings
  3. Select the following options: Import File Source: MOM Import (Default) | Import File Format: XML File
  4. Check Auto Import File Path and select the data directory (for example C:\XTENTO\MagentoToMOM\data\) created above.
  5. If you don't use the Import/Export Module in MOM at all, save this under the Default settings. Otherwise create a new import profile.
  6. Click Save
Importing orders manually into MOM
  1. Open MOM
  2. Go to Options > Order Import/Export Module > Import Orders
  3. Select the import profile you created above.
  4. Select the order file (XML) you want to import. Should be located in the data directory you created above.
  5. Click Process
Starting the automatic import
  1. Open MOM
  2. Go to Options > Order Import/Export Module > Automatic Import
  3. Select the import profile ("Saved Settings) you created above.
  4. Click Process to start the automatic import. This is an endless, never-ending task that will keep on running and will import new orders whenever new files have been downloaded from Magento by the synchronization task. You can stop this task by clicking Cancel and start it again whenever you want to import orders again.

Tracking Information Export to Magento

Provided you have purchased the tracking number add-on as well, follow this guide to set up the tracking information export from MOM to Magento.

Synchronization

We will get in touch with you to set up the MOM side for you. Please make sure the FTP synchronization has been set up by us and is functional. Remember the path where the file is sent to on the Magento server, it is usually the ./var/xtento/import/ directory.

Preparing Magento for Import

  1. Open the connector ZIP file downloaded after your purchase. (Located in our store at My Account > My Downloadable Products)
  2. Set up the Tracking Import Module (located inside the Xtento_TrackingImport ZIP file) following this guide: Installation Guide Follow all steps carefully.
  3. Log into the Magento backend and go to System > Configuration > XTENTO Extensions > Tracking Import Configuration and enter your license key, and set "Module Enabled" to "Yes". Save config.
  4. Please make sure the Magento cronjob (cron.php inside the Magento root directory) has been set up to be called every 5 minutes. This is important. Follow this guide if you don't know how to set up the cronjob: Magento cronjob
  5. Go to Sales > Tracking Import > Tools and import the xtento_trackingimport_settings_MOM.json file from the installation ZIP file.
  6. You've successfully installed the tracking importer.

Inventory Import into Magento

Provided you have purchased the inventory import add-on as well, follow this guide to set up the inventory information export from MOM to Magento.

Synchronization

We will get in touch with you to set up the MOM side for you. Please make sure the FTP synchronization has been set up by us and is functional. Remember the path where the file is sent to on the Magento server, it is usually the ./var/xtento/import/ directory.

Preparing Magento for Import

  1. Open the connector ZIP file downloaded after your purchase. (Located in our store at My Account > My Downloadable Products)
  2. Set up the Stock Import Module (located inside the Xtento_InventoryImport ZIP file) following this guide: Installation Guide Follow all steps carefully.
  3. Log into the Magento backend and go to System > Configuration > XTENTO Extensions > Stock Import Module and enter your license key, and set "Module Enabled" to "Yes". Save config.
  4. Please make sure the Magento cronjob (cron.php inside the Magento root directory) has been set up to be called every 5 minutes. This is important. Follow this guide if you don't know how to set up the cronjob: Magento cronjob
  5. Go to Catalog > Stock Import > Tools and import the xtento_stockimport_settings_MOM.json file from the installation ZIP file.
  6. You've successfully installed the stock import module.

Product Synchronization

Product sync is always "built to order" as each and every store has different requirements with regards to product sync that one utility couldn't handle. We supply the utility once all requirements have been finalized and provide the product importer (including the configuration) to you.

Please talk to us to figure out what attributes you want to send from MOM to Magento. Do you need to import new products, or just update products in Magento? Also, simple/configurable products, or just simple, or anything special? Images?

Troubleshooting

(S)FTP account required

We need a (S)FTP server to exchange data between MOM and Magento. Usually one has access to the Magento server, so we just set up a new SFTP user on that server and use that account to exchange data between MOM and Magento. With M2 Cloud, that's not possible obviously. We will need some kind of hosted (S)FTP account where we can drop and exchange files. This can be one of their current, or old servers, any cheap (secure) web hosting account, or a (S)FTP server they set up in their own network and which they make available on the internet (via port forwarding). Just any (S)FTP server which we can use to store files.

Questions

Got pre-sales questions? Need to change anything in the connector or the output files? A field missing that you want to add? Feel free to contact us! Contact Form

Personal tools
Namespaces
Variants
Actions
General Information
Magento 2 Guides
Magento 2 Extensions
Magento 1 Guides
Magento 1 Extensions
Magento Integration Suite
Product Feed Guides
Toolbox