Vault Commerce OS · Data Migration

Move Existing Commerce, Inventory and Relationship Data into Commerce OS without Losing Context

Plan and execute structured migrations from spreadsheets, legacy websites, warehouse systems, CRM platforms, rental systems and supported exports using source assessment, field mapping, cleansing, deduplication, staged imports, reconciliation, cutover and rollback controls.

Data Migration is a finite implementation workstream. It prepares trusted opening data for Commerce OS; ongoing connections after go-live belong under Integrations or the relevant connected module.

Source assessment and mapping
Clean, validate and reconcile
Controlled cutover and rollback
From legacy source to reconciled Commerce OS opening state
Assess + map + migrate + verify
01
Assess the Sources
Identify systems, spreadsheets, files, media, ownership, data quality, historical depth and export constraints.
02
Map and Clean
Translate fields, categories, identifiers, relationships, statuses and permissions while resolving duplicates and invalid values.
03
Dry Run and Reconcile
Import into a controlled environment, compare counts, totals, relationships and exceptions and correct the migration rules.
04
Cut Over and Verify
Freeze or delta-capture the source, run final migration, reconcile opening state, retain rollback evidence and approve production use.
A migration is successful only when the destination data is usable, reconciled and attributable—not merely imported.
Data transfer + operational trust
Choose the migration depth

Start with Essential Opening Data or Move the Wider Historical Operating Context

The correct migration scope depends on what the client needs to operate from day one, what must remain accessible for reference and what can safely stay archived outside Commerce OS.

Swipe through the Data Migration models
01

Essential Opening Migration

Move the current catalogue, inventory, locations, users and core relationship data needed to begin operations.

  • Current catalogue and stock
  • Opening locations and balances
  • Active contacts and accounts
  • Required users and permissions
03

Phased Multi-System Migration

Move several source systems in controlled waves while maintaining cross-system identifiers and reconciliation.

  • Multiple source systems
  • Wave-based migration
  • Cross-reference and lineage
  • Controlled cutover by module or site
Four connected Data Migration components

Control Source Discovery, Mapping, Reconciliation and Cutover as One Migration Programme

Migration quality depends on more than import scripts. The source data, transformation rules, relationships, exception handling and acceptance criteria all need to be explicit.

Swipe through the Data Migration components
01

Source Assessment

Inventory the systems, files, tables, media, identifiers, owners, history and data-quality risks before transformation begins.

SourcesExportsQualityScope

View source assessment

02

Mapping and Cleansing

Translate fields, categories, statuses, relationships and identifiers while resolving invalid values, duplicates and missing required data.

MapCleanDedupeTransform

View mapping and cleansing

03

Dry Run and Reconciliation

Test imports, compare source and destination counts, values and relationships and resolve exceptions before production cutover.

Dry RunCountsExceptionsReconcile

View dry run and reconciliation

04

Cutover and Verification

Control the final source freeze or delta, final import, opening-state validation, rollback evidence and production acceptance.

CutoverDeltaVerifyRollback

View cutover and verification

See the Data Migration workflow in action

Follow Legacy Data from Source Assessment through Mapping, Dry Run, Cutover and Reconciliation

Start with the complete migration architecture, then move through source inventory, profiling, field and relationship mapping, cleansing, deduplication, dry-run imports, reconciliation, cutover, rollback evidence and migration close.

Slide 1 of 10

Complete Data Migration architecture

02
Source inventory and scope The screen lists fictional source systems, extracts, media, owners, record counts, extraction method and included migration scope.
Step 1 · Assess the sources

Document Every Source before Deciding What to Move

The migration begins with a complete source inventory and ownership map.

  • Source systems, files and media
  • Record counts and source owners
  • Export or extraction method
  • Included, historical and archived scope
What this screen demonstrates Only approved sources and data domains should enter the migration programme.
03
Data-quality profile The screen shows completeness, invalid values, duplicates, orphan relationships and quality warnings by source domain.
Step 2 · Profile the data

Measure the Problems before Building Transformation Rules

Data profiling makes source quality and remediation effort visible early.

  • Field completeness
  • Invalid or inconsistent values
  • Duplicate candidates
  • Orphan and missing relationships
What this screen demonstrates Known source defects should be recorded rather than hidden by the migration.
04
Field and relationship mapping The screen maps fictional source fields, categories, statuses, identifiers and relationships into Commerce OS destinations.
Step 3 · Map the destination

Make Every Material Transformation Rule Explicit

The migration map describes how source meaning becomes destination structure.

  • Source and destination fields
  • Category and status translation
  • Parent-child and account relationships
  • Legacy and destination identifiers
What this screen demonstrates Unmapped required fields should block affected records until resolved.
05
Cleansing, deduplication and lineage The screen shows format normalisation, duplicate review, merge decisions, legacy IDs, source batch and transformation lineage.
Step 4 · Clean under control

