分类： 集成

配置PayPal

支付网关是一种电子商务应用服务提供商服务，用于为电子商务企业、在线零售商、线上到线下商家或传统实体商家授权信用卡支付。

支付网关促进支付门户（如网站、手机或交互式语音应答服务）与前端处理器或收单银行之间的信息传输。

要设置 PayPal，
探索 > 集成 > PayPal 设置

设置 PayPal

要启用 PayPal 支付服务，您需要配置 API 用户名、API 密码和签名等参数。

您还可以通过设置 Use Sandbox 来配置测试支付环境。

启用服务后，系统将创建支付网关记录，并在会计科目表中创建账户类型为银行的账户头。

同时，系统还会创建支付网关账户条目。支付网关账户是配置中心，您可以从中设置现有会计科目表中的账户头，以及默认的支付请求邮件正文模板。

启用服务并配置支付网关账户后，您的系统即可接受在线支付。

####支持的交易货币
AUD、BRL、CAD、CZK、DKK、EUR、HKD、HUF、ILS、JPY、MYR、MXN、TWD、NZD、NOK、PHP、PLN、GBP、RUB、SGD、SEK、CHF、THB、TRY、USD

##获取 PayPal 凭据

PayPal 沙盒 API 签名

  • 登录 PayPal 开发者账户，即 PayPal 开发者账户

  • 在账户选项卡中，创建一个新的企业账户。

  • 从该账户资料中，您将获取沙盒 API 凭据。

PayPal 账户 API 签名

  • 登录 PayPal 账户并进入个人资料页面

  • 从我的销售工具中进入API 访问

  • 在 API 访问页面上，选择选项 2 以生成 API 凭据

ERPNext 物流发货

版本 13 中引入

ERPNext 物流应用可帮助您比较多家服务提供商提供的运费报价、生成面单，并跟踪您的货件状态。

目前支持与以下服务提供商的集成：

  1. LetMeShip
  2. SendCloud

要使用这些功能，您需要在您的站点上安装 ERPNext 物流 应用。您可以在 GitHub、Frappe Cloud Marketplace 上获取该应用，或者联系您的托管平台。

  1. 设置

为使应用正常运行，您需要从上述平台中至少一个平台生成 API 密钥。以下是设置指南：

1.1 SendCloud

  1. 在 SendCloud 上注册。
  2. 按照以下步骤生成 公钥 和 私钥。
  3. 在搜索栏中搜索 SendCloud。
  4. 在 SendCloud DocType 的 ‘API 密钥’ 字段中添加 公钥，在 ‘API 私钥’ 字段中添加 私钥。
  5. 勾选 启用 字段。
  6. 保存。

1.2 LetMeShip

  1. 在 LetMeShip 上注册。
  2. 按照以下步骤生成 API ID 和 API 密码。
  3. 在搜索栏中搜索 LetMeShip。
  4. 将 API ID 和 API 密码 添加到 LetMeShip DocType。勾选 启用 字段。
  5. 保存。

  1. 功能

2.1 运费比较

货件提交后，如果应用已安装，将出现 获取运费报价 按钮。点击后，您将看到服务列表以及对应的服务提供商和费率。

您还可以使用 包裹服务类型 将常用服务添加到您的 首选服务 中：

  1. 假设高亮显示的服务是我们常用的服务，让我们将其添加到 首选服务 中


2. 转到 包裹服务类型 > 新建。创建一个新的 包裹服务。在我们的例子中，它是 ‘TNT’。
3. 添加一个 包裹服务类型。在我们的例子中，它是 ‘经济型’。
4. 同时将 ‘经济型’ 添加到 包裹服务类型别名 表中。
5. 添加描述（可选）。
6. 启用 在首选服务列表中显示 字段。保存。

现在，当您点击 获取运费报价 按钮时，您将始终在 首选服务 下看到之前高亮显示的服务。

2.2 创建货件

比较费率后，您可以点击相应服务行旁的 选择 按钮，继续使用任一服务。点击后，系统将在您的服务提供商平台上自动创建一个货件。

您会注意到，货件信息 部分会根据创建的货件自动更新。

