企业内部开发 服务端API OA 汇报 获取汇报统计数据
获取汇报统计数据

企业可通过access_token调用本接口,根据汇报表单id查询企业微信“汇报应用”的汇报统计汇总信息。该接口只能拉取到已经汇总的统计数据,对于尚未完成汇总的周期不会返回。

 

请求方式:POST(HTTPS)

请求地址:https://qyapi.weixin.qq.com/cgi-bin/oa/journal/get_stat_list?access_token=ACCESS_TOKEN

请求示例

{
    "template_id": "3TmALk1ogfgKiQE3e3jRwnTUhMTh8vca1N8zUVNUx",
    "starttime": 1604160000,
    "endtime": 1606363092
}

参数说明:

参数必须类型说明
access_tokenstring调用接口凭证
template_idstring汇报表单id,不多于256字节
starttimeuint64开始时间
endtimeuint64结束时间,时间区间最大长度为一年

 

权限说明: (无特殊权限)

返回结果:

{
    "errcode": 0,
    "errmsg": "ok",
    "stat_list": [
        {
            "template_id": "3TmALk1ogfgKiQE3e3jRwnTUhMTh8vca1N8zUVNU",
            "template_name": "日报",
            "report_range": {
                "user_list": [
                    {
                        "userid": "user1"
                    }
                ],
                "party_list": [
                    {
                        "open_partyid": "1"
                    }
                ],
                "tag_list": []
            },
            "white_range": {
                "user_list": [],
                "party_list": [],
                "tag_list": []
            },
            "receivers": {
                "user_list": [
                    {
                        "userid": "user3"
                    }
                ],
                "tag_list": [],
                "leader_list": []
            },
            "cycle_begin_time": 1606147200,
            "cycle_end_time": 1606233600,
            "stat_begin_time": 1606147200,
            "stat_end_time": 1606230000,
            "report_list": [
                {
                    "user": {
                        "userid": "user2"
                    },
                    "itemlist": [
                        {
                            "journaluuid": "4U9abSUrpY78VNxeNNv3J5TW5e9VLj8cDymH9py1Efpuj5X8QCDQx3stKr69pia3UL8auRjrCMsiRjgzL8mvKnff",
                            "reporttime": 1606218548,
                            "flag": 0
                        }
                    ]
                }
            ],
            "unreport_list": [
                {
                    "user": {
                        "userid": "user1"
                    },
                    "itemlist": [
                        {
                            "journaluuid": "",
                            "reporttime": 1606147200,
                            "flag": 0
                        }
                    ]
                },
                {
                    "user": {
                        "userid": "user3"
                    },
                    "itemlist": [
                        {
                            "journaluuid": "",
                            "reporttime": 1606147200,
                            "flag": 0
                        }
                    ]
                }
            ],
            "report_type": 2
        }
    ]
}

参数说明:

参数类型说明
errcodeint32返回码
errmsgstring错误码描述
stat_listobj[]统计数据列表
stat_list.template_idstring汇报表单id
stat_list.template_namestring汇报表单名称
stat_list.report_rangeobj汇报人员范围
stat_list.report_range.user_listobj[]指定人集合
stat_list.report_range.user_list.useridstring用户id
stat_list.report_range.party_listobj[]指定部门集合
stat_list.report_range.party_list.open_partyidstring部门id
stat_list.report_range.tag_listobj[]指定标签集合
stat_list.report_range.tag_list.open_tagidstring标签id
stat_list.white_rangeobj白名单集合
stat_list.white_range.user_listobj[]指定人集合
stat_list.white_range.user_list.useridstring用户id
stat_list.white_range.party_listobj[]指定部门集合
stat_list.white_range.party_list.open_partyidstring部门id
stat_list.white_range.tag_listobj[]指定标签集合
stat_list.white_range.tag_list.open_tagidstring标签id
stat_list.receiversobj固定汇报对象
stat_list.receivers.user_listobj[]指定人集合
stat_list.receivers.user_list.useridstring用户id
stat_list.receivers.tag_listobj[]指定标签集合
stat_list.receivers.tag_list.open_tagidstring标签id
stat_list.receivers.leader_listobj[]指定上级集合
stat_list.receivers.leader_list.leveluint64上级级别从1开始
stat_list.cycle_begin_timeuint64周期开始时间
stat_list.cycle_end_timeuint64周期结束时间
stat_list.stat_begin_timeuint64统计开始时间
stat_list.stat_end_timeuint64统计结束时间
stat_list.report_listobj[]已汇报用户列表
stat_list.report_list.userobj汇报用户
stat_list.report_list.user.useridstring用户id
stat_list.report_list.itemlistobj[]汇报记录列表
stat_list.report_list.itemlist.journaluuidstring汇报记录id
stat_list.report_list.itemlist.reporttimeuint32汇报时间
stat_list.report_list.itemlist.flaguint32是否迟交,1迟交;0非迟交
stat_list.unreport_listobj[]未汇报用户列表
stat_list.unreport_list.userobj未汇报用户
stat_list.unreport_list.user.useridstring用户id
stat_list.report_typeuint32汇报方式:2按日汇报; 3按周汇报; 4按月汇报

 

错误说明

错误码说明
301065无汇报应用数据拉取权限
301066请求参数错误
301067接口内部失败
上一篇
获取汇报记录详情
下一篇
审批流程引擎