增量查询请求书申请单
接口描述
此接口为增量接口用于按照请求书申请单最后变更日期查询请求书申请单。
请求URI
/api/openapi/application/request
请求方式
GET
请求参数示例
/api/openapi/application/request?startTime=2021-01-01 00:00:00&endTime=2021-01-29 00:00:00&page=1&size=20&status=1004,1005
请求参数说明
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| startTime | String | 是 | 查询开始时间。格式: yyyy-MM-dd HH:mm:ss |
| endTime | String | 是 | 查询结束时间。格式: yyyy-MM-dd HH:mm:ss |
| page | int | 是 | 页码, 第一页的page为1 |
| size | int | 是 | 每页结果数。最大50 |
| status | String | 是 | 申请单状态ID列表。 以 ,分隔 |
| fetchApprovalHistory | Boolean | 否 | 默认值为false 是否返回审批历史 |
{
"total": 3,
"current": 1,
"pageSize": 1,
"pages": 3,
"hasPrevious": false,
"hasNext": true,
"data": [
{
"tenantId": 1135722971472015361,
"businessCode": "IA00238187",
"title": "请求书申请单",
"remark": "请求书申请单",
"createdDate": "2021-06-03T17:24:20+09:00",
"lastUpdatedDate": "2021-06-03T17:24:21+09:00",
"setOfBooksCode": "s003",
"company": {
"oid": "f5b5ddb1-d9d4-4a7c-bdeb-335a7bd2b7fc",
"name": "JPY账套公司",
"code": "s003_com001"
},
"department": {
"oid": "2c699fa5-1bb8-449d-8c3e-15b348b7e204",
"name": "技术部_1_1",
"code": "D_TEC_1_1"
},
"applicant": {
"userOID": null,
"fullName": null,
"employeeId": null,
"corporation": null,
"company": null,
"department": null
},
"submittedBy": {
"userOID": "e52d1a94-d930-47a7-8397-63b6d2f17d54",
"fullName": null,
"employeeId": "DGR001",
"corporation": null,
"company": null,
"department": null
},
"createdBy": {
"userOID": "e52d1a94-d930-47a7-8397-63b6d2f17d54",
"fullName": null,
"employeeId": "DGR001",
"corporation": null,
"company": null,
"department": null
},
"lastApprovalDate": "2021-06-03T17:24:21+09:00",
"customForm": {
"formOID": "4bcc430a-91d8-46d8-b969-aaf3ef6c0b60",
"name": "请求书申请单",
"code": "request_app",
"formName": "请求书申请单",
"formType": 2007,
"formCode": "request_app",
"customFields": [
{
"formValueOID": "c16d5193-b1ef-4cb5-9310-c86e71f80996",
"fieldOID": "853b402e-36f2-47b8-a288-42ded77abf8a",
"fieldName": "取引年月日",
"fieldCode": "re1",
"fieldType": "DATE",
"value": "2021-06-30",
"valueName": "2021-06-30"
}
]
},
"approvalHistories": [
{
"operationType": 1002,
"operation": 2001,
"operationDetail": "",
"remark": null,
"approvalDate": "2023-01-04T12:26:08+09:00",
"operator": {
"userOID": "00000000-0000-0000-0000-000000000000",
"fullName": "システム承認",
"employeeId": "",
"corporation": null,
"company": {
"oid": "e4b4a421-0355-4449-a610-26ff99322ab1",
"name": "SYSTEM"
},
"department": {
"oid": "00000000-0000-0000-0000-000000000000",
"name": "系统部门"
}
},
"submitter": null,
"applicant": {
"userOID": "00000000-0000-0000-0000-000000000000",
"fullName": "システム承認",
"employeeId": "",
"corporation": null,
"company": {
"oid": "e4b4a421-0355-4449-a610-26ff99322ab1",
"name": "SYSTEM"
},
"department": {
"oid": "00000000-0000-0000-0000-000000000000",
"name": "系统部门"
}
}
},
{
"operationType": 1001,
"operation": 1001,
"operationDetail": null,
"remark": null,
"approvalDate": "2023-01-04T12:26:07+09:00",
"operator": {
"userOID": "428bcdaf-db13-4962-8457-aa862fda1346",
"fullName": "システム管理者",
"employeeId": "admin",
"corporation": {
"oid": "cde54596-7963-4d55-accd-bf5533cfdc79"
},
"company": {
"oid": "cde54596-7963-4d55-accd-bf5533cfdc79",
"name": "Stage動作検証環境–付刚",
"code": "test_001"
},
"department": {
"oid": "c92ddbf5-ea67-41a1-8b21-2ca9c199332e",
"name": "Stage動作検証環境–付刚222222222222222222",
"code": "stage_001"
}
},
"submitter": {
"userOID": "428bcdaf-db13-4962-8457-aa862fda1346",
"fullName": "システム管理者",
"employeeId": "admin",
"corporation": {
"oid": "cde54596-7963-4d55-accd-bf5533cfdc79"
},
"company": {
"oid": "cde54596-7963-4d55-accd-bf5533cfdc79",
"name": "Stage動作検証環境–付刚",
"code": "test_001"
},
"department": {
"oid": "c92ddbf5-ea67-41a1-8b21-2ca9c199332e",
"name": "Stage動作検証環境–付刚222222222222222222",
"code": "stage_001"
}
},
"applicant": null
}
],
"baseDate": "2021-06-03",
"applicationOID": "074aa71c-8839-487a-8c2e-46c63016fa6b",
"status": "PASSED",
"totalAmount": 1230.0,
"currencyCode": "JPY",
"baseCurrencyAmount": 1230.0000,
"type": 1004,
"expenseList": [
{
"expenseTypeCode": null,
"currencyCode": "JPY",
"amount": 1230.0,
"baseCurrencyAmount": 1230.0,
"actualCurrencyRate": 1.0,
"companyCurrencyRate": 1.0,
"createdDate": "2021-06-03T17:24:20+09:00",
"paymentType": 1001
}
]
}
]
}
接口返回字段
PageResposne
| 参数名 | 类型 | 说明 |
|---|---|---|
| total | int | 查询结果总个数 |
| current | int | 当前页数 |
| pageSize | int | 每页结果计 |
| pages | int | 查询结果总分页数 |
| hasPrevious | boolean | 是否有上一页 |
| hasNext | boolean | 是否有下一页 |
| data | Requestpplication[] | 请求书申请单列表 |
RequestApplication
| 参数名 | 类型 | 规则 | 说明 |
|---|---|---|---|
| applicationOID | UUID | 长度 36 | 申请单OID |
| tenantId | Long | 租户ID | |
| businessCode | String | 最大 36文字 | 费用申请单号 |
| title | String | 最大 500文字 | 事由 |
| remark | String | 最大 255文字 | 备注 |
| createdDate | ZonedDateTime | 时间格式：yyyy-MM-dd'T'HH:mm:ssZ | 创建时间 |
| lastUpdatedDate | ZonedDateTime | 时间格式：yyyy-MM-dd'T'HH:mm:ssZ | 最终更新时间 |
| lastApprovalDate | ZonedDateTime | 时间格式：yyyy-MM-dd'T'HH:mm:ssZ | 最终审批时间 |
| setOfBooksCode | String | 账套编码 | |
| company | EntitySummary | 单据关系公司 | |
| department | EntitySummary | 单据关系部门 | |
| applicant | UserSummary | 申请人 | |
| submittedBy | UserSummary | 提交人 | |
| createdBy | UserSummary | 创建人 | |
| status | StatusType | 单据状态 参照 StatusType | |
| baseDate | Date | 日期格式：yyyy-MM-dd | 基准日期 |
| currencyCode | String | 币种 | |
| totalAmount | BigDecimal | 总金额 | |
| baseCurrencyAmount | BigDecimal | 单据对应币种总金额 | |
| customForm | CustomForm | 关联自定义表单 | |
| approvalHistories | ApprovalHistory[] | 审批历史 | |
| expenseList | Expense[] | 费用列表 | |
| type | Int | 申请单类型: 1004-请求书申请单 |
StatusType
| 枚举值 | 枚举名 | 说明 |
|---|---|---|
| 1001 | INIT | 编辑中(新建、撤回、审批驳回、审核驳回、反冲驳回) |
| 1002 | SUBMIT | 提交审批 |
| 1003 | PASSED | 审批通过 |
| 1009 | CLOSED | 已停用 |
UserSummary
| 字段名 | 类型 | 规则 | 说明 |
|---|---|---|---|
| userOID | UUID | 长度 36 | 用户OID |
| fullName | String | 最大长度 100 | 员工姓名 |
| employeeId | String | 最大长度 32 | 员工姓名 |
| corporation | EntitySummary | 法人实体 | |
| company | EntitySummary | 归属公司 | |
| department | EntitySummary | 部门 |
EntitySummary
| 字段名 | 类型 | 必填 | 约束 | 说明 |
|---|---|---|---|---|
| oid | UUID | 否 | 长度 36 | 实体OID |
| name | String | 否 | 长度 50 | 实体name |
| code | String | 否 | 长度 50 | 实体Code |
| path | String | 实体path(仅部门) |
CustomForm
| 字段名 | 类型 | 规则 | 说明 |
|---|---|---|---|
| formOID | UUID | 长度 36 | 表单OID |
| formName | String | 最大长度 100 | 表单名称 |
| formType | CustomFormType | int | 表单类型 |
| formCode | String | 最大长度 100 | 表单编码 |
| customFields | CustomField[] | 自定义字段列表 |
CustomField
| 参数名 | 类型 | 约束 | 说明 |
|---|---|---|---|
| formValueOID | UUID | 最大长度 36 | 自定义字段业务OID |
| fieldOID | UUID | 最大长度 36 | 自定义字段OID |
| fieldName | String | 最大长度 100 | 自定义字段名称 |
| fieldCode | String | 最大长度 50 | 自定义字段编码 |
| fieldType | String | 最大长度 50 | 自定义字段类型 |
| value | String | 最大长度 1000 | 自定义字段值 |
| valueName | String | 最大长度 1000 | 自定义字段值名称 |
| valueCode | String | 最大长度 100 | 自定义字段值编码(仅针对控件(成本中心 、部门、自定义列表、付款方式)增加) |
Expense
| 参数名 | 类型 | 规则 | 说明 |
|---|---|---|---|
| expenseTypeCode | String | 費用类型编码 | |
| amount | Double | 金额 | |
| actualCurrencyRate | Double | 手输汇率 | |
| companyCurrencyRate | Double | 公司汇率 | |
| baseCurrencyAmount | Double | 本位币金额 | |
| currencyCode | String | 币种 | |
| createdDate | ZonedDateTime | 时间格式：yyyy-MM-dd'T'HH:mm:ssZ | 创建日期 |
| paymentType | Int | 付款类型:1001个人支付，1002公司支付 |
ApprovalHistory
| 字段名 | 类型 | 规则 | 说明 |
|---|---|---|---|
| operationType | Integer | 参见ApprovalOperationType | 操作类别 |
| operation | Integer | 参见 ApprovalOperation | 操作类型 |
| operationDetail | String | 最大长度 1000 | 操作备注 |
| remark | String | 最大长度 1000 | 操作备注(补充) |
| approvalDate | String | 时间格式：yyyy-MM-dd'T'HH:mm:ssZ | 审批时间 |
| operator | UserSummary | 参见引用说明 | 操作人 |
| submitter | UserSummary | 参见引用说明 | 提交人 |
| applicant | UserSummary | 参见引用说明 | 申请人 |
ApprovalHistory
| 字段名 | 类型 | 规则 | 说明 |
|---|---|---|---|
| operationType | Integer | 参见ApprovalOperationType | 操作类别 |
| operation | Integer | 参见 ApprovalOperation | 操作类型 |
| operationDetail | String | 最大长度 1000 | 操作备注 |
| remark | String | 最大长度 1000 | 操作备注(补充) |
| approvalDate | String | 时间格式：yyyy-MM-dd'T'HH:mm:ssZ | 审批时间 |
| operator | UserSummary | 参见引用说明 | 操作人 |
| submitter | UserSummary | 参见引用说明 | 提交人 |
| applicant | UserSummary | 参见引用说明 | 申请人 |