您还可以使用 货件 ID 字段在您的服务提供商平台上搜索您的交易。

2.3 打印面单

要使用 打印物流面单 按钮，必须在当前记录中生成 货件 ID。

然后您可以点击它并生成您的物流面单。

您还可以通过点击 查看 > 跟踪状态 来跟踪您的货件状态。

注意：当前集成的平台可能不覆盖您所在的地区。请访问其附带的链接以了解更多信息。

Zenoti 集成

自版本 13 起引入。

Zenoti 集成可从 Zenoti 拉取采购订单和销售发票，并在 ERPNext 中据此创建对应的采购订单和销售发票。

在创建这些记录时，如果 ERPNext 中缺少对应的客户、供应商或物料，系统将自动从 Zenoti 拉取相应详细信息，并创建新的客户、供应商或物料。

如何设置？

Zenoti 集成可通过 Frappe Cloud Marketplace 上的 电商集成 获取。

应用安装

  • 如果您在 Frappe Cloud 上托管 ERPNext 站点，可以前往站点仪表板快速安装该应用。该应用可在 Frappe Cloud Marketplace 中找到。
  • 如果您的站点由 Frappe 托管，请提交支持工单以在您的站点上安装该应用。
  • 如果您自行托管 ERPNext，可以使用 Frappe bench 安装该应用。请参阅 bench 文档了解如何安装 Frappe 应用。 bench get-app ecommerce_integrations --branch main

前提条件

  1. 对于 Zenoti 中的每个中心，都应在 ERPNext 中创建相应的成本中心和仓库，这些将用于 ERPNext 中 Zenoti 设置里的“成本中心和仓库映射”表。
  2. 必须创建物料*（至少是那些有库存影响的物料）*。可以使用数据导入功能来完成。
  3. 必须使用 ERPNext 中的“库存盘点”功能创建期初库存记录。
  4. 必须根据 Zenoti 中的税务组创建物料税务模板，并配置正确的科目和税率。
  5. 创建一个用于记录礼品卡、预付卡销售及小费负债的科目，这需要在 Zenoti 设置中设置为 用于登记礼品卡和预付卡销售的负债收入科目。
  6. 在付款方式中设置适当的科目。同时添加“卡”、“自定义”和“积分”作为付款方式。
  7. 应在“公司”主数据中取消勾选“启用永续盘存”。

在 ERPNext 上设置 Zenoti 的重要细节

要访问 Zenoti 设置，请前往：搜索栏 > Zenoti 设置。

  1. 上次同步时间： 上次同步发票的日期和时间。
  2. API 密钥： 来自 Zenoti 的 API 密钥。如果您没有 API 密钥，可以前往“管理 > 设置 > API”部分轻松生成一个。
  3. 同步间隔： 每次同步之间的间隔时长（小时）。可选选项如下 （1、3、6、12、24）。
  4. 默认采购仓库： 为所有采购订单设置的仓库。通常这是 Zenoti 中的主中心，因此请填写您为主中心创建的仓库。
  5. 默认采购价格列表： ERPNext 中用于维护物料价格所必需的。您可以新建一个，或使用 ERPNext 提供的现有 标准采购 价格列表。
  6. 默认销售价格列表： ERPNext 中用于维护物料价格所必需的。您可以新建一个，或使用 ERPNext 提供的现有 标准销售 价格列表。
  7. 用于登记小费、礼品卡和预付卡销售的负债收入科目： 在此处添加您为登记小费及礼品卡和预付卡销售而创建的科目。
  8. 默认客户组： 如果在同步销售发票时创建新客户，并希望为其分配特定的客户组，请在此处添加。如果未添加任何内容，则为这些新客户设置默认的 全部客户组。
  9. 默认供应商组： 如果在同步采购订单时创建新供应商，并希望为其分配特定的供应商组，请在此处添加。如果未添加任何内容，则为这些新供应商设置默认的 全部供应商组。
  10. 成本中心和仓库映射： 在此表中，将 Zenoti 的所有中心映射到 ERPNext 中对应的成本中心和仓库。

哪些内容会同步，哪些需要手动创建

物料

