开发者中心

首页

教程

接口

社区

工具

企业内部开发

快速入门服务端API 客户端API 附录更新日志联系我们

企业内部开发服务端API 汇报获取汇报记录详情

获取汇报记录详情

最后更新：2023/11/30

概述

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

附1 文本/多行文本控件（control参数为Text或Textarea）

附2 数字控件（control参数为Number）

附3 金额控件（control参数为Money）

附4 日期/日期+时间控件（control参数为Date）

附5 单选/多选控件（control参数为Selector）

附6 成员控件（control参数为Contact，且value参数为members）

附7 部门控件（control参数为Contact，且value参数为departments）

附8 说明文字控件（control参数为Tips）

附9 附件控件（control参数为File）

附10 明细控件（control参数为Table）

附11 时长组件（control参数为DateRange）

附12 位置控件（control参数为Location）

附13 公式控件（control参数为Formula）

附14 学生控件（control参数为SchoolContact，且value参数为students）

附15 班级控件（control参数为SchoolContact，且value参数为classes）

附16 文档控件（control参数为Doc）

附17 微盘附件控件（control参数为WedriveFile）

概述

根据汇报记录单号查询企业微信“汇报应用”的汇报详情。

请求方式:POST(HTTPS)

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

请求示例

{
    "journaluuid": "41eJejN57EJNzr8HrZfmKyCN7xwKw1qRxCZUxCVuo9fsWVMSKac6nk4q8rARTDaVNdx"
}

参数说明:

参数	必须	类型	说明
access_token	是	string	调用接口凭证
journaluuid	是	string	- 不多于256字节

权限说明:
调用的应用需要满足如下的权限：

应用类型	权限要求
自建应用	需要配置到「汇报 - 可调用接口的应用」中
代开发应用	暂不支持
第三方应用	暂不支持

注：从2023年12月1日0点起，不再支持通过系统应用secret调用接口，存量企业暂不受影响查看详情

返回结果:

{
    "errcode": 0,
    "errmsg": "ok",
    "info": {
        "journal_uuid": "41eJejN57EJNzr8HrZfmKyJZ6E3W9NQbr94x6QEA6MwvK2sVqFQNWy4BaF4Ptyzk26",
        "template_name": "今日工作汇报",
        "report_time": 1606365591,
        "submitter": {
            "userid": "LiQiJun"
        },
        "receivers": [
            {
                "userid": "LiQiJun"
            }
        ],
        "readed_receivers": [
            {
                "userid": "LiQiJun"
            }
        ],
        "apply_data": {
            "contents": [
                {
                    "control": "Text",
                    "id": "Text-1606365477123",
                    "title": [
                        {
                            "text": "工作内容"
                        }
                    ],
                    "value": {
                        "text": "今日暂无工作",
                        "tips": [],
                        "members": [],
                        "departments": [],
                        "files": [],
                        "children": [],
                        "stat_field": [],
                        "sum_field": [],
                        "related_approval": [],
                        "students": [],
                        "classes": []
                    }
                }
            ]
        },
        "comments": [
            {
                "commentid": 6899287783354824502,
                "tocommentid": 0,
                "comment_userinfo": {
                    "userid": "LiYiBo"
                },
                "content": "加油",
                "comment_time": 1606365615
            }
        ]
    }
}

参数说明:

参数	类型	说明
errcode	int32	返回码
errmsg	string	错误码描述
info	obj	汇报详情
info.journal_uuid	string	汇报记录id
info.template_name	string	汇报表单名称
info.template_id	string	汇报表单id
info.report_time	int32	汇报时间
info.submitter	obj	汇报提交者
info.submitter.userid	string	汇报用户id
info.receivers	obj[]	汇报接收对象
info.receivers.userid	string	接收用户id
info.readed_receivers	obj[]	已读用户
info.readed_receivers.userid	string	已读用户id
info.apply_data	obj	表单数据
info.apply_data.contents	obj[]	表单字段列表
info.apply_data.contents.control	string	控件类型：Text-文本；Textarea-多行文本；Number-数字；Money-金额；Date-日期/日期+时间；Selector-单选/多选；；Contact-成员/部门；Tips-说明文字；File-附件；Table-明细；DateRange-时长；Doc-文档；WedriveFile-微盘附件
info.apply_data.contents.id	string	控件id
info.apply_data.contents.title	obj	控件名称，若配置了多语言则会包含中英文的控件名称
info.apply_data.contents.value	obj	控件值，包含了申请人在各种类型控件中输入的值，不同控件有不同的值，具体说明详见附录
info.sys_journal_data	string	“汇报”模板数据，内容为富文本。“汇报”模板是一个特殊模板其表单不在apply_data中返回
info.comments	obj[]	评论
info.comments.commentid	uint64	评论id
info.comments.tocommentid	uint64	评论回复id
info.comments.comment_userinfo	obj	评论用户
info.comments.comment_userinfo.userid	string	评论用户id
info.comments.content	string	评论内容
info.comments.comment_time	uint32	评论时间

附录：各控件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-日期+时间；month-月份；minute-时分
└ s_timestamp	时间戳，字符串类型。若type为minute，则为从0点的偏移秒数

附5 单选/多选控件（control参数为Selector）

