申请单导入接口
说明
该接口用于进行申请单导入，在将单据导入到系统内时，会将单据自动保存到对应的员工下。 目前该接口中，仅支持部分主要字段，如果您所需要导入的字段不在文档内，请联系每刻工作人员。
接口限制
10次/秒/企业
注意事项
- 若导入时，填写formCode，则会校验是否和每刻系统内单据号重复（每刻内单据作废/删除，不会释放原单据号）。
- 若stagingFlag(暂存状态)为true，申请明细参数只会校验S级字段必填，其他必填字段可由提单人手动添加并提交。
- 单据导入成功且为提交状态，将会自动执行该单据所配置的审批流程 ，如果需要将单据直接完成，可以直接将单据配置为空流程（即没有审批人）。
- 在提单时，会正常触发预算占用、费控智能审核、自定义校验等校验，与员工手动提单相同。
- 例如预算管控：若为强控，则会导入失败（系统内不保存此单）；若为弱控，则提交成功（单据详情内会显示预算弱控提示信息）。
- 例如自定义校验：若错误等级为“ERROR”（错误）、“NEED_REASON”（警告但需填写理由），则会导入失败（系统内不保存此单）；其他校验类型，则提交成功（单据详情内会显示校验异常信息）。
- 若需导入申请明细，请调用申请明细导入接口
- 导入时若stagingFlag为false且在表单“提交”按钮配置了外部地址，则会触发校验，若校验为失败，则单据导入失败。
接口地址
/api/openapi/receive/application
请求类型
POST
请求参数
参数说明
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| formCode | String | 否 | 单据编码，有值时会使用该值作为单据号 |
| preConsumeName | String | 是 | 申请单事由 |
| formSubTypeBizCode | String | 是 | 表单类型的业务编号 |
| requestUserEmpNo | String | 是 | 提单人工号 |
| departmentBizCode | String | 是 | 承担部门编码 |
| comment | String | 否 （遵循表单配置） | 备注 |
| appliedAmount | AmountInput | 否 （遵循表单配置） | 申请金额 |
| receiptCurrency | String(3) | 否 | 申请币种字段（刷新单据上所有币种为该币种） |
| payeeAccount | PayeeAccount | 否 ，表单中配置为对公账户时，必须传往来单位 | 收款信息 |
| customObject | CustomObject | 否 | 自定义字段 |
| tradingPartnerBizCode | String | 否 | 往来单位编码 |
| legalEntityBizCode | String | 否 | 公司抬头编码 |
| applicationExpenseCodes | List<String> | 否 | 单独填写时申请明细code列表,需调用申请明细导入接口接口导入。 配置为“申请明细单独填写”时使用，若配置为“需要在行程下填写申请明细”，请传入travelRouteList内的applicationExpenseCodeList |
| procurementDetails | List<ProcurementDetail> | 否 | 采购明细 |
| travelRouteList | List<TravelRoute> | 否 | 行程列表 |
| formAssociatedList | List<FormAssociatedList> | 否 | 关联单据组件，关联单据数量需要遵循表单配置，仅限关联每刻内部单据 |
| consumeTime | DateInput | 否 | 预计消费日期 |
| submittedTime | Long | 否 | 提单时间 |
| budgetSubjectBizCode | String | 否 | 预算科目编码 |
| stagingFlag | boolean | 否 | 暂存标识，默认为false表示不暂存 |
| formAssociateUsers | List<String> | 否 | 申请单关联人（“允许他人关联”组件） |
| travelPartnerInfo | TravelPartner | 否 | 参与人 |
| loanAmount | List<String> | 否 | 借款金额 |
| expectedPaybackDate | Long | 否 | 预计回款时间 |
| relationAccrualContract | boolean | 否 | 是否关联预提合同(若为true,则表示该申请单为预提申请单,要求：1.申请单为预提申请单并且表单含有'关联预提合同'组件 2.未遵循'关联预提合同'组件范围限制 3.传入的applicationExpenseCodes必须全是合同预提明细生成接口 转化生成的费用 |
| disableContractCodes | List<String> | 否 | 停用合同编码（"停用合同"组件） |
| contractEndTime | Long | 否 | 合同终止时间（"合同终止时间"组件） |
FormAssociatedList 关联单据类型
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| bizCode | String() | 是 | 单据编码 |
| type | String(12) | 是 | 单据类型 REIM 报销单； APPL 申请单； LOAN 借款单； CONTR 合同； |
参数样例
{
"formCode": "CODE01",
"formSubTypeBizCode": "FT1908191E6CRDA8",
"requestUserEmpNo": "190013",
"departmentBizCode": "DI1803221E22UHXF",
"preConsumeName": "申请事由1",
"comment": "我是备注",
"appliedAmount": {
"currencyCode": "CNY",
"amount": "1.00"
},
"comsumeTime": {
"currentTime": 1566204741186,
"timeRange": {
"startDate": 1566305347895,
"endDate": 1566305356934
}
},
"receiptCurrency": "CNY",
"budgetSubjectBizCode": "BIZCODE",
"legalEntityBizCode": "LEB001",
"formAssociateUsers": [
"MK003",
"MW001"
],
"procurementDetails": [
{
"commodityName": "商品名称",
"specifications": "规格",
"quantity": 1,
"unit": "单位",
"unitPrice": {
"amount": "100",
"currency": "CNY"
},
"totalAmount": {
"amount": "100",
"currency": "CNY"
}
}
],
"submittedTime": 1566305356934,
"preConsumeCodeList": [
"MK211101001"
],
"formAssociatedList": [
{
"bizCode": "MK23050266",
"type": "APPL"
},
{
"bizCode": "MK23050267",
"type": "APPL"
}
],
"contractCode": "合同code",
"acceptCcyCode": "CNY",
"travelPartnerInfo": {
"internalTravelPartner": [
{
"employeeId": "001",
"departmentBizCode": "CODE01",
"classPositionBizCode": "CPBIZCODE01",
"gender": "MAN",
"enName": {
"firstName": "JIM",
"middleName": "D",
"lastName": "SMITH"
},
"idInfo": {
"idType": "ID_CARD",
"idNumber": "421XXXXXXX"
},
"customObject": {}
}
],
"externalTravelPartner": [
{
"name": "刘红",
"gender": "WOMAN",
"enName": {
"firstName": "JIM",
"middleName": "D",
"lastName": "SMITH"
},
"peopleNum": 10,
"idInfo": {
"idType": "ID_CARD",
"idNumber": "421XXXXXXX"
},
"customObject": {}
}
]
},
"travelRouteList": [
{
"travelCities": {
"departure": "北京市区",
"destination": [
"上海"
]
},
"travelTimeRange": {
"startDate": {
"currentTime": 1600085022912
},
"endDate": {
"currentTime": 1600085022912
}
},
"applicationExpenseCodeList": [
"AE2312453"
],
"tripWay": "SINGLE",
"travelDays": 1,
"customObject": {
"CF2797": "您好",
"CF2838": {
"currencyCode": "CNY",
"amount": "1.00"
},
"CF2839": {
"currentTime": 1566204741186
},
"CF2829": {
"index": 3
}
}
}
],
"applicationExpenseCodes": [
"CODE01"
],
"customObject": {
"CF1393": "我是单行文本",
"detail": [
{
"CF1400": "我是单行文本"
}
]
},
"submittedTime": 1566305356934,
"formAssociatedList": [
{
"bizCode": "mk1oo8611",
"type": "APPL"
}
],
"tradingPartnerBizCode": "ds2091-99",
"disableContractCodes": [
"LL241011105"
],
"contractEndTime": 1728876017930,
"stagingFlag": true
}
响应参数
响应参数说明
| 字段 | 字段类型 | 字段说明 |
|---|---|---|
| code | String | 返回结果 |
| message | String | 返回提示 |
| data | Json | 返回结果 |
| success | boolean | 是否成功 |
参数样例
- 正常响应参数示例
{
"code": "ACK",
"message": "操作成功",
"data": "formCode",
"success": true
}
- 每刻校验异常响应参数示例
当每刻系统的智能审核、多维费控、预算校验异常时会返回失败
| 字段 | 字段类型 | 字段说明 |
|---|---|---|
| level | String | 异常级别 |
| targetClassify | String | 触发校验类型 |
| targetKey | String | 触发校验的那条数据的Code主键，校验类型为FORM时，该字段为空 |
| ruleClassify | String | 校验触发的类型 |
| message | String | 校验信息 |
| needReason | boolean | 是否需要理由 |
level 异常等级
| 可取值 | 用法含义 |
|---|---|
| WARNING | 警告级别的信息，一般该类级别的信息不会阻止表单提交但需要提交者确认后才能继续提交（此时单据会暂存在提单人的“我的单据”内） |
| ERROR | 错误级别的信息，出现此级信息会阻止表单提交（系统内不可见此单据） |
{
"code": "NACK",
"message": "系统校验失败",
"data": [
{
"level": "ERROR",
"targetClassify": "REIMBURSE_EXPENSE",
"targetKey": "CODE01",
"ruleClassify": "BUDGET_MATCH",
"message": "预算组织-打车预算科目 额度870.00 报销10000.00",
"needReason": false
}
],
"success": false
}
修改记录
2023-02-08 新增申请单导入文档
2024-09-23 新增是否关联预提合同字段
2024-10-09 新增停用合同字段