正文

上周帮一家制造企业做钉钉对接，他们的痛点很典型：生产审批在钉钉里走，但ERP系统里看不到审批状态，采购人员得在两个系统之间来回切。考勤数据也是，钉钉打了卡但薪资系统还得手动导。钉钉开放平台集成能解决这些问题，但前提是你得搞清楚对接的路径。

审批流程对接：先理清审批流再动代码

钉钉的审批API分两块：审批模板管理和审批实例管理。对接外部系统时，最常见的做法是让钉钉做审批前端，外部系统做审批后端。

具体操作分三步走。第一步，在钉钉管理后台创建审批模板，把审批表单的字段定义好。第二步，通过“获取审批模板详情“接口拿到模板的form_code，这个码后面创建审批实例时要用。第三步，业务系统里触发审批时调“创建审批实例“接口，把业务数据填进表单字段提交。

有个关键细节：审批回调。审批通过或拒绝后，钉钉会推送回调事件到你配置的URL。在回调处理里，根据审批结果更新业务系统的状态。注意设置好回调的超时时间，钉钉要求三秒内响应，超时会重试最多三次。

踩坑提醒：钉钉审批模板里的控件有固定的类型约束，比如金额控件只能填数字，日期控件有格式要求。在业务系统侧做表单校验时，跟钉钉的控件类型保持一致，不然提交会被拒。

考勤数据同步：别用轮询，用回调

考勤数据同步最笨的办法是定时轮询“获取考勤结果“接口，每小时拉一次。数据量大的时候接口响应很慢，而且有延迟。正确做法是用钉钉的考勤事件回调。

钉钉提供了“考勤打卡结束“回调事件，员工打完卡就会触发。在回调处理里，记录打卡时间和员工ID，然后异步调用“获取考勤结果“接口拉详细数据。这样既保证了实时性，又不会因为同步调用拖慢回调响应。

考勤数据写入薪资系统时，建议加一层校验逻辑：比对打卡时间是否在工作日和排班时间内。钉钉的考勤数据是按打卡原始记录存的，迟到早退的判定逻辑需要你的业务系统自己做。

权限管理：给应用最小权限

钉钉开放平台的应用权限粒度比较细，审批和考勤是两套独立的权限组。创建应用时只勾选业务需要的权限，别图省事全选。权限越大，token泄露的风险越高。

多系统对接钉钉时，建议每个系统用独立的应用，不要共用一个。这样某个系统出问题时可以单独禁用，不影响其他系统的正常使用。token刷新机制也要做好，access_token有效期两小时，提前五分钟刷新比较稳妥。