借款单详情接口

说明

单据详情接口,无法查询到已删除单据信息。

接口限制

 10次/秒

接口地址

/api/openapi/form/loan/{formCode}

请求类型

GET

请求参数

参数说明

参数名称 类型 是否必填 参数说明
formCode String(50) 是 单据号

参数样例

MK230209002

响应参数

响应参数说明

参数名称 类型 是否必填 参数说明
formDataCode String(100) 是 单据内码
formCode String(100) 是 单据号
formSubTypeBizCode String(100) 是 单据小类编码
formSubTypeName String(150) 是 单据小类名称
loanName String(600) 是 事由
loanEmployeeName String(150) 是 借款人姓名
loanEmployeeId String(150) 是 借款人工号
fillEmployeeName String(150) 是 填单人姓名
fillEmployeeId String(150) 是 填单人工号
departmentBizCode String(300) 是 部门编码
departmentDingtalkId String(300) 是 钉钉部门Id
departmentName String(300) 否 部门名称
legalEntityBizCode String(150) 是 公司抬头信息
legalEntityName String(150) 是 公司抬头名称
comment String(1000) 否 备注
payeeAccount AccountInput 否 收款账户
payerAccounts List< PayInfoInput > 否 支付信息
consumeApplicationCodes List<String> 否 关联申请单单据号
amount AmountInput 是 借款金额
baseAmount AmountInput 是 借款本币金额
submittedEmployeeName String(150) 是 填单人工号
submittedEmployeeId String(150) 是 填单人姓名
submittedAt Long 否 最新一次提单时间
paymentAmount AmountInput 是 应付金额
paymentBaseAmount AmountInput 是 应付本币金额
tradingPartnerBizCode String(150) 否 往来单位编码
tradingPartnerParentBizCode String(150) 否 当前往来单位的上一级分类的编码
tradingPartnerName String(150) 否 往来单位名称
formStatus String(30) 是 单据状态
approvedAt Long 否 审批通过时间
approvedAmount AmountInput 否 审批通过金额
approvedBaseAmount AmountInput 否 审批通过本币金额
createdAt Long 是 单据创建时间
settledAt Long 否 支付时间
auditedAt Long 否 审核时间
expectRepayDate Long 否 预计还款时间
customObject CustomObject 否 自定义字段Map集合(表单的“控件”列所有组件)
detailTotalAmount Map<String,List<OpenApiTotalAmountDataDto>> 否 明细组件下的金额组件的总金额
externalVoucherCodes String(500) 否 外部凭证编码
generateVoucher boolean 是 单据生成凭证标识
originFormCode String(100) 否 原申请单(申请支持借款)
tagList List<OpenApiDynaTagDataDto> 否 标签列表
deductionComplete boolean 是 借款单是否核销完成
deductionForms List<DeductionFormDto> 否 借款核销关联单据列表
planPayTime Long 否 计划付款时间
creditScore BigDecimal 否 信用分
creditRank String 否 信用等级
requestDepartmentBizCode String(60) 否 提单人部门编码
requestDepartmentName String (150) 否 提单人部门名称

收款账户字段说明:data.payeeAccount 使用 AccountInput 结构。账户顶层返回国家/地区标准码 countryCode;非中国个人银行账户的城市、加拿大省/州代码、加拿大邮编和 MX ABM Code 位于 abroadExpand 中。

