协同审批接口

企业默认没有开通审批接口，如需使用请联系 开通。

1.获取审批类型列表

查询协同审批中的审批类型列表。

请求说明

请求方式：post+application/json 方式

请求路径：https://open.71360.com/cgi/approvalTypeForms/get

参数说明

请求包结构体示例：

{     "corpAccessToken": "CORP_ACCESS_TOKEN",     "corpId": "CORP_ID" }

返回说明

a)正确的Json返回结果示例:

{     "approvalTypeForms": [         {             "approveType": 1,             "name": "普通审批",             "id": "0076E076-2D2B-4392-8365-7982763840C4"         },         {             "approveType": 9,             "name": "加班申请",             "id": "1294EDEA-154F-4F81-8373-ADAA6FBB1DC6"         },         {             "approveType": 4,             "name": "出差申请",             "id": "190FB825-927E-49CA-B594-A153BA0FAADA"         },         {             "approveType": 8,             "name": "差旅报销",             "id": "1EABBFB4-4106-4056-95AC-BAE60CB3176F"         },         {             "approveType": 100,             "name": "内嵌部门和附件展示",             "id": "5012dede1b4547939984f73c74308bb1"         },         {             "approveType": 100,             "name": "固定审批流",             "id": "767f6c06dfa8491e84dcc88c3e4c50c1"         },         {             "approveType": 3,             "name": "普通报销",             "id": "872D6992-EF49-4B88-9F85-2C322671D3B2"         },         {             "approveType": 2,             "name": "请假",             "id": "93EAB3A0-1D5F-49EC-AC4D-743F6C35E2B7"         },         {             "approveType": 100,             "name": "测试审批附件BUG",             "id": "f46385a5e15a428fb457e5494898927f"         }     ],     "errorCode": 0,     "errorMessage": "success" }

b)错误的Json返回示例:

{     "errorCode": 20016,     "errorMessage": "corpAccessToken error" }

2.获取审批列表

查询起始时间段内审批列表，查询时间间隔不超过180天(默认按审批最后更新时间倒序排序)。

接口说明:

请求方式：post+application/json 方式

请求路径：https://open.71360.com/cgi/approval/query

请求参数说明：

请求参数示例：

{      "corpAccessToken":"CORP_ACCESS_TOKEN",      "corpId":"CORP_ID",      "pageSize": 10,    "pageNumber": 1,    "startTime": 1482809339093,    "endTime": 1482809349093,    "approvalFormId":"0076E076-2D2B-4392-8365-7982763840C4" }

返回参数说明：

1)正确的Json返回结果示例:

{     "errorCode": 0,     "errorMessage":  "0",     "approvals":  [         {             "id": 1,             "status": 1         }     ],     totalCount: 1000,     pageSize: 10,     pageNumber: 1  }

3.获取审批详情

根据审批id获取审批详情接口

接口说明:

请求方式：post+application/json 方式

请求路径：https://open.71360.com/cgi/approval/get

请求参数说明：

请求参数示例：

{      "corpAccessToken":"CORP_ACCESS_TOKEN",      "corpId":"CORP_ID",      "approvalId":1 }

返回参数说明：

其中approveType不为100的为系统预设表单，formRecord字段定义如下:

1. 普通报销审批

2. 差旅报销审批

3. 出差申请

4. 折扣申请

5. 借款申请

6. 付款申请

7. 加班申请

8. 请假申请

9.当approveType为100时为自定义表单

其格式为

