第三方集成

ccMonet 支持与多种外部服务连接，实现数据自动同步和业务流程打通。本文档涵盖会计软件对接、银行账户关联、Stripe 数据同步、Gmail 插件、Lark/飞书集成以及电子发票平台。

快速上手

ccMonet 提供以下六大类集成能力：

大部分集成的入口在：左侧菜单 → 设置 → 集成。

---

功能详细说明

会计软件对接

QuickBooks / Xero 连接

入口：左侧菜单 → 设置 → 集成

系统支持与 QuickBooks 和 Xero 两大主流会计软件的对接，实现联系人匹配、科目映射、税码映射和标签同步。

同一时间只能连接一个会计软件（QuickBooks 或 Xero 二选一）。仅组织所有者可以执行连接和同步操作。

连接流程：

1. 在集成页面选择 QuickBooks 或 Xero
2. 页面跳转到对应平台的授权页面，完成 OAuth 授权
3. 授权成功后返回系统，显示已连接状态和公司名称

连接后可在任何时候点击「断开连接」解除关联。

连接出错时页面顶部会显示红色错误提示，请检查第三方平台的授权状态后重新连接。

连接后的功能：

连接成功后，集成页面显示四个标签页：

联系人匹配

入口：左侧菜单 → 设置 → 集成 → 「联系人」标签页

将系统中的供应商和客户与会计软件中的联系人建立对应关系。页面顶部可切换查看「供应商」和「客户」。

支持按名称搜索和按日期范围筛选，分页选项：100 / 200 / 500 条每页。

科目映射

入口：左侧菜单 → 设置 → 集成 → 「科目」标签页

将系统的会计科目与会计软件中的科目建立对应关系，确保导出账单时科目准确匹配。

税码映射

入口：左侧菜单 → 设置 → 集成 → 「税码」标签页

将系统的税率与会计软件中的税务类型建立映射。页面分为「账单」和「收入」两个标签页，分别管理应付和应收的税率映射。

标签同步

入口：左侧菜单 → 设置 → 集成 → 「核算维度」标签页

展示从会计软件同步过来的追踪分类数据。点击「从第三方更新」可以重新拉取最新数据。

账单导出

连接会计软件后，可以将系统中的账单导出到 QuickBooks 或 Xero。导出前系统会自动检查账单是否满足导出条件，联系人、科目和税码按映射关系自动转换。

---

银行账户关联

系统支持通过四种方式关联银行账户，自动导入银行流水数据用于银行对账。

Plaid（美国地区）

入口：银行关联设置

Plaid 是美国主流的银行账户聚合服务。

连接流程：

1. 系统打开 Plaid 连接界面
2. 在 Plaid 界面中选择银行并完成授权
3. 授权成功后系统自动创建银行账户关联

默认同步过去 1 年的银行交易数据。部分银行需要跳转到银行页面完成授权，授权完成后会自动回到系统。

Finverse（亚太地区）

入口：银行关联设置

Finverse 是亚太区银行账户聚合服务。

连接流程：

1. 系统跳转到 Finverse 连接页面
2. 在 Finverse 页面中选择银行并完成授权
3. 授权完成后返回系统，系统自动查询连接结果

支持重新连接已有的银行关联（用于授权过期后重新操作）。Finverse 自动去重，同一笔交易不会重复导入。

Airwallex（跨境支付）

入口：银行关联设置

Airwallex 连接通过 API 密钥配置，需要填写：

Stripe 银行流水

入口：银行关联设置

通过 Stripe Secret Key 配置，导入 Stripe 平台的交易流水。

---

Stripe 数据同步

入口：左侧菜单 → 设置 → 第三方平台集成 → Stripe

将 Stripe 支付平台上的已付费发票和余额交易自动同步到系统中，实现发票收款和银行对账的自动化。同步方向为单向：Stripe → 系统。

关联步骤

1. 在设置页面输入 Stripe API 密钥（以 sk_live_ 或 sk_test_ 开头）
2. 系统验证密钥有效性（自动检查余额、发票等接口是否可访问）
3. 自动发现 Stripe 账户中的所有币种，为每个币种创建独立的银行账户（如 Stripe-USD、Stripe-EUR）
4. 设置同步起始日期

