alitrip.btrip.open.supplychain.vehicle.trade (商旅用车交易流水接口)

商旅用车交易流水接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
rq OpenApiZzdSearchRq 可选 入参
  • └ thirdpart_corp_id
  • String
  • 必须
  • asdf
  • 第三方企业ID
  • └ order_id
  • Number
  • 可选
  • 12345
  • 订单号
  • └ end_date
  • String
  • 可选
  • 2021-04-01 00:00:00
  • 结算结束时间
  • └ page_size
  • Number
  • 必须
  • 100
  • 每页条数
  • └ user_id
  • String
  • 可选
  • fghj
  • 第三方用户ID
  • └ apply_id
  • Number
  • 可选
  • 12345
  • 商旅审批单号
  • └ page
  • Number
  • 必须
  • 1
  • 页数
  • └ trade_id
  • String
  • 可选
  • sdfghjkl
  • 第三方交易id
  • └ start_date
  • String
  • 可选
  • 2021-04-01 00:00:00
  • 结算开始时间

响应参数

名称 类型 示例值 描述
result HisvResultSupport result 出参
  • └ success
  • Boolean
  • true
  • 是否成功
  • trade_list
  • OpenApiZzdVehicleOrderRs []
  • module
  • 出参
  • └ trade_id
  • String
  • asdfg
  • 第三方交易ID
  • └ trade_type
  • Number
  • 1
  • 1. 用车支付 2. 服务费 3. 用车取消后收费 101. 用车退款 102. 用车赔付
  • └ trade_action
  • Number
  • 1
  • 资金流向:1:支出,2:收入
  • └ order_id
  • Number
  • 1234
  • 订单号
  • └ corp_id
  • String
  • asdfg
  • 商旅企业id
  • └ thirdpart_corp_id
  • String
  • sadffg
  • 第三方企业id
  • └ user_id
  • String
  • fghjk
  • 第三方用户ID
  • └ user_nick
  • String
  • 测试用户
  • 企业维护的用户名称
  • └ depart_name
  • String
  • 测试部门
  • 部门名称
  • └ apply_id
  • Number
  • 12345
  • 商旅审批单id
  • └ third_part_apply_id
  • String
  • dfghjk
  • 第三方申请单id
  • └ apply_title
  • String
  • 审批单名称
  • 申请单标题
  • └ status
  • String
  • 1
  • 4:已取消 402:取消产生费用自动支付已投诉 6:取消产生费用已确认 403:取消产生费用已确认已投诉 404:取消产生费用未支付已投诉 500:行程结束不认可费用 502:行程结束已支付已投诉 700:行程结束车费合理 701:行程结束自动扣款系统检测合理待确认 702:行程结束自动扣款系统检测合理已确认 703:行程结束自动扣款系统检测费用不合理已投诉 704:历史行程结束待确认订单,订正为此 705:客服关单 706:行程结束自动扣款系统检测合理已确认已投诉 707:行程结束自动扣款系统检测合理直接投诉
  • └ user_confirm
  • Number
  • 1
  • 用户确认 0未确认 1确认 2 有异议 3 系统自动检测不合理
  • └ user_confirm_reason
  • String
  • 不认可
  • 用户认可/不认可原因
  • └ cancel_reason
  • String
  • 取消理由
  • 取消理由
  • └ gmt_create
  • String
  • 2021-04-01 00:00:00
  • 创建时间
  • └ gmt_modified
  • String
  • 2021-04-01 00:00:00
  • 订单状态改变时间
  • └ pay_type
  • Number
  • 0
  • 支付类型,0:企业支付 2.混合支付
  • └ settle_type
  • Number
  • 1
  • 结算方式:1:个人现付,2:企业现付,4:企业月结,8、企业预存
  • └ order_type
  • String
  • TRAVEL
  • TRAVEL: 差旅, TRAFFIC: 市内交通, WORK: 加班, OTHER: 其它
  • └ amount
  • Number
  • 10000
  • 总结算金额(分)
  • └ corp_amount
  • Number
  • 10000
  • 企业支付(分)
  • └ personal_amount
  • Number
  • 10000
  • 个人支付(分),当pay_type是混合支付时有值
  • └ refund_fee
  • Number
  • 100
  • 退票费(分)
  • └ service_fee
  • Number
  • 100
  • 服务费(分)
  • └ currency
  • String
  • CNY
  • 货币种类
  • └ settlement_batch_no
  • String
  • yyyy-MM-dd HH:mm:ss
  • 结算批次:该订单结算时间
  • └ invoice_id
  • String
  • 1234
  • 商旅发票ID
  • └ invoice_title
  • String
  • 发票抬头
  • 发票抬头
  • cost_center_list
  • CostCenterDo []
  • costCenterList
  • 成本中心信息
  • └ cost_center_id
  • Number
  • 1234
  • 商旅成本中心ID
  • └ cost_center_title
  • String
  • 测试成本
  • 成本中心名称
  • └ cost_center_number
  • String
  • sdfghj
  • 成本中心编号
  • └ third_cost_center_id
  • String
  • sdfghjk
  • 第三方成本中心ID
  • client_info_dos
  • ClientInfoDo []
  • clientInfoDOs
  • 用户信息
  • └ user_id
  • String
  • asdf
  • 第三方用户ID
  • └ user_name
  • String
  • 测试用户
  • 用户名称
  • └ project_code
  • String
  • dfghj
  • 项目编号
  • └ project_title
  • String
  • 测试项目
  • 项目名称
  • └ thirdpart_itinerary_id
  • String
  • asdfg
  • 第三方行程单号
  • └ itinerary_no
  • String
  • xcvbn
  • 商旅行程单号
  • └ cancel_time
  • Date
  • 2021-05-06 17:00:30
  • 取消时间
  • └ pay_time
  • Date
  • 2021-05-06 17:00:30
  • 支付时间
  • └ is_special
  • Boolean
  • true
  • 是否特殊订单
  • └ special_types
  • String
  • 特殊订单类型
  • v_sp_t_1:用车里程,v_sp_t_2:实际下车点,v_sp_t_3:用车金额,v_sp_t_4:用车次数,v_sp_t_5:跨城订单
  • car_info_do_list
  • CarInfoDo []
  • carInfoDOList
  • 用车信息
  • └ from_addr
  • String
  • 阿里巴巴西溪园区(南2门)
  • 预订出发地
  • └ to_addr
  • String
  • 阿里巴巴西溪园区(南2门)
  • 预订到达地
  • └ from_city_name
  • String
  • 杭州
  • 预订出发城市
  • └ to_city_name
  • String
  • 杭州
  • 预订到达城市
  • └ real_from_addr
  • String
  • 阿里巴巴西溪园区
  • 实际出发地
  • └ real_to_addr
  • String
  • 阿里巴巴西溪园区
  • 实际到达地
  • └ real_from_city_name
  • String
  • 杭州
  • 实际出发城市
  • └ real_to_city_name
  • String
  • 杭州
  • 实际到达城市
  • └ provider
  • Number
  • 2
  • 2:滴滴出行 8:滴滴出行 100087:滴滴出行 100000:滴滴出行 100003:曹操出行 3:曹操出行 100085:曹操出行 100007:阳光出行 5:阳光出行 0:其他
  • └ provider_name
  • String
  • 滴滴出行
  • 滴滴出行 曹操出行 阳光出行 其他
  • └ memo
  • String
  • 加班
  • 打车是由
  • └ car_level
  • String
  • KC
  • TAXI:出租车 KC:经济型 COSY:舒适型 COMMERCE:商务型 LUXURY:豪华型
  • └ car_info
  • String
  • 白色本田
  • 车辆类型
  • └ publish_time
  • Date
  • 2021-05-06 17:00:30
  • 乘客发布用车时间
  • └ taken_time
  • Date
  • 2021-05-06 17:00:30
  • 乘客上车时间
  • └ driver_confirm_time
  • Date
  • 2021-05-06 17:00:30
  • 司机到达确认时间
  • └ travel_distance
  • String
  • 17.40
  • 行驶公里数(km)

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripBtripOpenSupplychainVehicleTradeRequest req = new AlitripBtripOpenSupplychainVehicleTradeRequest();
AlitripBtripOpenSupplychainVehicleTradeRequest.OpenApiZzdSearchRq obj1 = new AlitripBtripOpenSupplychainVehicleTradeRequest.OpenApiZzdSearchRq();
obj1.setThirdpartCorpId("asdf");
obj1.setOrderId(12345L);
obj1.setEndDate("2021-04-01 00:00:00");
obj1.setPageSize(100L);
obj1.setUserId("fghj");
obj1.setApplyId(12345L);
obj1.setPage(1L);
obj1.setTradeId("sdfghjkl");
obj1.setStartDate("2021-04-01 00:00:00");
req.setRq(obj1);
AlitripBtripOpenSupplychainVehicleTradeResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_btrip_open_supplychain_vehicle_trade_response>
    <result>
        <success>true</success>
        <trade_list>
            <open_api_zzd_vehicle_order_rs>
                <trade_id>asdfg</trade_id>
                <trade_type>1</trade_type>
                <trade_action>1</trade_action>
                <order_id>1234</order_id>
                <corp_id>asdfg</corp_id>
                <thirdpart_corp_id>sadffg</thirdpart_corp_id>
                <user_id>fghjk</user_id>
                <user_nick>测试用户</user_nick>
                <depart_name>测试部门</depart_name>
                <apply_id>12345</apply_id>
                <third_part_apply_id>dfghjk</third_part_apply_id>
                <apply_title>审批单名称</apply_title>
                <status>1</status>
                <user_confirm>1</user_confirm>
                <user_confirm_reason>不认可</user_confirm_reason>
                <cancel_reason>取消理由</cancel_reason>
                <gmt_create>2021-04-01 00:00:00</gmt_create>
                <gmt_modified>2021-04-01 00:00:00</gmt_modified>
                <pay_type>0</pay_type>
                <settle_type>1</settle_type>
                <order_type>TRAVEL</order_type>
                <amount>10000</amount>
                <corp_amount>10000</corp_amount>
                <personal_amount>10000</personal_amount>
                <refund_fee>100</refund_fee>
                <service_fee>100</service_fee>
                <currency>CNY</currency>
                <settlement_batch_no>yyyy-MM-dd HH:mm:ss</settlement_batch_no>
                <invoice_id>1234</invoice_id>
                <invoice_title>发票抬头</invoice_title>
                <cost_center_list>
                    <cost_center_do>
                        <cost_center_id>1234</cost_center_id>
                        <cost_center_title>测试成本</cost_center_title>
                        <cost_center_number>sdfghj</cost_center_number>
                        <third_cost_center_id>sdfghjk</third_cost_center_id>
                    </cost_center_do>
                </cost_center_list>
                <client_info_dos>
                    <client_info_do>
                        <user_id>asdf</user_id>
                        <user_name>测试用户</user_name>
                    </client_info_do>
                </client_info_dos>
                <project_code>dfghj</project_code>
                <project_title>测试项目</project_title>
                <thirdpart_itinerary_id>asdfg</thirdpart_itinerary_id>
                <itinerary_no>xcvbn</itinerary_no>
                <cancel_time>2021-05-06 17:00:30</cancel_time>
                <pay_time>2021-05-06 17:00:30</pay_time>
                <is_special>true</is_special>
                <special_types>特殊订单类型</special_types>
                <car_info_do_list>
                    <car_info_do>
                        <from_addr>阿里巴巴西溪园区(南2门)</from_addr>
                        <to_addr>阿里巴巴西溪园区(南2门)</to_addr>
                        <from_city_name>杭州</from_city_name>
                        <to_city_name>杭州</to_city_name>
                        <real_from_addr>阿里巴巴西溪园区</real_from_addr>
                        <real_to_addr>阿里巴巴西溪园区</real_to_addr>
                        <real_from_city_name>杭州</real_from_city_name>
                        <real_to_city_name>杭州</real_to_city_name>
                        <provider>2</provider>
                        <provider_name>滴滴出行</provider_name>
                        <memo>加班</memo>
                        <car_level>KC</car_level>
                        <car_info>白色本田</car_info>
                        <publish_time>2021-05-06 17:00:30</publish_time>
                        <taken_time>2021-05-06 17:00:30</taken_time>
                        <driver_confirm_time>2021-05-06 17:00:30</driver_confirm_time>
                        <travel_distance>17.40</travel_distance>
                    </car_info_do>
                </car_info_do_list>
            </open_api_zzd_vehicle_order_rs>
        </trade_list>
    </result>
</alitrip_btrip_open_supplychain_vehicle_trade_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

返回
顶部