Data migration expert and APi
Job Title
Magento to Medusa Data Migration Specialist / E-commerce Data Architect
Role Summary
We are seeking an experienced Magento to Medusa Data Migration Specialist who can design and execute end-to-end data migration from Magento to Medusa (Node.js-based commerce engine). The role requires deep understanding of Magento database schema, Medusa data models, and Medusa REST/Admin APIs, with the ability to define correct API call sequencing to ensure data integrity and business continuity.
The ideal candidate will act as a bridge between data, APIs, and business workflows, ensuring a smooth transition without data loss or functional gaps.
Key Responsibilities
1. Magento Data Analysis
Analyze Magento database schema, including:
Products (simple, configurable, bundled)
Categories and category-product relationships
Customers and customer groups
Orders, order items, invoices, shipments, refunds
Pricing, tax, discounts, promotions
Inventory and stock tables
Identify custom Magento extensions and their impact on data migration.
Document Magento data dependencies and relationships.
2. Medusa Data Model & API Understanding
Develop strong understanding of Medusa core entities, including:
Products, Product Variants, Options
Collections, Categories
Customers and Customer Groups
Orders, Line Items, Payments, Fulfillments
Regions, Currencies, Taxes, Sales Channels
Inventory & Stock Locations
Understand Medusa’s:
Admin APIs
Store APIs
Authentication & access tokens
Idempotency and transactional behavior
3. Data Mapping & Transformation
Create detailed mapping documents:
Magento tables/fields → Medusa entities/fields
Data type transformations
Enum and status conversions
Pricing, tax, and currency mappings
Handle complex scenarios:
Configurable → Variant mapping
Attribute sets → Product options
Magento categories → Medusa collections/categories
Order lifecycle and state mapping
Define rules for:
Data normalization
Deduplication
Historical data handling (orders, customers)
4. API Sequencing & Migration Strategy
Define correct sequence of Medusa API calls, such as:
Regions, currencies, tax settings
Sales channels and stock locations
Product options and attributes
Products and variants
Inventory & pricing
Customers and customer groups
Orders (historical migration, if applicable)
Design idempotent and restartable migration flows.
Identify which data should be:
Migrated via APIs
Inserted via DB scripts (if justified)
Define rollback and validation strategies.
5. Migration Execution & Validation
Implement migration scripts using:
Node.js / TypeScript (preferred)
SQL-based extraction from Magento
Perform:
Data validation checks
Record count reconciliation
Sample order/product verification
Support dry runs and production cutover.
6. Documentation & Knowledge Transfer
Produce:
Data mapping documents
API sequencing diagrams
Migration runbooks
Support Medusa customization teams during and post-migration.
Required Skills & Experience
Mandatory
5+ years in e-commerce data migration or platform integration
Strong hands-on knowledge of Magento 2 DB schema
Solid understanding of Medusa architecture and APIs
Experience with REST APIs, authentication, and pagination
Strong SQL skills (MySQL/MariaDB)
Experience defining data migration strategies and sequencing
Technical Skills
Node.js / TypeScript
PostgreSQL (Medusa DB)
MySQL (Magento DB)
JSON data transformation
ETL / migration frameworks (custom or open source)
Git, version control
Nice to Have
Experience with:
Medusa custom modules
Headless commerce migrations
Large catalogs (50k+ products)
Knowledge of:
Payment & tax providers
Multi-store / multi-region Magento setups
Prior experience migrating Magento → headless platforms
Key Deliverables
Magento → Medusa data mapping specification
API call sequencing and dependency document
Migration scripts and logs
Validation and reconciliation reports
Post-migration support documentation
Apply tot his job
Apply To this Job