{
    "selector": {
        "type": "multi",
        "options": [
            {
                "key": "option-15111111111",
                "value": [
                    {
                        "text": "选项1"
                    }
                ]
            },
            {
                "key": "option-15222222222",
                "value": [
                    {
                        "text": "选项2"
                    }
                ]
            }
        ]
    }
}

参数	说明
selector	选择内容，即申请人在此控件选择的选项内容
└ type	选择类型：single-单选；multi-多选
└ options	申请人所选择的选项，多选情况下可能有多个（仅包含申请人所选择的选项，并非所有选项，若需要了解所有选项，需使用“获取审批模板详情”接口）
└ └ key	选项key，选项的唯一id，可通过“获取审批模板详情”接口获得（2022-08-25后新创建的企业，不再支持关联审批模板）
└ └ value	选项值

附6 成员控件（control参数为Contact，且value参数为members）

{
    "members": [
        {
            "userid": "WuJunJie"
        },
        {
            "userid": "WangXiaoMing"
        }
    ]
}

参数	说明
members	成员内容，即申请人在此控件选择的成员，多选模式下可能有多个
└ userid	成员的userid

附7 部门控件（control参数为Contact，且value参数为departments）

{
    "departments": [
        {
            "openapi_id": "2"
        },
        {
            "openapi_id": "3"
        }
    ]
}

参数	说明
departments	部门内容，即申请人在此控件选择的部门，多选模式下可能有多个
└ openapi_id	部门id

附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": "明细内文本控件"
                        }
                    ],
                    "value": {
                        "text": "明细文本"
                    }
                }
            ]
        }
    ]
}

参数	说明
children	明细内容，一个明细控件可能包含多个子明细
└ list	子明细列表，包含了申请人在子明细的所有子控件中填写的内容，子控件的数据接口同一般控件

附11 时长组件（control参数为DateRange）

{
    "date_range": {
		"type": "halfday",
        "new_begin": 1570550400,
        "new_end": 1570593600,
        "new_duration": 86400
    }
}

参数	说明
date_range	时长组件
└ type	时间展示类型：halfday-日期；hour-日期+时间
└ new_begin	开始时间,unix时间戳
└ new_end	结束时间，unix时间戳
└ new_duration	时长范围，单位秒

附12 位置控件（control参数为Location）

{
    "location": {
		"latitude": "30.547239",
		"longitude": "104.063291",
		"title": "腾讯科技(成都)有限公司(腾讯成都大厦)",
		"address": "四川省成都市武侯区天府三街198号腾讯成都大厦A座",
		"time": 1605690460
	}
}

参数	说明
latitude	纬度，精确到6位小数
longitude	经度，精确到6位小数
title	地点标题
address	地点详情地址
time	选择地点的时间（已废弃）

附13 公式控件（control参数为Formula）

{
   "formula": {
		"value": "5.0"
	}
}

参数	说明
value	公式的值

附14 学生控件（control参数为SchoolContact，且value参数为students）

{
    "students": [
        {
            "name": "Jackie"
        },
		{
			"name": "Tom"
        }
    ]
}

参数	说明
students	学生内容，即申请人在此控件选择的学生，多选模式下可能有多个
└ name	学生名

附15 班级控件（control参数为SchoolContact，且value参数为classes）

{
    "classes": [
        {
            "name": "1班",
        },
        {
            "name": "2班",
        }
    ]
}

参数	说明
classes	班级内容，即申请人在此控件选择的班级，多选模式下可能有多个
└ name	班级名

附16 文档控件（control参数为Doc）

{
    "docs": [
        {
            "docid": "xxx_j",
            "doc_url": "https://doc.weixin.qq.com/doc/xxx_j"
        }
    ]
}

参数	说明
docs	文档内容
└ docid	文档的docid
└ doc_url	文档的访问链接注：企业微信4.0.20版本后，不会有新增的文档控件数据。开发者可通过此url进一步查看/导出文档

附17 微盘附件控件（control参数为WedriveFile）

{
    "wedrive_files": [
        {
            "fileid": "xxxx"
        }
    ]
}

参数	说明
wedrive_files	微盘文件内容
└ fileid	微盘的fileid，可通过下载微盘文件接口下载文件

错误说明：

错误码	说明
301065	无汇报应用数据拉取权限
301066	请求参数错误
301067	接口内部失败

批量获取汇报记录单号

获取汇报统计数据

本节内容

概述
附录：各控件apply_data/contents/value参数介绍
附1 文本/多行文本控件（control参数为Text或Textarea）
附2 数字控件（control参数为Number）
附3 金额控件（control参数为Money）
附4 日期/日期+时间控件（control参数为Date）
附5 单选/多选控件（control参数为Selector）
附6 成员控件（control参数为Contact，且value参数为members）
附7 部门控件（control参数为Contact，且value参数为departments）
附8 说明文字控件（control参数为Tips）
附9 附件控件（control参数为File）
附10 明细控件（control参数为Table）
附11 时长组件（control参数为DateRange）
附12 位置控件（control参数为Location）
附13 公式控件（control参数为Formula）
附14 学生控件（control参数为SchoolContact，且value参数为students）
附15 班级控件（control参数为SchoolContact，且value参数为classes）
附16 文档控件（control参数为Doc）
附17 微盘附件控件（control参数为WedriveFile）