还款单写入接口
说明
该接口用于进行单据导入，在将单据导入到系统内时，会将单据自动保存到对应的员工下。
目前该接口中，仅支持部分主要字段，如果您所需要导入的字段不在文档内，请联系每刻工作人员。
注意事项：
- 若导入时，填写formCode，则会校验是否和每刻系统内单据号重复（每刻内单据作废/删除，不会释放原单据号）。
- 若导入报销单stagingFlag(暂存状态)为true，则只校验费用S级字段必填（对私：消费日期、费用金额、费用类型编码；对公：基于对私，增加到票时间、业务场景、是否对公），其他必填字段由提单人手动添加并提交。
- 单据导入成功且为提交状态，将会自动执行该单据所配置的审批流程，如果需要将单据直接完成，可以直接将单据配置为空流程（即没有审批人）。
- 单据导入成功且为提交状态，会正常触发预算、凭证、费控占用、智能审核等功能，与员工手动提单相同。
请求类型
POST
接口地址
/api/openapi/receive/repayment
请求参数说明
在各个表单中，分为系统字段、业务字段及普通字段，系统字段在表单配置界面中不会显示，如申请单中的requestUserEmpNo 字段。业务字段及普通字段，可以通过单据配置界面中的开发者模式来查看该字段导入时的的key值，其中普通字段的key值，也可以在界面中进行配置修改。
参数说明
| 字段名称 | 字段类型 | 必填性 | 字段说明 |
|---|---|---|---|
| formSubTypeBizCode | String | 是 | 单据类型业务编码 |
| submittedUserEmployeeId | String | 是 | 提单人的工号 |
| repaymentName | String | 是 | 事由 |
| legalEntityBizCode | String | 是 | 公司抬头业务编码 |
| coverEmployeeId | String | 是 | 责任人工号 |
| departmentBizCode | String | 是 | 部门的业务编号 |
| paymentType | String |
遵循表单配置 | 付款执行方式 ，BANK：从公司银行账户付款 BANK_AUTOMATIC：从公司银行账户自动扣款 ALIPAY：从公司支付宝账户付款 CASH：从公司现金付款 THIRD_PARTY：第三方支付 MONEY_ORDER：通过承兑汇票付款 OTHER：通过其他方式付款 NONE：无 |
| loanDeductions | Array[loanDeduction] | 遵循表单配置 | 核销借款信息 |
| repayAmount | AmountInput | 是 | 还款金额 |
| repaymentDate | Long | 遵循表单配置 | 还款日期 |
| repaymentDateZoneId | String | 否 | 还款日期对应的 IANA 时区 ID，如 Asia/Shanghai |
| payeeAccount | AccountInput | 遵循表单配置 | 还款账户 |
| payerAccountBizCode | String | 遵循表单配置 | 公司收款账户业务编码（支付账户） |
| comment | String | 遵循表单配置 | 备注信息 |
| customObject | customObject | 遵循表单配置 | 自定义普通字段 |
| tradingPartnerBizCode | String | 遵循表单配置 | 往来单位（供应商）业务编码 |
| submittedTime | Long | 否 | 提单时间，毫秒时间戳，非必填，默认为单据导入时间 |
| stagingFlag | boolean | 否 | 暂存标识，默认为false表示不暂存 |
| noReceiptReturnList | Array[noReceiptReturn] | 遵循表单配置 | 预付退回（无发票还款信息） |
| checkUserScope | boolean | 否 | 是否校验提单人是否在单据小类使用范围内，默认false不校验。当为true且提单人不在适用范围内时，返回错误：该员工不在导入单据的适用范围内 |
loanDeduction相关字段说明
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| loanCode | String | 是 | 被核销借款的借款单单据号 |
| deductionAmount | AmountInput | 是 | 核销金额 |
noReceiptReturnList相关字段说明
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| recordExpenseCode | String(100) | 是 | 费用内码 |
| recordDeductionAmount | AmountInput | 是 | 预付退回金额 |
payeeAccount相关字段说明
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| bankAcctName | String | 是 | 账户名 |
| bankAcctNumber | String | 否 | 银行账号（支付类型为银行账户时必填,支付类型为支付宝时必填，为用户手机号） |
| bankBranchNo | String | 否 | 支行号 |
| paymentType | String | 是 | 支付类型;ALIPAY-支付宝,BANK-银行账户,CASH-现金 |
| hasBankBranch | Boolean | 否 | 是否有分支行 |
| accountType | String | 是 | 账户类型：个人-PERSONAL,公司-CORP |
请求参数示例
{
"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,
"repaymentDateZoneId": "Asia/Shanghai",
"comment": "备注信息",
"tradingPartnerBizCode": "TRP2211011CQTIBNK",
"paymentType": "BANK",
"payeeAccount": {
"accountType": "PERSONAL",
"paymentType": "BANK",
"bankAcctNumber": "56897569000"
},
"payerAccountBizCode":"GJM00000001",
"loanDeductions": [
{
"loanCode": "MK323030049",
"deductionAmount": {
"currency": "CNY",
"amount": 0.27
}
}
],
"customObject": {
"CF152": "自定义文本dnfajfk"
}
}
修改记录
2026-08-13 新增 repaymentDateZoneId 字段