> For the complete documentation index, see [llms.txt](https://doc.duaer.com/zh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/zh/organizations/write-back.md).

# 让 Duaer 卡片上的决定回到原来的系统

员工在 Duaer 卡片上同意或驳回，结果回到飞书审批、钉钉审批、泛微 e-cology、金蝶云星空或你们自己的系统；事项在原来的系统里处理了，卡片自己关掉。
## 在 Duaer 里做决定，结果回到原来的系统

事项来自飞书审批、OA、ERP 这些系统时，员工在 Duaer 卡片上选了「同意」或「驳回」，这个决定可以回到原来的系统，不用再去那边点一次。

Duaer 不会直接改对方系统的数据库：只通过对方系统的接口，或者你们自己接收的 Webhook。回写默认是关的，所有者或管理员按卡片规则一条一条打开。

## 事项在原来的系统里处理了，卡片会自己关掉

这一项不用设置。卡片规则每次运行时，事项的状态不再是待处理、不再超期，或者换了负责人，这张卡片就会关掉，员工端「已决定」里写着「已在源系统处理」；换了负责人时，新负责人会收到一张新卡片。

事项从 Duaer cases 表里删掉时，卡片不动，这样重新写入事项表时不会把大家的卡片一下子全关掉。

## 打开回写设置

1. 所有者或管理员打开 Duaer 设置 ›「回写」（在「连接」下面）。
2. 在「回写目标」里点「添加 Webhook」「添加飞书审批」「添加钉钉审批」「添加泛微 e-cology」或「添加金蝶云星空」，填好后点「保存」。
3. 在「卡片规则」里，给一条规则选「回写到」哪个目标，再选哪些选项要回写，点「保存」。「保存」在改动之后才出现。
4. 目标需要成员在那个系统里的账号时，在「成员账号」里填好。

## 飞书审批

来自飞书审批数据源的卡片，事项编号就是飞书审批的实例编号。员工选定后，Duaer 用组织连接的飞书应用，找到这个人在这条审批里的待办，以他本人的身份同意或拒绝，并带上卡片上写的意见；飞书里记下的审批人是他本人。

- 先在知识来源里连接飞书；没有连接时，添加飞书审批会提示「飞书还没有连接」。
- 飞书应用要开通审批的读写权限，在飞书开放平台的应用权限里申请。
- 在卡片规则里给每个选项选「同意」「拒绝」或「不回写」；「不回写」的选项只在 Duaer 里生效。
- 成员的飞书账号：在飞书里绑定过的成员直接用；没有绑定的，第一次选定时 Duaer 按这个人在 Duaer 的邮箱去飞书查，查到就记下来。还对不上的，在「成员账号」里选「邮箱」或「手机号」，填这个人在飞书里的邮箱或手机号，Duaer 查出账号存好；也可以选「账号 ID」直接填 open_id。没有飞书账号的人选定时会被拦下，提示请管理员添加。
- 审批在飞书里已经结束、这个人在这条审批里没有待办，或者飞书返回错误时，卡片回到待处理，写着原因。

## 钉钉审批

卡片的事项编号要是钉钉审批的实例 ID。员工选定后，Duaer 用组织连接的钉钉应用，找到这个人在这条审批里正在处理的任务，以本人的身份同意或拒绝，并把卡片上写的意见作为审批意见；也可以只把意见作为评论加到这条审批上。

- 先在知识来源里连接钉钉；没有连接时，添加钉钉审批会提示「钉钉还没有连接」。
- 钉钉应用要开通审批的读写权限，在钉钉开放平台的应用权限里申请。
- 在卡片规则里给每个选项选「同意」「拒绝」「评论」或「不回写」。「评论」只加评论，不改变审批结果；卡片上没写意见时不会发出。
- 成员的钉钉账号：读过钉钉通讯录、按邮箱对上的成员直接用；对不上的，在「成员账号」里选「手机号」填这个人在钉钉的手机号，Duaer 查出 userId 存好，也可以选「账号 ID」直接填 userId；填了的优先。钉钉不能按邮箱查人。没有钉钉账号的人选定时会被拦下，Duaer 不会去调用钉钉。
- 审批在钉钉里已经结束、这个人在这条审批里没有正在处理的任务，或者钉钉拒绝时，卡片回到待处理，写着原因。

## 泛微 e-cology

来自泛微 e-cology 数据源的卡片，事项编号就是流程的请求 ID。员工选定后，Duaer 通过 e-cology 9 的接口，以本人身份提交或退回这条流程，并把卡片上写的意见作为签字意见。

- 先请泛微为 Duaer 发一个 appid（在 ECOLOGY_BIZ_EC 里加一行），并在 weaver_session_filter.properties 的 unchecksessionurl 里放开 /api/ec/dev/auth/regist 和 /api/ec/dev/auth/applytoken。
- 点「添加泛微 e-cology」，填 e-cology 地址和 appid 后保存；Duaer 这时去 e-cology 注册，失败会说明原因。
- 在卡片规则里给每个选项选「同意」（提交）「拒绝」（退回）或「不回写」。
- 在「成员账号」里填各人在 e-cology 里的人员 ID。没有账号的人选定时会被拦下，Duaer 不会去调用 e-cology。
- e-cology 不接受时（比如没有权限、流程已经不在这个人手里），卡片回到待处理，写着 e-cology 返回的原因。一次没有回应、重试时又被拒绝的，卡片会提示第一次可能已经成功，请在 e-cology 里看一下。

## 金蝶云星空

卡片的事项编号是所选表单里的单据编号；来自金蝶云星空数据源的卡片，就是采购订单或销售订单的编号。员工选定后，Duaer 通过凭证里的第三方应用，以这个人的金蝶用户名登录，提交、审核或反审核这张单据，金蝶里记下的操作人是本人。

- 先在凭证里添加金蝶云星空凭证，它的第三方应用要允许以其他用户登录。
- 点「添加金蝶云星空」，选凭证，填表单 ID（默认 PUR_PurchaseOrder，销售订单是 SAL_SaleOrder）。
- 在卡片规则里给每个选项选「提交」「审核」「反审核」或「不回写」。这几个操作不带意见，卡片上写的意见只留在 Duaer。
- 在「成员账号」里填各人的金蝶用户名。没有账号的人选定时会被拦下，Duaer 不会去调用金蝶。
- Duaer 先看单据状态：已经是要的状态就算同步了，不会再做一遍；状态不允许（比如还没提交就审核）、金蝶拒绝或登录失败时，卡片回到待处理，写着原因。

## Webhook

要接其他系统，或者交给你们自己的中间件处理，用 Webhook：Duaer 把每个决定用 POST 发到你填的「地址」。

- 内容是 JSON：event（card.decided；测试时是 ping）、key、attempt、decidedAt、card（projectId、id、ruleId、caseId 事项编号、title、link）、decision（choice、label、comment、values）、person（email、account）。
- 签名：请求头 X-Duaer-Signature 的值是 sha256= 加上用「签名密钥」对原始请求体做 HMAC SHA-256 得到的十六进制串，收到后先验签。签名密钥至少 16 个字符，保存后不再显示，编辑时留空就保持不变。
- 同一张卡片每次重试的 key 都一样（请求头 X-Duaer-Delivery 也是它），收到重复的可以直接忽略。
- 返回 2xx 算已同步；返回 4xx 算不接受，卡片退回并写明原因，原因取返回 JSON 里的 message 或 error；返回 5xx、408、429，或 10 秒内没有响应，会重试。
- 「账号所在系统」可以不填；填了（例如 weaverApproval），每次会带上这个人在该系统里的账号，没有账号的人选定时会被拦下。
- 点「测试」会发一次 event 为 ping 的请求，页面上显示「测试通过」或没有通过的原因。

## 先回写，再改 Duaer

回写的卡片，员工选定后先显示「正在同步到」目标名。对方系统接受了，Duaer 才改自己的事项状态、做后续的事；不接受时卡片回到待处理，事项状态不变。

没有响应时，1 分钟后、5 分钟后各再发一次，一共 3 次，都失败就退回卡片。
## Questions

### 工作流程推的卡片能回写吗？

回写按卡片规则设置。工作流程推的卡片，员工选定后工作流程会收到选项和意见，在后面接一个节点调用对方系统就行。

### 回写没有成功的卡片怎么办？

卡片回到员工的待处理里，写着原因。把原因处理好（例如给飞书应用开通审批权限、给成员填上账号）后，员工重新选一次。

### Duaer 会直接改我们 ERP 的数据库吗？

不会。Duaer 读取有些系统时直接读数据库，回写只通过对方系统的接口或你们的 Webhook，不写对方的数据库。

## 相关

- [让员工在 Duaer 员工端处理自己的事](https://doc.duaer.com/zh/organizations/employee-portal.md)
- [在 Duaer 里用任务表给员工派活](https://doc.duaer.com/zh/build/duaer-tasks.md)
- [在 Duaer 里看流程发现和 SOP 符合度](https://doc.duaer.com/zh/build/process-findings.md)
- [在 Duaer 里添加流程数据来源](https://doc.duaer.com/zh/build/process-sources.md)

