申请单详情V2接口

说明

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

接口限制

 10次/秒

接口地址

申请单详情接口

/api/openapi/form/preconsume/detail

请求类型

POST

请求参数

参数说明

参数名称 类型 是否必填 参数说明
formCode String(50) 是 单据号
enableAttachments boolean 否 是否需要附件
enableApplicationExpenseList boolean 否 是否需要申请明细
enableTravelPartnerInfo boolean 否 是否需要参与人
enableTravelRouteList boolean 否 是否需要行程
enablePayeeAccount boolean 否 是否需要收款账户
enableCollectionSchedule boolean 否 是否需要收款明细
enableProcurementDetails boolean 否 是否需要采购明细
enableBudgetTransferInfo boolean 否 是否需要预算调整转入、转出信息
enableAssociatedFormList boolean 否 是否需要关联单据（含外部单据）
enableCreditInfo boolean 否 是否需要信用分信息
enableHeadCount boolean 否 是否需要总人数
enableChangeHistory boolean 否 是否需要变更历史，默认为 false；仅传 true 时返回 changeHistoryList

参数样例

{
    "formCode": "MK24050042",
    "enableAttachments": true,
    "enableApplicationExpenseList": true,
    "enableTravelPartnerInfo": true,
    "enableTravelRouteList": true,
    "enablePayeeAccount": true,
    "enableCollectionSchedule": true,
    "enableProcurementDetails": true,
    "enableAssociatedFormList": true,
    "enableBudgetTransferInfo": true,
    "enableCreditInfo": true,
    "enableHeadCount": true,
    "enableChangeHistory": true
}

响应参数

响应参数说明

参数名称 类型 是否必填 参数说明
formDataCode String(100) 是 单据内码
formCode String(100) 是 单据号
applicationCode String(100) 否 申请单编码；历史数据或未配置申请单编码组件时可能为空
currentVersionNo Integer 否 当前查询申请单的版本号；未建立版本链时可能为空
changeHistoryList List<OpenApiPreConsumeChangeHistoryDto> 否 申请单变更历史；仅 enableChangeHistory 为 true 时返回
formSubTypeBizCode String(100) 是 单据小类编码
formSubTypeName String(150) 是 单据小类名称
preNature String(25) 是 申请单属性,NORMAL-普通申请单;ACCRUAL-预提申请单;CAPITAL_PLAN-资金计划申请单
preConsumeName String(600) 是 申请事由
applicantEmployeeName String(150) 是 申请人姓名
applicantEmployeeId String(150) 是 申请人工号
fillEmployeeName String(150) 是 填单人姓名
fillEmployeeId String(150) 是 填单人工号
departmentBizCode String(400) 是 部门编码
departmentName String(400) 是 部门名称
legalEntityBizCode String(150) 否 公司抬头信息
legalEntityName String(150) 否 公司抬头名称
comment String(1000) 否 备注
tradingPartnerBizCode String(150) 否 往来单位编码
tradingPartnerParentBizCode String(150) 否 当前往来单位的上一级分类的编码
tradingPartnerName String(150) 否 往来单位名称
submittedAt Long 否 最新一次提单时间
amount AmountInput 是 申请金额
formStatus String(150) 是 单据状态
approvedAt Long 否 审批通过时间
approvedAmount AmountInput 否 审批通过金额
createdAt Long 是 单据创建时间
acceptCcy String(3) 是 收款币种，默认为CNY
baseAmount AmountInput 否 申请金额（本币）
applicationExpense List<ApplicationDetailListInput> 否 申请明细
validationResult List<ValidationResult> 否 校验结果
customObject CustomObject 否 自定义字段
applyRules List<ApplyRule> 否 适用费用标准列表
procurementDetails List<ProcurementDetail> 否 采购明细
correlatedReimburseCodes List<String > 否 关联此申请单的报销单号
travelRouteList List<TravelRoute> 否 行程列表
prevFormCode String(100) 否 变更前申请单号
loanAmount AmountInput 否 核销金额
payeeAccount AccountInput 否 收款账户
expectRepayDate Long 否 借款预计规还时间
expectRepayTimeZoneId String 否 借款预计归还时间所在时区，IANA 时区标识（如 Asia/Shanghai）。与 expectRepayDate 配套使用，无时区信息时为 null
budgetTransferAdd List<BudgetProcessDto> 否 预算追加组件信息
budgetTransferOut List<BudgetProcessDto> 否 预算调出组件信息
formAssociateUserList List<SimpleUser > 否 允许他人关联组件
detailTotalAmount Map<String,List<OpenApiTotalAmountDataDto>> 否 明细组件下的金额组件的总金额
exportComments String(1000) 否 外部系统回写备注
externalVoucherCodes String(500) 否 外部系统回写凭证号
externalVoucherStatus String(500) 否 外部系统回写凭证状态
exportStatus int 否 外部系统回写的状态
tagList List<OpenApiDynaTagDataDto> 否 标签列表
travelPartnerInfo TravelPartnerInfo 否 参与人
requestDepartmentBizCode String(400) 否 提单人部门编码
requestDepartmentName String(400) 是 提单部门名称
associatedFormCodes List< String > 否 关联内部单据号
associatedForms List<AssociationFormDto> 否 关联单据对象列表
associatedExternalFormList List<OpenApiExternalFormAssociationDto> 否 关联外部单据对象列表
creditScore BigDecimal 否 信用分
creditRank String 否 信用等级
headCount Integer 否 总人数
correlatedPreConsumeCodes List<String > 否 关联此申请单的申请单号

