作者： Next

谷歌地图集成

ERPNext 提供了与 Google 地图的集成功能，用于计算和优化配送行程的时间。

如何设置 Google 地图集成

要设置 Google 地图，以便 ERPNext 能够计算和优化配送行程的时间，请按照以下步骤操作：

  • 在 Google 设置中启用 API 访问权限。

如何使用 Google 地图集成

计算和优化配送行程

  • 一旦 Google 地图集成成功，您可以计算配送停靠点的预计到达时间，或优化配送停靠点顺序。

设置 Dropbox 备份

我们始终建议客户在 ERPNext 中维护数据备份。数据库备份以 SQL 文件的形式下载。如果需要，此备份的 SQL 文件也可以恢复到另一个 ERPNext 账户中。

您可以自动将 ERPNext 账户的数据库备份下载到您的 Dropbox 账户中。

> 注意：如果您是 Frappe Cloud 用户，系统会自动为您创建本地和异地备份： > >

要设置 Dropbox 备份，请前往：> 首页 > 集成 > Dropbox 设置

第 1 步：登录 Dropbox 开发者区域

第 2 步：创建一个新的 Dropbox 应用

第 3 步：填写新应用的详细信息

第 4 步：插入您的自定义域名重定向 URI

https://{yourwebsite.com}/api/method/frappe.integrations.doctype.dropbox_settings.dropbox_settings.dropbox_auth_finish

第 5 步：在新窗口中，打开您的 ERPNext 安装中的 Dropbox 设置页面

第 6 步：设置备份频率和电子邮件

设置将站点备份下载到您的 Dropbox 账户的频率。

第 7 步：从您的 Dropbox 应用窗口输入密钥

从您的 Dropbox 应用页面，将应用密钥和（取消隐藏的）应用机密输入到 ERPNext Dropbox 设置页面中。

或者，您也可以手动将其输入到 sites/{sitename}/site_config.json 中，如下所示：

       {
 "db_name": "demo",
 "db_password": "DZ1Idd55xJ9qvkHvUH",
 "dropbox_access_key": "ACCESSKEY",
 "dropbox_secret_key": "SECRECTKEY"
}

第 8 步：在继续之前点击保存

第 9 步：保存后，点击“允许 Dropbox 访问”

Dropbox 登录页面将在新标签页中打开。这可能需要您允许为您的 ERPNext 账户弹出窗口。

第 11 步：允许 Dropbox 访问

登录成功后，您将看到如下确认消息。点击“允许”以让您的 ERPNext 账户访问您的 Dropbox 账户。

第 12 步：确认备份正常工作

从 ERPNext Dropbox 页面，点击 Take Backup Now，然后前往您的 Dropbox 文件视图。您应该会在 Dropbox 中看到一个名为 Apps 的新文件夹，其中包含您的 {新应用} 文件夹。在该文件夹内，应该有文件和数据库的备份文件夹。因此，对于一个名为 erpnext 的应用，文件夹位置如下：

Database files: /Apps/erpnext/database
Public files: /Apps/erpnext/files
Private files: /Apps/erpnext/private/files

> 注意：如果压缩后的备份大小超过 1GB（吉字节），系统将上传最新的可用备份到 Dropbox，而不是生成新的备份文件。

Google 联系人集成

ERPNext 提供了与 Google 联系人的集成功能，以便所有用户能够将其 Google 联系人同步到 ERPNext。

如何设置 Google 联系人集成

为了允许与 Google 联系人进行同步，您需要授权 ERPNext 从 Google 获取联系人数据。Google 联系人集成通过以下步骤进行设置：

  • 通过 Google 设置创建 OAuth 2.0 凭据。
  • 在 Google 联系人列表中，点击“新建”。输入您要同步的 Google 账户邮箱，然后保存。现在点击授权联系人访问，以授权 ERPNext 从 Google 获取联系人数据。

如何使用 Google 联系人集成

在 ERPNext 中创建联系人

  • 一旦 Google 联系人集成成功，如果勾选了 Push to Google Contacts，则在 ERPNext 中创建的所有联系人都会被同步。

在 ERPNext 中创建联系人：

它将会显示在 Google 联系人中：