参数样例

  1. 正常响应参数示例

    {
    "code": "ACK",
    "message": "",
    "data": {
       "formDataCode": "BX19101510VPV56O",
       "formCode": "MK19101502",
       "formSubTypeBizCode": "FT18081314B9DJB4",
       "formSubTypeName": "张三的报销单",
       "reimburseName": "测试费用分类",
       "coverEmployeeName": "张三",
       "coverEmployeeId": "MK001",
       "departmentBizCode": "",
       "departmentDingtalkId":"",
       "departmentName": "开发一部",
       "comment": "评论信息",
       "payeeAccount": {
          "bankBranchName": "中国工商银行股份有限公司杭州西城支行",
          "bankAcctName": "张三",
          "bankAcctNumber": "6210002870002188096",
          "swiftCode": "11qc",
          "bankNameEn": "11qb"
       },
       "legalEntityBizCode": "EC1803221E22UHXD",
       "legalEntityName": "杭州每时每刻有限公司",
       "consumeApplicationCodes": ["PRE001", "PRE002"],
       "tradingPartnerBizCode": "TPB001",
       "tradingPartnerName": "每刻科技往来单位有限公司",
       "submittedAt": 1571128001340,
       "amount": {
          "currency": "CNY",
          "amount": 3
       },
       "reimEmployeeName": "张三",
       "reimEmployeeId": "empNo001",
       "formStatus": "DRAFT",
       "paymentAmount": {
          "currency": "CNY",
          "amount": 3
       },
       "approvedAt": 1571208001340,
       "approvedAmount": {
          "currency": "CNY",
          "amount": 3
       },
       "settledAt": 1571208001340,
       "auditedAt": 1571208001340,
       "createdAt": 1571108001340,
       "signEmployeeName":"小明",
       "signEmployeeId":"190121",
       "expenseList": [
          {
             "expenseTypeBizCode": "EXPENSE001",
             "consumeAmount": {
                "currency": "CNY",
                "amount": 3
             },
             "comments": "备注信息",
             "airClass": {},
             "consumeTime": {
                "startTime":1546272000000, 
                "endTime":1548950400000
             },
             "consumeLocation": {
                "departure":"domestic-ZH32-ZH32_1",  
                "departureText":"杭州市", 
                "destination":"domestic-ZH1-ZH1_0",  
                "destinationText":"北京市"
             },
             "invoiceList": [
                {
                   "invoiceUrl":"xxxx",  
                   "validateStatusDesc":"xxx",
                   "invoiceType":"xxx",
                   "invoiceInfo":{
    
                   } 
                }
             ],
             "status":"OPEN",
             "customObject": {
                "CF1201": {
                   "type": "AmountInput",
                   "value":{
                      "currency": "USD",     
                      "amount": 800        
                   }
                },
                "cityId": {
                   "type": "CityInput",
                   "value":{
                      "code": "domestic-ZH32-ZH32_1",  
                      "text": "杭州市"  
                   }
                }
             },
             "applyRules": [
                {
                   "ruleCode": "ER2101091AXYTOTH",
                   "ruleName": "QC期控月度修改漂移测试规则",
                   "factorType": "AMOUNT",
                   "amountStd": {
                      "amount": "100.00",
                      "currency": "CNY"
                   },
                   "otherStds": []
                }
             ]
          }
       ],
       "customObject": {
    
       },
       "externalVoucherCodes": "外部凭证编码", 
       "generateVoucher":false,  
       "taxDeductBaseAmount": {
          "currency": "CNY",
          "amount": 3
       },
       "taxDeductAcceptAmount": {
          "currency": "CNY",
          "amount": 3
       },
       "detailTotalAmount": { 
          "mingzi01": [  
             {
                "currency": "CNY",  
                "amount": 11.1,  
                "businessCode": "totalamount",  
                "amountStr": "11.1"
             },
             {
                "currency": "CNY",
                "amount": 11.2,
                "businessCode": "CF161",
                "amountStr": "11.2"
             }
          ],
         "deductionComplete":true,
         "deductionForms":[
           {
             "formStatus":"COMPLETED",
             "formStatusText":"COMPLETED",
             "approvedDeductionAmountStr":"¥200.00",
             "formType":"REPAYMENT",
             "formCode":"MK23030425",
             "approvedDeductionAmountCcy":"CNY",
             "approvedDeductionAmount":200
           }
         ],
          "CF156": [ 
             {
                "currency": "CNY",
                "amount": 1.1,
                "businessCode": "CF158",
                "amountStr": "1.1"
             }
          ]
       },
      "planPayTime": 1697184095261,
      "creditScore": 80,
      "creditRank": "A",
      "requestDepartmentBizCode": "dept001",
      "requestDepartmentName":"部门一"
    }
    }
    

修改记录

2023-02-08  新增借款单详情文档
2023-05-06  新增借款关联单据列表,借款是否完成标识
2024-09-25  新增返回参数:"creditScore","creditRank"
2025-07-19  新增返回参数提单人部门编码,提单人部门名称
2025-12-09  新增返回参数bankNameEn字段
2026-09-21  收款账户新增countryCode及abroadExpand海外账户扩展信息
Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2026-09-23 10:19:53

results matching ""

    No results matching ""

    results matching ""

      No results matching ""