WooCommerce 集成

自版本 15 起已弃用

使用 WooCommerce 集成后,系统会通过 WooCommerce webhook 为在 WooCommerce 上创建的订单在 ERPNext 中生成销售订单。

从 WooCommerce 创建销售订单时,如果 ERPNext 中缺少客户或物料,系统将使用 WooCommerce 订单数据中的相应详细信息来创建新的客户/物料。系统还会使用订单数据中的配送信息创建关联到该客户的地址。

  1. 如何设置 WooCommerce?

1.1 生成 API 密钥和 API 机密

  1. 在您的 WooCommerce 网站侧边栏中,点击“设置”。
  2. 点击“高级”选项卡,然后点击 REST API 链接。


3. 点击“添加密钥”按钮。提供必要的详细信息,然后点击“生成 API 密钥”按钮。

1.2 WooCommerce 设置

  1. 在您的 ERPNext 站点上,前往:首页 > 集成 > 设置 > WooCommerce 设置
  2. 将上一步生成的 API 密钥和机密分别粘贴到“API 消费者密钥”和“API 消费者机密”字段中。
  3. 在“WooCommerce 服务器 URL”中粘贴您的 WooCommerce 网站的 URL。
  4. 确保已勾选“启用同步”。
  5. 在“账户详情”部分选择“税金科目”和“运费及转运科目”。
  6. 在“默认值”部分选择“创建用户”。该用户将用于创建客户、物料和销售订单。请确保该用户具有相关权限。
  7. 选择将用于创建销售订单的“公司”。
  8. 点击保存。
  9. 保存 WooCommerce 设置后,“机密”和“端点”将自动生成。

1.3 WooCommerce Webhook 设置

  1. 现在,从您的 WooCommerce 网站侧边栏,前往“设置”。
  2. 点击“高级”选项卡,然后点击 Webhooks 链接,接着点击“添加 Webhook”按钮。
  3. 为 webhook 指定一个您选择的名称。
  4. 点击“状态”下拉菜单,选择“启用”。
  5. 选择主题为“订单已创建”。
  6. 从您的 ERPNext 站点的“WooCommerce 设置”文档类型中复制“端点”,并将其粘贴到“投递 URL”字段中。
  7. 从您的 ERPNext 站点的“WooCommerce 设置”文档类型中复制“机密”,并将其粘贴到“机密”字段中。
  8. 保持 API 版本不变,然后点击“保存 Webhook”。现在,它已成功设置。

以下 GIF 展示了整个过程:

注意: 在上述截图和 GIF 中,您需要将您在 ERPNext 实例中保存“WooCommerce 设置”后于“端点”字段中获取的 URL,粘贴到 WooCommerce 网站上的投递 URL 位置。此处粘贴了其他 URL,是因为当时使用的是 localhost。

1.4 WooCommerce 订单创建与同步

  1. 在您的 WooCommerce 网站上,在“账户”页面注册成为用户。
  2. 然后点击“地址”选项并提供所需详细信息。
  3. 点击“商店”选项,即可看到可用的产品。
  4. 将所需产品添加到购物车,然后点击查看购物车
  5. 在购物车中添加完所需产品后,您可以点击“前往结账”。
  6. 现在可以看到所有账单详细信息和订单详细信息。确认无误后,点击提交订单按钮。
  7. 可以看到“订单已收到”消息,表示订单已成功提交。
  8. 现在,在您的 ERPNext 实例中,检查以下文档类型:客户、地址、物料、销售订单。它们将从 webhook 数据中获取并创建。
  9. 如果订单未同步,您可以在首页 > 设置 > 核心 > 错误日志中查看错误。

  1. 功能

2.1 默认值

在 WooCommerce 设置文档类型中:

  • 仓库:此仓库将用于创建销售订单。默认仓库为“商店”。
  • 交货天数(天):这是销售订单中交货日期的默认偏移量(天)。默认偏移量为订单下达日期后的 7 天。
  • 销售订单系列:您可以为通过 WooCommerce 创建的销售订单设置单独的系列。默认系列为“SO-WOO-”。
  • 计量单位:这是用于物料和销售订单的默认计量单位。默认计量单位为“个”。

  1. 相关主题

  1. 销售订单
  2. 物料
  3. 客户
  4. 地址

WooCommerce 集成

