alitrip.btrip.open.supplychain.train.trade (商旅火车票交易流水接口)

商旅火车票交易流水接口

公共参数

请求参数

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

响应参数

名称 类型 示例值 描述
result HisvResultSupport result 出参
  • └ success
  • Boolean
  • true
  • 是否成功
  • trade_list
  • OpenApiZzdTrainOrderRs []
  • module
  • 出参
  • └ service_fee
  • Number
  • 100
  • tmc收取的服务费(分)
  • └ refund_service_fee
  • Number
  • 100
  • tmc收取的退订服务费(分)
  • └ refund_fee
  • Number
  • 100
  • 退票费(分),退票退回的钱
  • └ personal_amount
  • Number
  • 100
  • 个人支付(分),当pay_type是个人支付时有值
  • └ corp_amount
  • Number
  • 100
  • 企业支付(分),当pay_type是企业支付时有值
  • └ amount
  • Number
  • 10000
  • 总结算金额(分)
  • └ settle_type
  • Number
  • 1
  • 结算方式:1个人支付,2企业现付,3预存,4月结
  • └ pay_type
  • Number
  • 1
  • 支付类型,0:企业支付,1:个人支付
  • └ gmt_modified
  • String
  • 2021-04-01 00:00:00
  • 订单状态改变时间
  • └ gmt_create
  • String
  • 2021-04-01 00:00:00
  • 创建时间
  • └ status
  • String
  • 1
  • 订单状态:-1, "订单初始化,此状态订单对用户不可见" 0, "待支付" 1, "出票中" 2, "已关闭" 3, "有改签单" 4, "有退票单" 5, "出票完成" 6, "退票申请中" 7, "改签申请中" 9, "出票失败" 10, "改签失败" 11, "退票失败";
  • └ apply_title
  • String
  • 审批单名称
  • 申请单标题
  • └ third_part_apply_id
  • String
  • ssfsdfs
  • 第三方申请单id
  • └ apply_id
  • Number
  • 1234
  • 商旅审批单id
  • └ depart_name
  • String
  • 测试部门
  • 部门名称
  • └ user_nick
  • String
  • 测试用户
  • 用户名称
  • └ user_id
  • String
  • dfghjk
  • 用户ID
  • └ thirdpart_corp_id
  • String
  • dfghj
  • 第三方企业ID
  • └ corp_id
  • String
  • dfghjk
  • 商旅企业ID
  • └ order_id
  • Number
  • 3456789
  • 订单号
  • └ trade_action
  • Number
  • 1
  • 资金流向:1:支出,2:收入
  • └ trade_type
  • Number
  • 1
  • 费用类型 1预定成功2退票成功3改签成功4差额退款6线下退票改签退款7火车票服务费8火车票赔付9火车票改签服务费10出票失败退款
  • └ trade_id
  • String
  • 123456dfgh
  • 第三方交易ID
  • └ currency
  • String
  • CNY
  • 货币种类
  • └ settlement_batch_no
  • String
  • yyyy-MM-dd HH:mm:ss
  • 结算批次:该订单结算时间
  • └ travel_standard_amount
  • Number
  • 300
  • 差标(分)
  • └ invoice_id
  • String
  • 23456
  • 商旅发票ID
  • └ invoice_title
  • String
  • 发票抬头
  • 发票抬头
  • └ project_code
  • String
  • dfghj
  • 项目编号
  • └ project_title
  • String
  • 测试项目
  • 项目名称
  • └ thirdpart_itinerary_id
  • String
  • 345678
  • 第三方行程单号
  • └ itinerary_no
  • String
  • 34567898
  • 商旅行程单号
  • cost_center_list
  • CostCenterDo []
  • costCenterList
  • 成本中心信息
  • └ cost_center_id
  • Number
  • 123456
  • 商旅成本中心ID
  • └ cost_center_title
  • String
  • 测试成本
  • 成本中心名称
  • └ cost_center_number
  • String
  • dfghj
  • 成本中心编号
  • └ third_cost_center_id
  • String
  • dfghjhgf
  • 第三方成本中心ID
  • client_info_dos
  • ClientInfoDo []
  • clientInfoDOs
  • 用户信息
  • └ user_id
  • String
  • sdfghj
  • 第三方用户ID
  • └ user_name
  • String
  • 测试用户
  • 用户名称
  • └ change_fee
  • Number
  • 1000
  • 改签费(分),改签补的差价
  • └ change_service_fee
  • Number
  • 100000
  • tmc收取的改签服务费(分)
  • └ ticket_count
  • Number
  • 2
  • 票数
  • └ passenger_count
  • Number
  • 2
  • 乘客人数
  • btrip_train_open_ticket_do_list
  • BtripTrainOpenTicketDo []
  • btripTrainOpenTicketDOs
  • 票信息,老火车票的票信息为空
  • └ train_no
  • String
  • sadsfg
  • 车次号
  • └ is_changed
  • Boolean
  • false
  • 是否退改
  • └ train_type
  • String
  • 动车
  • 车次类型
  • └ dep_time
  • Date
  • 2018-01-05 06:21:00
  • 出发时间
  • └ arr_time
  • Date
  • 2018-01-05 06:21:00
  • 到达时间
  • └ run_time
  • String
  • 16分
  • 运行时长
  • └ dep_city
  • String
  • 杭州
  • 出发城市
  • └ arr_city
  • String
  • 杭州
  • 到达城市
  • └ dep_station
  • String
  • 杭州东
  • 出发车站
  • └ arr_station
  • String
  • 杭州东
  • 到达车站
  • └ seat
  • String
  • 一等座
  • 坐席
  • └ ticket_price
  • Number
  • 1000
  • 票价(分)
  • └ service_fee
  • Number
  • 10000
  • tmc收取的服务费(分)
  • └ passenger_name
  • String
  • 测试乘客
  • 乘客名字
  • └ origin_ticket_price
  • Number
  • 1000
  • 原票价(分)
  • └ change_charge_fee
  • Number
  • 1000
  • 12306收取的改签手续费(分)
  • └ refund_charge_fee
  • Number
  • 1000
  • 12306收取的退票手续费(分)
  • └ is_changed
  • Boolean
  • true
  • 是否是改签流水
  • └ is_refund
  • Boolean
  • true
  • 是否是退票流水
  • └ result_code
  • Number
  • 0
  • 错误码
  • └ result_msg
  • String
  • 成功
  • 错误信息

