API开发文档 - 道一云

开发说明

开发说明

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

请求包体：

参数：data
{
	"reimNo": "B20250625152901",
	"pageSize": 10,
	"returnAssociatedForms": true,
	"toSearchCloseTime": true,
	"startTime": "2025-04-25",
	"endTime": "2025-06-25",
	"currentPage": 1,
	"toSearchLoan": false,
	"toSearchComment": false
}

请求参数说明：

参数名	释义	类型	是否必须	描述
token	用于验证	String	是	参考获取token接口
corpId	公司唯一标识	String	是
data	查询参数	ApiReimGetReimListVO	是

ApiReimGetReimListVO类型说明：

参数名	释义	类型	是否必须	描述
startTime	搜索开始日期	String	否	格式必须为:yyyy-MM-dd
endTime	搜索结束日期	String	否	格式必须为:yyyy-MM-dd，与搜索开始开始间隔不得超过两个月
toSearchCloseTime	是否按最后处理时间搜索	Boolean	否	传true时，列表按最后处理时间搜索和倒序，否则按创建时间
reimNo	报销单编号	String	否	按报销单编号精确搜索，如果有值，则上面三个字段均失效，为空时开始日期和结束日期必填
pageSize	分页大小	Integer	否	必须是正整数,如果超过最大页,当前页默认为最大页
currentPage	当前页码	Integer	否	默认为100,并且不超过1000
returnAssociatedForms	是否返回关联表单	Boolean	否	不加该参数等同于"false"，返回 taskProjectVO、formOrderList、caraskInfoDTO、travelFormVO、askInfoVO、orderList 字段为空
toSearchComment	是否返回评论列表	Boolean	否	不加该参数等同于"false"，返回 comments 字段为空
toSearchLoan	是否返回借款单信息	Boolean	否	不加该参数等同于"false"，返回 loanVO 字段为空

SDK调用示例：

		ApiReimGetReimListVO vo = new ApiReimGetReimListVO();
		vo.setStartTime("2022-08-01");
		vo.setEndTime("2022-09-30");
		//是否返回关联表单的开关，非必填，不填默认不返回
		vo.setReturnAssociatedForms(true);
		// 是否返回报销评论列表
		vo.setToSearchComment(true);
		System.out.println(JSONUtil.stringify(vo));
		ReimApi api = QwSdkUtil.getInter(ReimApi.class);
		// 调用接口
		ApiReimGetReimListResult re = api.getReimList(
				QwSdkUtil.getCacheToken(), SdkConfig.getString("corpId"), vo);
		// 表单id
		System.out.println(JSONUtil.stringify(re));

返回结果：