Improve Data Quality without Losing the Source Trail

Cleansing and deduplication remain governed and attributable.

  • Format and value normalisation
  • Duplicate candidate review
  • Merge or retain-separate decision
  • Legacy ID, source and transformation version
What this screen demonstrates A cleaned destination record should still be traceable to its originating data.
06
Dry-run migration batches The screen shows a fictional staging batch, source extract, transformation version, created, skipped, failed and rerun states.
Step 5 · Dry run the migration

Execute the Real Migration Logic before Production Cutover

Versioned staging batches expose transformation and import problems safely.

  • Batch and source-extract reference
  • Created, updated, skipped and failed counts
  • Transformation version
  • Repeatable rerun or reset
What this screen demonstrates A dry run should be reproducible, not a one-off manual test.
07
Migration reconciliation The screen compares fictional source and destination counts, quantities, values, media and relationships and lists exceptions.
Step 6 · Reconcile the result

Compare What Was Expected with What Actually Arrived

Reconciliation turns the import result into evidence the client can review.

  • Record and line counts
  • Opening quantities or balances
  • Media and relationship completeness
  • Exception count and ageing
What this screen demonstrates Reconciliation should use the measures relevant to each data domain.
08
Migration exceptions and approval The screen shows rejected records, causes, assigned owner, corrected rule, rerun result and client cutover approval.
Step 7 · Resolve and approve

Correct the Rule, Reconcile Again and Record Acceptance

Exceptions remain visible until fixed, accepted or explicitly excluded.

  • Rejected record and reason
  • Missing mapping or relationship conflict
  • Rule correction and rerun
  • Known exception and client approval
What this screen demonstrates Material unresolved exceptions should remain documented at cutover.
09
Cutover and opening verification The screen shows fictional source freeze or delta, final batch, opening-state checks, smoke tests and go-live approval.
Step 8 · Cut over

Control the Gap between Final Source Extract and Production Use

The cutover plan protects changes made during the transition window.

  • Source freeze or final delta
  • Final migration batch
  • Opening-state reconciliation
  • Operational smoke tests and approval
What this screen demonstrates The destination should not become authoritative until cutover verification is complete.
10
Rollback, archive and migration close The screen shows recovery point, rollback criteria, archived extracts, mapping documentation, acceptance register and migration close.
Step 9 · Verify and close

Finish the Migration with Recovery Evidence and a Clear Handover

The final workstream preserves what was migrated, how it was transformed and how the client accepted it.

  • Recovery point and rollback criteria
  • Approved source archive
  • Mapping and transformation documentation
  • Acceptance register and migration close
What this screen demonstrates After migration closes, continuing system-to-system exchange belongs under Integrations.
Swipe through the Data Migration walkthrough
01
Understand the source estate before writing migration rules

Systems, Files, Tables, Media, Identifiers, Owners, History and Export Constraints

The first migration task is to identify what data exists, where it lives, who owns it, how trustworthy it is and what the source system can actually export.

Current operational data and historical reference data do not always need the same migration treatment. The assessment should define what must become live Commerce OS data, what may remain read-only history and what can be archived.

Source inventory and ownership
Data-quality and export assessment
Operational versus archival scope
Swipe through source-assessment controls

Source-System Inventory

Document every source that contributes to the intended opening state.

  • Websites, ERP, WMS, CRM or rental platforms
  • Spreadsheets, CSVs and structured exports
  • Media libraries and document stores
  • Source owner and extraction method

Data Profiling and Quality

Measure what can be migrated reliably and what needs remediation.

  • Record counts and field completeness
  • Invalid, inconsistent or unexpected values
  • Duplicate identifiers or entities
  • Missing relationships and orphan records

Identity, History and Relationship Scope

Decide which historical connections must survive the move.

  • Legacy item, SKU, contact and transaction identifiers
  • Parent-child and variant relationships
  • Account, project and location relationships
  • Historical depth required for operational continuity

Migration Scope and Acceptance Baseline

Define what counts as a complete and accepted migration before execution begins.

  • Included and excluded source domains
  • Opening-state and historical requirements
  • Acceptance counts, totals and relationship checks
  • Known limitations and unresolved source issues
02
Transform legacy structures into the destination model without losing lineage

Field Mapping, Categories, Statuses, Identifiers, Deduplication, Cleansing and Relationship Preservation

Migration rules should show exactly how each source field and value becomes a Commerce OS field, category, status, relationship or retained legacy reference.

Cleaning and deduplication should be controlled. Records should not be merged, discarded or normalised without a traceable rule and, where necessary, review.

Explicit source-to-destination mapping
Controlled cleansing and deduplication
Legacy ID and relationship preservation
Swipe through mapping and cleansing controls

Field and Value Mapping

