服务商可通过第三方应用Secret调用本接口,根据审批单号查询企业微信“审批应用”中,由第三方应用添加模板所提交的审批申请详情。
请求方式:POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/oa/getapprovaldetail?access_token=ACCESS_TOKEN
请求示例:
{
"sp_no" : 201909270001
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证。必须使用第三方应用accesstoken获取,获取方式参考:文档-获取access_token |
sp_no | 是 | 审批单编号。 |
接口频率限制 600次/分钟
返回结果 :
{
"errcode": 0,
"errmsg": "ok",
"info": {
"sp_no": "201909270002",
"sp_name": "全字段",
"sp_status": 1,
"template_id": "Bs5KJ2NT4ncf4ZygaE8MB3779yUW8nsMaJd3mmE9v",
"apply_time": 1569584428,
"applyer": {
"userid": "WuJunJie",
"partyid": "2"
},
"sp_record": [
{
"sp_status": 1,
"approverattr": 1,
"details": [
{
"approver": {
"userid": "WuJunJie"
},
"speech": "",
"sp_status": 1,
"sptime": 0,
"media_id": []
},
{
"approver": {
"userid": "WangXiaoMing"
},
"speech": "",
"sp_status": 1,
"sptime": 0,
"media_id": []
}
]
}
],
"notifyer": [
{
"userid": "LiuXiaoGang"
}
],
"apply_data": {
"contents": [
{
"control": "Text",
"id": "Text-15111111111",
"title": [
{
"text": "文本控件",
"lang": "zh_CN"
}
],
"value": {
"text": "文本填写的内容",
"tips": [],
"members": [],
"departments": [],
"files": [],
"children": [],
"stat_field": []
}
}
]
},
"comments": [
{
"commentUserInfo": {
"userid": "WuJunJie"
},
"commenttime": 1569584111,
"commentcontent": "这是备注信息",
"commentid": "6741314136717778040",
"media_id": [
"WWCISP_Xa1dXIyC9VC2vGTXyBjUXh4GQ31G-a7jilEjFjkYBfncSJv0kM1cZAIXULWbbtosVqA7hprZIUkl4GP0DYZKDrIay9vCzeQelmmHiczwfn80v51EtuNouzBhUBTWo9oQIIzsSftjaVmd4EC_dj5-rayfDl6yIIRdoUs1V_Gz6Pi3yH37ELOgLNAPYUSJpA6V190Xunl7b0s5K5XC9c7eX5vlJek38rB_a2K-kMFMiM1mHDqnltoPa_NT9QynXuHi"
]
}
]
}
}
参数说明:
参数 | 说明 |
---|---|
sp_no | 审批编号 |
sp_name | 审批申请类型名称(审批模板名称) |
sp_status | 申请单状态:1-审批中;2-已通过;3-已驳回;4-已撤销;6-通过后撤销;7-已删除;10-已支付 |
template_id | 审批模板id。可在“获取审批申请详情”、“审批状态变化回调通知”中获得,也可在审批模板的模板编辑页面链接中获得。 |
apply_time | 审批申请提交时间,Unix时间戳 |
applyer | 申请人信息 |
└ userid | 申请人userid |
└ partyid | 申请人所在部门id |
sp_record | 审批流程信息,可能有多个审批节点。 |
└ sp_status | 审批节点状态:1-审批中;2-已同意;3-已驳回;4-已转审; 11-已退回 |
└ approverattr | 节点审批方式:1-或签;2-会签 |
└ details | 审批节点详情,一个审批节点有多个审批人 |
└ └ approver | 分支审批人 |
└ └ └ userid | 分支审批人userid |
└ └ speech | 审批意见 |
└ └ sp_status | 分支审批人审批状态:1-审批中;2-已同意;3-已驳回;4-已转审;11-已退回 |
└ └ sptime | 节点分支审批人审批操作时间戳,0表示未操作 |
└ └ media_id | 节点分支审批人审批意见附件,media_id具体使用请参考:文档-获取临时素材 |
notifyer | 抄送信息,可能有多个抄送节点 |
└ userid | 节点抄送人userid |
apply_data | 审批申请数据 |
└ contents | 审批申请详情,由多个表单控件及其内容组成 |
└ └ control | 控件类型:Text-文本;Textarea-多行文本;Number-数字;Money-金额;Date-日期/日期+时间;Selector-单选/多选;;Contact-成员/部门;Tips-说明文字;File-附件;Table-明细;Attendance-假勤;Vacation-请假;PunchCorrection-补卡;DateRange-时长 |
└ └ id | 控件id |
└ └ title | 控件名称 ,若配置了多语言则会包含中英文的控件名称 |
└ └ value | 控件值 ,包含了申请人在各种类型控件中输入的值,不同控件有不同的值,具体说明详见附录 |
comments | 审批申请备注信息,可能有多个备注节点 |
└ commentUserInfo | 备注人信息 |
└ └ userid | 备注人userid |
└ commenttime | 备注提交时间戳,Unix时间戳 |
└ commentcontent | 备注文本内容 |
└ commentid | 备注id |
└ media_id | 备注附件id,可能有多个,media_id具体使用请参考:文档-获取临时素材 |
附1 文本/多行文本控件(control参数为Text或Textarea)
{
"text": "文本填写的内容"
}
参数 | 说明 |
---|---|
text | 文本内容,即申请人在此控件填写的文本内容 |
附2 数字控件(control参数为Number)
{
"new_number": "700"
}
参数 | 说明 |
---|---|
new_number | 数字内容,即申请人在此控件填写的数字内容 |
附3 金额控件(control参数为Money)
{
"new_money": "700"
}
参数 | 说明 |
---|---|
new_money | 金额内容,即申请人在此控件填写的金额内容 |
附4 日期/日期+时间控件(control参数为Date)
{
"date": {
"type": "day",
"s_timestamp": "1569859200"
}
}
参数 | 说明 |
---|---|
date | 日期/日期+时间内容,即申请人在此控件选择的 日期/日期+时间内容 |
└ type | 时间展示类型:day-日期;hour-日期+时间 |
└ s_timestamp | 时间戳,字符串类型 |
附5 单选/多选控件(control参数为Selector)
{
"selector": {
"type": "multi",
"options": [
{
"key": "option-15111111111",
"value": [
{
"text": "选项1",
"lang": "zh_CN"
}
]
},
{
"key": "option-15222222222",
"value": [
{
"text": "选项2",
"lang": "zh_CN"
}
]
}
]
}
}
参数 | 说明 |
---|---|
selector | 选择内容,即申请人在此控件选择的选项内容 |
└ type | 选择类型:single-单选;multi-多选 |
└ options | 申请人所选择的选项,多选情况下可能有多个(仅包含申请人说选择的选项,并非所有选项,若需要了解所有选项,需使用“获取审批模板详情”接口) |
└ └ key | 选项key,选项的唯一id,可通过“获取审批模板详情”接口获得 |
└ └ value | 选项值,若配置了多语言则会包含中英文的选项值 |
附6 成员控件(control参数为Contact,且value参数为members)
{
"members": [
{
"userid": "WuJunJie",
"name": "Jackie"
},
{
"userid": "WangXiaoMing"
"name": "Tom"
}
]
}
参数 | 说明 |
---|---|
members | 成员内容,即申请人在此控件选择的成员,多选模式下可能有多个 |
└ userid | 成员的userid |
└ name | 成员名 |
附7 部门控件(control参数为Contact,且value参数为departments)
{
"departments": [
{
"openapi_id": "2",
"name": "销售部",
},
{
"openapi_id": "3",
"name": "生产部",
}
]
}
参数 | 说明 |
---|---|
departments | 部门内容,即申请人在此控件选择的部门,多选模式下可能有多个 |
└ openapi_id | 部门id |
└ name | 部门名 |
附8 说明文字控件(control参数为Tips)
此控件不显示在审批详情中,故value为空
附9 附件控件(control参数为File)
{
"files": [
{
"file_id": "WWCISP_v2z8qZENw2qwSiNroVKykbxxMXvmI1lELzG-fo25Y9n1duozezKEu6zSIvOHPCd9_8s934AJncRz5f9G4E_nCQonUHLdiAnCLjfZQQwVaiG7krKzyGB1MpYa9ZVkk0gQ7P8HvO_SOdwzLwpyUZ3Tm2ApyoO_78nTM-iEkf_TILqXuYxKd7ByYL34wMA9Czf6Iy151tHbcYNvbNZZHTnL4UMQdohJ_MPYA2Wz00IebZb3_UuIk5MdJSH_IKlZn9Ms5"
},
{
"file_id": "WWCISP_gZ3BMg5hwI1Adi16NwzJgpi9zp6QQjMdYcuemVWBeHnmMK3QJOYiIIkHvRIh0ysZcAo6gJp069o5tx7qxVzin1Q9LKswff624E1qCCmt088ISBVPScoqEiG4YTI_Kltrqn7b0wvMTudd9lIE3ywgHatPRWKxsHNsSxEY_FuaFWlGHzxcYKNq_LIfVBXZGji-C5bXp23MwpTcCXYfWPfSEpEeXW5c5sQscY_MeW5uc0gITpeFKFXARXmKC62_u7Ln"
}
]
}
参数 | 说明 |
---|---|
files | 文件内容,即申请人在此控件上传的文件内容,可能有多个 |
└ file_id | 文件的media_id,具体使用请参考:文档-获取临时素材 |
附10 明细控件(control参数为Table)
{
"children": [
{
"list": [
{
"control": "Text",
"id": "Text-15111111111",
"title": [
{
"text": "明细内文本控件",
"lang": "zh_CN"
}
],
"value": {
"text": "明细文本"
}
}
]
}
]
}
参数 | 说明 |
---|---|
children | 明细内容,一个明细控件可能包含多个子明细 |
└ list | 子明细列表,包含了申请人在子明细的所有子控件中填写的内容,子控件的数据接口同一般控件 |
附11 假勤组件-请假组件(control参数为Vacation)
{
"vacation": {
"selector": {
"type": "single",
"options": [
{
"key": "3",
"value": [
{
"text": "病假",
"lang": "zh_CN"
}
]
}
],
"exp_type": 0
},
"attendance": {
"date_range": {
"type": "hour",
"new_begin": 1568077200,
"new_end": 1568368800,
"new_duration": 291600
},
"type": 1
}
}
}
参数 | 说明 |
---|---|
vacation | 请假内容,即申请人在此组件内选择的请假信息 |
└ selector | 请假类型,所选选项与假期管理关联,为假期管理中的假期类型 |
└ └ type | 选择类型:single-单选;multi-多选,在假勤控件中固定为单选 |
└ └ options | 用户所选选项 |
└ └ └ key | 选项key,选项的唯一id,可通过“获取审批模板详情”接口获得 |
└ └ └ value | 选项值,若配置了多语言则会包含中英文的选项值 |
└ attendance | 假勤组件 |
└ └ date_range | 假勤组件时间选择范围 |
└ └ └ type | 时间展示类型:day-日期;hour-日期+时间 |
└ └ └ new_begin | 开始时间 |
└ └ └ new_end | 结束时间 |
└ └ └ new_duration | 请假时长 |
└ └ type | 假勤组件类型:1-请假;2-补卡;3-出差;4-外出;5-加班 |
附12 假勤组件-出差/外出/加班组件(control参数为Attendance)
{
"attendance": {
"date_range": {
"type": "halfday",
"new_begin": 1570550400,
"new_end": 1570593600,
"new_duration": 86400
},
"type": 4
}
}
参数 | 说明 |
---|---|
attendance | 假勤内容,即申请人在此组件内选择的假勤信息 |
└ date_range | 假勤组件时间选择范围 |
└ └ type | 时间展示类型:day-日期;hour-日期+时间 |
└ └ new_begin | 开始时间,unix时间戳 |
└ └ new_end | 结束时间,unix时间戳 |
└ └ new_duration | 出差/外出/加时长,单位秒 |
└ type | 假勤组件类型:1-请假;2-补卡;3-出差;4-外出;5-加班 |
附13 补卡组件(control参数为PunchCorrection)
{
"punch_correction": {
"state":"迟到",
"time":1570550400
}
}
参数 | 说明 |
---|---|
punch_correction | 补卡信息 |
└ state | 异常状态说明 |
└ time | 补卡时间,Unix时间戳 |
附14 时长组件(control参数为DateRange)
{
"date_range": {
"type": "halfday",
"new_begin": 1570550400,
"new_end": 1570593600,
"new_duration": 86400
}
}
参数 | 说明 |
---|---|
date_range | 时长组件 |
└ type | 时间展示类型:day-日期;hour-日期+时间 |
└ new_begin | 开始时间,unix时间戳 |
└ new_end | 结束时间,unix时间戳 |
└ new_duration | 时长范围, 单位秒 |
错误码 | 说明 |
---|---|
301055 | 无审批应用数据拉取权限 |
301025 | 请求参数错误 |
301026 | 拉取审批申请详情内部接口失败 |