{     "key1": {          "label": "", // 字段中文描述          "value": "" ,// 字段值          "type":"text"     },     "key2": {         "label": "",         "value": ["", ""], // 多选框的情况         "type":"select_many"    } }

其中type有如下定义: text:普通文本,select_one:单选框，显示时可以当做普通文本处理
select_many:多选框,其value对应数组,file_attachment:附件,其value对象附件的Id(素材Id)
image:图片,其value对象附件的Id(素材Id)

备注: 附件对象说明

10. 审批对象类型列表

a)正确的Json返回结果示例:

{   "approval": {     "approvalId": 71676,     "feed": {       "feedContent": "加班",       "createTime": "2017-01-05 22:22:46",       "lastUpdateTime": "2017-01-05 22:22:46"     },     "visibleDepartmentIds": [       1195     ],     "visibleEmployeeIds": [       "FSUID_442A9447ADD9EB86760B4AF319D187AC",       "FSUID_F7E1595DBD7CE7D0232EBE075CD8E54B"     ],     "approvalTasks": [       {         "taskId": "245d484112044ef5b6b4bafdf8a646ac",         "type": "single",         "state": "in_progress",         "taskMembers": [           {             "state": "in_progress",             "employeeId": "FSUID_442A9447ADD9EB86760B4AF319D187AC"           }         ],         "sequenceNumber": "1"       },       {         "taskId": "67333e3d8a974abf8427d44c5ac20cb5",         "type": "single",         "state": "schedule",         "taskMembers": [           {             "state": "schedule",             "employeeId": "FSUID_F7E1595DBD7CE7D0232EBE075CD8E54B"           }         ],         "sequenceNumber": "2"       }     ],     "formRecord": {       "invoiced": true,       "receiverName": "雷龙",       "companyName": "永辉",       "paymentTime": "2017-01-04 22:25",       "paymentAmount": 12,       "receiverAccount": "ll",       "paymentType": "支付宝"     },     "senderId": "FSUID_68D40E4FE7F461644E37E70B9BD64522",     "status": 1,     "approveType": 6,     "flowType": 1,     "currentTaskId": "245d484112044ef5b6b4bafdf8a646ac",     "approvalFormName": "付款申请",     "approvalFormId": "9A8AF67A-4793-4D8C-AE3D-AA03FB9F80CF"   },   "errorCode": 0,   "errorMessage": "success" }

b)错误的Json返回结果示例:

{     "errorCode": 15002,     "errorMessage":  "illegal parameter"  }

其中预设表单示例返回

1> 差旅报销

"formRecord": {       "details": [         {           "travelType": 4,           "remark": "上搜索",           "startTime": "2000-01-01 00:00",           "endTime": "2000-01-01 00:00",           "travelAmount": 123         },         {           "travelType": 4,           "attachments": [             {               "id": "55cb5a8a-1012-4d51-ab5a-b6100fb37122",               "type": 2,               "name": "我的二维码.jpg"             }           ],           "remark": "搜索",           "startTime": "2000-01-01 00:00",           "endTime": "2000-01-01 00:00",           "travelAmount": 3234         }       ]     },

2> 借款审批

"formRecord": {       "borrowerId": "FSUID_68D40E4FE7F461644E37E70B9BD64522",       "reason": "111",       "amount": 111.11     }

3> 付款审批

"formRecord": {       "invoiced": true,       "receiverName": "雷布斯",       "companyName": "小米",       "paymentTime": "2017-01-04 22:25",       "paymentAmount": 12,       "receiverAccount": "ll",       "paymentType": "支付宝"     }

4> 请假审批

"formRecord": {       "details": [         {           "hours": 8.4,           "leaveType": 1,           "startTime": "2017-01-04 22:15",           "endTime": "2017-01-06 22:15"         },         {           "hours": 12.5,           "leaveType": 2,           "startTime": "2017-01-07 22:15",           "endTime": "2017-01-09 22:15"         }       ]     }

5> 普通报销

"formRecord": {       "details": [         {           "amount": 200,           "attachments": [             {               "id": "55cb5a8a-1012-4d51-ab5a-b6100fb37122",               "type": 2,               "name": "我的二维码.jpg"             }           ],           "remark": "100只笔，50个本",           "title": "办公用品"         }       ]     }

6> 出差审批

"formRecord": {       "approveReason": "出差",       "details": [         {           "endPoint": "武汉",           "daysNumber": 1,           "startPoint": "上海",           "startTime": "2017-01-03 16:45",           "endTime": "2017-01-09 16:45",           "vehicle": 2         }       ],       "approvePrepayments": 222,       "memberIds": [         "FSUID_55E332B8B9637C744CFD5FC89F7FCA57"       ],       "approveBudget": 111     }

7> 折扣审批

"formRecord": {       "amount": 11,       "discountPercent": 11,       "companyName": "百度",       "remark": "备注",       "endTime": "2017-01-03"     }

8> 加班申请

"formRecord": {       "details": [         {           "hours": 12,           "leaveType": 8,           "startTime": "2017-01-04 16:50",           "endTime": "2017-01-09 16:50"         }       ]     }