合同预提明细生成接口
说明
该接口用于进行合同预提明细转化为申请费用.
先查询合同可预提明细合同预提明细查询接口 ,填写对应合同明细本次预提金额进行转化
关联预提申请单的部分可以查看申请单导入接口。
接口限制
10次/秒/企业
注意事项
- 该接口为部分失败。例如一次导入10条明细，其中一条失败，不会影响其他9条数据的正常导入。
- 每次导入最大值为10条合同预提明细.
- 根据返回的integrity可以识别该转化后单申请费用是否必填项传入完整:
- true:所有必填项均传入成功
- false
- 接口可导入的必填项未导入完整
- 不支持接口导入，但表单设置必填（此情况需要设置单据导入为草稿或者去除费用上对应组件的必填设置）
接口地址
/api/openapi/receive/contract/accrual/details
请求类型
POST
请求参数
请求参数说明
| 字段名 |
类型 |
说明 |
| employeeId |
String |
需要导入的对应员工的工号 |
| accrualGenInfoList |
List<OpenApiContractAccrualGenInfoDto> |
合同明细转预提明细信息集合 |
OpenApiContractAccrualGenInfoDto 合同预提明细信息
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| customNo |
String |
否 |
自定义编码(仅供调用方标识，服务端不储存) |
| contractCode |
String |
是 |
单据号 |
| accrualAmount |
Number |
是 |
本次预提金额 |
| ccy |
String |
是 |
金额币种 |
请求参数样例
{
"employeeId": "200070",
"accrualGenInfoList": [
{
"customNo": "no001",
"contractCode": "MK25040062",
"ceCode": "CE2504081MXY249A",
"accrualAmount": 50,
"ccy": "CNY"
},
{
"customNo": "no002",
"contractCode": "MK25040063",
"ceCode": "CE250786581MXY249B",
"accrualAmount": 2000,
"ccy": "CNY"
}
]
}
响应参数
响应参数说明
| 字段 |
字段类型 |
字段说明 |
| code |
String |
返回结果 |
| message |
String |
返回提示 |
| data |
Json |
返回结果 |
| success |
boolean |
是否成功 |
accrualGenResultList响应参数
| 字段名 |
类型 |
说明 |
| customNo |
String |
自定义编号 |
| contractCode |
String |
合同单据号 |
| ceCode |
String |
合同费用编码 |
| aeCode |
String |
预提申请费用编码（转化后的费用编码） |
| integrity |
boolean |
预提申请费用完整性 |
| consumeAmount |
Number |
预提费用消费金额 |
| ccy |
String |
消费币种 |
| success |
boolean |
是否成功 |
| message |
String |
失败信息 |
参数样例
- 正常响应参数示例
```json
{
"code": "ACK",
"message": "操作成功",
"data": {
"accrualGenResultList": [
{
"customNo": "no001",
"contractCode": "MK25040062",
"ceCode": "CE2504081MXY249A",
"aeCode": "AE250416XQKVG90",
"integrity": true,
"consumeAmount": 50,
"ccy": "CNY",
"success": true
},
{
"customNo": "no002",
"contractCode": "MK25040062",
"ceCode": "CE2504081MXY249A",
"integrity": false,
"success": false,
"message": "合同费用预提金额超出范围，请检查"
}
]
},
"errorCode": null,
"success": true
}
## 修改记录
```text
2025-04-16 新增合同明细预提导入文档