法国需求

ERPNext 旨在支持全球不同地区的本地法规。在大多数情况下,ERPNext 非常灵活,因此您可以轻松添加自定义字段并制作自定义报表,以满足您所在地区的法规要求。

本节包含针对法国的区域特定功能。

  • 会计账簿文件(FEC)
  • 销售与付款交易

翻译

ERPNext 支持多种语言,其中大部分由 ERPNext 社区贡献。

支持较为完善的语言包括法语、西班牙语、德语、土耳其语和波斯尼亚语。

  1. 如何贡献翻译?

  1. 从顶部搜索栏打开翻译工具
  2. 选择您想要翻译的语言
  3. 在左侧边栏中点击您想要添加翻译的任意源文本。
  4. 在“翻译文本”字段中输入您建议的翻译,然后点击提交建议
  5. 您可以点击左侧边栏中的其他源文本,继续添加其他翻译。
  6. 完成所有翻译后,点击贡献翻译按钮。
  7. 您可以通过点击“已贡献翻译”部分下的源文本来查看您的贡献状态。

  1. 已贡献翻译的状态

提交翻译后,翻译将进入待审核队列。Frappe 团队或社区的成员将验证您贡献的翻译,如果翻译正确,则将其状态设置为已验证。如果贡献的翻译不正确,Frappe 团队或社区的成员将拒绝该翻译。

每周,翻译服务器都会创建一个拉取请求,其中包含所有已贡献的已验证翻译

  1. 成为翻译审核员

如果您想审核社区其他成员贡献的翻译,请在 translate.erpnext.com 上注册。审核员可以验证或拒绝贡献的翻译。

区域

ERPNext 旨在支持全球所有地区的本地法规。在大多数情况下,ERPNext 非常灵活,您可以轻松添加自定义字段和创建自定义报表,以满足您所在地区的法规要求。

截至 2017 年年中,ERPNext 计划预设公司向相关机构轻松提交报告所需的额外字段和表单。

本部分仍在开发中。

印度

  • 印度合规应用
  • 较低扣税证明
  • 印度 TDS 设置

阿拉伯联合酋长国

  • 阿联酋的要求
  • 阿联酋区域字段
  • ERPNext 中的阿联酋增值税 201 报表
  • 增值税/消费税实施

沙特阿拉伯

  • 沙特增值税管理与报告

美国

  • Taxjar 集成

意大利

  • 意大利的要求
  • 从供应商导入电子发票

法国

  • 法国的要求
  • 销售和支付交易
  • 会计账簿文件 [FEC]

印度合规

任何需要在 ERPNext 中使用印度特定法定功能的用户,都可以安装 India Compliance 应用来解锁 ERPNext 中的相关能力。安装并配置完成后,该应用会添加在印度运营 ERPNext 所需的工作流程、字段、报表和校验规则。

官方文档:https://docs.indiacompliance.app/docs/getting-started/introduction

India Compliance 应用提供哪些功能

India Compliance 应用扩展了 ERPNext,以满足印度的税务和监管需求。对于需要直接在 ERPNext 中管理 GST、电子发票、电子运单、TDS、TCS 以及印度特定报表的公司来说,该应用尤其有用。

总的来说,该应用主要帮助处理以下事项:

  • GST 设置和符合 GST 规范的交易处理
  • GSTIN 和交易方税务信息
  • 商品和服务的 HSN/SAC 代码处理
  • GST 税模板和税务处理方式
  • GST 申报和法定报表
  • 电子发票的生成和管理
  • 电子运单的生成和管理
  • TDS 和 TCS 合规
  • 交易中的印度特定校验
  • 印度企业所需的区域化字段和工作流程

具体可用的功能可能取决于所安装的应用版本、ERPNext 版本以及为公司启用的配置。

为什么它独立于 ERPNext

ERPNext 服务于全球多个国家的用户。将印度特定的合规功能放在独立的应用中,可以使核心产品更加简洁,同时仍能让印度公司获得所需的工作流程。