物料需要在开始时从 Zenoti 手动创建到 ERPNext 中一次。之后，在同步销售/采购订单时，将按需自动创建。

物料税务模板

物料税务模板需要根据 Zenoti 上的税务组手动创建。

客户

客户和客户组将在同步销售发票时按需创建。如果 Zenoti 中没有客户组，将使用 Zenoti 设置中提到的“默认客户组”。如果 Zenoti 设置中未提及，则将使用“全部客户组”。

供应商

供应商和供应商组将在同步采购订单时按需创建。如果 Zenoti 中没有供应商组，将使用 Zenoti 设置中提到的“默认供应商组”。如果 Zenoti 设置中未提及，则将使用“全部供应商组”。

仓库

仓库需要在 ERPNext 中手动创建，并通过 Zenoti 设置中的“成本中心和仓库映射”表与 Zenoti 的中心进行映射。

成本中心

成本中心需要在 ERPNext 中手动创建，并通过 Zenoti 设置中的“成本中心和仓库映射”表与 Zenoti 的中心进行映射。

员工

员工需要在开始时从 Zenoti 手动创建到 ERPNext 中一次。之后，在同步销售/采购记录时，可以根据需求创建。对于员工字段，“出生日期”和“入职日期”是必填项。因此，当从销售/采购记录创建员工时，“入职日期”将设置为员工创建当天，“出生日期”将设置为“入职日期”前25年。这些信息之后可以修改。

采购订单

采购订单将在 Zenoti 中创建，并在当天结束时同步到 ERPNext。
如果供应商和项目是新的，将按需创建。

注意：采购订单中的采购发票需要手动创建。

借项通知单

借项通知单将根据 Zenoti 中的退货采购订单自动创建，并保持为草稿模式。

销售发票

发票将根据 Zenoti 设置中设定的时间间隔，通过 API 自动创建。
如果客户和项目是新的，将按需创建。

贷项通知单

贷项通知单将根据 Zenoti 中的退货发票自动创建，并且只包含产品，不包含服务。

礼品/预付卡销售

每张礼品/预付卡将被视为项目。
礼品/预付卡将被视为未来发票的支付方式，前提是在 Zenoti 中这些发票是通过这些卡支付的。

库存对账

在当天结束时，库存将通过库存对账进行同步。

Unicommerce 集成

Unicommerce 是许多电子商务平台的聚合器，它允许您通过多个受支持的市场销售商品，并通过名为 Uniware 的统一界面处理订单。了解更多关于 Unicommerce 的信息，请访问 https://unicommerce.com/

ERPNext 与 Unicommerce 的集成

ERPNext 使用 Uniware 的 REST API 提供与 Unicommerce 的完整双向集成。此集成通过 Frappe 团队官方支持的 Frappe 应用提供。总的来说，此集成涵盖：

  1. 与 Unicommerce 的商品目录同步（双向）
  2. 库存同步（单向，从 ERPNext 到 Unicommerce）
  3. 新销售订单同步
  4. 销售发票同步或销售发票生成（应使用任一选项）

应用安装

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

身份验证和基本设置

  1. 应用安装完成后，进入“Unicommerce 设置”页面。
  2. 点击“启用 Unicommerce”复选框。
  3. 输入您的 Unicommerce 站点、用户名和密码。
  4. 客户端 ID 默认已添加，但如果您配置了单独的客户端 ID，则需要在此处更新。如果您不确定您的客户端 ID，请联系 Unicommerce 支持团队。
  5. 点击“保存”，这将启动与 Unicommerce 的身份验证以及为集成设置自定义字段的流程。
  6. 此设置完成后，您将在“身份验证详情”部分看到访问/刷新令牌。这意味着身份验证成功，您现在可以开始进行进一步的设置。

如果身份验证失败：

  1. 请重新检查输入的信息。
  2. 您的服务器可能被防火墙阻止。请联系 Unicommerce 支持团队，将您服务器的 IP 地址加入白名单。

商品同步

