企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端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_tokenstring调用接口凭证
    journaluuidstring-
    不多于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
                }
            ]
        }
    }

    参数说明:

    参数类型说明
    errcodeint32返回码
    errmsgstring错误码描述
    infoobj汇报详情
    info.journal_uuidstring汇报记录id
    info.template_namestring汇报表单名称
    info.template_idstring汇报表单id
    info.report_timeint32汇报时间
    info.submitterobj汇报提交者
    info.submitter.useridstring汇报用户id
    info.receiversobj[]汇报接收对象
    info.receivers.useridstring接收用户id
    info.readed_receiversobj[]已读用户
    info.readed_receivers.useridstring已读用户id
    info.apply_dataobj表单数据
    info.apply_data.contentsobj[]表单字段列表
    info.apply_data.contents.controlstring控件类型:Text-文本;Textarea-多行文本;Number-数字;Money-金额;Date-日期/日期+时间;Selector-单选/多选;;Contact-成员/部门;Tips-说明文字;File-附件;Table-明细;DateRange-时长;Doc-文档;WedriveFile-微盘附件
    info.apply_data.contents.idstring控件id
    info.apply_data.contents.titleobj控件名称 ,若配置了多语言则会包含中英文的控件名称
    info.apply_data.contents.valueobj控件值 ,包含了申请人在各种类型控件中输入的值,不同控件有不同的值,具体说明详见附录
    info.sys_journal_datastring“汇报”模板数据,内容为富文本。“汇报”模板是一个特殊模板其表单不在apply_data中返回
    info.commentsobj[]评论
    info.comments.commentiduint64评论id
    info.comments.tocommentiduint64评论回复id
    info.comments.comment_userinfoobj评论用户
    info.comments.comment_userinfo.useridstring评论用户id
    info.comments.contentstring评论内容
    info.comments.comment_timeuint32评论时间

    附录:各控件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接口内部失败
    上一篇批量获取汇报记录单号
    下一篇获取汇报统计数据
      本节内容
    服务端API
    基础
    连接微信
    办公
    会议
    会议统计管理
    客户端API
    小程序
    基础
    连接微信
    办公
    WECOM-JSSDK
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们