alitrip.btrip.supplychain.vehicle.search (【商旅】用车订单搜索)

【商旅】用车订单搜索

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
rq OpenApiSearchRq 必须 出参
  • └ all_apply
  • Boolean
  • 可选
  • true
  • false:仅搜索未报销订单
  • └ apply_id
  • Number
  • 可选
  • 12345
  • 商旅审批单id
  • └ corp_id
  • String
  • 必须
  • corp1
  • 第三方企业id
  • └ depart_id
  • String
  • 可选
  • dept1
  • 用户所在部门id
  • └ end_time
  • Date
  • 可选
  • 2017-05-01 00:00:00
  • 结束时间
  • └ page
  • Number
  • 可选
  • 1
  • 页数,从1开始
  • └ page_size
  • Number
  • 可选
  • 10
  • 每页数量,默认10,最大50
  • └ start_time
  • Date
  • 可选
  • 2017-05-01 00:00:00
  • 开始时间
  • └ thirdpart_apply_id
  • String
  • 可选
  • 123
  • 第三方申请单ID
  • └ update_end_time
  • Date
  • 可选
  • 2017-05-01 00:00:00
  • 更新开始时间
  • └ update_start_time
  • Date
  • 可选
  • 2017-05-01 00:00:00
  • 更新结束时间
  • └ user_id
  • String
  • 可选
  • user1
  • 第三方用户id
  • └ version
  • Number
  • 可选
  • 2
  • 1、老版本2、isv对外版本

响应参数

