还款单写入接口
说明
该接口用于进行单据导入,在将单据导入到系统内时,会将单据自动保存到对应的员工下。
目前该接口中,仅支持部分主要字段,如果您所需要导入的字段不在文档内,请联系每刻工作人员。
注意事项:
- 若导入时,填写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 | 遵循表单配置 | 还款日期 |
payeeAccount | AccountInput | 遵循表单配置 | 还款账户 |
payerAccountBizCode | String | 遵循表单配置 | 公司收款账户业务编码(支付账户) |
comment | String | 遵循表单配置 | 备注信息 |
customObject | customObject | 遵循表单配置 | 自定义普通字段 |
tradingPartnerBizCode | String | 遵循表单配置 | 往来单位(供应商)业务编码 |
submittedTime | Long | 否 | 提单时间,毫秒时间戳,非必填,默认为单据导入时间 |
loanDeduction相关字段说明
字段名称 | 字段类型 | 是否必填 | 字段说明 |
---|---|---|---|
loanCode | String | 是 | 被核销借款的借款单单据号 |
deductionAmount | 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,
"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"
}
}