Sellissimo Read the quickstart
Documentation/Build and integrate

Import Cargo history

Preview a file-backed Cargo history import, resolve mappings, and then apply the reviewed batch.

Prepare the destination#

Back up the commerce database. Import the current catalog first, copy purchased files to the private disk, and create destination accounts. Copy source files into a directory containing orders/, discounts/, or both. Database-backed Cargo history must first be exported to that format.

Create a map for source IDs that differ from their destination. Link former product or variant references to their new SKUs. For example:

{
  "customers": {"previous-account-id": "destination-account-id"},
  "products": {"previous-entry-id|large": {"sku": "SHIRT-L"}},
  "discount_products": {"previous-entry-id": "destination-entry-id"}
}

Preview, apply, and reconcile#

php please sellissimo:import-history /path/to/content/cargo --site=default --map=/path/to/map.json

The preview validates and rolls back. Resolve missing customers, unknown product references, conflicting numbers, and unsupported discounts. Compare historical currencies, refund totals, and private download paths with the source.

Run the same command with --apply when satisfied. An unchanged repeat skips already imported records. Inspect an imported order, its customer, a discount, and a purchased download with its historical count. The importer preserves guest status and historical amounts, leaves stock alone, and suppresses historical receipt emails. Resolve historical pending payments in their original payment system.

All documentation