名称 类型 示例值 描述
result HisvResult result 出参
  • module_list
  • OpenApiVehicleOrderRs []
  • module
  • 用车订单列表
  • └ id
  • Number
  • 12345
  • 订单id
  • └ gmt_create
  • Date
  • 2017-05-01 00:00:00
  • 订单创建时间
  • └ gmt_modified
  • Date
  • 2017-05-01 00:00:00
  • 订单更新时间
  • └ passenger_name
  • String
  • 李四
  • 乘客名称
  • └ corp_id
  • String
  • corp1
  • 商旅企业id
  • └ corp_name
  • String
  • 阿里巴巴
  • 企业名称
  • └ user_name
  • String
  • 张三
  • 预定人名称
  • └ user_id
  • String
  • user1
  • 预定人id(第三方用户Id)
  • └ dept_id
  • Number
  • dept1
  • 用户所在部门id
  • └ dept_name
  • String
  • 淘宝
  • 用户所在部门名称
  • └ apply_id
  • Number
  • 123
  • 商旅系统审批单id
  • └ apply_show_id
  • String
  • 201802031353000525653
  • 商旅审批单展示id(非审批api对接企业)
  • └ real_from_address
  • String
  • 高新文教区东部软件园创新大厦(马塍路)
  • 真实出发地
  • └ real_to_address
  • String
  • 联创街
  • 真实到达地
  • └ real_from_city_name
  • String
  • 杭州
  • 实际出发城市
  • └ real_to_city_name
  • String
  • 杭州
  • 实际到达城市
  • └ from_address
  • String
  • 阿里巴巴西溪园区
  • 出发地
  • └ to_address
  • String
  • 乐佳国际
  • 目的地
  • └ from_city_name
  • String
  • 杭州
  • 出发城市
  • └ to_city_name
  • String
  • 杭州
  • 目的城市
  • └ memo
  • String
  • 加班
  • 打车事由
  • └ order_status
  • Number
  • 2
  • 订单状态:0:初始状态,1:已超时,2:派单成功,3:派单失败,4:已退款,5:已支付,6:已取消
  • └ car_level
  • Number
  • 3
  • 类型级别:1经济型、2舒适型、3豪华型
  • └ car_info
  • String
  • 白色本田
  • 车辆类型
  • └ estimate_price
  • String
  • 100.0
  • 订单预估价格
  • └ publish_time
  • Date
  • 2017-05-01 00:00:00
  • 乘客发布用车时间
  • └ taken_time
  • Date
  • 2017-05-01 00:00:00
  • 乘客上车时间
  • └ driver_confirm_time
  • Date
  • 2017-05-01 00:00:00
  • 司机到达目的地时间
  • └ cancel_time
  • Date
  • 2017-05-01 00:00:00
  • 取消时间
  • └ pay_time
  • Date
  • 2017-05-01 00:00:00
  • 支付时间
  • └ travel_distance
  • String
  • 1.2
  • 行驶公里数
  • └ service_type
  • Number
  • 1
  • 打车服务类型 1:出租车, 2:专车, 3:快车
  • └ business_category
  • String
  • TRAVEL
  • 用车原因:TRAVEL: 差旅, TRAFFIC: 市内交通, WORK: 加班, OTHER: 其它
  • └ cost_center_id
  • Number
  • 12345
  • 商旅成本中心id
  • └ cost_center_number
  • String
  • abcde
  • 成本中心编号
  • └ invoice_id
  • Number
  • 12345
  • 商旅发票id
  • └ invoice_title
  • String
  • 阿里巴巴
  • 发票抬头
  • └ project_code
  • String
  • abcef
  • 项目编号
  • └ project_title
  • String
  • 北京项目
  • 项目名称
  • price_info_list
  • OpenPriceInfo []
  • priceInfoList
  • 价目详情列表
  • └ price
  • String
  • 100.0
  • 企业支付金额
  • └ type
  • Number
  • 1
  • 资金流向:1:支出,2:收入
  • └ category
  • String
  • 用车支付
  • 交易类型(废弃):用车支付, 服务费, 用车取消后收费, 用车退款, 用车赔付
  • └ pay_type
  • Number
  • 1
  • 结算方式:1:个人现付,2:企业现付,4:企业月结,8、企业预存
  • └ gmt_create
  • Date
  • 2017-05-01 00:00:00
  • 流水创建时间
  • └ passenger_name
  • String
  • 张三,李四
  • 出行人,多个用‘,’分割
  • └ trade_id
  • String
  • 8908076767
  • 订单交易流水号
  • └ category_type
  • Number
  • 1
  • 交易类目类型1-飞机,2-酒店,3-火车,4-用车
  • └ category_code
  • Number
  • 1
  • 交易类目编码
  • └ person_price
  • String
  • 100.0
  • 个人支付金额
  • └ thirdpart_itinerary_id
  • String
  • abcdefg
  • 第三方行程id
  • user_affiliate_list
  • OpenUserAffiliateDo []
  • 张三、李四
  • 出行人列表
  • └ user_id
  • String
  • 123
  • 出行人ID(第三方用户Id)
  • └ user_name
  • String
  • 张三
  • 出行人名称
  • └ user_confirm
  • Number
  • 1
  • 用户确认状态:0未确认;1已确认;2有异议;3系统检查不合理
  • └ provider
  • Number
  • 2
  • 服务商:2滴滴;3:曹操;4:首汽;5:阳光。可能会有其他服务商的增加。
  • └ thirdpart_apply_id
  • String
  • 123
  • 第三方申请单ID
  • └ btrip_title
  • String
  • 出差
  • 申请单名称
  • └ cost_center_name
  • String
  • 测试成本中心
  • 成本中心名称
  • └ is_special
  • Boolean
  • true
  • 是否特殊订单
  • └ special_types
  • String []
  • v_sp_t_1
  • 特殊订单类型;v_sp_t_1:用车里程,v_sp_t_2:实际下车点,v_sp_t_3:用车金额,v_sp_t_4:用车次数,v_sp_t_5:跨城订单
  • └ project_id
  • Number
  • 1
  • 项目id
  • └ result_code
  • Number
  • 0
  • 返回码
  • └ result_msg
  • String
  • 成功
  • 错误信息
  • └ is_success
  • Boolean
  • true
  • 成功标识
  • page_info
  • PageInfoRs
  • module
  • 分页相关信息
  • └ page
  • Number
  • 1
  • 当前页
  • └ page_size
  • Number
  • 10
  • 每页大小
  • └ total_number
  • Number
  • 100
  • 总记录数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripBtripSupplychainVehicleSearchRequest req = new AlitripBtripSupplychainVehicleSearchRequest();
