OXID eShop to Shopware Migration - Step-by-Step Guide & Expert Services

A Comprehensive Guide to Transitioning from OXID eShop to Shopware

Migrating your e-commerce store is a significant undertaking, but with the right strategy and tools, it can be a smooth and rewarding process. This guide provides a detailed, step-by-step walkthrough for merchants looking to move their online store from OXID eShop to Shopware, a powerful and flexible platform known for its scalability and rich feature set. Whether you're seeking enhanced performance, a more modern user experience, or robust customization options, migrating to Shopware can unlock new opportunities for your business.

Given that OXID eShop is not directly supported by our automated migration tool via a bridge connection, the transition will primarily involve a CSV file data migration. This method ensures that all your critical store data, from products and customer information to orders and reviews, is meticulously transferred to your new Shopware environment. Follow this expert guide to ensure a successful and efficient replatforming journey.

Prerequisites for Migration

Before you begin the migration process, thorough preparation is key to ensuring a seamless transition and minimizing downtime. Here's what you'll need to have in place:

• New Shopware Store: Ensure you have a fresh installation of Shopware (version 5.2.2 or 6.0.0 is supported) on your hosting environment. It's recommended to start with a clean slate to avoid conflicts. You can learn more about preparing your target store here.
• OXID eShop Data Export: You will need to export all your vital data from your existing OXID eShop store into CSV files. This includes products, categories, manufacturers, customer records, orders, and reviews. Make sure your CSV files are well-structured and organized for easy import.
• Shopware Cart2Cart Migration Module: For a successful connection to Shopware, you'll need to install the specific Cart2Cart Shopware Migration module. This plugin facilitates the secure data transfer via a connection bridge.
• FTP/SFTP Access: You'll need FTP or SFTP access to both your OXID eShop (if direct file access is needed for CSV export assistance) and especially your Shopware store's root directory to upload the connection bridge file. Understanding what a root folder is can be helpful.
• Administrative Access: Full administrative access to both your current OXID eShop and your new Shopware store is essential for configuration and verification. You can find essential guidance on access credentials here.
• Data Backup: Always create a complete backup of your OXID eShop store's database and files before initiating any migration. This is a critical safety measure. Consider also backing up your new Shopware store before a full migration run, especially if clearing target data.
• Review Shopware Versions: Be aware that Shopware versions 6+ have certain ID preservation limitations. Plan accordingly if maintaining exact original IDs is crucial for your business.

Performing the Migration: A Step-by-Step Guide

Our migration wizard simplifies the complex process of data transfer. Follow these steps to successfully move your data from OXID eShop (via CSV) to Shopware.

Step 1: Set Up Your Source Store (OXID eShop via CSV)

Since direct API integration for OXID eShop is not available, we will treat your OXID eShop data as a CSV file source.

1. Select 'CSV File to Cart' as Your Source Cart: In the migration wizard, choose 'CSV File to Cart' from the dropdown list of supported platforms.
2. Upload Your Exported CSV Files: Upload the CSV files containing your OXID eShop data. Ensure all relevant entities like products, customers, orders, and categories are included. The tool will guide you through mapping these files.

Step 2: Connect Your Target Shopware Store

Now, let's establish the connection to your new Shopware store.

1. Choose 'Shopware' as Your Target Cart: Select 'Shopware' from the list of target platforms.
2. Enter Your Shopware Store URL: Provide the full URL of your Shopware store.
3. Download and Upload Connection Bridge: The wizard will prompt you to download a 'Connection Bridge' file. This is a small zip file. Unpack it and upload the `bridge2cart` folder to the root directory of your Shopware store via FTP/SFTP. This bridge acts as a secure data link.
4. Install Shopware Migration Module: Ensure the Cart2Cart Shopware Migration module is installed and activated in your Shopware administration. This is a plugin requirement for Shopware.

Step 3: Select Data Entities for Migration

This crucial step allows you to define exactly what data you want to transfer from your OXID eShop CSV files to Shopware. You can migrate a wide array of entities, including SKUs, product variants, customer data, and more.

