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 中这些发票是通过这些卡支付的。

库存对账

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