{
	"currentPage": 1,
	"pageData": [{
			"actualMoney": 40,
			"auditInfo": "【张三】，【】，【2025-06-25 15:32:18】\n",
			"comments": [{
					"commentId": "c47e9387034c4af382d597e53634ac95",
					"content": " :smile: :blush:",
					"createTime": "2025-07-02 17:56:12",
					"creator": "e712658c0f24f3513faa5132b14a33cd",
					"headPic": "https://wework.qpic.cn/bizmail/RrOag1j7YdoOeRNRrJ5C2nr24KbMITG5JzibdMIULACqyAz4bKc57Mw/100",
					"personName": "张三",
					"reimId": "65720b3b661f42eea3a053e4cbdf27e0",
					"type": "1"
				},
				{
					"commentId": "807e188047954eb294dc0657b00cdda6",
					"content": "评论带图片附件",
					"createTime": "2025-07-02 17:56:12",
					"creator": "e712658c0f24f3513faa5132b14a33cd",
					"fileList": [{
							"createPerson": "e712658c0f24f3513faa5132b14a33cd",
							"createTime": "2025-07-02 17:56:12",
							"fileExt": "CSV",
							"fileName": "data (2).csv",
							"fileSize": 110139,
							"fileSizeStr": "107.55 K",
							"groupId": "807e188047954eb294dc0657b00cdda6",
							"id": "0844426e9572f000",
							"mediaId": "3Ll4uPCJzTzeCOiHau_v-xf7xkWd5FxA0jAjnZzvKyB5DL-CUQP4R9MOg5P75vFN_",
							"mediaOutTime": 1751709370965,
							"orgId": "fe63cb089f0646208de2dcde7425aec1",
							"sort": 1751450172004,
							"sourceType": 2,
							"status": 1,
							"type": "file",
							"url": "/upload/file/fe63cb089f0646208de2dcde7425aec1/20250702/0844426e9572f000.csv"
						}

					],
					"headPic": "https://wework.qpic.cn/bizmail/RrOag1j7YdoOeRNRrJ5C2nr24KbMITG5JzibdMIULACqyAz4bKc57Mw/100",
					"personName": "张三",
					"picList": [{
							"createPerson": "e712658c0f24f3513faa5132b14a33cd",
							"createTime": "2025-07-02 17:56:25",
							"fileExt": "PNG",
							"fileName": "icon.png",
							"fileSize": 6576,
							"fileSizeStr": "6.42 K",
							"groupId": "807e188047954eb294dc0657b00cdda6",
							"id": "0844427b7c72f000",
							"mediaOutTime": 0,
							"orgId": "fe63cb089f0646208de2dcde7425aec1",
							"sort": 1751450184577,
							"sourceType": 1,
							"status": 1,
							"type": "image",
							"url": "/upload/img/fe63cb089f0646208de2dcde7425aec1/20250702/0844427b7c72f000.png"
						}

					],
					"reimId": "65720b3b661f42eea3a053e4cbdf27e0",
					"type": "6"
				},
				{
					"commentId": "e89f570cbc8d44b1864661687b95b713",
					"content": "评论内容",
					"createTime": "2025-06-26 18:11:36",
					"creator": "e712658c0f24f3513faa5132b14a33cd",
					"headPic": "https://wework.qpic.cn/bizmail/...",
					"personName": "张三",
					"reimId": "65720b3b661f42eea3a053e4cbdf27e0",
					"type": "1"
				}

			],
			"createTime": "2025-06-25 15:32:18",
			"creator": "创建人userId",
			"curAuditAccount": "当前审批人userId",
			"curNodeName": "节点1",
			"curProPersonName": "李四",
			"currentNodeId": "节点id",
			"departmentId": "8b05dfa3e1cc4c139703c3784fba1ad3",
			"departmentName": "部门A->部门B",
			"detailCount": 1,
			"detailList": [{
					"dtlId": "1b77ee5285d5419897c2adfcfded4bc1",
					"endTimes": "2025-06-25",
					"ext1": "1",
					"ext1Int": 1,
					"money": 50,
					"projId": "014fc4f01d5e4923a8d94ad088e6e509",
					"projName": "成本中心",
					"reimCustomFieldDataList": [{
							"customName": "自定义字段1",
							"value": "自定义字段值1"
						}

					],
					"reimId": "65720b3b661f42eea3a053e4cbdf27e0",
					"subjFullName": "科目全称",
					"subjId": "4986ad76114b4864b52ddaaa4c338cf9",
					"subjName": "科目名称",
					"time": "2025-06-25",
					{
						"askInfoVO": {
							"askId": "e2a375ec0ecc49e8925433ad2314aa4b",
							"askType": "9712f1f8a5a44d46ab5d868a83d73100",
							"askTypeName": "年假-固定流程",
							"content": "123123",
							"createTime": "2023-04-27 14:47:19",
							"endTime": "2023-04-27 18:00:00",
							"startTime": "2023-04-27 09:00:00",
							"sumAskDays": "1",
							"title": "张三_20230427"
						},
						"caraskInfoDTO": {
							"askId": "1d8d60ed450543449d1b2bc56f23e80f",
							"luqiaoFee": "60",
							"takeTime": "2024-05-08 11:36:00",
							"title": "20240508_用车申请_张三"
						},
						"formOrderList": [{
							"createTime": "2024-12-31 17:30:43",
							"creator": "userId",
							"formId": "form950c5cba56b54fcb9323b3fd59081c50",
							"formType": "",
							"instanceTitle": "转派负责人+抄送人",
							"isover": "2",
							"personName": "张三",
							"workId": "workf74c45a27d974dc7a026080b0864749e"
						}, {
							"createTime": "2024-12-31 11:10:30",
							"creator": "userId",
							"formId": "forma86f7431436f472780d58551c5172505",
							"formType": "reimbursement_3",
							"instanceTitle": "费用申请单_0001",
							"isover": "2",
							"personName": "张三",
							"workId": "work32b24b4c72224472844c6a46c1a58532"
						}],
						"taskProjectVO": {
							"taskProjectId": "项目id",
							"taskprojectName": "项目名称"
						},
						"travelFormVO": {
							"formId": "forma86f7431436f472780d58551c5172505",
							"personName": "张三",
							"bookingAgent": "userId2",
							"creator": "userId",
							"createTime": "2024-12-31 11:10:30",
							"currentNode": "出纳处理",
							"bookingAgentPersonName": "出纳-李四",
							"instanceTitle": "",
							"detailUrl": "http://qwy.do1.com.cn/wxqyh/...",
							"isover": "2",
							"workOrderId": "work32b24b4c72224472844c6a46c1a58532"
						},
						"orderList": [{
							"destinationArea": "",
							"payAmount": "199.5",
							"orderId": "10074788498",
							"orderStatusCode": "已成交",
							"departureArea": "",
							"isMore": false,
							"orderStatus": "Dealed",
							"startTime": "",
							"endTime": "",
							"hotelName": "会员酒店",
							"productType": "1"
						}]
					}
				}

			],
			"isFree": "3",
			"loanId": "借款单id",
			"loanVO": {
				"closePersonName": "admin@test",
				"closeTime": "2025-06-25 15:31:01",
				"createDeptId": "8b05dfa3e1cc4c139703c3784fba1ad3",
				"createDeptName": "部门A->部门B",
				"createPersonName": "张三",
				"createTime": "2025-06-25 15:28:53",
				"deptName": "部门A",
				"isFree": "3",
				"loanDate": "2025-06-25",
				"loanId": "借款单id",
				"loanMoney": 10,
				"loanNo": "J20250625152821",
				"printState": 0,
				"remark": "借款单备注",
				"repayDate": "2025-07-25",
				"repayMoney": 0,
				"surplusMoney": 0,
				"title": "2025年06月张三借款单",
				"transferTime": "2025-06-25",
				"wxUserId": "通讯录帐号"
			},
			"payableMoney": 40,
			"personName": "张三",
			"reimId": "65720b3b661f42eea3a053e4cbdf27e0",
			"reimNo": "B20250625152901",
			"state": 1,
			"status": "1",
			"statusDesc": "审批中",
			"title": "2025年06月张三报销单",
			"totalMoney": "50.00",
			"transferStatus": 0,
			"transferStatusDesc": "待转账",
			"typeId": "a7e26fd61146401e99c914dcf2ad3565",
			"typeName": "报销单支持借款单",
			"verificationMoney": 10,
			"wxUserId": "创建人帐号"
		}

	],
	"pageSize": 10,
	"startRow": 0,
	"totalPages": 1,
	"totalRows": 1
}

