钉钉开发文档

发起审批实例

更新时间: 2019-2-13

企业或ISV在现有业务系统或E应用上填写审批表单内容,然后使用此接口可发起一个审批实例,运用钉钉的审批流程进行跟踪管理。

请求方式:POST(HTTPS)
请求地址https://oapi.dingtalk.com/topapi/processinstance/create?access_token=ACCESS_TOKEN
参数说明

名称 类型 是否必须 示例值 描述
agent_id Number 可选 41605932 企业应用标识(ISV调用必须设置)
process_code String 必须 PROC-EF6YJL35 审批流的唯一码,process_code就在审批流编辑的页面URL中
originator_user_id String 必须 manager432 审批实例发起人的userid
dept_id Number 必须 100 发起人所在的部门,如果发起人属于根部门,传-1
approvers String 必须 zhangsan, lisi 审批人userid列表,最大列表长度:20。多个审批人用逗号分隔,按传入的顺序依次审批
cc_list String 可选 zhangsan, lisi 抄送人userid列表,最大列表长度:20。多个抄送人用逗号分隔
cc_position String 可选 START 抄送时间,分为(START, FINISH, START_FINISH)
form_component_values List 必须 审批流表单参数,最大列表长度:20。
└name String 必须 请假类型 表单每一栏的名称
└value String 必须 事假 表单每一栏的值
└ext_value String 可选 总天数:1 扩展值

SDK请求示例(JAVA)

DefaultDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/processinstance/create");
OapiProcessinstanceCreateRequest request = new OapiProcessinstanceCreateRequest();
request.setAgentId(41605932L);
request.setProcessCode("PROC-BY6LI83V-4R8T1CHNUX58O0Z6C55M3-DTQJJGEJ-1");
List<OapiProcessinstanceCreateRequest.FormComponentValueVo> formComponentValues = new ArrayList<OapiProcessinstanceCreateRequest.FormComponentValueVo>();
OapiProcessinstanceCreateRequest.FormComponentValueVo vo = new OapiProcessinstanceCreateRequest.FormComponentValueVo();
vo.setName("企业名称");
vo.setValue("test");
formComponentValues.add(vo);
request.setFormComponentValues(formComponentValues);
request.setApprovers("userid1,userid2");
request.setOriginatorUserId("userid1");
request.setDeptId(-1L);
request.setCcList("userid1,userid2");
request.setCcPosition("START_FINISH");
OapiProcessinstanceCreateResponse response = client.execute(request,accessToken);

返回结果

{
    "errcode":0,
    "errmsg":"ok",
    "process_instance_id":"12345"
}
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
process_instance_id 审批实例id
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!