还款单写入接口

说明

该接口用于进行单据导入,在将单据导入到系统内时,会将单据自动保存到对应的员工下。

目前该接口中,仅支持部分主要字段,如果您所需要导入的字段不在文档内,请联系每刻工作人员。

注意事项:

  1. 若导入时,填写formCode,则会校验是否和每刻系统内单据号重复(每刻内单据作废/删除,不会释放原单据号)。
  2. 若导入报销单stagingFlag(暂存状态)为true,则只校验费用S级字段必填(对私:消费日期、费用金额、费用类型编码;对公:基于对私,增加到票时间、业务场景、是否对公),其他必填字段由提单人手动添加并提交。
  3. 单据导入成功且为提交状态,将会自动执行该单据所配置的审批流程,如果需要将单据直接完成,可以直接将单据配置为空流程(即没有审批人)。
  4. 单据导入成功且为提交状态,会正常触发预算、凭证、费控占用、智能审核等功能,与员工手动提单相同。

请求类型

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"
  }
}

修改记录

Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2024-11-20 10:52:00

results matching ""

    No results matching ""

    results matching ""

      No results matching ""