Stripe 集成使用静态 API 密钥，无需 OAuth 授权流程。

发票同步

Stripe 上已全额付费的发票自动同步为系统中的收入单据，包含：

• 发票基本信息（编号、日期、金额、客户信息）
• 产品行项明细（名称、数量、单价、税额、折扣）
• Stripe 手续费（作为负数行项自动添加）

仅同步已全额付费的发票。部分付款和未付款发票不会被同步。退款不在发票同步中体现，仅作为独立的余额交易出现在交易同步中。

交易同步

Stripe 余额交易自动同步为银行流水记录，按币种分别对应不同的银行账户。

同步后系统自动执行银行流水与收入单据的对账匹配。

同步机制

• 定时任务：自动定期执行同步，支持断点续传，中断后从断点继续
• 实时通知：通过 Webhook 接收 Stripe 付款成功通知，实时同步新发票
• 错误处理：密钥失效时标记为「需要重新关联」并停止同步；单条发票处理失败不影响其他发票

---

Gmail 插件

Gmail Add-On 是 ccMonet 提供的 Gmail 浏览器扩展工具，用于在 Gmail 中将财务相关的邮件转发到系统，自动创建账单或报销单。

使用方式

1. 安装 Gmail Add-On 后，在插件中完成登录（使用 ccMonet 账号密码）
2. 插件自动获取组织的账单邮箱和报销邮箱地址
3. 在 Gmail 中浏览邮件时，插件可以将邮件转发到对应邮箱

账单和报销邮箱地址在组织设置中配置，不可在插件中修改。

---

系统与 Lark（国际版）和飞书（中国版）集成，支持账户绑定、文件上传和报销审批同步。

账户绑定

入口：左侧菜单 → 设置 → 个人设置

用户通过 OAuth 授权将 Lark 或飞书账户与系统关联。绑定后系统可以使用您的 Lark/飞书身份发起审批和上传附件。

Lark 和飞书是两个独立的平台，需要分别绑定。绑定后的授权令牌由系统自动刷新，无需手动维护。

报销审批同步

入口：左侧菜单 → 财务 → 个人支出 → 报销单详情 → 导出到 Lark/飞书

将系统中的报销单同步到 Lark/飞书的审批流程中。

流程：

1. 在报销单详情页选择「导出到 Lark/飞书」
2. 选择目标审批模板
3. 配置字段映射（将报销单字段对应到审批表单字段）
4. 系统自动将报销数据和所有附件上传到 Lark/飞书，创建审批实例

映射的报销单信息：

• 费用描述、金额、日期
• 供应商名称
• 关联的所有附件文件（自动上传到 Lark/飞书）

前提条件：

• 您已绑定 Lark/飞书账户
• 组织已配置 Lark/飞书审批定义

仅报销单的提交人可以执行导出操作。导出完成后可在报销单详情中追踪 Lark/飞书审批实例的状态。

审批通道配置

如果组织使用 Lark/飞书作为审批通道，可以在报销设置中将审批通道切换为「Lark 审批」或「飞书审批」。配置后，员工提交报销时会自动在 Lark/飞书中创建审批实例，审批结果同步回系统。

详见 审批流程 中的 Lark/飞书审批部分。

---

电子发票

管理电子发票的发布、发送和状态追踪，支持 InvoiceNow（新加坡）和 MyInvois（马来西亚）两大电子发票平台。

支持的平台

通过 InvoiceNow 或 MyInvois 同步到系统中的单据，不可再次发送电子发票（防止重复发布）。

文档类型

重新发布时，系统根据金额变化自动判定文档类型：本次总额高于上次用借记单，低于上次用贷记单。

发布流程

1. 前置校验：检查组织信息、客户信息和产品行项是否满足平台要求
2. 数据转换：将单据数据转为电子发票格式，自动判定文档类型
3. 提交到平台：调用电子发票平台接口发送
4. 等待确认：系统自动轮询平台确认结果（约 24 秒），如未获得结果由后台定时任务继续跟踪

电子发票发布操作仅 Web 端可用。发布后的状态查看 Web 和 App 均支持。

InvoiceNow（新加坡）校验要求