从 Google 联系人同步联系人

  • 一旦 Google 联系人集成成功，如果勾选了 Pull from Google Contacts，则 Google 联系人中的所有联系人都会被同步。

配置fairlogin

fairlogin 是 fairkom.eu 提供的一个符合 GDPR 标准的 oAuth 提供商。

要设置 fairlogin 作为 oAuth 提供商，请前往：

首页 > 集成 > 社交登录密钥

设置 keycloak

fairlogin 基于 keycloak，因此参数可能类似于任何使用 keycloak 的自定义 oAuth 设置。

在那里添加一个新客户端，选择 open-id 作为客户端协议，并将您的 ERPnext 实例地址输入为根 URL、重定向 URL 和基础 URL。

将您的 ERNext 服务添加为客户端是 fairkom 提供的一项服务。

设置 fairlogin

要启用 fairlogin 作为 ERPNext 的登录选项，您需要配置以下参数：

  • 基础 URL https://id.fairkom.net/auth/realms/fairlogin/
  • 授权 URL https://id.fairkom.net/auth/realms/fairlogin/protocol/openid-connect/auth
  • 重定向 URL /api/method/frappe.integrations.oauth2_logins.login_via_fairlogin
  • 访问令牌 URL https://id.fairkom.net/auth/realms/fairlogin/protocol/openid-connect/token
  • API 端点 https://id.fairkom.net/auth/realms/fairlogin/protocol/openid-connect/userinfo

启用服务后，系统将允许使用任何 fairlogin 账户登录。

新用户的默认角色是“博主”（目前为硬编码）。

Google 日历集成

ERPNext 提供了与 Google 日历的集成功能，以便所有用户能够将其 Google 日历事件与 ERPNext 同步。

如何设置 Google 日历集成

为了实现与 Google 日历的同步，您需要授权 ERPNext 从 Google 获取日历事件数据。Google 日历集成通过以下步骤设置：

  • 通过 Google 设置创建 OAuth 2.0 凭据。
  • 在 Google 日历列表中，点击“新建”。输入日历名称以及您要同步的用户，然后保存。
  • 根据您要同步的数据，可以选择以下选项：
  • 从 Google 日历拉取 – 将 Google 日历中的所有事件同步到 ERPNext。
  • 推送到 Google 日历 – 将 ERPNext 中的所有事件同步到 Google 日历。
  • 现在点击授权日历访问，以授权 ERPNext 从 Google 获取日历事件数据。
  • 授权后，您可以手动同步 Google 日历事件，或让 ERPNext 每天自动同步 Google 联系人。

如何使用 Google 日历集成

在 ERPNext 中创建事件

  • 一旦 Google 日历集成成功，如果勾选了 Push to Google Calendar，则在 ERPNext 中创建的所有事件都将被同步。
  • 在 ERPNext 中创建事件
  • 在 ERPNext 中删除事件

从 Google 日历同步事件

  • 一旦 Google 日历集成成功，如果勾选了 Pull from Google Calendar，则 Google 日历中的所有事件都将被同步。
  • 将事件从 Google 日历同步到 ERPNext

配置LDAP

轻量级目录访问协议（LDAP）是一种集中式访问控制系统，被许多中小型组织使用。

通过设置 LDAP 服务，您可以使用 LDAP 凭据登录 ERPNext 账户。

1. 前提条件

要使用 LDAP，您首先需要安装 ldap3 Python 模块。为此，请在托管 ERPNext 实例的服务器上打开一个终端会话。进入 frappe-bench 目录。 运行命令：./env/pip install ldap3

现在您已准备好启用 ERPNext 中的 LDAP 服务。

2. 设置 LDAP

要设置 LDAP，请前往

首页 > 集成 > LDAP 设置

许多参数是强制性的，以便让 ERPNext 连接到 LDAP。它们是：

  • LDAP 服务器 URL：这是您的 LDAP 服务器的 URL。必须采用 ldap://yourserver:port 或 ldaps://yourserver:port 的形式。

  • 基础专有名称（DN）：这是有权在您的 LDAP 服务器上查找用户详细信息的用户的专有名称。该用户应仅在您的 LDAP 服务器上拥有只读权限。

  • 基础 DN 的密码：这是上述用户的密码，用于在您的 LDAP 服务器上查找用户详细信息。

  • 用户组织单位：这是组织单位的 DN，您的 LDAP 服务器中的所有用户必须属于该组织单位才能登录 ERPNext。

  • 创建时的默认角色：当用户在 ERPNext 中创建时，他们将在首次登录时被分配此默认角色。

  • LDAP 搜索字符串：此字段允许 ERPNext 将 ERPNext 登录屏幕中输入的用户/电子邮件与 LDAP 服务器进行匹配。例如，您可以根据偏好使用电子邮件地址或用户名。