Translate source structures into the destination schema.

  • Source field to destination field
  • Data type and format conversion
  • Status and enumeration translation
  • Default, derived and required-value rules

Category and Relationship Mapping

Preserve the structural relationships the operating platform needs.

  • Category and attribute hierarchy
  • Variant and parent-child relationships
  • Location and container relationships
  • Contact, account, project and transaction links

Cleansing and Deduplication

Resolve unreliable source data without hiding the original problem.

  • Whitespace, casing and format normalisation
  • Invalid and impossible values
  • Possible duplicate review
  • Merge, retain-separate or exception decision

Legacy Identifiers and Data Lineage

Retain enough source reference to trace destination records back to the migration input.

  • Legacy record and system identifier
  • Source file, table or batch reference
  • Transformation version
  • Migration timestamp and exception history
03
Prove the migration rules before production cutover

Staging Imports, Validation, Counts, Totals, Relationship Checks, Exceptions and Sign-Off

A dry run should use the real mapping rules and representative source data in a controlled destination environment, not just a sample spreadsheet transformation.

Reconciliation should compare what was expected with what was successfully created, skipped, transformed, rejected or linked so the client can approve the migration rules before go-live.

Staged import and validation
Counts, totals and relationship reconciliation
Exception review and acceptance
Swipe through dry-run and reconciliation controls

Controlled Dry-Run Import

Execute the migration logic in staging before production data is affected.

  • Versioned migration batch
  • Source file or extract reference
  • Created, updated, skipped and failed records
  • Repeatable rerun or reset procedure

Record and Balance Reconciliation

Compare source and destination at the level relevant to the data set.

  • Record and line counts
  • Inventory quantities or opening balances
  • Value totals where appropriate
  • Media, relationship and status completeness

Exception and Root-Cause Review

Fix the migration rule rather than repeatedly patching individual destination records.

  • Rejected record and reason
  • Missing mapping or required data
  • Duplicate or relationship conflict
  • Rule correction and rerun history

Client Validation and Sign-Off

Approve the migration based on defined evidence rather than visual spot checks alone.

  • Acceptance criteria and result
  • Sample operational verification
  • Known exceptions accepted or unresolved
  • Approved cutover readiness
04
Control the transition from old operating data to new production truth

Freeze or Delta Capture, Final Import, Opening-State Verification, Rollback and Archive

The final migration should define what happens to source-system changes during cutover. Depending on the implementation, the old source may be frozen, a final delta may be extracted or the migration may occur in controlled waves.

Production acceptance should confirm the usable opening state and retain enough evidence to diagnose or reverse the cutover if a critical migration issue is found.

Controlled freeze or delta strategy
Final opening-state reconciliation
Rollback, archive and handover evidence
Swipe through cutover and verification controls

Cutover and Delta Strategy

Control what changes are allowed between final source extraction and go-live.

  • Source freeze window where practical
  • Final delta extract where required
  • Wave or site-based cutover
  • Cutover owner, timing and decision log

Final Migration and Verification

Run the approved migration rules and validate the destination opening state.

  • Final batch and transformation version
  • Counts, balances and relationship checks
  • Operational smoke tests
  • Go-live approval or hold decision

Rollback and Recovery Evidence

Prepare a response if a critical defect is discovered during cutover.

  • Pre-cutover backup or recovery point
  • Rollback decision criteria
  • Failed batch and affected scope
  • Recovery action and final resolution history

Archive, Handover and Migration Close

Close the migration programme without losing historical evidence or ownership context.

  • Source exports and approved archive
  • Mapping and transformation documentation
  • Exception and acceptance register
  • Migration close and transition to ongoing operations
Data Migration implementation workflow

Assess, Map, Clean, Test, Cut Over and Reconcile

The sequence makes data quality, transformation rules and acceptance visible before the client depends on the migrated data operationally.

Swipe through the Data Migration workflow
01

Assess Sources

Inventory systems, exports, media, owners, counts, data quality and required historical depth.

02

Map and Transform

Define destination fields, categories, statuses, relationships, identifiers and transformation rules.

03

Clean and Resolve

Address invalid values, duplicates, missing required data and relationship exceptions.

04

Dry Run and Reconcile

Import into staging, compare expected and actual results and correct rules before production.

05

Cut Over

Run the final freeze or delta strategy, approved import and opening-state checks.

06

Verify and Close

Complete acceptance, archive migration evidence and transition ongoing changes to operations or integrations.

Data Migration is not Integrations

Migration moves and reconciles a defined body of legacy data into the opening Commerce OS state. Integrations maintain ongoing data exchange after the destination is live.

Commerce OS Data Migration is not the same proposition as Services → Implementation & Migration

The Services page describes a broader managed onboarding and migration service. This page describes the Commerce OS migration workstream and controls used when bringing client data into the software platform.

Migration responsibility and governance

Keep Source Ownership, Transformation Rules and Destination Acceptance Explicit

