报销单详情接口

说明

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

接口限制

 10次/秒

接口地址

报销单详情接口(包含附件)

/api/openapi/form/reimburse/{formCode}

或

报销单详情接口(不包含附件)

/api/openapi/form/reimburse/noFile/{formCode}

请求类型

GET

请求参数

参数说明

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

参数样例

MK230209001

响应参数

响应参数说明

参数名称 类型 是否必填 参数说明
formDataCode String(100) 是 单据内码
formCode String(100) 是 单据号
formSubTypeBizCode String(100) 是 单据小类编码
formSubTypeName String(150) 是 单据小类名称
reimburseName String(600) 是 报销事由
coverEmployeeName String(150) 是 承担人姓名
coverEmployeeId String(150) 是 承担人工号
departmentBizCode String(150) 是 部门业务编码
departmentDingtalkId String(150) 否 钉钉部门ID
departmentName String(400) 否 部门名称
comment String(1000) 否 备注,长度以表单配置为准
remittanceRemark String(200) 否 汇款备注,报销单单据级字段
payeeAccount AccountInput 否 收款账户
payerAccounts List< PayInfoInput > 否 支付信息
legalEntityBizCode String(150) 是 公司抬头信息
legalEntityName String(150) 是 公司抬头名称
consumeApplicationCodes List< String > 否 关联申请单的号
associatedFormCodes List< String > 否 关联内部单据号
associatedForms List<AssociatedFormsDto> 否 关联单据组件对象列表
associatedExternalFormList List<OpenApiExternalFormAssociationDto> 否 关联外部单据对象列表
contractNumbers List<String> 否 关联合同编号列表
contractCodes List<String> 否 关联合同单据号列表
tradingPartnerBizCode String(150) 否 往来单位编码
tradingPartnerParentBizCode String(150) 否 当前往来单位的上一级分类的编码
tradingPartnerName String(150) 否 往来单位名称
submittedAt Long 否 最新一次提单时间
firstSubmittedAt Long 否 首次提单时间
amount AmountInput 是 报销金额(收款币种)
baseAmount AmountInput 是 报销本币金额(公司抬头本币币种)
reimEmployeeName String(150) 是 提单人姓名
reimEmployeeId String(150) 是 提单人工号
fillEmployeeName String(150) 是 填单人姓名
fillEmployeeId String(150) 是 填单人工号
formStatus String(150) 是 单据状态
paymentAmount AmountInput 是 应付金额(收款币种)
paymentBaseAmount AmountInput 是 应付本币金额(公司抬头本币币种)
approvedAt Long 否 审批通过时间
approvedAmount AmountInput 否 审批通过金额(收款币种)
approvedBaseAmount AmountInput 否 审批通过本币金额(公司抬头本币币种)
settledAt Long 否 支付时间
auditedAt Long 否 审核时间
createdAt Long 是 第一次单据创建时间(若单据先暂存,则值为第一次暂存时间)
expenseList List<ExpenseInputList> 是 费用列表。保证金/押金费用会在费用明细顶层返回 receiptMedium、receiptAttachments,预付款类型在费用明细 customObject 中
customObject CustomObject 否 自定义字段Map集合(表单的“控件”列所有组件)
loanDeductions List<LoanDeductionInput> 否 借款核销信息
collectionSchedule List<FormPayeeDetail> 否 多人收款
installment Boolean 否 是否使用分期付款
installmentStatus String(100) 否 分期状态,INIT:分期支付待开始;PAYING:分期支付中;COMPLETE:分期支付完成;DISUSE_APPROVE:停用审批中; DISUSE:停用
externalVoucherCodes String(600) 否 外部凭证编码(报销单标记接口返回的外部凭证编号)
validationResult List<ValidateDetail> 否 单据校验结果
signEmployeeName String(100) 否 签收人姓名(最后一个)
signEmployeeId String(100) 否 签收人工号(最后一个)
creditScore Long 否 信用分
creditRank Long 否 信用等级
applyRules List<ApplyRule> 否 适用费用标准列表
formDeductionAmount AmountInput 否 核销金额
firstPeriodPayment boolean 否 分期情况下首期是否随本单支付
generateVoucher boolean 是 单据生成凭证标识(false-不生成凭证 true-生成凭证)
invoiceBagCode String(150) 是 发票袋编码
detailTotalAmount Map<String,List<OpenApiTotalAmountDataDto>> 否 明细组件下的金额组件的总金额
taxDeductBaseAmount AmountInput 是 单据税额抵扣本币金额
taxDeductAcceptAmount AmountInput 是 单据税额抵扣收款金额
payerAccountObject AccountInput 否 支付账户组件
travelRouteList List<TravelRoute> 否 行程
submitUserDepartmentBizCode String(150) 是 提单人部门编码
submitUserDepartmentName String(150) 是 提单人部门名称
tagList List<OpenApiDynaTagDataDto> 否 标签列表
datahubBillList List<DatahubBillListInput> 否 月结账单
planPayTime Long 否 计划付款时间
planPayTimeZoneId String 否 计划付款时间所在时区,IANA 时区标识(如 Asia/Shanghai)。与 planPayTime 配套使用,无时区信息时为 null
budgetOccupyTime Long 否 预算使用月份(时间戳)
budgetOccupyTimeZoneId String 否 预算使用月份所在时区,IANA 时区标识(如 Asia/Shanghai)。与 budgetOccupyTime 配套使用,无时区信息时为 null
containMonthlyInvoices Boolean 否 是否有月结发票(单据下包含有月结发票组件的费用即为ture)