此集成会检查新创建的商品，并每小时将它们上传到 Unicommerce。要启用此功能，您需要进行以下设置：

  1. 进入“Unicommerce 设置”并启用“将新商品上传到 Unicommerce”。
  2. 设置一个默认商品组。这仅在商品组缺失时作为后备选项使用。
  3. 创建新商品时，勾选“与 Unicommerce 同步”复选框，以将该商品上传到 Unicommerce。
  4. 此复选框也可以对现有商品启用。

Unicommerce SKU 代码是不可变的，因此您不应在创建后更改商品代码。

为了正确地将商品组与产品类别同步，您需要将所有商品组映射到 Unicommerce 上相应的产品类别。

要将商品组映射到产品类别：

  1. 首先在 Unicommerce 上找到产品类别代码。
  2. 在 ERPNext 上打开相关的商品组，并在那里更新 Unicommerce 产品类别代码。


商品同步字段映射如下：

ERPNext 字段 Unicommerce 字段 备注
商品代码 SKU 适用 Unicommerce SKU 限制
商品名称 商品名称
描述 描述
单件重量 重量 仅在以克为单位时设置。
保质期（天） 保质期
HSN 代码 HSN 代码
图片 图片
Unicommerce 商品长度 长度
Unicommerce 商品宽度 宽度
Unicommerce 商品高度 高度
已禁用 已启用 （映射相反的值）
EAN 条码 EAN
UPC 条码 UPC-A
商品组 产品类别

库存同步

一旦完成商品同步设置，即可启用库存同步。该集成会检查 ERPNext 库存中的变更，并按设定的时间间隔将其推送至 Unicommerce。集成将 ERPNext 库存水平视为唯一数据来源，Unicommerce 的库存水平会被 ERPNext 的库存值覆盖。

  1. 前往“Unicommerce 设置”，向下滚动至“库存同步”部分。
  2. 勾选“启用库存同步”。
  3. 配置同步频率。建议频率为 15 至 60 分钟。
  4. 在仓库映射表中，添加您在 Unicommerce 中拥有的所有设施代码，并将其与 ERPNext 仓库进行映射。
  5. 为所有要启用的设施勾选“启用”复选框。
  6. 保存设置。

注意：所有库存均推送至“DEFAULT”货架。此集成不支持 Unicommerce 货架，请确保您在 Unicommerce 上只有一个名为“DEFAULT”的货架，以保证库存同步的准确性。

注意：与其他电子商务集成一样，Unicommerce 不支持小数库存。

销售订单处理 – 工作流程

以下是在 ERPNext 上处理订单的工作流程。您也可以选择在 Unicommerce 上处理订单，仅同步已完成的订单。

销售订单同步 – 渠道设置

Unicommerce 集成支持从多个渠道接收和处理订单。为此，销售订单同步的设置也需要分多个阶段进行。

销售订单同步的默认设置

  1. 前往“Unicommerce 设置”。
  2. 滚动至“销售订单同步”设置部分。
  3. 设置订单同步频率。建议频率为 30 至 60 分钟。
  4. 设置默认客户组和单据的命名系列。

特定渠道的销售订单同步配置

为了对每个渠道进行灵活配置，您需要为每个要启用销售订单同步的渠道创建“Unicommerce 渠道”单据。

  1. 从搜索栏或 Unicommerce 设置页面前往“Unicommerce 渠道”。
  2. 点击“添加 Unicommerce 渠道”。
  3. 填写所需详细信息，如渠道 ID、默认仓库、公司、科目和命名系列。
  4. 如果该渠道的配送由市场平台处理，请勾选“配送由市场平台处理”，否则取消勾选。
  5. 完全配置渠道后，点击“启用”复选框。

在 Unicommerce 中创建的新销售订单现在将开始与 ERPNext 同步。在此过程中，如果遇到新商品，则会使用 Unicommerce 中的信息在 ERPNext 中创建该商品。Unicommerce 订单的相关信息会映射到 ERPNext 字段，更多信息可在销售订单上的“Unicommerce 详情”部分找到。

销售发票同步

销售发票同步可通过以下两种方式之一处理。请根据您的需求选择适当的选项。

如果您希望在 Unicommerce 上处理订单和发票，并仅将完全处理完毕的订单同步到 ERPNext，请在 Unicommerce 设置中启用“仅同步已完成订单”。

