迁移指南

本指南帮助从其他电商平台迁移到 ShopFaaS。ShopFaaS 提供 CSV 导入工具与 API，支持从主流平台平滑迁移商品、客户、订单等数据。

迁移前准备

从 Shopify 迁移

1. 导出 Shopify 数据

在 Shopify 后台导出数据：

• 商品：产品 → 所有产品 → 导出，选择 CSV 格式
• 客户：客户 → 所有客户 → 导出
• 订单：订单 → 所有订单 → 导出（仅迁移近 6 个月）

2. 转换商品 CSV 格式

Shopify 商品 CSV 与 ShopFaaS 格式接近，需调整以下字段：

3. 导入 ShopFaaS

在 ShopFaaS 后台「设置 → 数据导入 → 商品」上传转换后的 CSV。

4. 迁移客户

Shopify 客户 CSV 转换：

从 WooCommerce 迁移

1. 导出 WooCommerce 数据

使用 WooCommerce 内置导出工具：

• 商品：WooCommerce → 产品 → 导出
• 客户：通过 WordPress 用户导出插件
• 订单：WooCommerce → 订单 → 导出

2. 转换商品 CSV 格式

WooCommerce 商品 CSV 需转换的字段较多：

3. 处理变体

WooCommerce 变体商品需额外处理：

• 父商品标记为 VARIABLE 类型
• 每个变体作为单独行，parent_handle 字段指向父商品
• 变体属性（颜色/尺码）映射到 options 字段

从 Magento 迁移

1. 导出 Magento 数据

Magento 数据导出较复杂，建议使用 Magento 的 REST API 导出：

# 示例：通过 API 导出商品
curl -X GET "https://your-magento.com/rest/V1/products/searchCriteria=all" \
  -H "Authorization: Bearer your-magento-token" \
  -o products.json

2. 转换数据格式

将 Magento JSON 响应转换为 ShopFaaS CSV：

// 示例转换脚本
import fs from "fs";

const magentoProducts = JSON.parse(fs.readFileSync("products.json", "utf-8"));

const shopfaasCsv = magentoProducts.items.map(p => ({
  handle: p.sku.toLowerCase().replace(/\s+/g, "-"),
  title: p.name,
  description: p.custom_attributes.find(a => a.attribute_code === "description")?.value || "",
  price: p.price,
  sku: p.sku,
  inventory: p.extension_attributes.stock_item?.qty || 0,
  status: p.status === 1 ? "ACTIVE" : "DRAFT",
}));

// 导出为 CSV
fs.writeFileSync("shopfaas-products.csv", convertToCsv(shopfaasCsv));

3. 迁移客户与订单

Magento 客户与订单数据量大时建议分批迁移，每批 500 条。

使用 API 批量迁移

对于大规模数据或需要定制化迁移逻辑的场景，使用 REST API 批量导入：

// 批量导入商品示例
import fs from "fs";
import { parse } from "csv-parse";

const records = [];
fs.createReadStream("products.csv")
  .pipe(parse({ columns: true }))
  .on("data", row => records.push(row))
  .on("end", async () => {
    // 分批处理，每批 50 条
    const batchSize = 50;
    for (let i = 0; i < records.length; i += batchSize) {
      const batch = records.slice(i, i + batchSize);

      await Promise.all(
        batch.map(product =>
          fetch("https://your-store.com/api/products", {
            method: "POST",
            headers: {
              "X-ShopFaaS-API-Key": process.env.SHOPFAAS_API_KEY!,
              "Content-Type": "application/json",
            },
            body: JSON.stringify(product),
          })
        )
      );

      console.log(`已导入 ${Math.min(i + batchSize, records.length)}/${records.length}`);
      // 避免 API 限流
      await new Promise(resolve => setTimeout(resolve, 1000));
    }
  });

迁移后检查清单

常见迁移问题

迁移支持