借款导入接口
说明
该接口用于进行借款单导入，在将单据导入到系统内时，会将单据自动保存到对应的员工下。 目前该接口中，仅支持部分主要字段，如果您所需要导入的字段不在文档内，请联系每刻工作人员。
接口限制
1次/秒/企业
注意事项
- 若导入时，填写formCode，则会校验是否和每刻系统内单据号重复（每刻内单据作废/删除，不会释放原单据号）。
- 单据导入成功且为提交状态，将会自动执行该单据所配置的审批流程，如果需要将单据直接完成，可以直接将单据配置为空流程（即没有审批人）。
接口地址
/api/openapi/receive/loan
请求类型
POST
请求参数
参数说明
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| formCode | String | 否 | 有值时会使用该值作为单据号 |
| loanName | String | 是 | 借款事由 |
| formSubTypeBizCode | String | 是 | 表单类型的业务编号 |
| loanUserEmpNo | String | 是 | 借款人工号 |
| departmentBizCode | String | 是 | 承担部门编码 |
| requestDepartment | String | 否 | 提单人部门编码 |
| comment | String | 是 | 备注 |
| loanAmount | String | 是 | 借款金额 |
| expectedPaybackDate | Long | 是 | 预计归还日期 |
| expectedPaybackDateZoneId | String | 否 | 预计归还日期对应的 IANA 时区 ID，如 Asia/Shanghai |
| payeeAccount | PayeeAccount | 否 | 收款账户相关信息 |
| customObject | CustomObject | 否 | 自定义字段 |
| tradingPartnerBizCode | String | 否 | 往来单位编码 |
| entLegalBizCode | String | 是 | 公司抬头编码 |
| remittanceRemark | String | 否 | 汇款备注 |
| consumeApplicationBizCode | String | 否 | 申请单业务编码 |
| formAssociatedInfo | formAssociatedInfo | 否 | 关联单据组件，目前只支持关联一个单据，仅限关联每刻内部单据 |
| stagingFlag | boolean | 否 | 暂存标识，默认为false表示不暂存 |
| loanFormDataPlanPayTime | Long | 否 | 单据计划付款时间 |
| loanFormDataPlanPayTimeZoneId | String | 否 | 单据计划付款时间对应的 IANA 时区 ID，如 Asia/Shanghai |
| acceptCcyCode | String | 否 | 单据收款币种（不传取收款账户的收款币种（此时要求账户的收款币种只有一个）），该币种需要在抬头和收款账户的限制收款币种内 |
| validateScope | boolean | 否 | 校验单据适用范围：限定以下部门或人员使用，默认为false表示不校验 |
| checkUserScope | boolean | 否 | 是否校验提单人是否在单据小类使用范围内，默认false不校验。与validateScope语义相同、独立生效，任一为true均会校验。当为true且提单人不在适用范围内时，返回错误：该员工不在导入单据的适用范围内 |
formAssociatedInfo 关联单据类型
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| bizCode | String() | 是 | 单据编码 |
| type | String(12) | 是 | 单据类型 REIM 报销单； APPL 申请单； LOAN 借款单； CONTR 合同； |
参数样例
{
"entLegalBizCode": "EC2104251J8ERCWA",
"repaymentName": "还款单导入",
"formSubTypeBizCode": "FT2211261K9KPY0W",
"submittedUserEmployeeId": "YYZ002",
"coverEmployeeId": "YYZ002",
"legalEntityBizCode": "ELC2104281BIIMDJ4",
"departmentBizCode": "DP1",
"repayAmount": {
"currency": "CNY",
"toCurrency": "CNY",
"amount": 0.27,
"customExchangeRate": 1
},
"repaymentDate": 1678330036607,
"comment": "备注信息",
"tradingPartnerBizCode": "TRP2211011CQTIBNK",
"paymentType": "BANK",
"payeeAccount": {
"accountType": "PERSONAL",
"paymentType": "BANK",
"bankAcctNumber": "56897569000"
},
"payerAccountBizCode":"GJM00000001",
"loanAmount": "12.01",
"loanDeductions": [
{
"loanCode": "MK323030049",
"deductionAmount": {
"currency": "CNY",
"amount": 0.27
}
}
],
"formAssociatedInfo": {
"bizCode": "MK21120114",
"type": "APPL"
},
"customObject": {
"CF152": "自定义文本"
},
"expectedPaybackDate": 1678330036607,
"expectedPaybackDateZoneId": "Asia/Shanghai",
"loanFormDataPlanPayTime": 1678330036607,
"loanFormDataPlanPayTimeZoneId": "Asia/Shanghai"
}
响应参数
响应参数说明
| 字段 | 字段类型 | 字段说明 |
|---|---|---|
| code | String | 返回结果 |
| message | String | 返回提示 |
| data | Json | 返回结果 |
| success | boolean | 是否成功 |
参数样例
{
"code": "ACK",
"message": "操作成功",
"data": "formCode",
"success": true
}
修改记录
2023-02-08 新增借款单导入文档
2026-1-07 新增单据适用范围校验开关：validateScope
2026-6-17 新增checkUserScope参数，与validateScope语义相同、独立生效
2026-08-13 新增 expectedPaybackDateZoneId、loanFormDataPlanPayTimeZoneId 字段