2. 在 ERPNext 上处理发票

如果您只想从 ERPNext 处理订单，则需要从 ERPNext 的销售订单生成发票。

要生成发票，请前往已同步的 Unicommerce 销售订单，点击“Unicommerce > 生成发票”。这将创建一张销售发票并扣减库存。

发货清单

如果您使用上述方法 #2 在 ERPNext 上处理订单，则需要创建并提交发货清单，以告知 Unicommerce 您已发货。

前提是设置以下单据类型，您可以在 Unicommerce 清单创建页面找到相关代码：

  1. 创建 Unicommerce 配送服务商
  2. 创建 Unicommerce 配送方式

创建清单的流程：

  1. 当您准备好将包裹交给配送服务商时，应创建“Unicommerce 发货清单”单据。前往搜索栏 > “Unicommerce 发货清单” > + 添加
  2. 选择渠道 ID、配送方式和配送服务商代码。
  3. 然后，您可以使用“获取包裹”按钮根据所选筛选条件获取未结订单，或使用“扫描 AWB 代码”字段扫描包裹的 AWB。保存后，两者都会自动填充其余详细信息。
  4. 确认所有详细信息正确无误后，保存并提交该单据。
  5. 提交清单后，Unicommerce 上会创建并关闭相应的清单，发货状态将标记为“已发货”。同时，Unicommerce 清单 PDF 也会被获取并附加到 ERPNext 清单单据上。

状态更新

Unicommerce 的状态会定期在 ERPNext 中更新，您可以在“Unicommerce 详情”部分查看当前状态。

订单取消

当订单在 Unicommerce 上被取消时，集成会同步此操作，并在 ERPNext 中取消相应订单。部分取消的订单也会同步，被取消的商品会从 ERPNext 销售订单中移除。全额取消和部分取消都会按小时同步，并在生成发票前立即同步。

订单退货

当在 Unicommerce 上创建退货时，集成会同步此操作，并在 ERPNext 中创建一张草稿贷项通知单。

两种退货情况均由集成处理：

  • RTO（退回发件人）
    当货件退回发件人时，货件状态会发生变化，并在ERPNext中生成一张贷项通知单（同时更新库存）。贷项通知单将全额退回。
  • CIR（客户发起退货）
    当客户退回货件时，该操作会反映在Unicommerce的销售订单部分。根据客户发起退货的性质，系统会生成全额或部分贷项通知单。

您可以通过进入“销售发票”并筛选“是否退货”为“是”来查看所有退货。退货跟踪代码也会记录在贷项通知单上。

创建退货时，退货仓库将根据Unicommerce设置中配置的退货仓库进行选择。如果未设置，则使用原始仓库。

亚马逊SP-API集成

Amazon 连接器用于从亚马逊市场拉取产品和销售订单。

如何设置 Amazon SP-API 连接器？

Amazon 连接器已从 ERPNext 中移出，现在通过 Frappe Cloud Marketplace 上的 Frappe 应用提供。

应用安装

  • 如果您在 Frappe Cloud 上托管 ERPNext 站点，可以通过进入站点仪表板快速安装该应用。该应用可在 Frappe Cloud Marketplace 中找到。
  • 如果您的站点由 Frappe 托管，请提交支持工单以在您的站点上安装该应用。
  • 如果您是自托管 ERPNext，可以使用 Frappe bench 安装该应用。有关安装 Frappe 应用的更多信息，请参阅 bench 文档。 bench get-app ecommerce_integrations --branch main

在 ERPNext 中设置凭据

一旦您在亚马逊卖家中心注册成为卖家，即可申请开发者凭据。有关更多详细信息，请点击此处。

1. 设置 SP-API 凭据

输入 IAM ARN、刷新令牌、客户端 ID、客户端密钥、AWS 访问密钥、AWS 秘密密钥和国家/地区。

2. 设置订单详细信息

设置公司、仓库、父物料组、价格列表、客户组、销售区域、客户类型和账户组。账户组用于记录亚马逊收取的佣金、税费等。

3. 设置同步配置

