SHOPLINE 与 Cin7 Omni 串接指南 – SHOPLINE 常见问题

SHOPLINE Cin7 Omni 应用可以将 SHOPLINE 店铺与您的 ERP 系统 Cin7 Omni 连接起来，自动同步商品、订单、库存、客户和物流信息。通过这个应用，您可以打通 SHOPLINE 店铺运营和库存/仓库系统，减少人工操作，提高订单发货效率，并降低库存错误和超卖的风险。

本文将指导您如何安装应用、完成基础配置，并说明数据同步的范围和规则，连接 SHOPLINE 店铺和 Cin7 Omni。

连接 SHOPLINE 和 Cin7 Omni

要将 Cin7 Omni 与 SHOPLINE 连接，请按照以下步骤操作：

前往 SHOPLINE 应用商店，搜索并安装 Cin7 Omni 应用到您的店铺。授权完成后，应用即可访问您的店铺数据。
输入您的 Cin7 Omni 用户名和密码，然后点击保存，确认数据已成功连接。
根据需要开启或关闭以下数据同步模块：
- 客户同步
- 商品同步
- 库存同步
- 订单同步
- 物流同步
建议开启邮件通知功能，当同步失败时，系统会每 30 分钟向指定收件人发送错误详情通知。

数据同步范围和说明

Cin7 Omni 应用支持「首次全量同步」和「后续增量同步」。不同数据类型的同步规则如下：

	同步方向	同步范围	同步时间
客户数据	SHOPLINE → Cin7 Omni	客户姓名邮箱电话客户更新信息	客户新增或更新后实时同步
商品数据	Cin7 Omni → SHOPLINE	商品名称 SKU / 变体商品价格商品图片商品规格（Option）商品尺寸（长宽高 / 体积）	首次启用时：进行全量同步后续：商品新增/更新后同步每小时进行增量更新 Cin7 Omni 新增至 SHOPLINE 商品默认不上架一个 Cin7 Omni 商品可以同时映射到多个 SHOPLINE 商品，并共用同一份库存，具体说明见下方「商品映射」章节
订单数据	SHOPLINE → Cin7 Omni	订单详情收件人信息商品 SKU / 变体价格 / 折扣运费和订单总金额	付款成功后实时同步仅同步「已付款（Paid）」订单
库存数据	Cin7 Omni → SHOPLINE	SKU 库存数量各仓库（Branch）库存可售库存（已扣除安全库存）	每 10 分钟自动同步一次库存以 Cin7 Omni 为准支持安全库存机制（避免超卖）如果未配置商品或仓库映射，将暂停同步并提示错误目前不支持同步负库存数据（例如 Cin7 Omni 商品库存数量为 -10 时，同步至 SHOPLINE 会提示错误）
物流数据	Cin7 Omni → SHOPLINE	发货状态（Dispatched）物流公司名称物流追踪单号（Tracking Number）	Cin7 Omni 标记发货后实时回写 SHOPLINE

备注：

建议在正式开启同步前，先完成「商品 + 仓库映射」的初始化。如果商品 SKU 或映射未完成，订单将无法成功同步。
同步失败的数据不会丢失，会进入重试或挂起队列。

管理数据映射和同步

商品映射

商品映射页面可以查看 Cin7 Omni 的商品名称和 ID，以及它们映射到 SHOPLINE 的商品名称和 ID、该商品的库存信息。您也可以点击「未映射」分页，手动映射 SHOPLINE 商品。

将一个 Cin7 Omni 商品映射到多个 SHOPLINE 商品

如果您在 SHOPLINE 复制了同一件商品用于不同用途（例如不同的营销活动或落地页），可以将这些复制出来的商品全部映射到同一个 Cin7 Omni 商品，并共用该商品的库存，不需要在 Cin7 Omni 分别维护多份库存数据。

举例说明：您在 Cin7 Omni 有一个商品 A，库存为 90 件。您在 SHOPLINE 将该商品复制成了三个商品：B（原始商品）、B1、B2，分别用于不同的营销页面。您可以将 A 同时映射到 B、B1、B2 这三个商品，它们会共用 Cin7 Omni 商品 A 的 90 件库存，系统按商品数量平均分配库存（本例中每个商品约 30 件；如有余数，会优先分配给排序在前的商品）。

