Upgrading from Magento 1

Our Magento 2 extensions retain the same database layout for most aspects of the extension easing migration from Magento 1 and Magento 2. Information that carries over automatically 

  • settings
  • export status to Xero
  • invoice linking information between Magento and Xero

We generally advise to have the Magento 2 extension installed already during the migration. We suggest the following process to ensure no interruption:

  • Order and install our Magento 2 extension
  • Make sure that all orders have been exported to Xero from your Magento 1 site
  • Run Migration - see below for additions to the Magento Data Migration Tool
    while we believe the export status is migrated over we suggest setting the export start date on the Magento 2 site to the day of the migration

Magento Data Migration Tool - Fooman Connect Additions

To migrate the extension data please add the following to your migration.

In your class-map.xml file add

<classmap xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="urn:magento:module:Magento_DataMigrationTool:etc/class-map.xsd">
    <!-- Fooman Connect: Xero -->
    <rename>
        <from>foomanconnect/system_salesProductAccountOptions</from>
        <to>Fooman\Connect\Model\System\SalesProductAccountOptions</to>
    </rename>

In your settings.xml add

<settings xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="urn:magento:module:Magento_DataMigrationTool:etc/settings.xsd">
...
   <value>
        <transform>
            <path>foomanconnectxero/connect/apikey</path>
            <handler class="\Migration\Handler\Encrypt" />
        </transform>
        <transform>
            <path>foomanconnectxero/connect/apisecret</path>
            <handler class="\Migration\Handler\Encrypt" />
        </transform>

In your map.xml file add

<map xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="urn:magento:module:Magento_DataMigrationTool:etc/map.xsd">
    <source>
        <document_rules>
       		<!-- Fooman Connect: Xero -->
            <ignore>
                <field>foomanconnect_creditmemo.xero_last_validation_errors</field>
            </ignore>
            <ignore>
                <field>foomanconnect_invoice.xero_last_validation_errors</field>
            </ignore>
            <ignore>
                <field>foomanconnect_order.xero_last_validation_errors</field>
            </ignore>
            <ignore>
                <field>foomanconnect_item.xero_last_validation_errors</field>
            </ignore>
            <!-- End Fooman Connect: Xero -->

            ...
        </document_rules>
    	<field_rules>
            <!-- Fooman Connect: Xero -->
            <ignore>
                <field>sales_flat_quote_item.xero_rate</field>
            </ignore>
            <ignore>
                <field>sales_flat_order.xero_rate</field>
            </ignore>
            <ignore>
                <field>sales_flat_order_item.xero_rate</field>
            </ignore>
            <ignore>
                <field>tax_calculation_rate.xero_rate</field>
            </ignore>
            <!-- End Fooman Connect: Xero -->

After migration has completed please set up the mapping of the tax rates as that information would not have migrated. Please see these here: https://magento2-support.fooman.co.nz/article/1301-4-map-tax-rates

Still need help? Contact Us Contact Us