API开发文档 - 道一云

开发说明

开发说明

功能说明：获取借款列表信息
请求方式：POST（HTTPS）
请求地址：https://qwif.do1.com.cn/qwcgi/api/loanApiCtl/loanList.do?token=token&corpId=corpId

请求包体：

startTime:2025-06-25
endTime:2025-06-26
toSearchCloseTime:true
loanNo:J20250625152821
toSearchComment:true
toSearchAudit:true
currentPage:1
pageSize:10

请求参数说明：

参数名	释义	类型	是否必须	描述
token	用于验证	String	是	参考获取token接口
corpId	公司唯一标识	String	是
startTime	搜索开始日期	String	否	格式必须为:yyyy-MM-dd
endTime	搜索结束日期	String	否	与搜索开始开始间隔不的超过两个月
toSearchCloseTime	是否按最后处理时间搜索	Boolean	否	传true时，按最后处理时间搜索和倒序，否则按创建时间
loanNo	借款单编号	String	否	按借款单编号精确搜索，如果有值，则上面三个参数失效，为空时开始日期和结束日期必填
toSearchComment	是否返回评论列表	Boolean	否	不加该参数等同于"false"，返回 comments 字段为空
toSearchAudit	是否返回审批记录	Boolean	否	不加该参数等同于"false"，返回 auditSerial 字段为空
currentPage	当前页码	Integer	否
pageSize	分页大小	Integer	否

SDK调用示例：

		ReimApi api = QwSdkUtil.getInter(ReimApi.class);
		ApiLoanPagerResult result = api.loanList(QwSdkUtil.getCacheToken(), SdkConfig.getString("corpId"),
				"2021-01-01", "2021-01-31", false,"",false,false,
				1, 10);
		System.out.println(JSONUtil.stringify(result));

返回结果：

{
	"currPage": 1,
	"totalRows": 1,
	"maxPage": 1,
	"pageSize": 10,
	"pageData": [{
		"loanId": "1b0bf69ea92c47e6b9cf481d91feb7ae",
		"title": "2025年06月张三借款单",
		"createPersonName": "张三",
		"createDeptId": "8b05dfa3e1cc4c139703c3784fba1ad3",
		"createDeptName": "部门A->部门B",
		"wxUserId": "评论人通讯录帐号",
		"deptName": "部门A",
		"loanNo": "J20250625152821",
		"typeName": "借款单",
		"loanMoney": 10,
		"repayMoney": 10,
		"surplusMoney": 0,
		"loanDate": "2025-06-25",
		"repayDate": "2025-07-25",
		"closePersonName": "admin@test",
		"closeTime": "2025-06-25 15:31:01",
		"transferTime": "2025-06-25",
		"printState": 0,
		"createTime": "2025-06-25 15:28:53",
		"isFree": "3",
		"remark": "借款单备注",
		"comments": [{
			"commentId": "083b1e4177f2f000",
			"orgId": "fe63cb089f0646208de2dcde7425aec1",
			"loanId": "1b0bf69ea92c47e6b9cf481d91feb7ae",
			"content": "借款金额已发放。",
			"creator": "8ff9bef0-0414-4965-b542-9d00738126ab",
			"createTime": "2025-06-25 15:31:48",
			"personName": "云办公SIT环境",
			"type": 1,
			"time": "2025年06月25日"
		}, {
			"commentId": "21aee80054b9421fb826ac2660a1e2af",
			"orgId": "fe63cb089f0646208de2dcde7425aec1",
			"loanId": "1b0bf69ea92c47e6b9cf481d91feb7ae",
			"content": "已审批，审批意见为：同意 ",
			"creator": "e712658c0f24f3513faa5132b14a33cd",
			"createTime": "2025-06-25 15:30:07",
			"personName": "张三",
			"wxUserId": "评论人通讯录帐号",
			"headPic": "https://wework.qpic.cn/..."
			"type": 1,
			"time": "2025年06月25日"
		}, {
			"commentId": "24a07e7842894906b01b9fa1ba6da759",
			"orgId": "fe63cb089f0646208de2dcde7425aec1",
			"loanId": "1b0bf69ea92c47e6b9cf481d91feb7ae",
			"content": "已确认，确认意见为：已确认 ，流程已结束",
			"creator": "865d9d43297073bb38da055892ba326c",
			"createTime": "2025-06-25 15:31:02",
			"personName": "admin@test",
			"wxUserId": "评论人通讯录帐号",
			"headPic": "https://wework.qpic.cn/..."
			"type": 1,
			"time": "2025年06月25日"
		}, {
			"commentId": "36e7d6fb8c0f4cab9ca2ee1cc8a586a9",
			"orgId": "fe63cb089f0646208de2dcde7425aec1",
			"loanId": "1b0bf69ea92c47e6b9cf481d91feb7ae",
			"content": "已阅",
			"creator": "865d9d43297073bb38da055892ba326c",
			"createTime": "2025-06-25 15:30:55",
			"personName": "admin@test",
			"wxUserId": "评论人通讯录帐号",
			"headPic": "https://wework.qpic.cn/..."
			"type": 3,
			"time": "2025年06月25日"
		}, {
			"commentId": "4f46dfcc761644c2944ddc9bf920c11d",
			"orgId": "fe63cb089f0646208de2dcde7425aec1",
			"loanId": "1b0bf69ea92c47e6b9cf481d91feb7ae",
			"content": "核销申请，张三的借款单关联了报销单2025年06月张三报销单，申请核销10元。",
			"creator": "e712658c0f24f3513faa5132b14a33cd",
			"createTime": "2025-06-25 15:32:20",
			"personName": "张三",
			"wxUserId": "评论人通讯录帐号",
			"headPic": "https://wework.qpic.cn/..."
			"type": 1,
			"time": "2025年06月25日"
		}, {
			"commentId": "5a0886f02a7f47a586239752fbd32d34",
			"orgId": "fe63cb089f0646208de2dcde7425aec1",
			"loanId": "1b0bf69ea92c47e6b9cf481d91feb7ae",
			"content": "图片附件评论",
			"creator": "e712658c0f24f3513faa5132b14a33cd",
			"createTime": "2025-06-26 17:28:15",
			"personName": "张三",
			"wxUserId": "评论人通讯录帐号",
			"headPic": "https://wework.qpic.cn/..."
			"type": 6,
			"time": "2025年06月26日"
		}, {
			"commentId": "e4ca8930dc034bf19c33b0c6cd8143f2",
			"orgId": "fe63cb089f0646208de2dcde7425aec1",
			"loanId": "1b0bf69ea92c47e6b9cf481d91feb7ae",
			"content": "@李四",
			"creator": "e712658c0f24f3513faa5132b14a33cd",
			"createTime": "2025-06-26 17:28:25",
			"personName": "张三",
			"wxUserId": "评论人通讯录帐号",
			"headPic": "https://wework.qpic.cn/..."
			"type": 1,
			"time": "2025年06月26日"
		}],
		"auditSerial": [{
			"nodeName": "提交",
			"handleAccounts": "张三",
			"auditTime": "2025-06-25 15:28:53",
			"auditOpinion": "提单",
			"nodeType": "提交"

		}, {
			"nodeName": "节点83",
			"handleAccounts": "张三",
			"auditTime": "2025-06-25 15:30:04",
			"auditOpinion": "同意",
			"nodeType": "审批"
		}, {
			"nodeName": "节点84",
			"handleAccounts": "admin@test",
			"auditTime": "2025-06-25 15:31:00",
			"auditOpinion": "已确认",
			"nodeType": "知会"
		}]
	}]
}