使用“起始日期”功能，您可以同步该日期之后创建的订单。如果您要导入大量历史数据，建议按照“起始日期”的倒序，分小块导入数据。完成所有配置后，勾选“启用”并保存设置。现在您就可以使用此集成了。

4. Amazon – ERPNext 物料映射

可以使用 ASIN 和 SellerSKU 将亚马逊物料与相应的 ERPNext 物料进行映射。例如，如果您的系统中已有通过其他集成创建的物料，您可以使用“自定义表单”功能在物料主数据中创建一个自定义字段，并将 ASIN/SellerSKU 设置为该字段的值。

在从亚马逊同步订单的过程中，系统将尝试使用在“Amazon – ERPNext 物料映射”表中配置的字段来查找物料编码。如果在映射表中未找到该物料，您可以通过勾选物料不存在时创建选项来创建新物料。

5. 同步订单

点击此按钮以同步销售订单。一旦成功，您应该会在 ERPNext 中看到您的亚马逊订单显示为销售订单。您也可以设置计划任务以自动同步订单。

> 如果您的开发者账户无权访问个人身份信息，客户名称将存储为 BuyerName + 或市场邮箱 ID 的组合。
>
>

注意

该连接器不会处理订单取消。如果您在亚马逊上取消了任何订单，则必须在 ERPNext 中手动取消相应的销售订单及其他单据。

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. 地址

Unicommerce 集成

Unicommerce 是许多电商平台的聚合器，它允许您通过多个受支持的市场销售商品，并通过名为 Uniware 的统一界面处理订单。了解更多关于 Unicommerce 的信息，请访问 https://unicommerce.com/

ERPNext 与 Unicommerce 的集成

ERPNext 使用 Uniware 的 REST API 提供与 Unicommerce 的完整双向集成。此集成通过 Frappe 团队官方支持的 Frappe 应用提供。此集成大致涵盖以下内容：

  1. 商品目录与 Unicommerce 同步（双向）
  2. 库存同步（单向，从 ERPNext 到 Unicommerce）
  3. 新销售订单同步
  4. 销售发票同步或销售发票生成（应使用任一选项）

应用安装

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

身份验证与基本设置

  1. 应用安装完成后，进入“Unicommerce 设置”页面。
  2. 点击“启用 Unicommerce”复选框。
  3. 输入您的 Unicommerce 站点、用户名和密码。
  4. 默认已添加客户端 ID，但如果您配置了单独的客户端 ID，则需要在此处更新。如果您不确定您的客户端 ID，请联系 Unicommerce 支持团队。
  5. 点击“保存”，这将启动与 Unicommerce 的身份验证以及为集成设置自定义字段的流程。
  6. 此设置完成后，您将在“身份验证详情”部分看到访问/刷新令牌。这意味着身份验证成功，您现在可以开始进行进一步的设置。

如果身份验证失败：

  1. 请重新检查输入的信息。
  2. 您的服务器可能被防火墙阻止。请联系 Unicommerce 支持团队，将您服务器的 IP 加入白名单。

商品同步

此集成会每小时检查新创建的商品并将其上传到 Unicommerce。要启用此功能，您需要进行以下设置：

  1. 进入“Unicommerce 设置”并启用“将新商品上传到 Unicommerce”。
  2. 设置一个默认商品组。这仅在商品组缺失时作为后备使用。
  3. 创建新商品时，勾选“与 Unicommerce 同步”复选框，以将该商品上传到 Unicommerce。
  4. 此复选框也可以对现有商品启用。

Unicommerce SKU 代码是不可变的，因此您不应在创建后更改商品代码。

为了正确地将商品组与产品类别同步，您需要将所有商品组映射到 Unicommerce 上相应的产品类别。

要将商品组映射到产品类别：

  1. 首先在 Unicommerce 上找到产品类别代码。
  2. 在 ERPNext 上打开相关的商品组，并在那里更新 Unicommerce 产品类别代码。


商品同步字段映射如下：

