根据差旅申请单号查询

接口描述

此接口为根据差旅申请单号查询差旅申请单。

请求URI

/api/openapi/application/travel/{businessCode}?fetchApprovalHistory=true

请求方式

GET

请求参数示例

/api/openapi/application/travel/TA00658710?fetchApprovalHistory=true

请求参数说明

参数名	类型	是否必填	说明
businessCode	String	◯	差旅申请单单号
fetchApprovalHistory	Boolean		默认值为false 是否返回审批历史

接口返回示例

{
      "tenantId": 1135722971472015361,
      "businessCode": "TA00231181",
      "title": "111",
      "remark": "",
      "createdDate": "2021-03-16T12:00:54+09:00",
      "lastUpdatedDate": "2021-03-17T18:33:40+09:00",
      "setOfBooksCode": "DEFAULT_SOB",
      "company": {
        "oid": "7c819140-41cf-4a70-aed1-9ade4cc63c2d",
        "name": "默认公司",
        "code": "COM001"
      },
      "department": {
        "oid": "f0b03110-10a7-4830-899e-92b601128fee",
        "name": "人事部",
        "code": "111"
      },
      "applicant": {
        "userOID": "ebcfdb25-5979-4e87-8c90-75c62889e5f6",
        "fullName": "租户管理员",
        "employeeId": "admin",
        "corporation": null,
        "company": {
          "oid": "7c819140-41cf-4a70-aed1-9ade4cc63c2d",
          "name": "默认公司",
          "code": "COM001"
        },
        "department": {
          "oid": "f0b03110-10a7-4830-899e-92b601128fee",
          "name": "人事部",
          "code": "111"
        }
      },
      "submittedBy": {
        "userOID": "ebcfdb25-5979-4e87-8c90-75c62889e5f6",
        "fullName": null,
        "employeeId": "admin",
        "corporation": null,
        "company": null,
        "department": null
      },
      "createdBy": {
        "userOID": "ebcfdb25-5979-4e87-8c90-75c62889e5f6",
        "fullName": null,
        "employeeId": "admin",
        "corporation": null,
        "company": null,
        "department": null
      },
      "customForm": {
        "formOID": "47c9b424-6a9b-42a7-8317-2f1951d5b3a2",
        "name": "出張申請伝票",
        "code": "trip_application",
        "formName": "出張申請伝票",
        "formType": 2001,
        "formCode": "trip_application",
        "customFields": [
          {
            "formValueOID": "043adb7b-f80a-41fe-b5f7-551796ea69fe",
            "fieldOID": "0095d314-1693-46bf-bcdf-4e20e5221996",
            "fieldName": "部門",
            "fieldType": "TEXT"
          }
        ]
      },
      "approvalHistories": [
        {
            "operationType": 1001,
            "operation": 1001,
            "operationDetail": null,
            "remark": null,
            "approvalDate": "2023-01-04T10:42:13+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-03-16",
      "applicationOID": "0e2284d5-4ea7-44f7-8d25-5e7b0d93ef0e",
      "status": "INIT",
      "currencyCode": "CNY",
      "totalAmount": 220.0,
      "originCurrencyCode": "CNY",
      "originCurrencyTotalAmount": 220.0,
      "type": 1002,
      "travelStartDate": "2021-02-28T15:00:00.000+00:00",
      "travelEndDate": "2021-04-13T15:00:00.000+00:00",
      "expenseList": [
        {
          "expenseTypeCode": "DEFAULT_SOBEXP0005",
          "currencyCode": "CNY",
          "amount": 220.0,
          "baseCurrencyAmount": 220.0,
          "actualCurrencyRate": 1.0,
          "companyCurrencyRate": 1.0,
          "createdDate": "2021-03-17T18:33:40+09:00",
          "paymentType": 1001
        }
      ]
}

接口返回字段

TravelApplication

参数名	类型	规则	说明
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		总金额
originCurrencyCode	String		单据所选币种,默认为本位币
originCurrencyTotalAmount	BigDecimal		单据对应币种总金额
customForm	CustomForm		关联自定义表单
approvalHistories	ApprovalHistory[]		审批历史
expenseList	Expense[]		费用列表
type	Int		申请单类型: 1001-费用申请单，1002-差旅申请单
travelStartDate	Date	日期格式：yyyy-MM-dd	出差开始日期
travelEndDate	Date	日期格式：yyyy-MM-dd	出差结束日期

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	参见引用说明	申请人

失败示例

{
    "message": "差旅申请单不存在",
    "errorCode": "spd.31278.002"
}

字段说明

字段名称	类型	说明
message	String	返回信息说明
errorCode	String	返回错误码

错误代码

errorCode	message	说明
spd.31278.002	差旅申请单不存在

← 差旅申请单删除增量查询请求书申请单 →