Migrate a custom commerce platform to Shopify
For proprietary shop systems, framework-based custom builds and historically accumulated commerce applications.
Contents
When is this approach the right fit?
For proprietary shop systems, framework-based custom builds and historically accumulated commerce applications.
The first step is therefore not tool selection but a decision map. It separates essential processes from habits, names dependencies and shows which parts already sit inside Shopify's standard capabilities. Only the remaining gaps justify apps, middleware or custom development.
NICCOS considers a topic ready for delivery only when the objective, non-goals, owners and acceptance are documented. This prevents a concise page title from turning into an open-ended transformation programme whose effort nobody can explain reliably.
What architecture does it require?
The target architecture is derived from business processes rather than source code. Legacy contracts are decoupled through temporary adapters until every surrounding system points to Shopify.
The architecture is shaped around change frequency, outage impact and team ownership. A process that runs every minute needs different guarantees from a nightly catalogue export. Editorial content requires different approvals from a price or an order.
We always plan an observable path: stable IDs, logged state transitions, repeatable processing and a dashboard for exceptions. Without that operating layer, a technically working connection is only a demo rather than a dependable commerce solution.
Which data and process decisions come first?
There is no reliable standard meaning for the data. Tables, fields and status values are interpreted with business teams and reconciled against Shopify using real records.
For every relevant object we document source, destination, key, update frequency, conflict rule and error path. It sounds formal, but it removes the late loops caused when two systems hold the same field with different meanings.
Data is not merely migrated or synchronised; it is reconciled against business meaning. Samples must cover variants, taxes, markets, discounts, returns and historical exceptions. A successful import without business reconciliation proves only that files were read.
What does delivery look like from discovery to operations?
The delivery path is deliberately split into verifiable outcomes. Every phase ends with an artefact, a decision or test evidence. The team can change scope without losing the overall plan, and risks become visible before they block the critical path.
The order follows risk: data and processes first, then architecture and prototype, followed by implementation, migration, acceptance and staged rollout. Interfaces are not approved against sample data, and integrations are complete only after failure and recovery paths have been tested.
- Process, code and data inventory
- Fit-gap and retirement matrix
- Target data model with reconciliation rules
- Migration rehearsals and dry run
- Cutover with explicit legacy shutdown
Which risks require active control?
These risks need explicit controls in discovery, testing and monitoring. Before implementation, each one receives an owner, evidence requirement and fallback path.
Undocumented cron jobs and admin workarounds contain hidden business logic.
Data fields carry several historical meanings.
The old store remains a parallel source of truth for too long.
What does NICCOS add beyond a standard implementation?
Source code is evidence, not specification. What matters is which process is actually used today and what value it still creates in the target.
We connect commerce decisions with SEO, data quality, analytics and operations. A solution is not complete when the happy path works. It must be discoverable, measurable, accessible, translatable and understandable to the team after the project.
We also document when the standard is the better decision. Not every requirement deserves custom software, not every data flow needs real-time processing, and not every historical exception should be carried into the target architecture.
How is quality measured before launch?
Acceptance measures are set before implementation and tested with real data. Functional tests alone are insufficient: completeness, speed, fault tolerance and the team's ability to recognise and classify exceptions are what matter.
- Gate 1
- Every active process has a tested target path
- Gate 2
- Record counts and totals reconcile between source and target
- Gate 3
- The legacy system can be retired through a documented plan
| Check | Expected evidence |
|---|---|
| Gate 1 | Every active process has a tested target path |
| Gate 2 | Record counts and totals reconcile between source and target |
| Gate 3 | The legacy system can be retired through a documented plan |
Related playbooks
Migrate Salesforce Commerce Cloud to Shopify
An SFCC to Shopify migration is not a data export but the deliberate replacement of cartridges, jobs, OCAPI or SCAPI flows, price books and accumulated campaign logic. The safe route inventories every extension, assigns it to standard, app, integration or retirement, and migrates catalogue, SEO and operations in testable waves.
Open playbookReplace Oracle ATG with Shopify in controlled stages
With Oracle ATG, the risk lies in custom business logic rather than product import. Repositories, droplets, pipelines and batch processes must first be sorted by business value. Shopify takes standard commerce, while the few stable differentiating processes are remodelled through apps or middleware.
Open playbookMove AEM Commerce experiences to Shopify
With AEM, the first decision is whether the CMS stays or is replaced with the commerce platform. If AEM remains, Shopify becomes the commerce core and AEM supplies selected content. If AEM goes, components, content fragments, assets, approvals and URLs form a migration of their own.
Open playbook
Frequently asked questions
When is this approach useful?
How should the project start?
Which data must never be maintained twice?
What belongs in acceptance testing?
What is the NICCOS point of view?
Primary sources
Official documentation used for capabilities, constraints and implementation guidance.
More projects
Settle the decision before the build
We assess a custom commerce platform migration to Shopify against real processes, data and operating requirements, then turn it into a deliverable scope with clear release gates.




