返回参数说明：

参数名	释义	类型	是否必须	描述
pagerData	ApiReimPagerResult	ApiReimPagerResult	否

ApiReimPagerResult类型说明：

参数名	释义	类型	是否必须
currentPage	当前页码	Integer	否
totalRows	总条数	Integer	否
totalPages	最大页码	Integer	否
pageSize	分页大小	Integer	否
startRow	开始行数	Integer	否
pageData	ApiReimDataResult	ApiReimDataResult[]	否

ApiReimDataResult类型说明：

参数名	释义	类型	是否必须	描述
reimId	报销单id	String	否
title	报销单标题	String	否
totalMoney	报销金额	String	否
createTime	创建时间	String	否
closePerson	最后处理人userId	String	否
closePersonName	最后处理人姓名	String	否
closeReason	最后处理意见	String	否
closeTime	最后处理时间	String	否
state	审批状态	Integer	否	1:审批中;2:已取消;3:已退审;4:已审批;5:转账中;6:已转账;7:转账失败
statusDesc	审批状态描述	String	否
isFree	流程类型	String	否	1:自由流程;2:固定流程;3:分支流程;4:不需要走流程
receiptFullName	收款单位全称	String	否
bankAccount	银行账号	String	否
depositBank	开户银行	String	否
auditInfo	审批信息	String	否
globalRemark	备注	String	否
actualMoney	实付金额	BigDecimal	否
verificationMoney	总核销金额	BigDecimal	否
payableMoney	应付金额	BigDecimal	否
transferStatus	转账状态	Integer	否	0:待转账;1:已转帐;2:转账失败;
transferStatusDesc	转账状态描述	String	否
detailList	报销明细	ApiReimDetailDataResult[]	否
detailCount	明细个数	Integer	否
creator	报销人userId	String	否
personName	报销人名称	String	否
wxUserId	报销人帐号	String	否
departmentName	报销人部门名称	String	否
departmentId	报销人部门id	String	否
typeId	报销单类型id	String	否
typeName	报销单类型名称	String	否
reimNo	报销单编号	String	否
loanId	借款单id	String	否
itemMap	全局自定义字段值json字	Map	否
fieldList	字段列表	FieldApiVO[]	否
curAuditAccount	当前处理人Id	String	否
curProPersonName	当前处理人	String	否
currentNodeId	当前节点id	String	否
curNodeName	当前节点名称	String	否
proxyUserId	代报销人userId	String	否
proxyPerson	代报销人信息	TbQyReimbursementRecipientVO	否
transferTime	转账时间	String	否
comments	报销单评论	TbQyReimbursementCommentVO[]	否
loanVO	借款单信息	LoanApiVO	否