它必须以以下格式输入：LDAPFIELD={0}

Active Directory 用户名示例：sAMAccountName={0}

Open LDAP 用户名示例：uid={0}

  • LDAP 电子邮件字段：指定包含用户电子邮件地址的 LDAP 字段。

Active Directory 和 Open LDAP 示例：mail

  • LDAP 用户名字段：指定包含用户用户名的 LDAP 字段。

Active Directory 示例：sAMAccountName

Open LDAP 示例：uid

  • LDAP 名字字段：指定包含用户名字的 LDAP 字段。

Active Directory 示例：givenName

Open LDAP 示例：sn

还有许多其他非强制性字段，您可以使用它们将 LDAP 用户字段映射到 ERPNext 用户字段。它们是：

  • 中间名
  • 电话
  • 手机

一旦您的设置正确，您可以点击顶部的 Enabled 复选框。当尝试启用 LDAP 时，ERPNext 将尝试连接到 LDAP 服务器以确保设置正确。如果失败，您将无法启用 LDAP，并会收到一条错误消息。

错误消息将指示需要解决的问题才能继续。

启用 LDAP 后，在登录屏幕上，系统会启用通过 LDAP 登录选项。

2.1 LDAP 安全

在 LDAP 安全部分，您有多种选项可以安全地连接到您的 LDAP 服务器。

  • SSL/TLS 模式

指定是否要在初始连接到 LDAP 服务器时启动 TLS 会话。

  • 需要受信任的证书

指定是否需要受信任的证书才能连接到 LDAP 服务器。

如果您指定了受信任的证书，则需要指定证书文件的路径。这些文件应放置在您的 ERPNext 服务器上，以下字段应为服务器上文件的绝对路径。 证书字段包括：

  • 私钥文件路径

  • 服务器证书路径

  • CA 证书文件路径

2.2 LDAP 组映射

ERPNext 还允许您自动将多个 LDAP 组映射到相应的 ERPNext 角色。 例如，您可能希望所有会计部门的员工自动拥有“会计用户”角色。

请确保填写 LDAP 组字段以允许此操作。这是 LDAP 中用户对象上的字段，包含用户所属的所有组。

对于 Active Directory 和 Open LDAP，此字段应设置为 memberOf。

Open LDAP 可能需要在您的 LDAP 服务器上启用此字段。有关更多详细信息，请参阅互联网上的示例。

请注意，每次用户登录时都会检查所有 ERPNext 角色，并会从用户权限中移除或添加相应角色。

在 LDAP 设置区域，有两个下拉菜单。

  1. SSL/TLS 模式 – 将其设置为 StartTLS 以使用 StartTLS 连接到您的 LDAP 服务器。如果您的 LDAP 服务器不支持 StartTLS，将其设置为 StartTLS 将导致错误 StartTLS is not supported。如果收到此错误，请检查 LDAP 服务器上的配置。
  2. 需要受信任的证书 – 如果将此选项更改为是，则 LDAP 服务器提供的证书必须受 Frappe/ERPNext 服务器信任。如果您希望使用带有自签名（不受信任）证书的 StartTLS，请将此选项设置为否。如果您不使用 StartTLS，则此设置将被忽略。

Google 设置

要启用 Google 集成，ERPNext 需要通过 API 访问数据以进行同步，这可以通过 OAuth 2.0 认证协议实现。

如何设置 Google 设置

针对 Google 日历、Google 联系人、Google 云端硬盘和 Google 索引