返回参数说明：

参数名	释义	类型	是否必须
currPage	当前页码	Integer	否
totalRows	总条数	Integer	否
maxPage	最大页码	Integer	否
pageSize	分页大小	Integer	否
pageData	借款单列表	LoanApiVO[]	否

LoanApiVO类型说明：

参数名	释义	类型	是否必须	描述
loanId	借款单ID	String	否
title	借款单标题	String	否
createPersonName	借款人姓名	String	否
createDeptId	借款人部门id	String	否
createDeptName	创建人部门名称	String	否
wxUserId	借款账号	String	否
deptName	所属部门	String	否
loanNo	借款单号	String	否
typeName	借款类型	String	否
loanMoney	借款金额	BigDecimal	否
repayMoney	已还金额	BigDecimal	否
surplusMoney	待还金额	BigDecimal	否
loanDate	借款日期	String	否
repayDate	还款日期	String	否
receiptFullName	收款单位全称	String	否
bankAccount	银行账号	String	否
depositBank	开户银行	String	否
curNodeName	当前节点	String	否
curProPersonName	当前处理人	String	否
closePersonName	最后处理人	String	否
closeTime	最后处理时间	String	否
transferTime	转账时间	String	否
loanState	单据状态	String	否
printState	打印状态	Integer	否
createTime	创建日期	String	否
isFree	流程类型	String	否	1，自由流程；2，固定流程；3，分支流程 4:不需要走流程
remark	备注	String	否
comments	借款单评论	TbQyLoanCommentVO[]	否
auditSerial	审批记录	FlowAuditLogVO[]	否

TbQyLoanCommentVO类型说明：

参数名	释义	类型	是否必须
content	评论内容	String	否
creator	评论人userId	String	否
createTime	评论时间	Date	否
personName	评论人姓名	String	否
wxUserId	评论人账号	String	否
headPic	评论人头像	String	否
picList	评论中的图片数组	TbFileMediaVO[]	否
fileList	评论中的附件数组	TbFileMediaVO[]	否

TbFileMediaVO类型说明：

参数名	释义	类型	是否必须	描述
id	附件id	String	否
mediaId	附件媒体id	String	否
type	附件类型	String	否	image:图片；voice:语音;video:视频;file:普通文件
sourceType	上传来源	Integer	否	1:后台；2:手机用户
url	文件相对路径地址	String	否
fileName	文件名	String	否
fileExt	文件扩展名	String	否
fileSizeStr	文件大小，文本表示。如：1.45 M	String	否
fileSize	文件大小	Long	否
createTime	上传时间	String	否
createPerson	上传人userId	String	否

FlowAuditLogVO类型说明：

参数名	释义	类型	是否必须	描述
nodeName	节点名称	String	否
handleAccounts	处理人	String	否
auditTime	处理时间	String	否	yyyy-MM-dd HH:mm:ss
auditOpinion	处理意见	String	否
nodeType	类型	String	否

企业微信

获取借款列表信息

开发说明