申请单更新接口
说明
该接口用于进行申请单更新,需先调用申请单导入接口将单据导入到系统后,才能调用此接口。
目前该接口中,仅支持部分主要字段,如果您所需要导入的字段不在文档内,请联系每刻工作人员。
注意事项
- 只支持更新以下状态的申请单:暂存、驳回、驳回直达、召回状态。
- 申请单更新传值,若不传则默认复用原值,传则按最新值进行更新。
- 以下特殊费用字段全覆盖且以最新传值进行更新,不复用旧值:
- formAssociateUsers(申请单关联人)
- customObject(自定义字段信息)
接口地址
/api/openapi/receive/application/update
请求类型
POST
请求参数
参数说明
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| formCode | String | 是 | 单据编码 |
| preConsumeName | String | 否 | 申请单事由 |
| departmentBizCode | String | 否 | 部门编码 |
| comment | String | 否 | 备注 |
| appliedAmount | AmountInput | 否 | 申请金额。币种以"申请币种字段"为准;如果申请金额取自申请明细且存在申请明细,取值以申请明细为准。 |
| receiptCurrency | String(3) | 否 | 申请币种字段(刷新单据上所有币种为该币种) |
| consumeTime | DateInput | 否 | 预计消费日期 |
| budgetSubjectBizCode | String | 否 | 预算科目编码 |
| travelPartnerInfo | TravelPartner | 否 | 参与人 |
| requestDepartmentBizCode | String | 否 | 提单人部门编码 |
| legalEntityBizCode | String | 否 | 公司抬头编码 |
| tradingPartnerBizCode | String | 否 | 往来单位编码,表单中配置为对公账户时,必须传往来单位 |
| applicationExpenseCodes | List<String> | 否 | 单独填写时申请明细code列表,需调用申请明细导入接口接口导入。 配置为“申请明细单独填写”时使用,若配置为“需要在行程下填写申请明细”,请传入travelRouteList内的applicationExpenseCodeList |
| procurementDetails | List<ProcurementDetail> | 否 | 采购明细 |
| formAssociateUsers | List<String> | 否 | 申请单关联人(“允许他人关联”组件) |
| relationAccrualContract | boolean | 否 | 是否关联预提合同(若为true,则表示该申请单为预提申请单,要求:1.申请单为预提申请单并且表单含有'关联预提合同'组件 2.未遵循'关联预提合同'组件范围限制 3.传入的applicationExpenseCodes必须全是合同预提明细生成接口 转化生成的费用 |
| disableContractCodes | List<String> | 否 | 停用合同编码("停用合同"组件) |
| contractEndTime | Long | 否 | 合同终止时间("合同终止时间"组件) |
| formAssociatedList | List<FormAssociatedList> | 否 | 关联单据组件,关联单据数量需要遵循表单配置,仅限关联每刻内部单据 |
| expectedPaybackDate | Long | 否 | 预计回款时间 |
| loanAmount | String | 否 | 借款金额 |
| payeeAccount | PayeeAccount | 否 | 收款信息 |
| travelRouteList | List<TravelRoute> | 否 | 行程列表 |
| customObject | CustomObject | 否 | 自定义字段,全量更新 |
FormAssociatedList 关联单据类型
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| bizCode | String() | 是 | 单据编码 |
| type | String(12) | 是 | 单据类型 REIM 报销单; APPL 申请单; LOAN 借款单; CONTR 合同; |
请求参数样例
{
"formCode": "CODE01",
"formSubTypeBizCode": "FT1908191E6CRDA8",
"departmentBizCode": "DI1803221E22UHXF",
"preConsumeName": "申请事由1",
"comment": "我是备注",
"appliedAmount": {
"currencyCode": "CNY",
"amount": "1.00"
},
"consumeTime": {
"currentTime": 1566204741186,
"timeRange": {
"startDate": 1566305347895,
"endDate": 1566305356934
}
},
"receiptCurrency": "CNY",
"budgetSubjectBizCode": "BIZCODE",
"legalEntityBizCode": "LEB001",
"formAssociateUsers": [
"MK003",
"MW001"
],
"procurementDetails": [
{
"commodityName": "商品名称",
"specifications": "规格",
"quantity": 1,
"unit": "单位",
"unitPrice": {
"amount": "100",
"currency": "CNY"
},
"totalAmount": {
"amount": "100",
"currency": "CNY"
}
}
],
"preConsumeCodeList": [
"MK211101001"
],
"contractCode": "合同code",
"acceptCcyCode": "CNY",
"travelPartnerInfo": {
"internalTravelPartner": [
{
"employeeId": "001",
"departmentBizCode": "CODE01",
"classPositionBizCode": "CPBIZCODE01",
"gender": "MAN",
"enName": {
"firstName": "JIM",
"middleName": "D",
"lastName": "SMITH"
},
"idInfo": {
"idType": "ID_CARD",
"idNumber": "421XXXXXXX"
},
"customObject": {}
}
],
"externalTravelPartner": [
{
"name": "刘红",
"gender": "WOMAN",
"enName": {
"firstName": "JIM",
"middleName": "D",
"lastName": "SMITH"
},
"peopleNum": 10,
"idInfo": {
"idType": "ID_CARD",
"idNumber": "421XXXXXXX"
},
"customObject": {}
}
]
},
"travelRouteList": [
{
"travelCities": {
"departure": "北京市区",
"destination": [
"上海"
]
},
"travelTimeRange": {
"startDate": {
"currentTime": 1600085022912
},
"endDate": {
"currentTime": 1600085022912
}
},
"applicationExpenseCodeList": [
"AE2312453"
],
"tripWay": "SINGLE",
"travelDays": 1,
"customObject": {
"CF2797": "您好",
"CF2838": {
"currencyCode": "CNY",
"amount": "1.00"
},
"CF2839": {
"currentTime": 1566204741186
},
"CF2829": {
"index": 3
}
}
}
],
"applicationExpenseCodes": [
"CODE01"
],
"customObject": {
"CF1393": "我是单行文本",
"detail": [
{
"CF1400": "我是单行文本"
}
]
},
"formAssociatedList": [
{
"bizCode": "mk1oo8611",
"type": "APPL"
}
],
"tradingPartnerBizCode": "ds2091-99",
"disableContractCodes": [
"LL241011105"
],
"contractEndTime": 1728876017930
}
响应参数
响应参数说明
| 字段 | 字段类型 | 字段说明 |
|---|---|---|
| code | String | 返回结果 |
| message | String | 返回提示 |
| data | Json | 返回结果 |
| success | boolean | 是否成功 |
参数样例
- 正常响应参数示例
{
"code": "ACK",
"message": "操作成功",
"data": "formCode",
"success": true
}
- 每刻校验异常响应参数示例
当每刻系统的智能审核、多维费控、预算校验异常时会返回失败
| 字段 | 字段类型 | 字段说明 |
|---|---|---|
| level | String | 异常级别 |
| targetClassify | String | 触发校验类型 |
| targetKey | String | 触发校验的那条数据的Code主键,校验类型为FORM时,该字段为空 |
| ruleClassify | String | 校验触发的类型 |
| message | String | 校验信息 |
| needReason | boolean | 是否需要理由 |
level 异常等级
| 可取值 | 用法含义 |
|---|---|
| WARNING | 警告级别的信息,一般该类级别的信息不会阻止表单提交但需要提交者确认后才能继续提交(此时单据会暂存在提单人的“我的单据”内) |
| ERROR | 错误级别的信息,出现此级信息会阻止表单提交(系统内不可见此单据) |
{
"code": "NACK",
"message": "系统校验失败",
"data": [
{
"level": "ERROR",
"targetClassify": "REIMBURSE_EXPENSE",
"targetKey": "CODE01",
"ruleClassify": "BUDGET_MATCH",
"message": "预算组织-打车预算科目 额度870.00 报销10000.00",
"needReason": false
}
],
"success": false
}
修改记录
2026-03-31 新增申请单更新文档