收款账户字段说明:data.payeeAccount、data.collectionSchedule[].payeeAccount 和 data.collectionSchedule[].collectionObject.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": "评论信息",
       "remittanceRemark": "汇款备注",
       "payeeAccount": {
          "bankBranchName": "中国工商银行股份有限公司杭州西城支行",
          "bankAcctName": "张三",
          "bankAcctNumber": "6210002870002188096"
       },
      "payerAccounts":[
        {
          "payerPaymentType": "BANK",
          "payerName": "每刻研发工程师",
          "payerBankName": "杭州每刻银行",
          "payerBankAccount": 621000000000000,
          "accountBizCode": "ABC200612149DH5OG",
          "swiftCode": "11qc",
          "bankNameEn": "11qb"
        }
      ],
      "legalEntityBizCode": "EC1803221E22UHXD",
       "legalEntityName": "杭州每时每刻有限公司",
       "consumeApplicationCodes": ["PRE001", "PRE002"],
       "tradingPartnerBizCode": "TPB001",
       "tradingPartnerName": "每刻科技往来单位有限公司",
       "submittedAt": 1571128001340,
       "firstSubmittedAt": 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,
                "startTimeZoneId":"Asia/Shanghai",
                "endTimeZoneId":"Asia/Shanghai"
             },
             "consumeLocation": {
                "departure":"domestic-ZH32-ZH32_1",  
                "departureText":"杭州市", 
                "destination":"domestic-ZH1-ZH1_0",  
                "destinationText":"北京市"
             },
             "invoiceList": [
                {
                   "invoiceUrl":"xxxx",
                   "validateStatusDesc":"xxx",
                   "invoiceType":"xxx",
                   "invoiceInfo":{
    
                     "invoiceOriginalInfo": {
                       "aaa.pdf": "https://oss-ng-accelerate.maycur.com/458c7605-40c3-4b2e-9f9a-e77ee473c5c8.jpg?Expires=1724054653&OSSAccessKeyId=LTAI4GFjSbZ82hyPuwCBC9Sg&Signature=DJ1PkXFeUbBzZ0kNBrMWQ8Ox7i0%3D&x-oss-process=image%2Fresize%2Cw_1876%2Ch_1239%2Fcrop%2Cx_1%2Cy_11%2Cw_1875%2Ch_1228%2Frotate%2C360%2Fauto-orient%2C0"
                     }
                   } 
                }
             ],
             "status":"OPEN",
             "customObject": {
                "CF1201": {
                   "type": "AmountInput",
                   "value":{
                      "currency": "USD",     
                      "amount": 800        
                   }
                },
                "cityId": {
                   "type": "CityInput",
                   "value":{
                      "code": "domestic-ZH32-ZH32_1",  
                      "text": "杭州市"  
                   }
                },
                "noReceiptSubType": {
                   "detailBusinessCode": "BID_DEPOSIT",
                   "businessCode": "BID_DEPOSIT",
                   "text": "投标保证金"
                }
             },
             "receiptMedium": "ELECTRONIC",
             "receiptAttachments": [
                {
                   "name": "保证金收据.pdf",
                   "url": "https://example.com/receipt.pdf",
                   "pdfUrl": null
                }
             ],
             "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"
             }
          ],
          "CF156": [ 
             {
                "currency": "CNY",
                "amount": 1.1,
                "businessCode": "CF158",
                "amountStr": "1.1"
             }
          ]
       },
      "planPayTime": 1697184095261,
      "planPayTimeZoneId": "Asia/Shanghai",
      "budgetOccupyTime": 1697184095261,
      "budgetOccupyTimeZoneId": "Asia/Shanghai",
      "containMonthlyInvoices": false
    }
    }
    

修改记录

2023-02-08  新增报销单详情文档
2024-10-08  报销单详情接口-响应参数,新增"预算使用月份"字段
2025-12-09  报销单详情接口-响应参数,新增bankNameEn字段
2026-02-02  响应参数新增“是否有月结发票”
2026-07-08  报销单详情接口-响应参数,新增“汇款备注”字段
2026-06-29  报销单详情费用明细补充保证金/押金收据介质、收据附件和 customObject 中的预付款类型说明
2026-06-30  补充保证金/押金预付款类型 businessCode 和收据附件 pdfUrl 返回示例
2026-08-27  新增 planPayTimeZoneId、budgetOccupyTimeZoneId,并在费用消费时间示例中补充时区字段
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 ""