eteams OpenAPI——与 ERP、金蝶等系统对接
为什么需要系统对接
很多企业已经在用一些业务系统——ERP、金蝶、钉钉、财务软件、HR 系统等。如果这些系统和 eteams 各自为政，就会产生：
- 重复录入：员工信息在 HR 系统录一遍、eteams 里再录一遍
- 数据不一致：审批在 eteams 里通过了，但财务系统里没记录
- 流程断点：报销审批在 eteams 走完后，需要手动把凭证录入金蝶
- 信息孤岛：CRM 客户在 SalesForce 里、项目在 eteams 里、合同在法务系统里，各看各的
eteams 的 OpenAPI 就是为解决这些问题设计的——让外部系统可以读写 eteams 的数据，让 eteams 的数据可以推送到外部系统。
OpenAPI 是什么
eteams 提供了一套 RESTful API，第三方开发者可以通过 HTTP 请求来：
- 查询数据：获取审批列表、任务列表、客户列表、员工信息等
- 创建数据：提交审批、创建任务、新增客户、创建员工账号等
- 更新数据：修改任务状态、更新客户信息、修改员工部门等
- 接收事件：当 eteams 里发生了某些事件（审批完成、任务完成等），回调通知外部系统
API 能对接什么
1. ERP / 财务系统对接
这是最常见的对接场景。
典型对接点：
| eteams 事件 | ERP/财务系统操作 |
|---|---|
| 报销审批通过 | 自动在金蝶/用友里生成报销凭证 |
| 采购审批通过 | 自动在 ERP 里创建采购订单 |
| 合同审批通过 | 自动在财务系统里登记合同金额 |
| 回款任务完成 | 自动在财务系统里冲销应收账款 |
2. HR 系统对接
典型对接点：
| HR 系统事件 | eteams 操作 |
|---|---|
| 新员工入职 | 自动在 eteams 创建账号 + 分配部门岗位 + 设置考勤规则 |
| 员工调岗 | 自动在 eteams 更新部门和岗位 |
| 员工离职 | 自动在 eteams 停用账号 |
| 考勤数据 | 自动同步到 HR 系统的薪资计算 |
3. CRM 系统对接
如果公司之前在用 Salesforce、HubSpot 或其他 CRM：
- 可以把旧 CRM 的客户数据批量导入 eteams
- 或者保留旧 CRM 做主系统，eteams 通过 API 实时同步客户数据
4. 企业门户/网站对接
- 网站的"联系表单" → 自动在 eteams CRM 里创建线索
- 企业门户的新闻公告 → 自动同步到 eteams 的综合办公公告
- 内部知识门户 → 自动同步到 eteams 文档库
5. 钉钉对接
虽然 eteams 和钉钉是竞品，但不少公司同时在用。通过 API 可以：
- 钉钉里的组织架构同步到 eteams
- eteams 审批完成后在钉钉里通知
API 调用方式
认证
eteams API 使用 API Key + Secret 的方式认证：
- 在 eteams 管理后台创建 API 应用，获取 AppKey 和 AppSecret
- 每次调用 API 时带上 AppKey 和签名（用 AppSecret 生成）
- 签名机制保证请求不会被伪造或篡改
常用 API 列表
| API | 方法 | 说明 |
|---|---|---|
| /api/flow/list | GET | 获取审批列表 |
| /api/flow/submit | POST | 提交审批 |
| /api/flow/approve | POST | 审批通过 |
| /api/task/list | GET | 获取任务列表 |
| /api/task/update | POST | 更新任务状态 |
| /api/customer/list | GET | 获取客户列表 |
| /api/customer/create | POST | 新增客户 |
| /api/user/list | GET | 获取员工列表 |
| /api/user/create | POST | 创建员工账号 |
| /api/doc/upload | POST | 上传文档 |
| /api/attendance/list | GET | 获取考勤数据 |
回调通知（Webhook）
eteams 支持设置回调 URL——当某些事件发生时，eteams 会自动向你指定的 URL 发送 POST 请求，包含事件详情。
支持的回调事件：
- 审批提交 / 审批完成 / 审批驳回
- 任务创建 / 任务完成 / 任务评论
- 客户新增 / 客户更新
- 员工新增 / 员工离职
这样外部系统不需要定时轮询 eteams 数据——事件发生时自动收到通知。
谁来做对接
API 对接有三种方式：
| 方式 | 谁做 | 适用场景 |
|---|---|---|
| 自己开发 | 公司内部 IT 团队 | 有现成 IT 团队，想自己掌控 |
| eteams 服务 | 泛微的技术服务团队 | 不想自己开发，让服务商做 |
| 第三方集成工具 | 用 Zapier/钉钉连接器等 | 简单场景，不想写代码 |
如果公司有懂技术的 IT，建议自己先尝试——API 设计得比较规范，文档也齐全。复杂场景或没有 IT 团队的公司可以联系 eteams 销售，他们会推荐合适的集成方案。
API 对接的注意事项
- 付费要求：OpenAPI 接口权限通常在付费版里才有（免费版不支持）
- 频率限制：API 有调用频率限制（比如每分钟最多 N 次），避免滥用
- 数据安全：API Key 和 Secret 要妥善保管，不要硬编码在代码里
- 幂等设计：外部系统对接时要考虑"重复调用"的情况——比如同一个审批完成通知可能会收到两次，处理逻辑要能去重
- 错误处理：API 调用可能失败（网络问题、eteams 服务维护等），要有重试机制
不需要 API 的轻量对接
有些场景不需要完整的 API 对接——eteams 提供了一些更简单的集成方式：
- CSV 批量导入：员工、客户、项目等数据可以通过 Excel/CSV 批量导入，不需要写代码
- Webhook 简单通知：某些事件可以直接配置简单的 URL 通知，不需要完整 API 认证
- 单点登录：eteams 支持 SSO，可以和企业内部的统一身份认证系统对接
先用轻量方式尝试，不够再上 API 对接。