为了允许与上述任一服务进行同步，您需要授权 ERPNext 从 Google 获取数据。以下是设置 Google 联系人集成的示例：

  1. 在 Google Cloud Platform 上创建一个新项目，并生成新的 OAuth 2.0 凭据。

  • 在 API 库中为您希望集成的服务启用 API 访问权限。

    • Google 日历：Calendar API
    • Google 联系人：People API
    • Google 云端硬盘：Drive API
    • Google 索引：Indexing API

  • 在 API 和服务 > 凭据 中，创建一个新的凭据，并选择 创建 OAuth 客户端 ID

  • 选择应用程序类型为 Web 应用程序

  • 将 https://{yoursite} 添加到已授权的 JavaScript 来源。

  • 将 https://{yoursite}?cmd=frappe.integrations.doctype.google_calendar.google_calendar.google_callback 添加为 Google 日历的已授权重定向 URI。

  • 将 https://{yoursite}/api/method/frappe.integrations.google_oauth.callback 添加为其余服务的已授权重定向 URI。

  • 在 首页 > 集成 > Google 服务 > Google 设置 的 Google 设置中添加您的客户端 ID 和客户端密钥。

针对 Google 地图

仅当您想使用 Directions API（例如在 ERPNext 的 配送行程 中）时，才需要设置 API 密钥。对于其他功能，则无需设置。

为了允许与 Google 地图同步，您需要生成一个 API 密钥，因为 Google 地图不需要访问 Google 的数据。

  1. 在 Google Cloud Platform 上创建一个新项目，并生成新的 API 密钥。
  • 在 API 库中为 Directions API 启用 API 访问权限，然后在 首页 > 集成 > Google 服务 > Google 设置 的 Google 设置中添加 API 密钥。

集成类别

ERPNext 提供了广泛的集成能力，使企业能够无缝连接各种第三方应用和服务，从而提升运营效率和数据流转。

这些集成涵盖电商平台、支付网关、物流服务商、谷歌服务、电商提供商等。通过将 ERPNext 与这些系统集成，企业可以简化流程、减少手动数据录入、提高数据准确性，并更深入地洞察运营情况，最终有助于做出明智的业务决策。

如需将 ERPNext 与未在此列出的其他应用集成，您可以使用 Frappe 的 REST API。请访问以下链接了解更多信息：

Frappe REST API

身份认证集成

  • 配置 LDAP
  • 配置 Fairlogin

备份集成

  • 配置 Dropbox 备份
  • Google Drive 集成
  • 上传备份至 Amazon S3

银行集成

  • Plaid 集成

电商集成

  • Shopify 集成
  • WooCommerce 集成
  • Amazon SP-API 集成
  • Unicommerce 集成
  • Zenoti 集成

物流集成

支付集成

  • RazorPay 集成
  • GoCardless 集成
  • Stripe 集成
  • Braintree 集成
  • Paytm 集成
  • M-pesa 集成

电话集成

  • Exotel 集成

谷歌集成

  • 谷歌设置
  • 谷歌日历集成
  • 谷歌联系人集成
  • 谷歌地图集成

里程碑跟踪

在版本 12 中引入

如果文档经历多个阶段，您可以基于其生命周期自动跟踪里程碑。

里程碑设置的配置可以在里程碑跟踪中进行，每个里程碑会在里程碑中更新。

要访问里程碑跟踪器，请前往：

首页 > 设置 > 里程碑跟踪器

1. 创建里程碑跟踪器

  1. 点击新建。
  2. 设置要跟踪的文档类型（例如：“问题”）。
  3. 设置表示阶段的字段（例如：“状态”）。

注意：里程碑阶段可以通过链接或选择属性来定义。

> 设置完成后，每当任何问题的状态发生变化时，都会创建一个新的里程碑记录。 > > 可以在视图的时间线中查看里程碑： > >

> 注意：里程碑独立于版本运行。 > >

2. 功能

>

里程碑可以成为报告和通知的重要来源。例如，如果潜在客户资格认定是“潜在客户”上的一个里程碑，里程碑可以帮助生成关于某个时期内被认定的潜在客户数量的报告。

>

2.1 将里程碑与仪表板结合使用

>

与仪表板一起使用时，里程碑可以帮助跟踪里程碑的趋势。例如，如果“资格认定”被跟踪为“潜在客户阶段”，则按资格认定筛选的里程碑仪表板将显示已认定潜在客户的趋势。

>

2.2 将里程碑与能量点结合使用

>

