Name

QQ::weixin::work::corp

DESCRIPTION

FUNCTION

get_join_qrcode(access_token, size_type);

获取加入企业二维码 最后更新:2019/11/30

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/91714

请求说明:

参数说明:

	参数	            必须	说明
    access_token	是	调用接口凭证
    size_type	否	qrcode尺寸类型,1: 171 x 171; 2: 399 x 399; 3: 741 x 741; 4: 2052 x 2052

权限说明:

须拥有通讯录的管理权限,使用通讯录同步的Secret。

RETURN 返回结果:

    {
    	"errcode": 0,
    	"errmsg": "ok",
		"join_qrcode": "https://work.weixin.qq.com/wework_admin/genqrcode?action=join&vcode=3db1fab03118ae2aa1544cb9abe84&r=hb_share_api_mjoin&qr_size=3"
    }

RETURN 参数说明:

	参数	        说明
    errcode	    出错返回码,为0表示成功,非0表示调用失败
    errmsg	对返回码的文本描述内容
    join_qrcode	二维码链接,有效期7天

getapprovaldata(access_token, hash);

获取审批数据(旧) 最后更新:2019/11/22 提示:推荐使用新接口“批量获取审批单号”及“获取审批申请详情”,此接口后续将不再维护、逐步下线。

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/91530

请求说明:

通过本接口来获取公司一段时间内的审批记录。一次拉取调用最多拉取100个审批记录,可以通过多次拉取的方式来满足需求,但调用频率不可超过600次/分。

请求包结构体为:

{
   "starttime":  1492617600,
   "endtime":    1492790400,
   "next_spnum": 201704200003
}

参数说明:

参数		必须		说明
access_token	是	调用接口凭证。必须使用审批应用的secret获取,获取方式参考:文档-获取access_token
starttime	是	获取审批记录的开始时间。Unix时间戳
endtime	是	获取审批记录的结束时间。Unix时间戳
next_spnum	否	第一个拉取的审批单号,不填从该时间段的第一个审批单拉取

1. 获取审批记录请求参数endtime需要大于startime, 同时起始时间跨度不要超过30天; 2. 一次请求返回的审批记录上限是100条,超过100条记录请使用next_spnum进行分页拉取。

权限说明:

RETURN 返回结果:

{
	"errcode":0,
	"errmsg":"ok",
	"count":3,
	"total":5,
	"next_spnum":201704240001,
	"data":[
		{
			"spname":"报销",
			"apply_name":"报销测试",
			"apply_org":"报销测试企业",
			"approval_name":[
				"审批人测试"
			],
			"notify_name":[
					"抄送人测试"
			],
			"sp_status":1,
			"sp_num":201704200001,
			"mediaids":["WWCISP_G8PYgRaOVHjXWUWFqchpBqqqUpGj0OyR9z6WTwhnMZGCPHxyviVstiv_2fTG8YOJq8L8zJT2T2OvTebANV-2MQ"],
			"apply_time":1499153693,
			"apply_user_id":"testuser",
			"expense":{
				"expense_type":1,
				"reason":"",
				"item":[
					{
						"expenseitem_type":6,
						"time":1492617600,
						"sums":9900,
						"reason":""
					}
				]
			},
			"comm":{
				"apply_data":"{\"item-1492610773696\":{\"title\":\"abc\",\"type\":\"text\",\"value\":\"\"}}"
			}
		},
		{
			"spname":"请假",
			"apply_name":"请假测试",
			"apply_org":"请假测试企业",
			"approval_name":[
				"审批人测试"
			],
			"notify_name":[
					"抄送人测试"
			],
			"sp_status":1,
			"sp_num":201704200004,
			"apply_time":1499153693,
			"apply_user_id":"testuser",
			"leave":{
				"timeunit":0,
				"leave_type":4,
				"start_time":1492099200,
				"end_time":1492790400,
				"duration":144,
				"reason":""
			},
			"comm":{
				"apply_data":"{\"item-1492610773696\":{\"title\":\"abc\",\"type\":\"text\",\"value\":\"\"}}"
			}
		},
		{
			"spname":"自定义审批",
			"apply_name":"自定义",
			"apply_org":"自定义测试企业",
			"approval_name":[
				"自定义审批人"
			],
			"notify_name":[
					"自定义抄送人"
			],
			"sp_status":1,
			"sp_num":201704240001,
			"apply_time":1499153693,
			"apply_user_id":"testuser",
			"comm":{
				"apply_data":"{\"item-1492610773696\":{\"title\":\"abc\",\"type\":\"text\",\"value\":\"\"}}"
			}
		}
	]
}

RETURN 参数说明:

	参数	类型	说明
    errcode	int32	错误码
	errmsg	string	错误码说明
	count	拉取的审批单个数,最大值为100,当total参数大于100时,可运用next_spnum参数进行多次拉取
	total	时间段内的总审批单个数
	next_spnum	拉取列表的最后一个审批单号
	spname	审批名称(请假,报销,自定义审批名称)
	apply_name	申请人姓名
	apply_org	申请人部门
	approval_name	审批人姓名
	notify_name	抄送人姓名
	sp_status	审批状态:1审批中;2 已通过;3已驳回;4已取消;6通过后撤销;10已支付
	sp_num	审批单号
	apply_time	审批单提交时间
	apply_user_id	审批单提交者的userid
	leave	请假类型(只有请假模板审批记录有此数据项)
	timeunit	请假时间单位:0半天;1小时
	leave_type	请假类型:1年假;2事假;3病假;4调休假;5婚假;6产假;7陪产假;8其他
	start_time	请假开始时间,unix时间
	end_time	请假结束时间,unix时间
	duration	请假时长,单位小时
	reason	请假事由
	expense	报销类型(只有报销模板的审批记录有此数据项)
	expense_type	报销类型:1差旅费;2交通费;3招待费;4其他报销
	reason	报销事由
	item	报销明细 (历史单据字段,新申请单据不再提供)
	expenseitem_type	费用类型:1飞机票;2火车票;3的士费;4住宿费;5餐饮费;6礼品费;7活动费;8通讯费;9补助;10其他 (历史单据字段,新申请单据不再提供)
	time	发生时间,unix时间 (历史单据字段,新申请单据不再提供)
	sums	费用金额,单位元 (历史单据字段,新申请单据不再提供)
	reason	明细事由 (历史单据字段,新申请单据不再提供)
	comm	审批模板信息
	apply_data	审批申请的单据数据,请参见下方返回数据注解2;
	mediaids	审批的附件media_id,可使用media/get获取附件