这意味着,不需要印度合规功能的公司可以继续使用标准的 ERPNext,而印度公司则可以安装 India Compliance 应用,并启用本地运营所需的额外功能。

典型使用流程

Install ERPNext
      |
      v
Install India Compliance app
      |
      v
Configure company and GST settings
      |
      v
Set up masters such as GSTIN, HSN/SAC, tax templates
      |
      v
Create transactions in ERPNext
      |
      v
Generate India-specific compliance outputs

常见影响范围

主数据

该应用可以在公司、客户、供应商、地址、商品和税模板等主数据中添加或使用印度特定的详细信息。这些信息有助于 ERPNext 在交易过程中正确应用 GST 及其他规则。

交易

销售发票、采购发票、交货单和其他单据可以包含印度特定的税务信息。该应用会根据印度的合规要求,帮助校验和处理这些交易。

报表

该应用提供印度法定合规所需的报表和输出,包括与 GST 相关的报表和其他税务汇总。

电子合规

对于需要电子发票或电子运单流程的企业,India Compliance 应用在 ERPNext 内部提供了所需的集成和单据处理体验。

何时应该安装?

如果您的 ERPNext 站点由印度公司或需要遵守印度税务和发票规则的公司使用,请安装 India Compliance 应用。

如果您的公司不在印度运营,且不需要印度的法定报表,则可能无需安装。

了解更多

请在此处阅读官方的 India Compliance 文档:

https://docs.indiacompliance.app/docs/getting-started/introduction

ERPNext 与 Raven 聊天

ERPNext Chat 已弃用,不应再用于新实施。如果您的组织需要在 Frappe 生态系统中进行即时通讯、团队频道、文档共享和协作,请改用 Raven

Raven 是一款用于团队消息传递的 Frappe 应用。它是开源的 Slack 替代方案,可以安装在 ERPNext 和其他 Frappe 应用所在的同一站点上。这使得它成为希望内部沟通与业务数据和工作流程紧密关联的组织的理想选择。

为什么使用 Raven

Raven 帮助团队在不离开 Frappe 生态系统的情况下进行实时沟通。团队可以创建频道、发送直接消息、共享文件、提及用户、对消息做出反应以及搜索对话。

对于使用 ERPNext 的组织来说,它尤其有用,因为讨论可以围绕实际工作展开:客户、销售订单、发票、问题、项目、任务以及其他业务单据。

主要功能

  • 频道和直接消息: 为团队、部门、项目或主题创建公开或私有频道。
  • 丰富的消息功能: 发送格式化消息、链接、代码块、表情符号、提及、回复和反应。
  • 文件共享: 直接在对话中共享图片、文档、PDF 和其他文件。
  • 搜索: 搜索消息、频道、文件和用户。
  • 移动端友好: Raven 专为桌面端和移动端的协作而设计。
  • 深色模式: 用户可以为日常沟通选择舒适的界面。

ERPNext 和 Frappe 原生功能

Raven 不仅仅是一个独立的聊天工具。由于它基于 Frappe 构建,因此可以与 ERPNext 和其他 Frappe 应用紧密协作。

有用的 ERPNext 原生功能包括:

  • 在 Raven 对话中共享 ERPNext 单据。
  • 从 Desk 界面发送消息到频道。
  • 将消息链接到单据,以便从单据时间线中获取讨论上下文。
  • 根据单据事件触发通知。
  • 共享 ERPNext 记录时使用文档预览。
  • 在支持的情况下,从对话中执行与工作流相关的操作。
  • 将协作与业务记录关联起来,而不是分散在外部聊天工具中。

这使得 Raven 对于希望对话与实际的 ERPNext 工作保持关联,而不是孤立地存在于另一个系统中的团队非常有用。

何时使用 Raven

当您的组织需要以下功能时,请使用 Raven:

  • 内部团队消息传递。
  • 部门或项目频道。
  • 围绕单据和事务的 ERPNext 相关讨论。
  • Slack 的 Frappe 原生替代方案。
  • 可自托管或由 Frappe Cloud 托管的沟通工具。
  • 在聊天、文档和工作流之间建立更好的上下文关联。

