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"，返回 formOrderList 字段为空
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"
						}

					],
					"reimId":"65720b3b661f42eea3a053e4cbdf27e0",
					"subjFullName":"科目全称",
					"subjId":"4986ad76114b4864b52ddaaa4c338cf9",
					"subjName":"科目名称",
					"time":"2025-06-25"
				}

			],
			"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[]	否
formOrderList	表单集合	FormOrderVO[]	否
reimCustomFieldDataList	自定义字段值	ReimDetailCustomDataApiVO[]	否

ReimApiMediaVO类型说明：

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

ReimDetailInvoiceApiVO类型说明：

参数名	释义	类型	是否必须	描述
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:滴滴发票

FormOrderVO类型说明：

参数名	释义	类型	是否必须
createTime	提单时间	String	否
formId	form表单id	String	否
workId	work工单明细id	String	否
instanceTitle	表单标题	String	否

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	否

企业微信

获取报销信息列表

开发说明