获取申请单列表

调用本接口按照企业corpid和用户userid维度，获取申请单包括审批状态、时间等数据。

iShot2021-12-24 11

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	阿里商旅专用权限点	调试
第三方企业应用	是	阿里商旅专用权限点	调试
第三方个人应用	否	—	—

基本信息

请求方式：POST

请求地址：https://oapi.dingtalk.com/topapi/alitrip/btrip/apply/search

Query参数

名称

类型

是否必填

示例值

描述

access_token

String

是

dc73axxxx

调用该API的应用凭证。

企业内部应用，通过获取企业内部应用的access_token接口获取。
第三方企业应用，通过获取第三方企业的access_token接口获取。

Body参数

名称	类型	是否必填	示例值	描述
rq	OpenSearchRq	是		请求对象。
gmt_modified	Date	否	2017-05-01 00:00:00	更新时间大于等于此时间的审批单。
page_size	Number	否	10	每页返回数量，默认10，最多50。
end_time	Date	否	2017-05-01 00:00:00	结束时间。
start_time	Date	否	2017-05-01 00:00:00	开始时间。
page	Number	否	1	页数，从1开始。
userid	String	否	user1	提交审批单的用户的userid。
deptid	String	否	dept1	部门ID。
corpid	String	是	corp1	企业的corpid。
all_apply	Boolean	否	true	是否包括未报销的申请： false: 未报销的申请单
only_shang_lv_apply	Boolean	否	false	是否仅包括商旅申请单： true：商旅申请单

返回参数

名称	类型	示例值	描述
module	OpenApplyRs[]		审批单列表。
id	Number	7438532	商旅审批单ID。
apply_show_id	String	201710111505000464651	商旅审批展示ID。
gmt_create	Date	2017-05-01 00:00:00	创建时间。
gmt_modified	Date	2017-05-01 00:00:00	更新时间。
thirdpart_id	String	81bb785b-4ee2xxxx	第三方审批单ID。如果非第三方审批单则为空。
corpid	String	corp1	企业的corpid。
userid	String	user1	用户的userid。
deptid	String	dept1	用户的部门ID。
corp_name	String	阿里巴巴	企业名称。
user_name	String	张三	用户名称。
dept_name	String	钉钉	部门名称。
trip_day	Number	1	出差天数。
trip_cause	String	项目沟通	出差事由。
trip_title	String	北京出差	申请单标题。
status	Number	1	申请单状态： 0：申请 1：同意 2：拒绝 3：转交 4：取消 5：修改已同意 6：撤销已同意 7：修改审批中 8：已同意(修改被拒绝) 9：撤销审批中 10：已同意(撤销被拒绝) 11：已同意(修改被取消) 12：已同意(撤销被取消)
status_desc	String	同意	审批单状态描述。
itinerary_list	OpenItineraryInfo[]		行程列表。
trip_way	Number	1	行程方式： 0：单程 1：往返
itinerary_id	String	8947547	行程ID。
traffic_type	Number	0	交通方式： 0：飞机 1：火车 2：汽车 3：其他
dep_city	String	杭州	出发城市。
arr_city	String	北京	到达城市。
cost_center_name	String	阿里巴巴	成本中心。
invoice_name	String	阿里巴巴	发票抬头。
dep_date	Date	2017-05-01 00:00:00	出发日期。
arr_date	Date	2017-05-01 00:00:00	到达日期。
project_code	String	xm1	项目代码。
project_title	String	项目1	项目名称。
traveler_list	OpenUserInfo[]		出行人列表。
userid	String	user1	出行人userid。
user_name	String	张三	出行人姓名。
approver_list	OpenApproverInfo[]		审批人列表。
order	Number	1	审批人顺序。
user_name	String	张三	审批人姓名。
userid	String	user1	审批人userid。
status	Number	1	审批状态： 0：审批中 1：已同意 2：已拒绝 3：已转交 4：已取消 5：已终止 6：发起审批 7：评论
status_desc	String	同意	审批状态描述。
note	String	同意	审批意见。
operate_time	Date	2017-05-01 00:00:00	操作时间。
flow_code	String	abc123	流程编码。
errmsg	String	成功	返回码。
errcode	Number	0	返回码描述。
success	Boolean	true	操作是否成功。

示例

请求示例（HTTP）

POST https://oapi.dingtalk.com/topapi/alitrip/btrip/apply/search?access_token=ACCESS_TOKEN

请求正文

{
        "rq":{
                "start_time":"2017-05-01 00:00:00",
                "corpid":"corp1",
                "all_apply":"true",
                "only_shang_lv_apply":"false",
                "end_time":"2017-05-01 00:00:00",
                "deptid":"dept1",
                "page":"1",
                "gmt_modified":"2017-05-01 00:00:00",
                "userid":"user1",
                "page_size":"10"
        }
}

请求示例（JAVA SDK）

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/alitrip/btrip/apply/search");
OapiAlitripBtripApplySearchRequest req = new OapiAlitripBtripApplySearchRequest();
OpenSearchRq obj1 = new OpenSearchRq();
obj1.setGmtModified(StringUtils.parseDateTime("2017-05-01 00:00:00"));
obj1.setPageSize(10L);
obj1.setEndTime(StringUtils.parseDateTime("2017-05-01 00:00:00"));
obj1.setStartTime(StringUtils.parseDateTime("2017-05-01 00:00:00"));
obj1.setPage(1L);
obj1.setUserid("user1");
obj1.setDeptid("dept1");
obj1.setCorpid("corp1");
obj1.setAllApply(true);
obj1.setOnlyShangLvApply(false);
req.setRq(obj1);
OapiAlitripBtripApplySearchResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

返回示例

{
        "errcode":"0",
        "success":"true",
        "module":{
                "gmt_create":"2017-05-01 00:00:00",
                "apply_show_id":"201710111505000464651",
                "corpid":"corp1",
                "status_desc":"同意",
                "user_name":"张三",
                "deptid":"dept1",
                "dept_name":"淘宝",
                "gmt_modified":"2017-05-01 00:00:00",
                "corp_name":"阿里巴巴",
                "userid":"user1",
                "flow_code":"abc123",
                "trip_day":"1",
                "traveler_list":{
                        "user_name":"张三",
                        "userid":"user1"
                },
                "thirdpart_id":"abc",
                "trip_title":"北京出差",
                "itinerary_list":{
                        "arr_city":"北京",
                        "arr_date":"2017-05-01 00:00:00",
                        "trip_way":"1",
                        "itinerary_id":"abcdefg",
                        "traffic_type":"0",
                        "dep_city":"杭州",
                        "project_code":"xm1",
                        "project_title":"项目1",
                        "cost_center_name":"阿里巴巴",
                        "dep_date":"2017-05-01 00:00:00",
                        "invoice_name":"阿里巴巴"
                },
                "approver_list":{
                        "note":"同意",
                        "status_desc":"同意",
                        "user_name":"张三",
                        "userid":"user1",
                        "order":"1",
                        "status":"1",
                        "operate_time":"2017-05-01 00:00:00"
                },
                "id":"12345",
                "trip_cause":"北京出差",
                "status":"1"
        },
        "errmsg":"成功"
}