可以定义能量点规则，自动向达到里程碑的用户授予能量点。这可用于激励在各个级别对交易采取行动。

自动重复

自动重复功能可帮助您在指定时间段内自动创建某些单据。

从版本 12 开始，您可以自定义任何表单，使单据可重复。

例如：假设您对某些项目采用递延费用制度。这要求您每月创建相同的日记账分录，以贷记递延费用账户并借记费用账户。您可以先手动创建第一笔日记账分录，然后为其创建自动重复交易。

要访问自动重复功能，请前往：

首页 > 设置 > 自动化 > 自动重复

1. 如何设置自动重复

1.1 自定义表单

  1. 前往：首页 > 自定义 > 表单自定义 > 自定义表单。
  2. 选择您希望允许创建可重复单据的表单。
  3. 勾选“允许自动重复”，以允许为该表单创建可重复单据。这对于该单据类型在自动重复单据类型下的“参考单据”字段中显示是必要的。

1.2 设置自动重复

  1. 前往 首页 > 设置 > 自动化 > 自动重复 > 新建。
  2. 选择参考单据类型，例如日记账分录或销售发票等。
  3. 选择参考单据。这是您希望重复的单个单据。
  4. 设置开始日期和结束日期（可选）。 如果未指定结束日期，则将创建重复单据，除非自动重复被禁用。
  5. 设置创建可重复单据的频率 （每日、每周、每月、每季度、每半年、每年）。
  6. 保存。

1.3 直接从单据设置自动重复

您还可以通过单击工具栏菜单中的重复选项来设置单据自动重复。

注意：如果单据已设置为自动重复，则“重复”选项不可用。

单击“重复”后，将显示自动重复提示。填写详细信息，然后单击“保存”。

2. 功能

2.1 创建时提交

如果参考单据类型是可提交的，您将看到一个名为创建时提交的选项。如果勾选此项，您的单据将在创建时被提交。

2.2 通过电子邮件通知

如果您希望在创建重复单据时通知某些联系人，您可以在自动重复的“通知”部分勾选“通过电子邮件通知”。这将把自动生成的重复单据发送到指定的电子邮件地址。相关字段说明如下：

  • 收件人：定义接收重复单据创建电子邮件的收件人电子邮件地址。
  • 获取联系人：此按钮将获取与设置为自动重复的单据相关联的联系人，并填充到“收件人”字段。
  • 模板：您可以为电子邮件选择一个电子邮件模板。这也会填充“主题”和“消息”字段。
  • 主题：电子邮件的主题（例如：重复待办事项创建成功）。
  • 消息：要在电子邮件中发送的消息。
  • 预览消息：此按钮将显示消息的预览。
  • 打印格式：选择一种打印格式来定义应通过电子邮件发送给客户的单据视图。

注意：如果您为其设置自动重复的单据是可提交的，请确保在“打印设置”中启用了“允许打印草稿”，以便在自动重复通知电子邮件中收到新的重复单据。如果未启用，您将收到关于重复单据创建的通知，但不会附带该单据。

2.3 在特定日期重复

如果频率设置为每月、每季度、每半年或每年，则它将在相应月份的与自动重复“开始日期”相同的日期创建重复单据。如果您希望在其他日期创建重复单据，则可以设置以下选项之一：

  • 重复日：创建重复单据的月份中的日期。例如，如果频率为每月，您输入 7，则它将在相应月份的 7 日生成重复单据。
  • 在每月最后一天重复：此选项可用，因为每个月的最后一天不同。例如，在闰年，2 月的最后一天是 29 日，否则是 28 日。如果您勾选此选项，它将在相应月份的最后一天创建重复单据。

2.4 为自动重复选择工作日的功能

在版本 13 中引入

频率为每周的自动重复允许您选择希望创建重复单据的日期。

2.5 仪表板

您可以在自动重复单据的仪表板中查看自动重复计划。如果您未指定结束日期，则计划将仅显示下一个计划日期。

2.6 侧边栏上的自动重复频率

当文档设置为自动重复时，您可以在侧边栏看到自动重复的频率。 您可以点击状态来查看关联的自动重复文档。

2.7 禁用自动重复

如果您勾选此字段，将停止创建重复文档，并取消自动重复文档与参考文档的关联。