客户必须填写 Peppol ID。系统提供 Peppol 目录搜索功能，可按公司名称或注册号在全球目录中查询客户的 Peppol ID。

搜索 Peppol ID：在发送电子发票前，可通过搜索功能查找客户的 Peppol ID，支持按名称或注册号查询，可选按国家/地区筛选。搜索结果包括 Peppol ID、公司名称、国家代码和注册日期。

MyInvois（马来西亚）校验要求

组织级：需要填写完整的电子发票基本信息（电话、地址、城市、地区、邮箱）。马来西亚组织的地区须从 16 个标准州代码中选择（如 Johor、Selangor、W.P. Kuala Lumpur 等）。

客户级（非公共客户）：需要填写税务识别号（TIN）、注册类型、注册号、地址、电话、国家、城市、地区等信息。发票日期须在过去 72 小时至当前时间范围内。

TIN 查询与验证：系统提供马来西亚税务识别号（TIN）的查询和验证功能，可根据证件类型和号码查询 TIN，也可验证已有 TIN 是否有效。

公共客户：当客户税务信息不完整时，可以选择以「公共客户」身份发送（跳过客户信息校验），系统自动使用公共税务识别号。

产品行项：所有产品必须填写分类代码，自开发票不可包含特定分类代码的行项。

批量发送

支持批量发送电子发票（每批最多 10 条）。发送前会显示校验结果弹窗，列出所有校验错误，并提供「编辑联系人」操作可直接补充客户信息。

操作选项：

• 「仅提交已就绪的」——跳过校验不通过的发票
• 「使用公共客户提交」（仅 MyInvois）——校验不通过的发票使用公共客户身份发送

校验不通过的发票会被跳过，不影响其余发票的处理。

取消与退款

已发布的电子发票不可删除，需先执行取消或退款操作。

MyInvois 强制发送规则

2026 年 1 月 1 日（马来西亚时间）起，总额超过 10,000 MYR 的单据必须通过电子发票方式提交。非 MYR 币种按当前汇率换算后判定。满足条件时，详情页的「提交」按钮替换为「提交并发送电子发票」。

发布状态

同一单据可在多个平台、多种文档类型下有独立的发布记录。每个平台、每种文档类型仅允许一次成功发布。

InvoiceNow 与 MyInvois 差异对比

---

典型场景

公司用 Xero 管会计，怎么和 ccMonet 打通？ 左侧菜单 → 设置 → 集成，点击 Xero 卡片完成 OAuth 授权。连接后依次配置联系人匹配、科目映射和税码映射，之后账单导出就会自动按映射关系转换。

怎么关联银行账户实现自动对账？ 在银行关联设置中选择对应的银行连接方式（Plaid/Finverse/Airwallex/Stripe），完成授权后银行流水会自动导入，在银行对账模块中进行匹配。

公司用飞书审批，报销单怎么同步过去？ 先在个人设置中绑定飞书账户，然后在报销单详情页选择「导出到飞书」。如果组织将报销审批通道配置为「飞书审批」，提交报销时会自动在飞书中创建审批实例。

收到供应商的邮件账单，不想手工上传？ 安装 Gmail Add-On 插件，直接在 Gmail 中将邮件转发到组织的账单邮箱，系统会自动创建账单草稿。

需要向新加坡客户发送电子发票？ 确保客户已填写 Peppol ID（可通过 Peppol 目录搜索查找），然后在收入单据中点击发送电子发票。系统会校验信息完整性后提交到 InvoiceNow 平台。

马来西亚客户的 TIN 不知道怎么填？ 在客户信息中使用 TIN 查询功能，输入客户的证件类型和证件号码即可从 MyInvois 平台查询对应的税务识别号。查询到后还可以验证 TIN 是否有效。

Stripe 上的收款怎么自动入账？ 在设置中配置 Stripe API 密钥，系统会自动将 Stripe 上的已付费发票同步为收入单据，余额交易同步为银行流水，并自动完成对账。

批量发送电子发票时部分客户信息不全怎么办？ 批量发送时系统会显示校验结果，可以选择「仅提交已就绪的」跳过不合格的发票，也可以点击「编辑联系人」补充客户信息。MyInvois 平台还支持以「公共客户」身份发送。

---

如有其他问题，请联系客服团队。