1. Choose Specific Entities: Check the boxes next to the entities you wish to migrate. Common selections include Products, Categories, Manufacturers, Customers, Orders, Reviews, and CMS Pages.
2. Select 'All Entities' for a Full Transfer: If you want to move all available data, simply select the 'All entities' option.

Step 4: Configure Additional Migration Options

Tailor your migration with a range of powerful additional options designed to enhance data integrity and preserve your SEO rankings.

• Clear Target Store Data: The option to clear current data on your Target store before migration is highly recommended for a fresh Shopware installation to prevent duplicate entries or conflicts.
• Preserve IDs: Opt to preserve product, customer, and order IDs. This is particularly useful for maintaining historical data consistency and external system integrations. Be mindful of potential limitations with Shopware 6+ as noted in our platform data.
• Migrate Images in Product Descriptions: Ensure all embedded images within your product descriptions are successfully transferred.
• Create 301 Redirects: Automatically generate 301 redirects for your old product and category URLs to new ones. This is vital for maintaining link equity and preventing lost SEO rankings post-migration.

Step 5: Map Data Fields

Data mapping ensures that your OXID eShop data correctly aligns with Shopware's structure, preventing inconsistencies and errors. This is particularly important for customer groups and order statuses.

1. Map Customer Groups: Match customer groups from your OXID eShop (e.g., 'Registered Customers', 'Guests') to their corresponding groups in Shopware.
2. Map Order Statuses: Align order statuses (e.g., 'Pending', 'Processing', 'Completed') from your source to the appropriate statuses in Shopware.

Step 6: Run a Demo and Full Migration

Before committing to the full replatform, it's highly recommended to perform a free demo migration.

1. Initiate Demo Migration: Run a limited data transfer (e.g., 10-20 products, customers, and orders) to see how your data appears in Shopware. This allows you to check for any issues and verify data integrity.
2. Review Demo Results: Carefully inspect your new Shopware store. Check product details, customer accounts, and order history for accuracy.
3. Start Full Migration: Once satisfied with the demo, proceed with the full migration. This step will transfer all selected data entities. You may also consider a Migration Insurance Plan for added peace of mind, allowing for future remigrations.

Post-Migration Steps

Your data has been transferred, but the journey isn't over yet. These post-migration steps are crucial for launching your new Shopware store successfully and ensuring a positive user experience.

• Thorough Store Testing: Conduct comprehensive testing of your new Shopware store. Verify product displays, pricing, inventory, search functionality, checkout processes, customer login, and order placement. Ensure all links work correctly and that images and metadata are displayed as intended.
• Update DNS Records: Once testing is complete and you're ready to go live, update your Domain Name System (DNS) records to point your domain to the new Shopware store's hosting server. Plan this carefully to minimize downtime.
• Implement 301 Redirects (if not automated): If you didn't use the automated 301 redirect option during migration, it's imperative to manually set up redirects for all old OXID eShop URLs to their new Shopware counterparts. This preserves your SEO rankings and prevents visitors from encountering broken links.
• Install and Configure Extensions/Apps: Install any necessary Shopware plugins or apps that provide functionality your business relies on (e.g., payment gateways, shipping integrations, marketing tools).
• Update SEO Settings: Review and optimize your Shopware store's SEO settings, including meta titles, descriptions, and URL structures. Check your analytics to monitor traffic and rankings.
• Notify Customers: Inform your customers about the migration and any changes they might notice. Provide guidance on logging in or any new features.
• Remove Old Store: Once you are confident that your new Shopware store is fully functional and stable, you can safely decommission your old OXID eShop to avoid content duplication issues.
• Ongoing Monitoring: Continuously monitor your Shopware store's performance, user experience, and SEO health. Make adjustments as needed to ensure optimal operation.

Migrating from OXID eShop to Shopware opens up a world of possibilities for your e-commerce business. By following this detailed guide and leveraging the automated migration process, you can achieve a smooth and successful replatforming, setting your store up for future growth. If you encounter any challenges or require custom solutions, our team is always ready to assist. Feel free to contact us for expert support or check our Frequently Asked Questions.