Merchantry Magento Extension Merchantry Magento Extension serves as a gateway between the Merchantry platform and the Magento ecommerce storefront. It can be used by retailers who have storefronts based on Magento and who need to connect to suppliers in themerchantry platform. Merchantry Magento Extension can be configured to work in one of the following ways on the Magento instance it's installed on: Storefront - you're a retailer using the Magento instance as a storefront, and the extension will be used to connect to suppliers in the Merchantry platform. Supplier - you're a supplier using the Magento instance to manage your products and orders, and you're going to sell your products through a retailer, and you use the extension to connect to the retailer. Here you can find more information about Merchantry Magento Extension which can help to set up the extension and start to use it: System Requirements Installation Guide Administrator's Guide Limitations System Requirements Merchantry Magento Extension works correctly with systems of the following versions Versions Supported - 1 -
Chapter 1 Magento Versions Enterprise - version 1.13 Community - not supported Magento user with administrator permissions is needed to install and set up the Merchantry Magento Extension. Merchantry platform API Versions Merchantry Platform - Retailer account / Supplier accounts Product Integration API - Version 1.8 FLAT Installation Guide Environment Readiness Installing the Extension Uninstalling the Extension Note: Please contact your account manager if you are interested in getting the latest version of Merchantry Magento Extension. Environment Readiness This Extension must be pre-installed/tested on a snapshot of the destination production Magento instance prior to live deployment. Installing the Extension Note: Magento Connect installation requires Magento administrator permissions. - 2 -
Installation Guide Log in to the Magento admin Go to ystem > Magento Connect > Magento Connect Manager - 3 -
Chapter 1 Enter your admin user password to log in to Magento Connect Manager - 4 -
Installation Guide Make sure you are on the Extensions tab In the Direct package file upload section click Choose File and then select the Merchantry_xxx.tgz file - 5 -
Chapter 1 Click Upload and the extension will be installed to your Magento instance The window at the bottom of the screen will show the status of the procedure (it may take several minutes to run). Uninstalling the Extension Log in to the Magento admin - 6 -
Installation Guide Go to System > Magento Connect > Magento Connect Manager - 7 -
Chapter 1 Enter your admin user password to log in to Magento Connect Manager - 8 -
Installation Guide Make sure you are on the "Extensions tab Scroll to the bottom to find Manage Existing Extensions section Under Package Name you will see Merchantry_importexporter. In the Actions drop down menu select uninstall Click Commit Changes at the bottom and the extension will be uninstalled - 9 -
Chapter 1 The window at the bottom of the screen will show the status of the procedure (it may take several minutes to run). Administrator's Guide Navigating and Configuration Merchantry Magento Extension Menu General Configuration Product Data Mapping Data Processing Manual Processing (Import, Export) Supplier Options (Export) Viewing Processing Status Scheduling Processes - 10 -
Merchantry Magento Extension Menu Merchantry Magento Extension Menu Note: Configuring the Merchantry Magento Extension requires Magento administrator permissions. After the Merchantry Magento Extension successfully installed to your Magento instance, you can see new item "Merchantry" in the upper menu Menu Items Note: Menu items visibility depends on the Configuration Type set for the Merchantry Magento Extension instance. See General Configuration for details. Configuration - general configuration parameters. Add New Attribute - used for adding new attributes to attribute lists in product data mapping. Download Crontab File - obsolete. Ignore the menu item. - 11 -
Chapter 1 Supplier Options - available for "Supplier" configuration type only. This section is used for running manually processes to export products, prices, inventory, fulfilled and canceled orders. Manual Processing Options - used for triggering manually import/export processes such as import products, prices, inventory, orders, RMAs. The processes which can be run in this section differ for Supplier and Storefront configurations. Transactional Logs View - viewing the recent process log. Download - downloads a log file. Processing Status - available for "Storefront" configuration type only. Leads to Processing Status section. General Configuration The page allows to view and change general configuration options of the extension. - 12 -
General Configuration General Settings Magento Store Id - Magento Store identifier indicates which Magento store will be used for the Merchantry Magento Extension. The default is Default Store View. - 13 -
Chapter 1 Configuration Type - defines if the Magento instance works with the Merchantry platform as a Storefront 1 or as a Supplier system. Applicable values are: Storefront - select this option if you are using the extension to connect to suppliers in the Merchantry platform Supplier - select this option if you are using the extension to sell your products through a retailer Select user if Guest Checkout is Disabled - a user with administrative permission needs to be created in Magento for this module to allow updates when Guest Checkout is disabled on the cart. Select the admin user name. Minimum Product Quantity For Export - available only if "Supplier" configuration type is selected. Products with quantity below the value set in the field will be exported with zero inventory. Account ID - Company ID of your account in the Merchantry platform. The value is available from Merchantry once the account is created. Contact your account manager to get the value, and then enter the value in this field. Example: 119. Currency - currency used to sell your products. The default is set to USD. Log Level - defines who much detailed logs are needed. Show Magento Attributes - available only if "Supplier" configuration type is selected. Normal - attributes not visible and not applied to any product type in Magento are not shown in drop down lists in Data Mapping section. 1 A storefront is a website where customers can browse and buy products. - 14 -
General Configuration All - all attributes are available in drop down lists in Data Mapping section. Use Parent Pricing Model - automatically calculate the parent product price based on its child products. The lowest price across all the children will be taken as the parent price when this is enabled. Available options are: Yes (Default) - turns on parent pricing No - turns off parent pricing Status - indicates the status of the Extension. Select the appropriate option: Enabled - extension is active for the Merchantry platform Disabled - extension is not active for the Merchantry platform Shipping Settings Shipping Integration - FTP Settings File Transfer Protocol used as data pass through. The information is available in your account in the Merchantry platform. FTP Mode - indicates if you use FTP or secure FTP protocol for data transfer. Available options are: SFTP FTP FTP UserName - your FTP account username FTP Password - your FTP account password FTP Host URL - your FTP server/services host address - 15 -
Chapter 1 FTP Export data to this folder name - the folder to which you are sending files. Usually it's FromSupplier (without quotes) for Supplier. Example: FromSupplier (for Suppliers) FromStorefront (for Retailers) FTP Import data from this folder name - the folder from which you will receive files. Usually it's ToSupplier (without quotes) for Supplier. Example: ToSupplier (for Suppliers) ToStorefront (for Retailers) Export Orders from Previous Day(s) - available only if "Storefront" configuration type selected. Specifies the start day of a date range for exporting orders (current date is the end date). Orders placed within the date range are to be exported to Suppliers. Enter the appropriate numeric value representing number of days. Example: 1 (means 1 day). Note: Suppliers can ignore this field. Product Data Mapping For Retailer ("Storefront" Configuration Type) To view the "Data Mapping" section go to "Merchantry" menu item -> "Configuration" menu item -> "Data Mapping" tab. - 16 -
Product Data Mapping This section allows to configure mapping of Merchantry data fields (MPO Source Attribute) to Magento attributes fields (Destination Attribute in Magento) which will be used on import of product data from Merchantry platform. By default a limited number of core fields are available. Additional fields will become available for mapping once an initial product, inventory and price file is imported. Create Magento attributes as required based on the data elements available from the Merchantry data fields. Modify the mapping by selecting proper Magento attributes in drop down lists, then click "Save Configuration" to apply changes. Adding New Import Attributes Manually 1. Go to "Merchantry" menu item -> "Configuration" -> "Add New Attribute" menu item. - 17 -
Chapter 1 2. Fill the "Attribute Name to Import" field with the proper name of the Magento attribute you want to export your Merchantry platform attributes to. 3. Select a value in "Attribute Type" - one of Localized/Attribute -> domain = MPO Localized/Attribute -> domain = CommonTaxonomy Shipping Data -> Shipping Option - to add shipping option data. 4. Click "Add New Attribute" to add the new attribute to the attribute list in "Data Mapping" section. For Suppliers ("Supplier" Configuration Type) To view the "Supplier Data Mapping" section go to "Merchantry" menu item -> "Configuration" menu item -> "Supplier Data Mapping" tab. - 18 -
Product Data Mapping This section allows to configure mapping of Magento attributes fields to Merchantry data fields which will be used on export of product data from Magento to the Merchantry platform Adding New Export Attributes Manually 1. Go to "Merchantry" menu item -> "Configuration" -> "Add New Attribute" menu item. 2. Fill the "Attribute Name to Export" field with the proper name of the attribute in Merchantry platform you want to export your Magento attributes to. 3. Select a value in "Attribute Type" (one of "Export - Variation Theme" and "Export - Custom Attribute"). 4. Click "Add New Attribute" to add the new attribute to the attribute list in "Supplier Data Mapping" section. - 19 -
Chapter 1 Manual Processing (Import, Export) The section allow to run different processes for Supplier and Storefront configurations of the extension. You can select the process you need to trigger, fill additional parameters (if any), and click "Run" to start the process. You will see a notification message indicated that the process was successfully completed. - 20 -
Manual Processing (Import, Export) Processes Available for Suppliers ("Supplier" configuration type) Import Orders - Supplier Option Export ALL Magento Categories RESET Import / Export Attribute Mappings Processes Available for Retailers ("Storefront" configuration type) Download Files from FTP - the process moves all files from the FTP directory specified in "FTP Export data to this folder name" configuration option to special directory in Magento where the files will be taken to be imported to Magento. The files will be removed from the FTP directory. Note: The destination directory in Magento is located there: <Your Magento instance URL>/var/www/html/var/merchantry Example: http://yourmagentoinstance.com/var/www/html/var/merchantry Import Products / Fulfillments / Prices / Inventory - the process imports product, prices, inventory and fulfillment files from Merchantry Magento Extension directory to the Magento instance. Note: All necessary product related settings such as a mapping of Merchantry attributes to storefront attributes, taxonomy/category, tax class, shipping options should be configured prior to importing product data into - 21 -
Chapter 1 Magento. Note: The product data files should be previously downloaded from FTP to the special Merchantry Magento Extension directory. Export NEW Merchantry Orders - exports not exported orders to the FTP directory specified in "FTP Import data from this folder name". Refer to Orders (ecommerce API 1.4) for the file format. You can specify the following additional parameters for the process: Export Orders from Previous Day(s) - specifies a numeric value which indicates the number of days old from current date to export orders. When it's set to zero or empty value, the process exports all orders that have not been exported before. Example: 1 indicates to export orders that are 1 day old from current date. Order EXPORT Status Filter - order status in Magento. The process will export only orders in the status. It is recommended to select "Processing" or "Pending". Export Orders by Order Number - exports orders by order numbers to the FTP directory specified in "FTP Import data from this folder name". Refer to Orders (ecommerce API 1.4) for the file format. Order Numbers to Export (comma separated for multiple) - specify order numbers to export (comma separated list) Export ALL Merchantry Orders - works similarly to "Export NEW Merchantry Orders" but exports all orders, including the ones that have been exported previously. Useful when you need to re-send previously exported order. Export NEW Merchantry RMA's - exports not exported RMA's to the FTP directory specified in "FTP Import data from this folder name". Refer to RMAs (ecommerce API 1.4) for the file format. Export ALL Merchantry RMA's - exports all RMA's (including previously exported ones) to the FTP directory specified in "FTP Import data - 22 -
Supplier Options from this folder name". Refer to RMAs (ecommerce API 1.4) for the file format. Export ALL Magento Categories - exports all Magento categories to Merchantry platform Refer to Storefront Categories (ecommerce API 1.4) for the file format. RESET Import / Export Attribute Mappings - Used to reset all data mappings back to defaults prior to data mappings being created for products, prices, inventory, etc. Supplier Options Note: This section is available only for "Supplier" configuration of the extension. This section allows Suppliers to run processes manually to export products, prices, inventory. - 23 -
Chapter 1 You can choose export settings and the process to run, and click "Run Export" to trigger the process. Available settings: Start Export from beginning - this setting defines if the system should export products which have been exported already. It doesn't affect order export. Yes - exports all products No - export only products not exported yet Number of Records to Process - TBD Export Type - select the export process needed. The following processes are available to export the corresponding product data sets: Products, Prices, Inventory Products - 24 -
Viewing Processing Status Pricing Inventory Fulfilled Orders Canceled Orders Viewing Processing Status On the page you can view processing statuses of all processes run. You can filter the process list by process ID, file name, start date and end date, and processing status. Note: By default the list shows product related processes. Use filter by File Name to search for other processes. Clicking a process in the list opens the process detail page where you can download the process file and the process logs: - 25 -
Chapter 1 Scheduling Processes To schedule processes in Merchantry Magento Extension, follow the steps below: - 26 -
Scheduling Processes 1. Login to Magento admin 2. Go to System -> Configuration in the upper menu 3. Find "Merchantry" section in the left menu, and open the "Scheduled Tasks" tab 4. Schedule a process start, then click "Save Config" to apply changes. Scheduling Processes For Retailers ("Storefront" Configuration Type) - 27 -
Chapter 1 You can use the following configuration options Merchantry - FTP Frequency - defines the time and frequency when the Merchantry Magento Extension should download files from FTP. Merchantry - Import Frequency - defines the time and frequency when product related files and fulfillments will be imported to Magento. Recommended to schedule the trigger to be fired AFTER the "Merchantry - FTP Frequency" one to have all data downloaded from FTP to Magento before the import. - 28 -
Limitations Import - Maximum Number of Files - specifies the maximum number of files to process at one time. If not specified, the system tries to import all files RMA - Export Frequency - defines the time and frequency when RMAs and fulfillments will be imported to Magento. Orders - Export Frequency - defines the time and frequency when orders and fulfillments will be imported to Magento. Orders - Age Before Sent - not supported. Orders - Previous Days to Export - specifies a numeric value which indicates the number of days old from current date to export orders. When it's set to zero or empty value, the process exports all orders that have not been exported before. Orders - Status to Export - order status in Magento. The process will export only orders in the status. Use CRON format to specify process frequency. For Suppliers ("Supplier" Configuration Type) Not supported at this moment. Limitations Below is the list of cases not supported currently in Merchantry Magento Extension. Order Export - Magento does not support tax calculations at the orderitem level. Orders are exported with the order tax total amount specified for the first order item. - 29 -