安装和源代码

您可以从 Frappe Cloud Marketplace 安装 Raven:

  • Frappe Cloud Marketplace 上的 Raven
  • Raven GitHub 仓库
  • ERPNext
  • Frappe 框架
  • Frappe Cloud Marketplace 上的 Raven
  • Raven GitHub 仓库

集成ERPNext与其他应用

ERPNext 的设计目标是与其它应用程序集成。由于 ERPNext 构建在 Frappe 框架之上,业务记录通过一致的 REST API 暴露出来。这使得将 ERPNext 与外部系统(如 CRM 平台、物流供应商、订单管理系统、再商务平台、Google 服务、银行系统、支付网关以及内部业务应用程序)连接变得非常简单。

为什么 ERPNext 易于集成

大多数 ERPNext 业务对象都是 DocType。客户、物料、销售订单、采购订单、销售发票、交货单、付款条目、库存条目、项目以及许多其它记录都遵循相同的文档模型。Frappe 自动为 DocType 提供 REST API 访问,因此集成可以通过可预测的端点读取、创建、更新和删除记录。

这意味着第三方应用程序不需要为每个 ERPNext 模块单独定制 API。一旦外部系统知道 DocType 和字段名称,它就可以使用标准的 HTTPS 请求和 JSON 数据与 ERPNext 交换数据。

在 ERPNext 中添加的自定义字段会成为 DocType 元数据的一部分,并立即可用于集成。例如,如果企业在销售订单上添加了自定义字段 marketplace_order_id 或在交货单上添加了 courier_tracking_id,第三方应用程序就可以通过用于标准字段的同一 REST API 发送和接收这些值。

当 ERPNext 连接到需要自己的标识符、状态、引用或运营数据的外部系统时,这一点尤其有用。自定义字段让团队能够扩展 ERPNext,而不会破坏标准数据模型。

REST API 如何工作

Frappe 为 DocType 提供 REST API 端点。第三方应用程序可以使用 API 密钥和 API 密钥进行身份验证,然后调用端点来列出文档、获取特定文档、创建新记录、更新现有记录,或在权限允许的情况下删除记录。

常见的集成模式包括:

  • 从 ERPNext 读取: 获取客户、物料、价格、库存水平、发票或付款状态。
  • 写入 ERPNext: 创建潜在客户、客户、销售订单、采购订单、交货单、付款条目或支持工单。
  • 更新 ERPNext 发送物流更新、对账参考、银行交易 ID、市场订单 ID 或履行状态。
  • 响应 ERPNext 事件: 使用 Webhook 在文档被创建、更新、提交或取消时通知其它应用程序。

集成示例

  • CRM: 在 ERPNext 和销售 CRM 之间同步潜在客户、商机、客户、报价和跟进状态。
  • 物流: 将交货单或发货请求发送到快递平台,并将跟踪号接收回 ERPNext。
  • 订单管理: 将订单从订单管理系统推送到 ERPNext 作为销售订单,然后将履行和发票状态发送回去。
  • 再商务平台: 同步产品目录、客户订单、库存可用性、退货、翻新状态和付款。
  • Google 服务: 将 ERPNext 与 Google Workspace、Google 日历、Google 表格或报告工作流连接。
  • 银行和支付系统: 导入银行交易、更新付款参考、对账付款,或连接收款工作流。

典型集成流程

  1. 确定涉及的 ERPNext DocType,例如客户、物料、销售订单、交货单、销售发票、付款条目或自定义 DocType。
  2. 映射 ERPNext 和外部应用程序之间的字段,包括业务流程所需的任何自定义字段。
  3. 在 ERPNext 中创建一个集成用户,仅授予集成所需的角色和权限。
  4. 为该用户生成 API 凭据,并安全地进行 API 调用身份验证。
  5. 使用 REST API 端点根据需要创建、获取、更新或删除记录。
  6. 使用 Webhook 或后台作业进行事件驱动的同步、重试和异步处理。

