dropshipping-integration

一件代发集成

概述

一件代发集成会将客户订单自动路由至供应商仓库，将供应商库存同步到你的店铺，并追踪每笔销售的利润。做好后，客户可以按时收到商品，而你无需接触任何实体库存。做得不好，超卖和履约失败会损害你的声誉。

本技能将介绍如何使用合适的工具在你的平台上设置一件代发，随后还会介绍为从头构建的用户提供的自定义／无头实现方案。

何时使用此技能

• 在没有实体库存的情况下开设店铺，将订单直接路由至供应商仓库时
• 在自有库存之外，添加由一件代发履约的商品类别时
• 构建多供应商路由引擎，根据价格、库存或位置为每笔订单选择最佳供应商时
• 需要让店铺库存与供应商可用库存数据源（CSV、EDI、API）保持同步时
• 追踪一件代发利润，以用于会计核算和供应商绩效报告时

核心说明

第 1 步：确定你的平台并选择合适的集成方式

平台	推荐工具	原因
Shopify	DSers（免费）、AutoDS 或 Spocket	DSers 是 AliExpress 的官方合作伙伴；AutoDS 和 Spocket 可对接优质／美国供应商，并自动路由订单
WooCommerce	AliDropship 插件、DropshipMe，或 WooCommerce + 自定义 webhook	AliDropship 可自动处理 AliExpress 订单；对接其他供应商时，使用 WooCommerce webhook 将订单推送至供应商 API
BigCommerce	Modalyst、Spocket，或 BigCommerce + 自定义集成	Modalyst 和 Spocket 提供原生 BigCommerce 应用，可同步库存
自定义／无头	使用供应商 API 或 CSV／EDI 数据源构建供应商集成层	可完全控制路由逻辑、利润追踪和供应商选择

第 2 步：设置库存同步

让店铺库存水平与供应商可用库存保持同步是最关键的一环——超卖会立即损害客户信任。

Shopify

使用 DSers（AliExpress 一件代发）：

1. 从 Shopify App Store 安装 DSers
2. 在 DSers 设置中连接你的 AliExpress 账号
3. 通过 DSers → Products → Import 从 AliExpress 导入商品
4. DSers 每隔几小时自动同步一次库存水平
5. 在 DSers → Settings → Supplier 中启用“Auto-update inventory”，将供应商库存推送到 Shopify 库存

使用 Spocket（美国／欧盟供应商）：

1. 从 Shopify App Store 安装 Spocket
2. 浏览 Spocket 市场并将商品导入 Shopify
3. Spocket 会自动同步库存变更，无需手动配置
4. 在 Spocket 设置中启用“Auto-fulfill orders”，自动将新的 Shopify 订单路由给供应商

使用 AutoDS（多供应商）：

1. 从 Shopify App Store 安装 AutoDS
2. 添加供应商（AliExpress、Amazon、Walmart 等）并导入其商品
3. AutoDS 会监控供应商价格和库存，并自动更新你的 Shopify 商品列表
4. 在 AutoDS → Settings → Price Rules 中配置价格规则，自动设置加价

WooCommerce

使用 AliDropship 插件：

1. 购买并安装 AliDropship 插件
2. 使用 Chrome 扩展程序直接从 AliExpress 将商品导入 WooCommerce
3. 在 AliDropship → Settings → Auto-update 中启用自动更新价格和库存
4. 订单路由：你在插件控制面板中批准订单后，AliDropship 会自动在 AliExpress 上下单

对于非 AliExpress 供应商：

1. 安装 WooCommerce Zapier 扩展程序，或使用 n8n（免费、可自托管）将 WooCommerce 订单 Webhook 连接到供应商系统
2. 前往 WooCommerce → Settings → Advanced → Webhooks，为“Order created”事件创建 Webhook
3. 将 Webhook URL 指向你的自动化工作流（Zapier/n8n），由其整理订单格式并转发给供应商
4. 如需同步库存，请安排每日运行的 WP-Cron 任务，拉取供应商的 CSV 数据源，并通过 REST API 更新 WooCommerce 库存

BigCommerce

使用 Modalyst：

1. 从 BigCommerce App Marketplace 安装 Modalyst
2. 浏览 Modalyst 的供应商目录，并将商品导入 BigCommerce
3. 连接后，Modalyst 会自动处理库存同步和订单路由

使用 Spocket：

1. 从 BigCommerce App Marketplace 安装 Spocket
2. 导入商品，并在 Spocket 设置中启用自动履行
3. 含有 Spocket 商品的新订单会自动路由给供应商

自定义／无头架构

对于无头商店，请构建供应商集成层：

// Supplier product and inventory schema
interface SupplierProduct {
  supplierId: string;
  supplierSku: string;       // supplier's own SKU
  internalProductId: string; // your product ID
  costPriceCents: number;    // what you pay the supplier
  stockQty: number;
  lastSyncedAt: Date;
}

// Route an order line to the best available supplier
async function selectBestSupplier(
  productId: string,
  requiredQty: number
): Promise<SupplierProduct | null> {
  // Pick the cheapest in-stock supplier with enough quantity
  return db.supplierProducts.findOne({
    internal_product_id: productId,
    stock_qty: { gte: requiredQty },
    is_active: true,
  }, { orderBy: ['cost_price_cents', 'asc'] });
}

