开发者中心
首页
文档
社区
工具
第三方应用开发
快速入门 服务端API 客户端API 运营规范 附录 更新日志 联系我们
第三方应用开发 服务端API OA 审批 获取审批申请详情
获取审批申请详情

服务商可通过第三方应用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具体使用请参考：文档-获取临时素材

附录：各控件apply_data/contents/value参数介绍

附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拉取审批申请详情内部接口失败
上一篇
批量获取审批单号
下一篇
获取企业假期管理配置