变更历史参数说明

changeHistoryList 返回同一申请单变更链中的有效版本及最新待生效版本，按版本生成顺序倒序排列。最新待生效版本的版本号为当前有效版本号加 1；已取消的变更记录不对外返回。

参数名称 类型 是否必填 参数说明
formCode String(100) 是 该版本对应的申请单单据号
versionNo Integer 是 该申请单在变更链中的版本号

参数样例

  1. 正常响应参数示例
    {
"code": "ACK",
"message": "",
"data": {
 "formDataCode": "PC2405281OPP9280",
 "formCode": "MK24050042",
 "applicationCode": "APP-2024-00042",
 "currentVersionNo": 2,
 "changeHistoryList": [
   {
     "formCode": "MK24050042",
     "versionNo": 2
   },
   {
     "formCode": "MK24040042",
     "versionNo": 1
   }
 ],
 "formSubTypeBizCode": "FT2201271MS8MNEO",
 "formSubTypeName": "zhangsan的行程",
 "preConsumeName": "123",
 "applicantEmployeeName": "张三",
 "applicantEmployeeId": "zhangsan",
 "fillEmployeeName": "张三",
 "fillEmployeeId": "zhangsan",
 "departmentBizCode": "DI22011323LENASR",
 "departmentName": "测试",
 "requestDepartmentBizCode": "DI22011323LENASR",
 "requestDepartmentName": "测试",
 "legalEntityBizCode": "aaa",
 "legalEntityName": "123",
 "comment": "1111",
 "tradingPartnerBizCode": "1003",
 "tradingPartnerParentBizCode": null,
 "tradingPartnerName": "123",
 "submittedAt": null,
 "firstSubmittedAt": null,
 "amount": {
   "currency": "CNY",
   "amount": 0.00,
   "amountStr": "0.00"
 },
 "formStatus": "DRAFT",
 "approvedAt": null,
 "approvedAmount": {
   "currency": "CNY",
   "amount": 0.00,
   "amountStr": "0.00"
 },
 "createdAt": 1716890131775,
 "attachments": null,
 "applicationDetail": null,
 "applicationExpense": [
   {
     "code": "AE2212011D3TL8OP",
     "prevExpenseCode": "AE2211011D3TL7ZY",
     "originExpenseCode": "AE2210011D3TL6XA",
     "expenseTypeBizCode": "",
     "expenseTypeName": "费用（字段权限）",
     "consumeAmount": {
       "currency": "CNY",
       "amount": 34.00,
       "amountStr": "34.00"
     },
     "comments": "",
     "consumeTime": {
       "startTime": 1670292365345,
       "endTime": 1670292365345,
       "startTimeZoneId": "Asia/Shanghai",
       "endTimeZoneId": "Asia/Shanghai"
     },
     "consumeLocation": {
       "departure": "330101",
       "departureFullCode": "domestic-ZH32-ZH32_1-ZH32_1_01",
       "departureText": "杭州市区",
       "destination": "330101",
       "destinationFullCode": "domestic-ZH32-ZH32_1-ZH32_1_01",
       "destinationText": "杭州市区",
       "location": null
     },
     "attachments": null,
     "travelPartnerInfo": null,
     "customObject": {
       "CF223": [
         {
           "url": null,
           "name": "钉钉特战队111_20_202211091EJTOXHC.xlsx",
           "pdfUrl": null
         }
       ],
       "CF91": {
         "startTime": null,
         "endTime": null
       }
     },
     "applyRules": null,
     "detailTotalAmount": {},
     "allocationList": null
   }
 ],
 "travelPartnerInfo": null,
 "travelRouteList": [
   {
     "travelRouteCode": "TRC2405281OPPOV40",
     "prevTravelRouteCode": "TRC2404281OPPOU31",
     "originTravelRouteCode": "TRC2403281OPPOT22",
     "expenseCodeList": [],
     "applicationExpenseCodeList": null,
     "travelCity": {
       "departure": "650121",
       "departureFullCode": "domestic-ZH30-ZH30_13-ZH30_13_21",
       "departureText": "乌鲁木齐县",
       "destination": "110114",
       "destinationFullCode": "domestic-ZH1-ZH1_0-ZH1_0_14",
       "destinationText": "昌平区",
       "location": null
     },
     "travelTime": {
       "startTime": 1716911999999,
       "endTime": 1716998399999,
       "startTimeZoneId": "Asia/Shanghai",
       "endTimeZoneId": "Asia/Shanghai"
     },
     "travelPartnerInfo": null,
     "customObject": {
       "CF555": "222",
       "CF556": "333",
       "CF557": {
         "departure": "110114",
         "departureFullCode": "domestic-ZH1-ZH1_0-ZH1_0_14",
         "departureText": "昌平区",
         "destination": "110114",
         "destinationFullCode": "domestic-ZH1-ZH1_0-ZH1_0_14",
         "destinationText": "昌平区",
         "location": "domestic-ZH1-ZH1_0-ZH1_0_14"
       },
       "CF558": {
         "detailBusinessCode": "zz-4",
         "businessCode": "RD2201181EO568ZK",
         "text": "en004"
       }
     },
     "tripWay": "ROUND_TRIP",
     "travelDays": 2.0
   }
 ],
 "validationResult": null,
 "customObject": {
   "CF575": {
     "currency": "CNY",
     "amount": 11,
     "amountStr": "11"
   },
   "CF576": 2,
   "CF565": {
     "currency": "CNY",
     "amount": 22,
     "amountStr": "22"
   },
   "CF522": [
     {
       "url": "https://oss-dtuat-accelerate.maycur.com/EC31GG30ICPIY1/9cfee51f-6ed6-41fb-8b8f-5c4b1048.doc?Expires=1717567215&OSSAccessKeyId=LTAIW3TdsFRisDtO&Signature=ODycZ%2B6IruCUtTQWWhuM9RgZJDI%3D",
       "name": "附件一.doc",
       "pdfUrl": null
     },
     {
       "url": "https://oss-dtuat-accelerate.maycur.com/EC31GG30ICPIY1/0b5dc8c7-59d0-416a-a646-cc01d63a.xlsx?Expires=1717567215&OSSAccessKeyId=LTAIW3TdsFRisDtO&Signature=M8XeWjf1sCewW5F2qUzksUftoBE%3D",
       "name": "附件二.xlsx",
       "pdfUrl": null
     },
     {
       "url": "https://oss-dtuat-accelerate.maycur.com/EC31GG30ICPIY1/469fbfaa-05e2-48ee-8b0c-83d75cfd.pdf?Expires=1717567215&OSSAccessKeyId=LTAIW3TdsFRisDtO&Signature=66rTQiF1OU7yEKLVpLK4j5yFIEk%3D",
       "name": "附件3.pdf",
       "pdfUrl": null
     }
   ],
   "CF577": "111",
   "CF578": "1",
   "CF546": "111",
   "CF571": [
     {
       "CF579": "22",
       "CF572": "33"
     }
   ],
   "CF573": {
     "detailBusinessCode": "zz-4",
     "businessCode": "RD2201181EO568ZK",
     "text": "en004"
   },
   "CF574": {
     "departure": "110114",
     "departureFullCode": "domestic-ZH1-ZH1_0-ZH1_0_14",
     "departureText": "昌平区",
     "destination": "110114",
     "destinationFullCode": "domestic-ZH1-ZH1_0-ZH1_0_14",
     "destinationText": "昌平区",
     "location": "domestic-ZH1-ZH1_0-ZH1_0_14"
   }
 },
 "procurementDetails": [
   {
     "code": "PDC2405281OPSURR4",
     "commodityName": "1",
     "specifications": "1",
     "quantity": 1.000000,
     "unit": "1",
     "unitPrice": {
       "currency": "CNY",
       "amount": 1.00,
       "amountStr": "1.00"
     },
     "totalAmount": {
       "currency": "CNY",
       "amount": 1.00,
       "amountStr": "1.00"
     },
     "customObject": {}
   }
 ],
 "correlatedReimburseCodes": [],
 "prevFormCode": "MK24050042",
 "budgetTransferAdd": null,
 "budgetTransferOut": null,
 "loanAmount": {
   "currency": "CNY",
   "amount": 222.00,
   "amountStr": "222.00"
 },
 "payeeAccount": {
   "accountType": "PERSONAL",
   "payerPaymentType": "CASH",
   "bankBranchName": "",
   "bankAcctName": "1111",
   "bankAcctNumber": null,
   "bankCode": null,
   "bankName": null,
   "bankLocation": "",
   "bankCityPlaceCode": null,
   "bankCityName": null,
   "bankProvincePlaceCode": null,
   "bankProvinceName": null,
   "bankBranchNo": "",
   "accountBizCode": null,
   "swiftCode": null,
   "payeeBsbNumber": "",
   "abaNumber": "",
   "ibanNumber": "",
   "bankCodeEN": null,
   "bankCountry": "CHINA",
   "abroadBankAddress": null
 },
 "expectRepayDate": 1716889434716,
 "expectRepayTimeZoneId": "Asia/Shanghai",
 "detailTotalAmount": {},
 "formAssociateUserList": [
   {
     "empId": "22291",
     "empName": "皮皮虾"
   }
 ],
 "externalVoucherCodes": null,
 "exportComments": null,
 "externalVoucherStatus": null,
 "exportStatus": 0,
 "tagList": [
   {
     "name": "加急",
     "code": "URGENT"
   }
 ],
 "reportPosition": {
   "name": "AA",
   "businessCode": "aa",
   "description": "UI41463806192258188UI41463806192258218UI41464538043781344UI64303046181524653UI41463806192258188UI41463806192258218UI41464538043781344UI64303046181524653UI41463806192258188UI41463806192258218UI41464538043781344UI64303046181524653UI41463806192258188UI41463806192258218UI41464538043781344UI64303046181524653"
 },
 "associatedFormCodes": [
   "MK24040048",
   "MK24030151"
 ],
 "associatedForms": [
   {
     "formType": "PRECONSUME",
     "formSubTypeName": "zhangsan的行程",
     "formSubTypeCode": "FT2201271MS8MNEO",
     "formSubTypeBizCode": "FT2201271MS8MNEO",
     "formCode": "MK24040048"
   },
   {
     "formType": "PRECONSUME",
     "formSubTypeName": "zhangsan的行程",
     "formSubTypeCode": "FT2201271MS8MNEO",
     "formSubTypeBizCode": "FT2201271MS8MNEO",
     "formCode": "MK24030151"
   }
 ],
 "associatedExternalFormList": [],
 "creditScore": 80,
 "creditRank": "A",
 "headCount":10
},
"errorCode": null,
"success": true
}

修改记录

2024-05-29  新增申请单详情V2文档
2024-09-25  新增"enableCreditInfo"参数。如果"enableCreditInfo"为true，则返回"creditScore"和"creditRank"参数
2024-11-19  新增申请单总人数
2026-06-26  新增 expectRepayTimeZoneId（借款预计归还时区）、pettyCashConsumeTime、pettyCashConsumeLocation、pettyCashAmount（备用金相关字段，消费时间含时区）；行程 travelTime、申请明细 consumeTime 示例补充时区字段
2026-07-17  新增 baseAmount（申请金额，本币）响应字段
2026-08-09  新增申请单编码、当前版本号、按需返回的变更历史，以及申请明细/行程的前序编码和跨版本稳定编码
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 ""