// Sync supplier inventory from CSV feed
async function syncSupplierInventoryFromCsv(
  supplierId: string,
  csvContent: string
): Promise<void> {
  const rows = parseCsv(csvContent); // [{sku, qty, cost}]
  for (const row of rows) {
    await db.supplierProducts.upsert({
      supplier_id: supplierId,
      supplier_sku: row.sku,
      stock_qty: parseInt(row.qty),
      cost_price_cents: Math.round(parseFloat(row.cost) * 100),
      last_synced_at: new Date(),
    });
  }
  // Zero out SKUs not in the feed (discontinued)
  const activeSKUs = new Set(rows.map(r => r.sku));
  const allProducts = await db.supplierProducts.findBySupplierId(supplierId);
  for (const sp of allProducts) {
    if (!activeSKUs.has(sp.supplier_sku)) {
      await db.supplierProducts.update(sp.id, { stock_qty: 0 });
    }
  }
}

// Submit a dropship order to a supplier API
async function submitDropshipOrder(params: {
  supplierApiEndpoint: string;
  supplierApiKey: string;
  orderReference: string;
  shippingAddress: Address;
  items: { supplierSku: string; quantity: number }[];
}): Promise<string> {
  const response = await fetch(params.supplierApiEndpoint + '/orders', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${params.supplierApiKey}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      reference: params.orderReference,
      ship_to: params.shippingAddress,
      items: params.items,
    }),
  });
  if (!response.ok) throw new Error(`Supplier API error: ${response.status}`);
  const result = await response.json();
  return result.order_id; // supplier's order reference
}

第 3 步：配置自动订单路由

Shopify

• DSers：前往 DSers → Settings → Automatic Actions，并启用“Auto-sync tracking number to Shopify”和“Auto-fulfill Shopify orders”
• AutoDS：在 AutoDS → Settings 中启用 Auto-Orders。在 Shopify 中付款的订单会自动提交给供应商，跟踪号码也会同步回 Shopify 履行记录
• 如果供应商订单失败（缺货），DSers 和 AutoDS 会通过电子邮件提醒你，以便你手动改派订单

WooCommerce

• 对于 AliDropship：在 AliDropship 控制面板中批准的订单会自动提交。前往 AliDropship → Orders 并确认待处理订单，或在设置中启用完全自动化
• 对于自定义供应商集成：使用 WooCommerce Webhook 触发向供应商提交订单，然后使用第二个 Webhook 或轮询接收跟踪号码，并通过 WooCommerce REST API 将订单标记为已履行（POST /wp-json/wc/v3/orders/{id}）

BigCommerce

• Modalyst 和 Spocket 都会自动处理订单路由。查看 BigCommerce → Orders，并检查“Fulfillment”列——路由给供应商的订单会显示供应商名称
• 对于跟踪号码：这两个应用都会自动将跟踪信息同步回 BigCommerce 订单，并触发 BigCommerce 内置的发货通知邮件

第 4 步：跟踪代发货利润率

跟踪利润率至关重要——你可能不会察觉到成本价已偏离售价。

Shopify

• 使用 Shopify Analytics → Profit 报告（需要在 Shopify 管理后台中输入成本）
• 前往 Shopify 管理后台中每个商品的变体，并填写“Cost per item”——Shopify 会自动计算利润率
• 如需跟踪多个供应商：从 DSers/AutoDS 导出订单和成本，并使用 Google Sheet 或 QuickBooks 计算每笔订单的利润率

WooCommerce

• 安装 WooCommerce Cost of Goods 插件（SkyVerge），以跟踪每件商品的成本，并在 WooCommerce 报告中自动计算利润率
• AliDropship 会在其分析控制面板中显示成本价与售价

BigCommerce

• 在 BigCommerce 管理后台 → Products → [Product] → Variants → Cost 中填写每个商品变体的成本价
• BigCommerce 内置的 Insights 报告（Plus 及更高版本提供）会显示各商品的利润率

最佳实践

• 至少每 4 小时同步一次库存——供应商的库存经常变化；对于销量较快的 SKU，如果供应商的 API 支持，建议每小时同步一次
• 保留库存缓冲——不要卖掉供应商的最后 3–5 件商品；库存可能在同步周期之间发生变化，你的“有货”数据可能已经过时
• 保存供应商的订单参考号——务必保存供应商的订单确认号，以便客服人员就特定发货事宜直接联系供应商
• 按供应商跟踪交货时间——不同供应商的履约速度不同；使用各供应商的交货时间，而不是通用预估值，来显示准确的送达预估
• 供应商发货后立即向客户发送跟踪号——大多数供应商应用都会自动同步跟踪信息；请在应用设置中启用此功能，并通过测试订单进行验证
• 每月核对供应商发票——将实际收费与下单时记录的金额进行比较；价格差异累积起来可能造成重大损失

常见问题

问题	解决方案
客户下单后，商品在下一次同步前已在供应商处售罄	经常同步并设置库存缓冲阈值；在 DSers/AutoDS 中启用缺货事件的电子邮件提醒
供应商发错商品	大多数供应商应用不会核验实际发出的商品——直接联系供应商，并准备好其订单参考号
应用重试时，代发货订单被重复提交	DSers 和 AutoDS 会在内部使用幂等机制；对于自定义集成，请在重新提交前检查是否已有供应商订单参考号
利润计算未计入运费	如果你提供“免费配送”，但需要向供应商支付运费，请从利润计算中扣除这笔费用——这是真实成本
跟踪号未同步回平台	检查应用的跟踪同步设置；对于 WooCommerce Webhook，请在 WooCommerce → 设置 → 高级 → Webhooks 中检查 Webhook 投递日志

相关技能

• @order-fulfillment-workflow
• @vendor-management
• @shipment-tracking
• @multi-channel-selling
• @order-management-system