自版本 15 起已弃用

使用 WooCommerce 集成功能,系统会通过 WooCommerce 的 webhook 为在 WooCommerce 上创建的订单在 ERPNext 中生成销售订单。

从 WooCommerce 创建销售订单时,如果 ERPNext 中缺少对应的客户或物料,系统将使用 WooCommerce 订单数据中的相应详细信息自动创建新的客户/物料。同时,系统还会根据订单数据中的配送信息,创建与该客户关联的地址。

  1. 如何设置 WooCommerce?

1.1 生成 API 密钥和 API 密码

  1. 在您的 WooCommerce 网站侧边栏中,点击“设置”。
  2. 点击“高级”选项卡,然后点击“REST API”链接。


3. 点击“添加密钥”按钮。提供必要的信息,然后点击“生成 API 密钥”按钮。

1.2 WooCommerce 设置

  1. 在您的 ERPNext 站点上,前往:首页 > 集成 > 设置 > WooCommerce 设置
  2. 将上一步生成的 API 密钥和密码粘贴到“API 消费者密钥”和“API 消费者密码”字段中。
  3. 在“WooCommerce 服务器 URL”中粘贴您的 WooCommerce 网站地址。
  4. 确保已勾选“启用同步”。
  5. 在“账户详情”部分选择“税金科目”和“运费及转运科目”。
  6. 在“默认值”部分选择“创建用户”。该用户将用于创建客户、物料和销售订单。请确保该用户拥有相关权限。
  7. 选择将用于创建销售订单的“公司”。
  8. 点击“保存”。
  9. 保存 WooCommerce 设置后,“密码”和“端点”将自动生成。

1.3 WooCommerce Webhook 设置

  1. 现在,从您的 WooCommerce 网站侧边栏,前往“设置”。
  2. 点击“高级”选项卡,然后点击“Webhooks”链接,接着点击“添加 Webhook”按钮。
  3. 为这个 webhook 起一个您喜欢的名称。
  4. 点击“状态”下拉菜单,选择“启用”。
  5. 选择主题为“订单已创建”。
  6. 从您的 ERPNext 站点的“WooCommerce 设置”文档类型中复制“端点”,并粘贴到“投递 URL”字段中。
  7. 从您的 ERPNext 站点的“WooCommerce 设置”文档类型中复制“密码”,并粘贴到“密码”字段中。
  8. 保持 API 版本不变,然后点击“保存 Webhook”。至此,设置成功完成。

以下是一个展示整个过程的 GIF 动图:

注意: 在上述截图和 GIF 中,您需要将您在 ERPNext 实例中保存“WooCommerce 设置”后,在“端点”字段中获得的 URL 粘贴到 WooCommerce 网站的投递 URL 位置。此处粘贴了其他 URL,是因为当时使用的是 localhost。

1.4 WooCommerce 订单创建与同步

  1. 在您的 WooCommerce 网站上,在“账户”页面注册成为用户。
  2. 然后点击“地址”选项,并提供所需详细信息。
  3. 点击“商店”选项,即可看到可用的产品。
  4. 将所需产品添加到购物车,然后点击查看购物车
  5. 在购物车中添加完所需产品后,您可以点击“前往结账”。
  6. 现在可以看到所有账单详情和订单详情。确认无误后,点击提交订单按钮。
  7. 可以看到“订单已收到”的消息,表示订单已成功提交。
  8. 现在,在您的 ERPNext 实例中,检查以下文档类型:客户、地址、物料、销售订单。它们将根据 webhook 数据被获取并创建。
  9. 如果订单未同步,您可以在首页 > 设置 > 核心 > 错误日志中查看错误信息。

  1. 功能特性

2.1 默认值

在 WooCommerce 设置文档类型中:

  • 仓库:此仓库将用于创建销售订单。默认仓库为“商店”。
  • 交货天数(天):这是销售订单中交货日期的默认偏移天数。默认偏移量为订单下达日期后的 7 天。
  • 销售订单系列:您可以为通过 WooCommerce 创建的销售订单设置单独的系列。默认系列为“SO-WOO-”。
  • 计量单位:这是用于物料和销售订单的默认计量单位。默认计量单位为“个”。

  1. 相关主题

  1. 销售订单
  2. 物料
  3. 客户
  4. 地址