ERPNext 字段 Unicommerce 字段 备注
商品代码 SKU 适用 Unicommerce SKU 限制
商品名称 商品名称
描述 描述
每单位重量 重量 仅当以克为单位设置时。
保质期（天） 保质期
HSN 代码 HSN 代码
图片 图片
Unicommerce 商品长度 长度
Unicommerce 商品宽度 宽度
Unicommerce 商品高度 高度
已禁用 已启用 （映射关系相反）
EAN 条码 EAN
UPC 条码 UPC-A
商品组 产品类别

库存同步

一旦设置了商品同步，就可以启用库存同步。集成会检查 ERPNext 库存中的变更，并按配置的时间间隔将其推送到 Unicommerce。集成将 ERPNext 库存水平视为唯一数据来源，Unicommerce 的库存水平会被 ERPNext 的库存值覆盖。

  1. 前往“Unicommerce 设置”并向下滚动到“库存同步”部分。
  2. 勾选“启用库存同步”
  3. 配置同步频率。建议频率为 15 到 60 分钟。
  4. 在仓库映射表中，添加您在 Unicommerce 中拥有的所有设施代码，并将其与 ERPNext 仓库进行映射。
  5. 为所有要启用的设施勾选“启用”复选框。
  6. 保存设置。

注意：所有库存都会推送到“DEFAULT”货架。此集成不支持 Unicommerce 货架，请确保您在 Unicommerce 中只有一个名为“DEFAULT”的货架，以确保库存同步的准确性。

注意：与其他电子商务集成一样，Unicommerce 不支持小数库存。

销售订单处理 – 工作流程

以下是在 ERPNext 上处理订单的工作流程。您也可以选择在 Unicommerce 上处理订单，仅同步已完成的订单。

销售订单同步 – 渠道设置

Unicommerce 集成支持从多个渠道接收和处理订单。为此，销售订单同步的设置也需要分多个阶段进行。

销售订单同步的默认设置

  1. 前往“Unicommerce 设置”。
  2. 滚动到“销售订单同步”设置部分。
  3. 设置订单同步频率。建议频率为 30 到 60 分钟。
  4. 设置默认客户组和单据的命名系列。

特定渠道的销售订单同步配置

为了允许对每个渠道进行灵活配置，您需要为每个要启用销售订单同步的渠道创建“Unicommerce 渠道”单据。

  1. 从搜索栏或 Unicommerce 设置页面前往“Unicommerce 渠道”。
  2. 点击“添加 Unicommerce 渠道”
  3. 填写所需详细信息，如渠道 ID、默认仓库、公司、科目和命名系列。
  4. 如果该渠道的配送由市场平台处理，则勾选“配送由市场平台处理”，否则取消勾选。
  5. 完全配置渠道后，点击“启用”复选框。

在 Unicommerce 中创建的新销售订单现在将开始与 ERPNext 同步。在此过程中，如果遇到新商品，则会使用 Unicommerce 中的信息在 ERPNext 中创建该商品。有关 Unicommerce 订单的相关信息会映射到 ERPNext 字段，其他信息可在销售订单上的“Unicommerce 详情”部分找到。

销售发票同步

销售发票同步可以通过以下两种方式之一处理。请根据您的需求选择合适的选项。

如果您希望在 Unicommerce 上处理订单和发票，并且仅在 ERPNext 中同步完全处理完毕的订单，请在 Unicommerce 设置中启用“仅同步已完成的订单”。

2. 在 ERPNext 上处理发票

如果您只想从 ERPNext 处理订单，则需要从 ERPNext 的销售订单生成发票。

要生成发票，请前往已同步的 Unicommerce 销售订单，点击“Unicommerce > 生成发票”。这将创建一张销售发票并同时扣减库存。

发货清单

如果您使用上述方法 #2 在 ERPNext 上处理订单，则需要创建并提交发货清单，以告知 Unicommerce 您已发货。

前提是设置以下单据类型，您可以在 Unicommerce 清单创建页面找到代码：

  1. 创建 Unicommerce 配送服务商
  2. 创建 Unicommerce 配送方式