ApiReimDetailDataResult类型说明：

参数名	释义	类型	是否必须
time	产生日期-开始	String	否
endTimes	产生日期-结束	String	否
money	报销金额	Double	否
projId	成本中心id	String	否
projName	成本中心名称	String	否
subjId	科目id	String	否
subjName	科目名称	String	否
subjFullName	科目全称	String	否
subjCode	科目代码	String	否
remark	备注	String	否
mediaList	附件地址集合	ReimApiMediaVO[]	否
imgPathList	图片地址集合	String[]	否
invoices	发票集合	ReimDetailInvoiceApiVO[]	否
taskProjectVO	关联项目	LinkTaskProjectVO	否
formOrderList	关联表单	FormOrderVO[]	否
caraskInfoDTO	关联用车单	CaraskInfoDTO	否
travelFormVO	关联差旅申请单	ApiFormTravelWorkOrderVO	否
askInfoVO	关联请假出差单	AskInfoVO	否
orderList	关联商旅订单	TravelOrderPortalVO[]	否
reimCustomFieldDataList	自定义字段值	ReimDetailCustomDataApiVO[]	否

ReimApiMediaVO类型说明：

参数名	释义	类型	是否必须	描述
fileName	文件名	String	否
url	文件url	String	否

ReimDetailInvoiceApiVO类型说明：

参数名	释义	类型	是否必须	描述
invoiceId	发票id	String	否	可用于查询发票详情
type	智能拍票识别的发票类型名称	String	否
invoiceCode	发票代码	String	否
invoiceNumber	发票号码	String	否
date	发票日期	String	否
checkCode	校验码	String	否
total	发票总金额	BigDecimal	否
tax	source为1时表示税率，source为2时表示智能拍票识别出来的税额	BigDecimal	否
pretaxAmount	发票-税前金额，智能拍票税前金额	BigDecimal	否
invoiceName	发票类型名称	String	否
amount	价税合计	BigDecimal	否
taxAmount	税额	BigDecimal	否
noTaxAmount	不含税金额	BigDecimal	否
source	发票来源	Integer	否	1:用户手动添加;2:智能拍票;3:微信电子发票;4:滴滴发票

