文档中心 > API类目 > 阿里商旅对外API

阿里商旅对外API

alitrip.btrip.corpop.apply.get (【商旅】查询审批单)

【商旅】查询审批单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
rq OpenIsvSearchRq 必须 请求对象
  • └ apply_id
  • Number
  • 可选
  • 123
  • 阿里商旅审批单id
  • └ apply_show_id
  • String
  • 可选
  • 201710111505000464651
  • 阿里商旅审批单展示id
  • └ corp_id
  • String
  • 必须
  • corpId1
  • 第三方企业ID
  • └ thirdpart_apply_id
  • String
  • 可选
  • abcdef
  • 外部审批单id
  • └ version
  • Number
  • 可选
  • 2
  • 1、老版本2、isv对外版本
  • └ type
  • Number
  • 可选
  • 2
  • 申请单提交类型 1代提交 2本人提交 注意：当申请单为代提交时，申请单提交人自己无法为自己下单

响应参数

名称 类型 示例值 描述
result HisvResult result 出参对象
  • module
  • OpenIsvApplyRs
  • module
  • 审批单对象
  • └ apply_show_id
  • String
  • 201710111505000464651
  • 商旅审批展示id
  • approver_list
  • OpenApproverInfo []
  • approverList
  • 审批人列表
  • └ note
  • String
  • 同意
  • 审批意见
  • └ operate_time
  • Date
  • 2017-05-01 00:00:00
  • 操作时间
  • └ order
  • Number
  • 1
  • 审批人顺序
  • └ status
  • Number
  • 1
  • 审批状态：0审批中 1已同意 2已拒绝 3已转交，4已取消 5已终止 6发起审批 7评论
  • └ status_desc
  • String
  • 同意
  • 审批状态描述
  • └ user_id
  • String
  • user1
  • 审批人id
  • └ user_name
  • String
  • 张三
  • 审批人名称
  • └ corp_id
  • String
  • corp1
  • 商旅企业id
  • └ corp_name
  • String
  • 阿里巴巴
  • 企业名称
  • └ depart_id
  • String
  • dept1
  • 申请人部门id
  • └ depart_name
  • String
  • 淘宝
  • 部门名称
  • └ gmt_create
  • Date
  • 2017-05-01 00:00:00
  • 创建时间
  • └ gmt_modified
  • Date
  • 2017-05-01 00:00:00
  • 更新时间
  • └ id
  • Number
  • 12345
  • 商旅审批单id
  • itinerary_list
  • OpenItineraryInfo []
  • itineraryList
  • 行程列表
  • └ arr_city
  • String
  • 北京
  • 到达城市
  • └ arr_city_code
  • String
  • 330100
  • 到达城市编码，0代表不管控到达城市
  • └ arr_date
  • Date
  • 2017-05-01 00:00:00
  • 到达时间
  • └ cost_center_name
  • String
  • 阿里巴巴
  • 成本中心
  • └ dep_city
  • String
  • 杭州
  • 出发城市
  • └ dep_city_code
  • String
  • 330100
  • 出发城市编码，0代表不管控出发城市
  • └ dep_date
  • Date
  • 2017-05-01 00:00:00
  • 出发时间
  • └ invoice_name
  • String
  • 阿里巴巴
  • 发票抬头
  • └ itinerary_id
  • String
  • abcdefg
  • 行程id
  • └ project_code
  • String
  • xm1
  • 项目编号
  • └ project_title
  • String
  • 项目1
  • 项目名称
  • └ traffic_type
  • Number
  • 0
  • 交通方式： 0 飞机、酒店、用车, 1 火车、酒店、用车, 2 用车、酒店, 3 用车、酒店，4 用车、酒店，6 飞机、用车，7 火车、用车，9 飞机、火车、酒店、用车，10 飞机、火车、用车，11 仅用车，21 飞机、酒店，22 火车、酒店，24 酒店，25 飞机，26 火车，27 飞机、火车、酒店，28 飞机、火车
  • └ trip_way
  • Number
  • 1
  • 行程方式：0单程 1往返
  • └ status
  • Number
  • 1
  • 审批状态：0审批中 1已同意 2已拒绝 3已转交，4已取消 5已终止 6发起审批 7评论
  • └ status_desc
  • String
  • 同意
  • 审批状态描述
  • └ thirdpart_business_id
  • String
  • 123
  • 第三方业务id
  • └ thirdpart_id
  • String
  • abc
  • 第三方审批单id,如果非第三方审批单则为空
  • traveler_list
  • OpenUserInfo []
  • travelerList
  • 出行人列表
  • └ user_id
  • String
  • user1
  • 出行人id
  • └ user_name
  • String
  • 张三
  • 出行人名称
  • └ flight_cabins
  • String
  • Y
  • 国内机票舱等，多值逗号分隔。F：头等舱，C：商务舱，Y：经济舱，P：超级经济舱
  • └ economy_discount
  • Number
  • 1
  • 经济舱折扣。1到10的整数
  • └ business_discount
  • Number
  • 1
  • 商务舱折扣。1到10的整数
  • └ first_discount
  • Number
  • 1
  • 头等舱折扣。1到10的整数
  • └ train_seats
  • String
  • 1
  • 火车票坐席，多值逗号分隔。0：硬座，1：硬卧，2：软座，3：软卧，4：高级软卧，5：商务座，6：一等座，7：二等座，8：动卧
  • hotel_citys
  • HotelCityFee []
  • 酒店城市费用列表
  • └ city_code
  • String
  • 330100
  • 城市编码，0代表其他全部城市
  • └ city_name
  • String
  • 北京
  • 城市名称
  • └ fee
  • Number
  • 10000
  • 酒店间夜金额，单位(分)，不限：99999999。注意：差标只能管控到元，角、分会被抹掉。
  • └ reserve_type
  • Number
  • 1
  • 限制差标类型。0-不限差标，1-限制差标
  • └ international_flight_cabins
  • String
  • Y
  • 国际机票舱等，多值逗号分隔。F：头等舱，C：商务舱，Y：经济舱，P：超级经济舱
  • └ premium_economy_discount
  • Number
  • 1
  • 超级经济舱折扣。1到10的整数
  • └ trip_cause
  • String
  • 北京出差
  • 出差事由
  • └ trip_day
  • Number
  • 1
  • 出差天数
  • └ trip_title
  • String
  • 北京出差
  • 审批单标题
  • └ user_id
  • String
  • user1
  • 申请人id（第三方用户Id）
  • └ user_name
  • String
  • 张三
  • 用户名称
  • └ type
  • Number
  • 2
  • 申请单提交类型 1代提交 2本人提交 注意：当申请单为代提交时，申请单提交人自己无法为自己下单
  • └ union_no
  • String
  • abc131
  • 第三方关联单号
  • external_traveler_list
  • OpenUserInfo []
  • externalTravelerList
  • 外部出行人列表
  • └ flight_cabins
  • String
  • Y
  • 国内机票舱等，多值逗号分隔。F：头等舱，C：商务舱，Y：经济舱，P：超级经济舱
  • └ economy_discount
  • Number
  • 1
  • 经济舱折扣。1到10的整数
  • └ business_discount
  • Number
  • 1
  • 商务舱折扣。1到10的整数
  • └ first_discount
  • Number
  • 1
  • 头等舱折扣。1到10的整数
  • └ train_seats
  • String
  • 1
  • 火车票坐席，多值逗号分隔。0：硬座，1：硬卧，2：软座，3：软卧，4：高级软卧，5：商务座，6：一等座，7：二等座，8：动卧
  • hotel_citys
  • HotelCityFee []
  • 酒店城市费用列表
  • └ city_code
  • String
  • 330100
  • 城市编码，0代表其他全部城市
  • └ city_name
  • String
  • 北京
  • 城市名称
  • └ fee
  • Number
  • 10000
  • 酒店间夜金额，单位(分)，不限：99999999。注意：差标只能管控到元，角、分会被抹掉。
  • └ reserve_type
  • Number
  • 1
  • 限制差标类型。0-不限差标，1-限制差标
  • └ user_name
  • String
  • 张三
  • 用户名称
  • └ international_flight_cabins
  • String
  • Y
  • 国际机票舱等，多值逗号分隔。F：头等舱，C：商务舱，Y：经济舱，P：超级经济舱
  • └ premium_economy_discount
  • Number
  • 1
  • 超级经济舱折扣。1到10的整数
  • └ hotel_budget
  • Number
  • 100000
  • 审批单酒店预算，单位分
  • └ flight_budget
  • Number
  • 100000
  • 审批单机票预算，单位分
  • └ train_budget
  • Number
  • 100000
  • 审批单火车票预算，单位分
  • └ vehicle_budget
  • Number
  • 100000
  • 审批单用车预算，单位分
  • └ budget
  • Number
  • 100000
  • 审批单总预算，单位分
  • └ budget_merge
  • Number
  • 1
  • 多个申请单预算合并。1：否，【union_no】相同的【申请单(apply id)】，每个的【预算】仅对本申请单生效。2：是，所有【union_no】相同的【申请单(apply id)】，其中全部【预算】合并求和，可以混用。
  • └ limit_traveler
  • Number
  • 0
  • 0：不限制出行人，1：限申请单内的出行人。注意：不限出行人，实际出行人也不限制差标
  • └ together_book_rule
  • Number
  • 1
  • 同时预订(机票&火车票)规则。1：就高；2：就低。
  • hotel_share
  • HotelShareInfo
  • 酒店合住规则
  • └ type
  • String
  • 1
  • 合住公式。1-"(A+B)*param%",2-"A*param%",3-"A+B*param%",4-"A+param元",5-"(A+B)/2+param元"
  • └ param
  • String
  • 70
  • 合住公式参数
  • itinerary_set_list
  • OpenItineraryInfo []
  • 城市集行程列表
  • └ itinerary_id
  • String
  • abcdefg
  • 行程id
  • └ traffic_type
  • Number
  • 0
  • 交通方式： 0 飞机、酒店、用车, 1 火车、酒店、用车, 2 用车、酒店, 3 用车、酒店，4 用车、酒店，6 飞机、用车，7 火车、用车，9 飞机、火车、酒店、用车，10 飞机、火车、用车，11 仅用车，21 飞机、酒店，22 火车、酒店，24 酒店，25 飞机，26 火车，27 飞机、火车、酒店，28 飞机、火车
  • └ city_set
  • String
  • 北京，上海
  • 离抵城市名称，多个城市用中文“，”隔开
  • └ city_code_set
  • String
  • 330100，110100
  • 离抵城市code，多个城市用中文“，”隔开
  • └ dep_date
  • String
  • 2017-05-01 00:00:00
  • 出发日期
  • └ arr_date
  • String
  • 2017-05-01 00:00:00
  • 到达日期
  • └ cost_center_name
  • String
  • 成本中心名称
  • 成本中心名称
  • └ invoice_name
  • String
  • 发票抬头
  • 发票抬头
  • └ project_code
  • String
  • 项目编号
  • 项目编号
  • └ project_title
  • String
  • 项目名称
  • 项目名称
  • └ itinerary_rule
  • Number
  • 0
  • 申请单城市规则： 0出发&目的地一对一，按列表传行程 1多选N个地点，城市集行程 不传默认为0 会根据商旅管理后台-通用差旅设置-行程城市规则中的设置，校验申请单本字段的值是否正确 当行程城市规则中设置的是“1对1行程”时，必须传0 当行程城市规则中设置的是“多对多城市集行程”时，必须传1 会根据此字段传入的值，校验行程传参是否正确 当申请单城市规则为0，itinerary_list行程列表必填 当申请单城市规则为1，城市集行程必填
  • └ result_code
  • Number
  • 0
  • 错误码
  • └ result_msg
  • String
  • 成功
  • 错误信息
  • └ success
  • Boolean
  • true
  • 成功标识

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripBtripCorpopApplyGetRequest req = new AlitripBtripCorpopApplyGetRequest();
AlitripBtripCorpopApplyGetRequest.OpenIsvSearchRq obj1 = new AlitripBtripCorpopApplyGetRequest.OpenIsvSearchRq();
obj1.setApplyId(123L);
obj1.setApplyShowId("201710111505000464651");
obj1.setCorpId("corpId1");
obj1.setThirdpartApplyId("abcdef");
obj1.setVersion(2L);
obj1.setType(2L);
req.setRq(obj1);
AlitripBtripCorpopApplyGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
<alitrip_btrip_corpop_apply_get_response>
    <result>
        <module>
            <apply_show_id>201710111505000464651</apply_show_id>
            <approver_list>
                <open_approver_info>
                    <note>同意</note>
                    <operate_time>2017-05-01 00:00:00</operate_time>
                    <order>1</order>
                    <status>1</status>
                    <status_desc>同意</status_desc>
                    <user_id>user1</user_id>
                    <user_name>张三</user_name>
                </open_approver_info>
            </approver_list>
            <corp_id>corp1</corp_id>
            <corp_name>阿里巴巴</corp_name>
            <depart_id>dept1</depart_id>
            <depart_name>淘宝</depart_name>
            <gmt_create>2017-05-01 00:00:00</gmt_create>
            <gmt_modified>2017-05-01 00:00:00</gmt_modified>
            <id>12345</id>
            <itinerary_list>
                <open_itinerary_info>
                    <arr_city>北京</arr_city>
                    <arr_city_code>330100</arr_city_code>
                    <arr_date>2017-05-01 00:00:00</arr_date>
                    <cost_center_name>阿里巴巴</cost_center_name>
                    <dep_city>杭州</dep_city>
                    <dep_city_code>330100</dep_city_code>
                    <dep_date>2017-05-01 00:00:00</dep_date>
                    <invoice_name>阿里巴巴</invoice_name>
                    <itinerary_id>abcdefg</itinerary_id>
                    <project_code>xm1</project_code>
                    <project_title>项目1</project_title>
                    <traffic_type>0</traffic_type>
                    <trip_way>1</trip_way>
                </open_itinerary_info>
            </itinerary_list>
            <status>1</status>
            <status_desc>同意</status_desc>
            <thirdpart_business_id>123</thirdpart_business_id>
            <thirdpart_id>abc</thirdpart_id>
            <traveler_list>
                <open_user_info>
                    <user_id>user1</user_id>
                    <user_name>张三</user_name>
                    <flight_cabins>Y</flight_cabins>
                    <economy_discount>1</economy_discount>
                    <business_discount>1</business_discount>
                    <first_discount>1</first_discount>
                    <train_seats>1</train_seats>
                    <hotel_citys>
                        <hotel_city_fee>
                            <city_code>330100</city_code>
                            <city_name>北京</city_name>
                            <fee>10000</fee>
                        </hotel_city_fee>
                    </hotel_citys>
                    <reserve_type>1</reserve_type>
                    <international_flight_cabins>Y</international_flight_cabins>
                    <premium_economy_discount>1</premium_economy_discount>
                </open_user_info>
            </traveler_list>
            <trip_cause>北京出差</trip_cause>
            <trip_day>1</trip_day>
            <trip_title>北京出差</trip_title>
            <user_id>user1</user_id>
            <user_name>张三</user_name>
            <type>2</type>
            <union_no>abc131</union_no>
            <external_traveler_list>
                <open_user_info>
                    <flight_cabins>Y</flight_cabins>
                    <economy_discount>1</economy_discount>
                    <business_discount>1</business_discount>
                    <first_discount>1</first_discount>
                    <train_seats>1</train_seats>
                    <hotel_citys>
                        <hotel_city_fee>
                            <city_code>330100</city_code>
                            <city_name>北京</city_name>
                            <fee>10000</fee>
                        </hotel_city_fee>
                    </hotel_citys>
                    <reserve_type>1</reserve_type>
                    <user_name>张三</user_name>
                    <international_flight_cabins>Y</international_flight_cabins>
                    <premium_economy_discount>1</premium_economy_discount>
                </open_user_info>
            </external_traveler_list>
            <hotel_budget>100000</hotel_budget>
            <flight_budget>100000</flight_budget>
            <train_budget>100000</train_budget>
            <vehicle_budget>100000</vehicle_budget>
            <budget>100000</budget>
            <budget_merge>1</budget_merge>
            <limit_traveler>0</limit_traveler>
            <together_book_rule>1</together_book_rule>
            <hotel_share>
                <type>1</type>
                <param>70</param>
            </hotel_share>
            <itinerary_set_list>
                <open_itinerary_info>
                    <itinerary_id>abcdefg</itinerary_id>
                    <traffic_type>0</traffic_type>
                    <city_set>北京，上海</city_set>
                    <city_code_set>330100，110100</city_code_set>
                    <dep_date>2017-05-01 00:00:00</dep_date>
                    <arr_date>2017-05-01 00:00:00</arr_date>
                    <cost_center_name>成本中心名称</cost_center_name>
                    <invoice_name>发票抬头</invoice_name>
                    <project_code>项目编号</project_code>
                    <project_title>项目名称</project_title>
                </open_itinerary_info>
            </itinerary_set_list>
            <itinerary_rule>0</itinerary_rule>
        </module>
        <result_code>0</result_code>
        <result_msg>成功</result_msg>
        <success>true</success>
    </result>
</alitrip_btrip_corpop_apply_get_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
404 没有找到对应的审批单 排查一下查询入参是否正确

API工具

API测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部
阿里巴巴集团 | 淘宝网 | 天猫 | 聚划算 | 全球速卖通 | 阿里巴巴国际交易市场 | 1688 | 阿里妈妈 | 阿里旅行·去啊 | 阿里云计算 | YunOS | 阿里通信 | 万网 | 高德 | 优视 | 友盟 | 酷盘 | 虾米 | 天天动听 | 来往 | 钉钉 | 11Main | 支付宝
关于淘宝 合作伙伴 营销中心 联系客服 开放平台 诚征英才 联系我们 网站地图 法律声明 © 2016 Taobao.com 版权所有
网络文化经营许可证：文网文[2010]040号 | 增值电信业务经营许可证：浙B2-20080224-1 | 信息网络传播视听节目许可证：1109364号