备注： 一个 SHOPLINE 商品的规格（SKU）最多只能映射一个 Cin7 Omni 商品的规格，但一个 Cin7 Omni 规格可以同时被多个 SHOPLINE 规格映射。

设置主更新商品

当一个 Cin7 Omni 商品映射了多个 SHOPLINE 商品时，您需要从中指定一个作为【主更新商品】：

主更新商品：当 Cin7 Omni 商品的标题、描述、图片、价格等信息更新时，只有主更新商品的信息会同步更新。
其他映射商品：只同步库存，不会自动更新标题、描述、图片等商品信息。

延续上面的例子：如果您将 B 设置为主更新商品，那么当 Cin7 Omni 商品 A 的信息发生变化时，只有 B 的商品信息会更新，B1 和 B2 会保持原样，但三者仍会继续共用库存。

设置方式：

在【商品映射】列表中，找到该 Cin7 Omni 商品所在的行
点击【设置主更新商品】
从已建立 SKU 映射的商品中选择一个作为主更新商品，或选择【不设置主更新商品】以暂停商品信息更新（此时库存仍会照常同步）

备注：

更换或移除主更新商品，不会影响已建立的 SKU 映射和库存共享。
系统不会自动指定或切换主更新商品，需要您手动设置。

解除商品映射

如果您不再需要某个 SHOPLINE 商品与 Cin7 Omni 商品保持关联，可以手动解除映射：

在【商品映射】列表中，找到需要解除的 SHOPLINE SKU 映射，点击【解除映射】图标。
在确认弹窗中核对 Cin7 SKU 与 SHOPLINE SKU 信息，点击确认。
解除映射后，该 SHOPLINE SKU 会停止共享该 Cin7 SKU 的库存（库存自动清零），但商品本身不会被删除，您可以之后重新建立映射。如果需要一次处理多个映射，也可以勾选多个 Cin7 SKU 后点击【批量移除映射】。

备注： 卸载 Cin7 Omni 应用后，系统会自动清除该店铺所有商品映射关系。重新安装应用后，需要重新建立商品映射，历史映射不会自动恢复。

重新同步失败的商品

如果商品因为信息缺失或格式错误导致同步失败，您可以在 Cin7 Omni 商品修正信息后，直接重新触发同步，无需重新创建映射：

前往【商品同步】列表，找到同步失败的商品。
点击【重新同步】。
系统会重新获取该商品在 Cin7 Omni 的最新信息并再次尝试同步。

备注： 同步中的商品会显示为置灰状态，避免重复提交。您也可以勾选多个失败的商品，点击【批量重试】一次性重新同步。

商品更新同步

除了商品首次同步，您还可以设置当 Cin7 Omni 商品信息更新后，是否自动同步到对应的 SHOPLINE 主更新商品。

前往应用首页，找到【商品更新】设置。
开启开关前，请先确认【更新字段设置】中勾选的字段是否符合您的需求，开启后系统会立即按照您的设置开始同步。
在【更新字段设置】中，选择需要自动同步的商品信息，例如商品标题、描述、图片、售价、重量等。

备注：

只有已设置【主更新商品】的商品才会被自动更新；有 SKU 映射但尚未设置主更新商品的商品，将不会自动更新商品信息。
如果您经常在 SHOPLINE 后台直接调整售价，建议关闭「商品款式的售价」这一项，避免售价被 Cin7 Omni 的数据覆盖。
关闭此设置后再重新开启，历史未同步的商品信息不会自动补齐，需要您手动前往【商品同步】列表重新同步。

库存地点映射

库位映射页面可以让您设置 Cin7 Omni 对应的 SHOPLINE 仓库。

订单同步

订单同步页面可以查看 SHOPLINE 订单同步到 Cin7 Omni 的状态。您也可以点击「SHOPLINE 订单同步失败」和「物流同步失败」页面，查看失败原因。