Shopify 集成

Shopify 连接器从 Shopify 拉取订单,并在 ERPNext 中针对这些订单创建销售订单。

在创建销售订单时,如果 ERPNext 中缺少客户或物料,系统将通过从 Shopify 拉取相应详情来创建新的客户/物料。

如何设置连接器?

Shopify 连接器已从 ERPNext 中移出,现在可通过 Frappe Cloud 市场上的 Frappe 应用获取。

旧版 Shopify 连接器用户须知

如果您尚未在 ERPNext 站点上设置 Shopify 连接器,可以直接进入下一步。

如果您正在使用 ERPNext 中提供的旧版 Shopify 集成,则需要在继续之前禁用该连接器。安装应用后,它会将现有数据(例如物料的唯一 product_id)迁移到单独的文档类型。完成新集成配置后,您可以通过进入“电子商务集成日志”文档类型来确认迁移状态。

应用安装

  • 如果您在 Frappe Cloud 上托管 ERPNext 站点,可以通过进入站点仪表板快速安装该应用。该应用在 Frappe Cloud 市场中可用。
  • 如果您的站点由 Frappe 托管,请提交支持工单以在您的站点上安装该应用。
  • 如果您自行托管 ERPNext,可以使用 Frappe bench 安装该应用。有关安装 Frappe 应用的详细信息,请参考 bench 文档。 bench get-app ecommerce_integrations --branch main

在 Shopify 中创建自定义应用

  1. 点击菜单栏中的“应用”

  2. 点击为您的商店开发应用以创建自定义应用

  3. 创建新应用

  4. 填写详细信息并创建应用。每个应用都有自己的 API 密钥、密码和共享密钥

  5. 为应用授予以下权限。

  • 草稿订单 – 读取和写入
  • 订单 – 读取和写入
  • 位置 – 读取
  • 客户 – 读取
  • 分配的履行订单 – 读取和写入
  • 产品 – 读取和写入
  • 产品列表 – 读取和写入
  • 库存 – 读取和写入

您的最终管理员权限范围应如下所示:

  1. 在您的站点上安装该应用

在 ERPNext 中设置 Shopify:-

在 Shopify 上创建私有应用后,在 ERPNext 的 Shopify 设置中设置应用凭据和其他详细信息。

要访问 Shopify 设置,请转到:
超级搜索栏 > Shopify 设置

  1. 从 Shopify 的私有应用中填写 Shopify 站点 URL、访问令牌和 API 密钥。

  2. 设置客户、公司和库存配置。

  1. 设置同步配置。
    系统从 Shopify 拉取订单并在 ERPNext 中创建销售订单。您可以配置 ERPNext 系统以捕获针对订单的付款和履行信息。

  2. 设置税务映射器。
    为您在 Shopify 中应用的每种税费和运费准备税费和运费映射器。您可以从 Shopify 管理页面找到您的税费名称。

设置完所有配置后,启用 Shopify 同步并保存设置。这将向 Shopify 注册 API,系统将开始 Shopify 和 ERPNext 之间的订单同步。

同步来自 Shopify 的旧订单

完成 Shopify 配置并启用 Shopify 同步后,您还可以将 Shopify 中的旧订单同步到 ERPNext。此同步将在后台进行,根据您的订单数量可能需要几个小时。

  1. 启用“同步旧 Shopify 订单”
  2. 输入需要同步订单的起始和结束日期

库存同步

您可以更新从 Shopify 同步的物料在 Shopify 中的库存。库存同步通过计划任务每小时执行一次。自上次同步以来发生变化的物料库存水平将被推送到 Shopify。ERPNext 仓库的库存水平与 Shopify 位置一一对应。

  1. 要启用库存同步,请点击复选框,这将显示一个表格,用于将 ERPNext 仓库与 Shopify 位置进行映射。
  2. 选择同步频率。建议频率为 30 到 60 分钟。
  3. 点击“获取 Shopify 位置”按钮,在表格中填充 Shopify 位置。
  4. 将每个位置与 ERPNext 仓库关联。
  5. 保存设置。

注意:此连接器假定 ERPNext 是库存水平信息的主要来源,对 Shopify 库存水平所做的任何更改,如果 ERPNext 库存水平发生变化,都将被 ERPNext 覆盖。

注意:Shopify 不支持小数数量。如果在 ERPNext 中发现小数数量,Shopify 上的库存水平将通过向下取整设置为最接近的整数。

物料同步

您可以通过勾选“将新的 ERPNext 物料上传到 Shopify”来启用将新的 ERPNext 物料同步到 Shopify。

您也可以在更新 ERPNext 物料时同步更新 Shopify 物料。

以下字段将被上传/更新:

ERPNext 字段 Shopify 字段
物料名称 标题
物料编码 SKU
描述正文 描述
物料组 产品类型
单位重量 重量
重量单位 重量单位

默认情况下,所有物料在 Shopify 上均标记为“草稿”,且不会在任何商店中发布。

提供此功能的目的是为了与 Shopify 同步物料。无法实现所有字段的一一对应。通过此方法在 Shopify 上创建物料后,该物料将与 ERPNext 关联,从而避免重复。您之后可以在 Shopify 上修改物料以添加更多详细信息。

注意:此功能不支持数据导入,也不适用于变体/模板物料。

订单取消

此连接器按以下方式处理各种取消场景:

  1. 如果 Shopify 上的订单被取消,且该订单没有关联的发票或交货单,则 ERPNext 销售订单将被取消。
  2. 如果 ERPNext 销售订单有关联的文档,则 Shopify 上的订单状态将添加到相应文档中。用户需根据此信息自行取消并准备相应的文档。