ShipBob 用户手册

Shoplazza 与 ShipBob 集成应用旨在帮助商户将其订单和产品信息同步至 ShipBob，实现高效的订单履行流程。本应用通过 OAuth 认证建立与 ShipBob 的连接，支持产品同步、订单同步和追踪信息更新功能，适用于新用户和已有 ShipBob 账户的用户。

一、优势说明

Shoplazza 与 ShipBob 集成应用通过产品与订单的高效同步，为商户提供以下显著优势：

1. 简化操作流程：

• 自动化订单同步：避免手动输入订单信息的错误，提高履约效率。
• 产品信息预同步：让商户在订单生成前即可完成商品的同步，减少后续调整 SKU 的麻烦。

2. 提升履约效率：

• 通过 ShipBob 强大的海外仓网络，加快订单配送时间，提升客户满意度。
• 实现物流追踪信息的实时更新，让商户和客户及时掌握发货状态。

3. 灵活控制同步范围：

• 支持虚拟产品的智能过滤：对于无需履约的商品，系统自动跳过同步。
• 通过开关控制订单和产品同步，商户可根据业务需求自由调整同步策略。

4. 适用不同类型商户：

• 新 ShipBob 用户可通过初次同步快速准备商品信息。
• 现有 ShipBob 用户可直接连接账户，开始订单履约。

二、权限说明

在应用安装过程中，我们会请求以下权限：

• 产品数据: 读取、修改产品、变体和集合信息。
• 订单数据: 读取和修改订单及履行状态。
• 其他数据: 读取商店管理员配置信息。

这些权限确保产品和订单信息能够无缝同步至 ShipBob，同时允许您管理相关的履行流程。

三、授权流程概览

以下是两种用户场景的集成流程：

1. 已有 ShipBob 账户的商户: 通过 ShipBob 账号登录并连接应用。

2. 新用户: 创建 ShipBob 账户并完成集成设置。

四、操作流程｜适用于已有 ShipBob 账户的用户

准备工作

确保您已在 ShipBob 平台注册并拥有有效账户，同时具备 Shoplazza 商店的管理权限。

操作步骤

1. 安装应用

• 点击此处  即可安装应用。
• 或者在 Shoplazza 后台应用市场  搜索 ShipBob 点击添加应用即可。

2. OAuth 授权

• 安装完成后，页面会自动跳转至 ShipBob 的 OAuth 授权页面。
• 输入您的 ShipBob 登录凭据，完成授权。
• 授权成功后，返回 Shoplazza 应用。

五、操作流程｜适用于新 ShipBob 用户

准备工作

确保您已具备 Shoplazza 商店的管理权限。

操作步骤

1. 安装安装应用：点击此处  获取应用的安装链接，安装过程中查看并确认所需权限，点击 安装App。

2. 创建 ShipBob 账户

• 安装完成后，页面会跳转至 ShipBob 注册页面  。
• 填写相关信息，创建账户并完成认证。

• 注册完成后，系统将返回至 Shoplazza 应用。

3. OAuth 授权   在安装好的ShipBob应用后台，点击去授权，点击Allow & Install 完成 OAuth 授权。

4. 初次产品同步 授权完成后，页面点击下一步。

进入到「初次产品同步」页面，点击 开始同步 按钮，系统会将 Shoplazza 产品数据同步至 ShipBob。

产品同步成功后，点击下一步进入到订单同步。

5. 初次订单同步与导入延迟设置

在完成 OAuth 授权后及初次产品同步，系统会引导您进入 初次订单同步 页面。在此页面，您可启用 自动同步（Auto Sync） 功能，并选择 订单导入延迟（Order Import Delay） 的设置，以确保订单同步和履约流程的有效性和灵活性。

订单延迟同步功能可以为商户提供一定的缓冲时间，特别适用于需要人工确认或可能会有变更的订单。通过设置延迟，商户可以避免订单过早同步到ShipBob，减少因特殊要求或库存调整导致的发货错误，确保履约更精准。

• 启用自动同步:
  • 商户需要手动开启 自动同步 开关。
  • 开启后，Shoplazza 的订单数据将自动同步至 ShipBob，支持近实时的履约。
• 设置订单导入延迟:
  • 商户可以在 订单导入延迟”下拉菜单中选择延迟时间。
  • 可选延迟选项包括：
    • 30 分钟
    • 3 小时
    • 6 小时
  • 此设置将在订单创建时间的基础上添加延迟，以推迟订单同步至 ShipBob 的时间。
• 授权及同步完成：

六、产品&订单同步逻辑

1. 产品同步逻辑

初次产品同步:

• 排除所有 “无需发货” (关闭"需要物流" ) 的商品。
• 对于 "需要物流" 属性的变更：
• • "需要物流"关闭时，该商品将从之后的同步中排除。

持续产品同步:

• 启用后，Shoplazza 中新增的商品将自动创建于 ShipBob*。

• 对于 "需要物流" 属性的变更：
  • "需要物流"关闭时，该商品将在订单中排除。

2. 订单同步逻辑

虚拟订单跳过同步:

• 如果订单中所有商品均为“无需发货”，系统将跳过该订单的同步。

混合商品订单同步:

• 如果订单中既有“需要发货”的商品又有“不需要发货”的商品，系统将整体同步该订单至 ShipBob，由 ShipBob 处理具体的履行逻辑。

3. 取消订单的处理流程

订单同步后取消：

• 场景：订单已经通过 Shoplazza 同步至 ShipBob，且 ShipBob 已创建对应的发货任务。
• 逻辑：
  • 当商户在 Shoplazza 中将订单状态更改为“取消”（Cancelled）时，系统会通过 API 通知 ShipBob，将对应的订单更新为“已取消”状态。
  • 如果 ShipBob 已经开始履约（例如，订单已经打包或发货），取消请求可能会失败，此时商户需手动联系 ShipBob 支持团队。

订单未同步取消：

• 场景：订单尚未同步至 ShipBob，但在 Shoplazza 中被取消。
• 逻辑：
  • 系统会直接跳过该订单的同步操作，无需对 ShipBob 进行任何通知。

七、常见问题

1. 产品同步失败

• 问题描述: 点击“开始同步”后提示同步失败。
• 解决方法:
  • 检查网络连接是否正常。
  • 确认 Shoplazza 商品中已填写正确的 SKU 和相关信息。
  • 重试操作，或联系技术支持。

2. 订单未同步

• 问题描述: 某些订单未能同步至 ShipBob。
• 解决方法:
  • 检查订单中的商品是否全部为“无需发货”商品。如果是，系统将跳过同步。
  • 确认订单中的商品已成功同步至 ShipBob。