良好实践

  • 使用专用的集成用户,而不是管理员账户。
  • 应用基于角色的权限,以便集成只能访问其需要的记录。
  • 将外部 ID 存储在自定义字段中,以便更轻松地进行对账和故障排除。
  • 将集成设计为幂等的,以便重试请求不会创建重复记录。
  • 对于高容量工作流,使用 Webhook 或队列,而不是让所有操作都同步进行。
  • 记录请求 ID、外部引用和错误消息,以便快速追踪失败。
  • Frappe REST API
  • 基于令牌的身份验证
  • Webhook
  • 通过 API 插入文档
  • 自定义字段

DATEV集成

概述

DATEV 集成应用将 ERPNext 与德国会计团队和税务顾问使用的 DATEV 工作流程连接起来。该应用在 Frappe Cloud Marketplace 上以 DATEV Integration 的名称列出,由 ALYF GmbH(Raffael 的团队)发布。

功能说明

  • DATEV Unternehmen Online: 通过电子邮件将已提交的凭证发送到 DATEV Unternehmen Online。发出的凭证可以转换为 PDF,而收到的凭证可以发送附件文件。
  • DATEV CSV 导出: 以 DATEV CSV 格式从 ERPNext 导出原始总账条目。
  • 税务顾问交接: 将包含主数据的 DATEV 报告导出为 ZIP 文件,以便导入税务顾问的 DATEV 系统。

设置摘要

使用客户编号、税务顾问编号和临时往来账户配置 DATEV 设置。对于 DATEV Unternehmen Online,启用集成、选择发送邮件的账户、选择凭证类型、添加来自 DATEV 的目标电子邮件地址,并选择发送附件还是生成的打印件。

兼容性

市场列表显示支持 ERPNext 版本 13、14、15 和 16。在用于会计交接之前,请在暂存站点上测试集成。

  • Frappe Cloud Marketplace 上的 DATEV Integration

免责声明

DATEV 和 DATEV Unternehmen Online 是 DATEV eG 的商标。市场列表注明此集成未经 DATEV eG 批准或认可。

Exotel 集成

此集成允许您将 Exotel 集成到您的 ERPNext 账户中。通过 Exotel 捕获的线索及其电话号码可以直接保存到您的 ERPNext 中。

1. 功能特性

  • 在您的 ERPNext 账户中跟踪来电。
  • 当收到来电时,向员工显示现有的线索/客户信息弹窗。

2. 如何设置

2.1 设置您的 Exotel 账户

  • 登录您的 Exotel 账户,然后前往应用市场。
  • 为新的流程创建一个新应用。
  • 按照您的需求设置流程。
  • 在您的连接 API 中的“创建弹窗…”部分,粘贴以下 URL:
    https://<your-site>/api/method/erpnext.erpnext_integrations.exotel_integration.handle_incoming_call</your-site>


注意: 将 URL 中的 <your-site></your-site> 替换为您的站点名称。例如,如果站点名称是 frappe.erpnext.com,则 URL 将变为:
https://frappe.erpnext.com/api/method/erpnext.erpnext_integrations.exotel_integration.handle_incoming_call

  • 之后,在“通话结束后”部分添加一个 Passthru 小程序,并粘贴以下 URL:
    https://<your-site>/api/method/erpnext.erpnext_integrations.exotel_integration.handle_end_call</your-site>

注意: 确保勾选“使 Passthru 异步执行”。

  • 同样,在“如果无人接听…”部分添加一个 Passthru 小程序,并粘贴以下 URL:
    https://<your-site>/api/method/erpnext.erpnext_integrations.exotel_integration.handle_missed_call</your-site>

注意: 确保勾选“使 Passthru 异步执行”。

  • 保存流程。
  • 现在,将此新创建的应用分配给您用于接听业务电话的 ExoPhone。

2.2 在 ERPNext 中设置

  • 从万能栏中,前往“Exotel 设置”。
  • 设置您的“Exotel SID”和“Exotel 令牌”。您可以在您的 Exotel 仪表板上找到您的 Exotel API 密钥和令牌。
  • 前往“沟通媒介”。
  • 添加您的 ExoPhone 并安排该号码。根据此安排,员工将收到弹窗。

