报销单更新接口
说明
该接口用于进行报销单修改,需先调用报销单导入接口将单据导入到系统后,才能调用此接口。
目前该接口中,仅支持部分主要字段,如果您所需要导入的字段不在文档内,请联系每刻工作人员。
接口限制
10次/秒/企业
注意事项
- 只支持更新以下状态的报销单:暂存、驳回、驳回直达、召回状态。
- 无特殊说明的字段不传入或传入null表示不更新、传入空字符串或者空列表表示删除(清除该值)
- 只支持单合同的修改
- 暂不支持行程、参与人的修改
接口地址
/api/openapi/receive/reimburse/update
请求类型
POST
请求参数
参数说明
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| formCode |
String |
是 |
报销单导入接口返回的单据号 |
| reimburseName |
String |
否 |
报销单事由 |
| legalEntityBizCode |
String |
否 |
公司抬头编码,支持不更新,不支持删除 |
| coverUserEmployeeId |
String |
否 |
承担人工号,支持不更新,不支持删除 |
| coverDepartmentBizCode |
String |
否 |
承担部门编码,支持不更新,不支持删除 |
| comments |
String |
否 |
备注 |
| payeeAccount |
PayeeAccount |
否 |
收款账户,表单中收款类型为对公账户(往来单位)时,必传往来单位tradingPartnerBizCode。不传表示不更新,传空对象表示删除(不更新或删除时会先考虑多人付款是否需要更新) |
| tradingPartnerBizCode |
String |
否 |
往来单位编码 |
| paymentSceneBizCode |
String |
否 |
多人收款场景(支付场景)表单业务编码,需要填写多人收款时必填,不传或者传null表示不更新,传空字符串表示删除收款明细,传值表示更新(不更新或删除时会先考虑付款账户是否需要更新) |
| collectionSchedule |
CollectionTradingType |
否 |
多人收款,由paymentSceneBizCode控制多人收款更新与否 |
| expenseCodes |
List<String> |
否 |
费用的每刻内码Code列表,最多50条,传null表示不更新,空列表表示清空 |
| preConsumeCodeList |
List<String> |
否 |
报销单关联申请单号,传null表示不更新,空列表表示清空 |
| contractCode |
String |
否 |
报销单关联的合同单号(只支持单合同的修改) |
| nonCheckContractAgent |
bool |
否 |
不需要校验合同责任人,true-不校验,false-校验(默认校验) |
| contractPaymentPlans |
List<contractPaymentPlan> |
否 |
关联的付款合同含分期,需指定本期发起的期数和金额,格式见contractPaymentPlan说明 |
| contractPayRecords |
List<contractPayRecords> |
否 |
关联的付款合同含费用明细,可以指定占用支付金额以及到票金额(注:填写的明细行金额需要大于0,不填写的合同明细行默认金额为0。 |
| reimburseFormDataPlanPayTime |
Long |
否 |
报销单计划付款时间,null表示不更新,0表示删除 |
| acceptCcyCode |
String(3) |
否 |
单据收款币种(不传取更新后收款账户的收款币种(此时要求账户的收款币种只有一个)),该币种需要在抬头和收款账户的限制收款币种内 |
| associatedForm |
List<AssociatedForm> |
否 |
关联单据组件,关联单据数量需要遵循表单配置,仅限关联每刻内部单据,传null表示不更新,空列表表示清空 |
| loanFormCodes |
List<String> |
否 |
核销借款,由此字段控制借款更新与否,传null表示不更新,空列表表示清空 |
| loanDeductionHistoryList |
List<DeductionHistory> |
否 |
自定义核销金额(使用该组件,必须配合loanFormCodes使用,且本组件核销单据号必须在loanFormCodes内)。 需开启“核销借款”组件的“支持手动修改本次核销金额”开关 |
| remittanceRemark |
String |
否 |
汇款备注 |
| invoiceBagCode |
String |
否 |
发票袋编号 |
| reportPositionBizCode |
String |
否 |
职位编码 |
| budgetOccupyTime |
Long |
否 |
预算使用月份(时间戳,null表示不更新,0表示删除) |
| customObject |
CustomObject |
否 |
自定义字段 |
contractPayRecords 参数说明
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| expenseCode |
String |
是 |
合同费用编码 |
| payAmount |
AmountInput |
是 |
本次支付金额 |
| receiveAmount |
AmountInput |
是 |
本次到票金额 |
contractPaymentPlan 参数说明
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| code |
String |
是 |
合同付款计划行code |
| paymentPlanAmountNow |
AmountInput |
是 |
付款计划行本次支付金额 |
| receiptAmountNow |
AmountInput |
是 |
付款计划行本次到票金额 |
参数样例
{
"formCode": "MKXXXXX",
"reimburseName": "事由",
"submittedUserEmployeeId": "XXXX",
"legalEntityBizCode": "ELCXXXXX",
"coverUserEmployeeId": "XXXX",
"coverDepartmentBizCode": "DIXXXXXXXXXX",
"comments": "备注",
"collectionSchedule": [
{
"payeeAccount": {
"bankAcctName": "张三",
"bankAcctNumber": "123456789123456789",
"paymentType": "BANK",
"accountType": "PERSONAL",
"bankBranchNo": "XXXX"
},
"collectionTradingPartnerBizCode": "015108m",
"amountRatio": 100,
"amount": {
"amount": 100,
"currency": "CNY"
},
"collectionUserEmployeeId": "190016",
"collectionUserName": "张三",
"collectionUserTargetScope": "EMPLOYEE",
"collectionType": "BANK",
"acceptanceDraftCode": "789562787687234",
"acceptanceIssueDate": "2024-06-20",
"installmentInfo": {
"installmentExpectDate": 1602569779579
}
}
],
"paymentSceneBizCode": "XXXXX",
"expenseCodes": [
"expenseCode1",
"expenseCode2"
],
"preConsumeCodeList": [
"MKXXXX"
],
"contractCode": "MKXXXX",
"nonCheckContractAgent": false,
"reimburseFormDataPlanPayTime": 1766381949798,
"acceptCcyCode": "CNY",
"associatedForm": [
{
"formCode": "MK23030069",
"formType": "PRECONSUME",
"formSubTypeBizCode": "FT24739297869438025",
"formSubTypeName": "测试申请单",
"isMine": true
}
],
"loanFormCodes": [],
"loanDeductionHistoryList": [],
"remittanceRemark": "汇款备注1",
"invoiceBagCode": "23121231",
"budgetOccupyTime": 1766381950000,
"customObject": {
"CF850": {
"currentTime": 1766373652332
},
"CF598": {
"amount": 33.43,
"currency": "CNY"
},
"CF852": {
"userEmpNos": [
"XXX"
]
},
"CF846": "单行文本",
"CF847": "多行文本1\n多行文本2\n多行文本3"
}
}
响应参数
响应参数说明
| 字段 |
字段类型 |
字段说明 |
| code |
String |
返回结果 |
| message |
String |
返回提示 |
| data |
Json |
返回结果 |
| success |
boolean |
是否成功 |
参数样例
- 正常响应参数示例
{
"code": "ACK",
"message": "操作成功",
"data": "formCode",
"success": true
}
- 可编辑性校验异常响应参数示例
{
"code": "NACK",
"message": "系统校验失败: A不可编辑\nB不可编辑",
"success": false
}
修改记录
2025-02-30 新增报销单修改文档