The implementation should identify who can authorise source extraction, who owns the meaning of the legacy data, who configures transformations and who accepts the destination opening state.

Responsibility
Client Data Owners
Commerce OS Migration Team
Source or External System
Source access, extraction authority and business meaning
Own and approve
Assess and document
Provide accessible export where supported
Field, category, status and relationship mapping
Approve business interpretation
Design and configure transformation
Define source structure
Cleansing, deduplication and exception decisions
Approve material business decisions
Execute agreed rules and maintain lineage
Provide source evidence where available
Dry-run reconciliation and acceptance criteria
Validate and sign off
Execute, report and remediate
Support source comparison where required
Cutover timing, freeze/delta and rollback decision
Approve business cutover
Execute migration and recovery plan
Support final extraction or freeze where possible
Source archive, retention, privacy and disposal obligations
Own policy and legal obligations
Implement agreed handling within scope
Subject to source/provider capabilities and terms
Swipe through the Data Migration responsibility views
01

Client Data Owners

  • Source access Authorise
  • Business meaning Confirm
  • Mapping decisions Approve
  • Final acceptance Sign off
02

Commerce OS Migration Team

  • Assessment and mapping Execute
  • Transformation and cleansing Execute
  • Dry runs and reconciliation Execute
  • Cutover and recovery Execute within scope
03

Source or External System

  • Export capability Provider-dependent
  • Source schema Define
  • Final extraction Support where available
  • Retention and access Provider-dependent
Different migration source patterns

Configure the Migration around the Source Data and Operational Risk

A spreadsheet catalogue, long-running rental platform and multi-site WMS require different extraction, transformation, reconciliation and cutover approaches.

Swipe through the Data Migration use cases
Spreadsheet-Based OperationsConsolidate files, standardise fields, resolve duplicates, create identifiers and validate opening catalogue or stock.
Legacy eCommerce WebsiteMap catalogue, variants, media, client accounts and selected transaction history while preserving useful legacy references.
Existing WMS or Inventory SystemMove sites, locations, items, quantities, opening balances and required movement history with reconciliation.
Rental Platform MigrationMap rental-ready inventory, rate rules where relevant, active commitments, historical rentals and return context.
CRM MigrationMove contacts, companies, source, ownership, pipeline context, activities and communication preferences with deduplication.
Multi-System ConsolidationResolve overlapping identifiers and entities across several systems before establishing one Commerce OS relationship.
Phased Site MigrationMove facilities or business units in waves with cutover boundaries, legacy references and reconciled opening state.
Historical Archive + Live OperationsMove only the history required for active use while preserving deeper legacy data in an approved archive.
Data Migration FAQs

Common Questions before Moving Legacy Data into Commerce OS

The final migration scope depends on source access, data quality, historical depth, identity relationships, required opening state, downtime constraints and acceptance requirements.

Request a Commerce OS Demo

Can Commerce OS migrate from spreadsheets?

Yes, where the source data can be structured and mapped. Spreadsheet migrations still require field definitions, validation, duplicate rules and reconciliation before production use.

Can data be migrated from an existing website, WMS or CRM?

Potentially. The approach depends on the source system’s export capability, schema, data quality, identifiers and the scope of data the client needs in Commerce OS.

Do we need to migrate all historical data?

No. The client can define the history required for operational continuity and reporting, while older or less useful data may remain in an approved archive if that better fits the implementation.

How are duplicate contacts or catalogue records handled?

Deduplication rules should identify probable matches and route material merge decisions through approved rules or review. Original source references should remain traceable.

Can legacy IDs be retained?

Yes, where useful. Legacy identifiers can be preserved as source references so migrated records can be traced back to the originating system or export.

What is a dry run?

A dry run executes the intended mapping and transformation rules in a controlled environment so counts, relationships, values and exceptions can be reconciled before production cutover.

How do we know the migration is complete?

The migration should use agreed acceptance criteria such as counts, opening balances, relationship checks, media completeness, sample operational testing and a documented exception register.

What happens to changes made in the old system during cutover?

The cutover plan should define a source freeze, final delta extraction or phased boundary so changes are not silently lost between the final source extract and go-live.

Is Data Migration the same as Integrations?

No. Data Migration moves a defined legacy data set into the opening Commerce OS state. Integrations maintain ongoing exchange between live systems after go-live.

Is this the same as the Implementation & Migration service?

No. Services → Implementation & Migration is the broader managed service proposition. This page describes the Commerce OS migration workstream and platform controls used when moving client data into the software.

Begin with the source systems, data owners and opening state you need

Show Us What Data Must Move and What the New System Must Reconcile to

We will map source systems, fields, categories, identifiers, relationships, duplicates, historical depth, dry runs, acceptance criteria, cutover, rollback, archive and the transition to ongoing operations or integrations.