请求示例

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

响应示例

  • XML示例
  • JSON示例
<alitrip_btrip_open_supplychain_train_trade_response>
    <result>
        <success>true</success>
        <trade_list>
            <open_api_zzd_train_order_rs>
                <service_fee>100</service_fee>
                <refund_service_fee>100</refund_service_fee>
                <refund_fee>100</refund_fee>
                <personal_amount>100</personal_amount>
                <corp_amount>100</corp_amount>
                <amount>10000</amount>
                <settle_type>1</settle_type>
                <pay_type>1</pay_type>
                <gmt_modified>2021-04-01 00:00:00</gmt_modified>
                <gmt_create>2021-04-01 00:00:00</gmt_create>
                <status>1</status>
                <apply_title>审批单名称</apply_title>
                <third_part_apply_id>ssfsdfs</third_part_apply_id>
                <apply_id>1234</apply_id>
                <depart_name>测试部门</depart_name>
                <user_nick>测试用户</user_nick>
                <user_id>dfghjk</user_id>
                <thirdpart_corp_id>dfghj</thirdpart_corp_id>
                <corp_id>dfghjk</corp_id>
                <order_id>3456789</order_id>
                <trade_action>1</trade_action>
                <trade_type>1</trade_type>
                <trade_id>123456dfgh</trade_id>
                <currency>CNY</currency>
                <settlement_batch_no>yyyy-MM-dd HH:mm:ss</settlement_batch_no>
                <travel_standard_amount>300</travel_standard_amount>
                <invoice_id>23456</invoice_id>
                <invoice_title>发票抬头</invoice_title>
                <project_code>dfghj</project_code>
                <project_title>测试项目</project_title>
                <thirdpart_itinerary_id>345678</thirdpart_itinerary_id>
                <itinerary_no>34567898</itinerary_no>
                <cost_center_list>
                    <cost_center_do>
                        <cost_center_id>123456</cost_center_id>
                        <cost_center_title>测试成本</cost_center_title>
                        <cost_center_number>dfghj</cost_center_number>
                        <third_cost_center_id>dfghjhgf</third_cost_center_id>
                    </cost_center_do>
                </cost_center_list>
                <client_info_dos>
                    <client_info_do>
                        <user_id>sdfghj</user_id>
                        <user_name>测试用户</user_name>
                    </client_info_do>
                </client_info_dos>
                <change_fee>1000</change_fee>
                <change_service_fee>100000</change_service_fee>
                <ticket_count>2</ticket_count>
                <passenger_count>2</passenger_count>
                <btrip_train_open_ticket_do_list>
                    <btrip_train_open_ticket_do>
                        <train_no>sadsfg</train_no>
                        <is_changed>false</is_changed>
                        <train_type>动车</train_type>
                        <dep_time>2018-01-05 06:21:00</dep_time>
                        <arr_time>2018-01-05 06:21:00</arr_time>
                        <run_time>16分</run_time>
                        <dep_city>杭州</dep_city>
                        <arr_city>杭州</arr_city>
                        <dep_station>杭州东</dep_station>
                        <arr_station>杭州东</arr_station>
                        <seat>一等座</seat>
                        <ticket_price>1000</ticket_price>
                        <service_fee>10000</service_fee>
                        <passenger_name>测试乘客</passenger_name>
                        <origin_ticket_price>1000</origin_ticket_price>
                    </btrip_train_open_ticket_do>
                </btrip_train_open_ticket_do_list>
                <change_charge_fee>1000</change_charge_fee>
                <refund_charge_fee>1000</refund_charge_fee>
                <is_changed>true</is_changed>
                <is_refund>true</is_refund>
            </open_api_zzd_train_order_rs>
        </trade_list>
        <result_code>0</result_code>
        <result_msg>成功</result_msg>
    </result>
</alitrip_btrip_open_supplychain_train_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

返回
顶部