LinkTaskProjectVO类型说明：

参数名	释义	类型	是否必须	描述
taskprojectName	项目名称	String	否
taskProjectId	项目ID	String	否

FormOrderVO类型说明：

参数名	释义	类型	是否必须	描述
createTime	提单时间	String	否
formId	form表单id	String	否
workId	work工单明细id	String	否
instanceTitle	表单标题	String	否
formType	表单类型	String	否	空白表示"表单","reimbursement_3"表示"费用申请单"
creator	提单人userId	String	否
personName	提单人姓名	String	否
isover	审批状态	String	否	-1:关闭;0:退审;1:全部审核通过;2:流转中

CaraskInfoDTO类型说明：

参数名	释义	类型	是否必须	描述
askId	申请单id	String	否
title	标题	String	否
luqiaoFee	用车费用	String	否
takeTime	预定时间	String	否	yyyy-MM-dd HH:mm:ss

ApiFormTravelWorkOrderVO类型说明：

参数名	释义	类型	是否必须	描述
workOrderId	work工单明细id	String	否
formId	form表单id	String	否
instanceTitle	工单标题	String	否
creator	提单人userId	String	否
detailUrl	单的详情链接	String	否
createTime	提单时间	String	否
personName	提单人的姓名	String	否
currentNode	当前节点	String	否
isover	审批状态	String	否	-1:关闭;0:退审;1:全部审核通过;2:流转中
bookingAgent	代订人userId	String	否
bookingAgentPersonName	代订人姓名	String	否

AskInfoVO类型说明：

参数名	释义	类型	是否必须	描述
askId	请假单id	String	否
title	标题	String	否
startTime	请假开始时间	String	否	yyyy-MM-dd HH:mm:ss
sumAskDays	请假时长	String	否
content	请假内容	String	否
endTime	请假结束时间	String	否	yyyy-MM-dd HH:mm:ss
createTime	提单时间	String	否	yyyy-MM-dd HH:mm:ss
askType	请假类型id	String	否
askTypeName	请假类型名称	String	否

TravelOrderPortalVO类型说明：

参数名	释义	类型	是否必须	描述
orderId	携程订单id	String	否
productType	携程产品类型	Integer	否	1:飞机;2:火车;3:酒店;
orderStatus	携程订单状态	String	否	常见值：C,Cancelled,Dealed,S,Paid,TD,R,Confirmed,TF,WP,T
orderStatusCode	携程订单状态编码	String	否	常见值：已取消,已成交,已付款,已购票,全部退票,已确认,出票失败,待支付,部分退票
payAmount	支付金额	BigDecimal	否
hotelName	酒店名称	String	否
startTime	开始时间	String	否
endTime	结束时间	String	否
departureArea	出发车站/机场名	String	否
destinationArea	到达车站/机场名	String	否
isMore	是否多程	Boolean	否

ReimDetailCustomDataApiVO类型说明：

参数名	释义	类型	是否必须	描述
customName	字段名称	String	否
value	自定义字段值	String	否

FieldApiVO类型说明：

参数名	释义	类型	是否必须
itemKey	字段key	String	否
itemType	字段类型	String	否
itemName	字段名称	String	否

TbQyReimbursementRecipientVO类型说明：

参数名	释义	类型	是否必须
userId	通讯录userId	String	否
personName	姓名	String	否
headPic	头像	String	否
wxUserId	帐号	String	否

TbQyReimbursementCommentVO类型说明：

参数名	释义	类型	是否必须
content	评论内容	String	否
creator	评论人userId	String	否
createTime	评论时间	Date	否
personName	评论人姓名	String	否
headPic	评论人头像	String	否
wxUserId	评论人账号	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	否

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	否

企业微信

获取报销信息列表

开发说明