M-Pesa 集成

M-Pesa 集成允许通过支付网关提供商 M-Pesa 处理交易。

M-Pesa 集成有助于处理 M-Pesa 应用程序与 ERPNext 之间的支付。M-Pesa 集成仅适用于销售点(POS)以处理相关支付。此功能不适用于购物车。

要设置 M-Pesa,请前往:

集成 > 支付 > M-Pesa 设置

1. 如何获取您的 M-Pesa 凭据?

  1. 为了激活您的 API 凭据,您需要登录您的 M-Pesa 账户。
  2. 然后,打开应用程序的“上线”部分,并按照步骤获取应用程序的批准。
  3. 当所有测试用例均满足且预期结果与最终结果一致时,您需要提交文档并按照步骤获取应用程序的最终凭据。
  4. “生产环境 URL 和凭据”部分中提到的详细信息,就是您应在 M-Pesa 设置中使用的凭据。

2. 设置 M-Pesa

要启用 M-Pesa Express,您需要配置所有从 M-Pesa 收到的必填参数。如果您想使用集成的暂存环境,您可以选择暂存选项,并通过为此创建单独的应用程序来使用 M-Pesa 提供的暂存凭据。

在 ERPNext 中启用 M-Pesa 集成后,系统将创建一个支付网关记录,并在科目表中创建一个账户类型为“银行”的会计科目,如下面的截图所示。


系统还会创建一个与支付网关同名的付款方式及对应账户,并在 POS 设置中添加某些自定义字段以处理 POS 支付。

配置支付网关账户后,您将能够通过 M-Pesa 接受在线支付。

3. M-Pesa POS 支付

使用 M-Pesa 付款方式设置 POS 配置文件后,POS 结账页面将显示一个附加信息区域。该区域包含两个字段,这些字段是在添加 M-Pesa 设置时自动创建的。

当 POS 用户填写客户的手机号码后,即可向客户发起支付请求。请求会发送到与该手机号码关联的客户 M-Pesa 移动应用程序。用户处理完支付后,系统会通过确认对话框提示用户提交支付。

4. M-Pesa 账户余额

与单个 M-Pesa 关联的账户余额可以通过“获取账户余额”按钮获取。这将把 M-Pesa 账户余额详情加载到仪表板中。

5. 支持的交易货币

M-Pesa 仅适用于公司货币为 KSH(肯尼亚先令)的公司。

Paytm 集成

Paytm 集成允许通过支付网关提供商 Paytm 处理交易。

Paytm 集成有助于处理 Paytm 支付门户与 ERPNext 之间的付款。您的客户可以选择使用任何信用卡/借记卡、UPI、网上银行、Paytm 钱包进行支付。

要设置 Paytm,请前往:

集成 > 支付 > Paytm 设置

1. 如何获取您的 Paytm API 凭据?

  1. 为了激活您的 API 凭据,您需要登录您的 Paytm 账户。
  2. 然后,在侧边栏中打开“开发者设置”选项。
  3. 选择“API 密钥”选项,它将显示两种类型的 API 详细信息(测试/生产)。
  4. “生产 API 详细信息”中提到的详细信息是您应该在 Paytm 设置中使用的凭据。

2. 设置 Paytm

要启用 Paytm 支付服务,您需要配置从 Paytm 收到的所有必填参数。如果您想使用集成的暂存环境,您可以选择暂存选项并使用 Paytm 提供的测试 API 开发者凭据。

ERPNext 中启用 Paytm 集成后,系统将创建一个支付网关记录,并在会计科目表中创建一个账户类型为“银行”的科目,如下面的截图所示。

此外,它还会创建一个支付网关账户条目。支付网关账户是配置中心,您可以在其中设置科目以及用于向客户请求付款的默认付款请求电子邮件模板。

配置支付网关账户后,您将能够通过 Paytm 接受在线付款。

3. 支持的交易货币

Paytm 仅适用于公司货币为 INR(印度卢比)的公司。