创建清单的流程：

  1. 当您准备好将包裹交给配送服务商时，应创建“Unicommerce 发货清单”单据。前往搜索栏 > “Unicommerce 发货清单” > + 添加
  2. 选择渠道 ID、配送方式和配送服务商代码。
  3. 然后，您可以使用“获取包裹”按钮根据所选筛选条件获取未结订单，或使用“扫描 AWB 代码”字段扫描包裹的 AWB。保存后，两者都会自动填充其余详细信息。
  4. 确认所有详细信息无误后，保存并提交该单据。
  5. 提交清单后，将在 Unicommerce 上创建并关闭相同的清单，并且发货状态将标记为“已发货”。同时也会获取 Unicommerce 清单 PDF，并将其附加到 ERPNext 清单单据上。

状态更新

Unicommerce 的状态会定期在 ERPNext 中更新，您可以在“Unicommerce 详情”部分查看当前状态。

订单取消

当订单在 Unicommerce 上被取消时，集成会同步此操作，并在 ERPNext 中取消该订单。部分取消的订单也会同步，被取消的商品会从 ERPNext 销售订单中移除。完整取消和部分取消都会每小时同步一次，并且在生成发票之前也会同步。

订单退货

当在 Unicommerce 上创建退货时，集成会同步此操作，并在 ERPNext 中创建一张草稿贷项通知单。

两种退货情况均由集成处理：

  • RTO（退回发件人）
    当货件退回发件人时，货件状态会更新，并在ERPNext中自动生成一张贷记凭证（同时更新库存）。该贷记凭证为全额退货。
  • CIR（客户发起退货）
    当客户退回货件时，该操作会反映在Unicommerce的销售订单部分。根据客户发起退货的性质，系统会生成全额或部分贷记凭证。

您可以通过进入“销售发票”并筛选“是否退货”为“是”来查看所有退货记录。退货跟踪编码也会记录在贷记凭证上。

创建退货时，退货仓库将根据Unicommerce设置中配置的退货仓库进行选择。如果未设置，则使用原仓库。

亚马逊SP-API集成

Amazon 连接器用于从亚马逊市场拉取产品和销售订单。

如何设置 Amazon SP-API 连接器？

Amazon 连接器已从 ERPNext 中移出，现在作为 Frappe 应用在 Frappe Cloud Marketplace 上提供。

应用安装

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

在 ERPNext 中设置凭据

一旦您在亚马逊卖家中心注册成为卖家，即可申请开发者凭据。有关更多详细信息，请点击此处。

1. 设置 SP-API 凭据

输入 IAM ARN、刷新令牌、客户端 ID、客户端密钥、AWS 访问密钥、AWS 秘密密钥和国家/地区。

2. 设置订单详情

设置公司、仓库、父物料组、价格列表、客户组、地区、客户类型和科目组。科目组用于记录亚马逊收取的佣金、税费等。

3. 设置同步配置

使用“起始日期”字段，您可以同步该日期之后创建的订单。如果您要导入大量历史数据，建议按照“起始日期”的倒序，分小批次导入数据。设置完所有配置后，点击“启用”并保存设置。现在您就可以使用此集成了。

4. Amazon – ERPNext 物料映射

可以使用 ASIN 和 SellerSKU 将亚马逊物料与相应的 ERPNext 物料进行映射。例如，如果您系统中已有通过其他集成创建的物料，您可以使用“自定义表单”功能在物料主数据中建立一个自定义字段，并将 ASIN/SellerSKU 设置为该字段的值。

在从亚马逊同步订单的过程中，系统将尝试使用在“Amazon – ERPNext 物料映射”表中配置的字段来查找物料编码。如果在映射表中未找到该物料，您可以通过勾选物料不存在时创建选项来创建新物料。

5. 同步订单

点击此按钮以同步销售订单。一旦成功，您应该会在 ERPNext 中看到您的亚马逊订单显示为销售订单。您也可以设置计划任务来自动同步订单。

> 如果您的开发者账户无权访问个人身份信息，客户名称将存储为 BuyerName + 或市场邮箱 ID 的组合。
>
>

注意

该连接器不处理订单取消。如果您在亚马逊上取消了任何订单，则需要在 ERPNext 中手动取消相应的销售订单及其他单据。

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. 地址

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 上的订单状态将添加到相应文档中。用户需根据此信息自行取消并准备相应的文档。