AlitripBtripSupplychainVehicleSearchRequest.OpenApiSearchRq obj1 = new AlitripBtripSupplychainVehicleSearchRequest.OpenApiSearchRq();
obj1.setAllApply(true);
obj1.setApplyId(12345L);
obj1.setCorpId("corp1");
obj1.setDepartId("dept1");
obj1.setEndTime(StringUtils.parseDateTime("2017-05-01 00:00:00"));
obj1.setPage(1L);
obj1.setPageSize(10L);
obj1.setStartTime(StringUtils.parseDateTime("2017-05-01 00:00:00"));
obj1.setThirdpartApplyId("123");
obj1.setUpdateEndTime(StringUtils.parseDateTime("2017-05-01 00:00:00"));
obj1.setUpdateStartTime(StringUtils.parseDateTime("2017-05-01 00:00:00"));
obj1.setUserId("user1");
obj1.setVersion(2L);
req.setRq(obj1);
AlitripBtripSupplychainVehicleSearchResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_btrip_supplychain_vehicle_search_response>
    <result>
        <module_list>
            <open_api_vehicle_order_rs>
                <id>12345</id>
                <gmt_create>2017-05-01 00:00:00</gmt_create>
                <gmt_modified>2017-05-01 00:00:00</gmt_modified>
                <passenger_name>李四</passenger_name>
                <corp_id>corp1</corp_id>
                <corp_name>阿里巴巴</corp_name>
                <user_name>张三</user_name>
                <user_id>user1</user_id>
                <dept_id>dept1</dept_id>
                <dept_name>淘宝</dept_name>
                <apply_id>123</apply_id>
                <apply_show_id>201802031353000525653</apply_show_id>
                <real_from_address>高新文教区东部软件园创新大厦(马塍路)</real_from_address>
                <real_to_address>联创街</real_to_address>
                <real_from_city_name>杭州</real_from_city_name>
                <real_to_city_name>杭州</real_to_city_name>
                <from_address>阿里巴巴西溪园区</from_address>
                <to_address>乐佳国际</to_address>
                <from_city_name>杭州</from_city_name>
                <to_city_name>杭州</to_city_name>
                <memo>加班</memo>
                <order_status>2</order_status>
                <car_level>3</car_level>
                <car_info>白色本田</car_info>
                <estimate_price>100.0</estimate_price>
                <publish_time>2017-05-01 00:00:00</publish_time>
                <taken_time>2017-05-01 00:00:00</taken_time>
                <driver_confirm_time>2017-05-01 00:00:00</driver_confirm_time>
                <cancel_time>2017-05-01 00:00:00</cancel_time>
                <pay_time>2017-05-01 00:00:00</pay_time>
                <travel_distance>1.2</travel_distance>
                <service_type>1</service_type>
                <business_category>TRAVEL</business_category>
                <cost_center_id>12345</cost_center_id>
                <cost_center_number>abcde</cost_center_number>
                <invoice_id>12345</invoice_id>
                <invoice_title>阿里巴巴</invoice_title>
                <project_code>abcef</project_code>
                <project_title>北京项目</project_title>
                <price_info_list>
                    <open_price_info>
                        <price>100.0</price>
                        <type>1</type>
                        <category>用车支付</category>
                        <pay_type>1</pay_type>
                        <gmt_create>2017-05-01 00:00:00</gmt_create>
                        <passenger_name>张三,李四</passenger_name>
                        <trade_id>8908076767</trade_id>
                        <category_type>1</category_type>
                        <category_code>1</category_code>
                        <person_price>100.0</person_price>
                    </open_price_info>
                </price_info_list>
                <thirdpart_itinerary_id>abcdefg</thirdpart_itinerary_id>
                <user_affiliate_list>
                    <open_user_affiliate_do>
                        <user_id>123</user_id>
                        <user_name>张三</user_name>
                    </open_user_affiliate_do>
                </user_affiliate_list>
                <user_confirm>1</user_confirm>
                <provider>2</provider>
                <thirdpart_apply_id>123</thirdpart_apply_id>
                <btrip_title>出差</btrip_title>
                <cost_center_name>测试成本中心</cost_center_name>
                <is_special>true</is_special>
                <special_types>
                    <string>v_sp_t_1</string>
                </special_types>
                <project_id>1</project_id>
            </open_api_vehicle_order_rs>
        </module_list>
        <result_code>0</result_code>
        <result_msg>成功</result_msg>
        <is_success>true</is_success>
        <page_info>
            <page>1</page>
            <page_size>10</page_size>
            <total_number>100</total_number>
        </page_info>
    </result>
</alitrip_btrip_supplychain_vehicle_search_response>

异常示例

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

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部