alitrip.tripvp.agent.receiptorder.search (直营报销凭证查询接口)

提供报销凭证订单信息的批量查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_query_receipt_order_list_r_q QueryReceiptOrderListRq 可选 入参
  • └ agent_id
  • Number
  • 必须
  • 1111
  • 代理商id-必填
  • └ begin_time
  • Date
  • 可选
  • 2017-07-01 00:00:00
  • 开始时间-必填,如果选orderId了,可不填
  • └ current_page
  • Number
  • 可选
  • 1
  • 当前页码
  • └ end_time
  • Date
  • 可选
  • 2017-07-01 00:00:00
  • 结束时间-必填,如果选orderId了,可不填
  • └ order_id
  • Number
  • 可选
  • 123
  • 订单id,可为空,填了优先使用订单id
  • └ page_size
  • Number
  • 可选
  • 100
  • 单次最大查询数,建议一次查50

响应参数

名称 类型 示例值 描述
result ReceiptOrderListRS result
  • └ api_error_code
  • Number
  • 111
  • apiErrorCode
  • └ api_error_msg
  • String
  • 111
  • apiErrorMsg
  • └ current_page
  • Number
  • 111
  • currentPage
  • └ err_trace
  • String
  • 111
  • errTrace
  • error
  • ApiError
  • error
  • └ code
  • Number
  • 111
  • code
  • └ detail_info
  • String
  • 1111
  • detailInfo
  • └ err_type
  • String
  • 111
  • errType
  • └ ext_err_code
  • String
  • 11
  • extErrCode
  • └ ext_err_msg
  • String
  • 111
  • extErrMsg
  • └ msg_detail
  • String
  • 111
  • msgDetail
  • └ msg_for_client
  • String
  • 111
  • msgForClient
  • └ msg_for_sys
  • String
  • 111
  • msgForSys
  • └ outer_code
  • String
  • 111
  • outerCode
  • └ raw_err_code
  • String
  • 111
  • rawErrCode
  • └ raw_err_msg
  • String
  • 111
  • rawErrMsg
  • └ std_err_code
  • String
  • 111
  • stdErrCode
  • └ std_err_msg
  • String
  • 111
  • stdErrMsg
  • └ failure
  • Boolean
  • true
  • failure
  • └ has_next
  • Boolean
  • false
  • hasNext
  • └ host_name
  • String
  • 111
  • hostName
  • └ page_size
  • Number
  • 111
  • pageSize
  • receipt_order4_api_v_o_list
  • ReceiptOrder4ApiVo []
  • 返回的大结构
  • └ address
  • String
  • 111
  • 收件地址
  • └ agent_flag
  • Number
  • 1
  • 是否代打,0否,1是
  • └ all_receipt_details
  • String
  • 等额行程单
  • 发票的具体描述,有可能包括保险的信息
  • └ arr_time
  • Date
  • 2017-07-01 00:00:00
  • 到达时间
  • at_modify_apply_v_o_s
  • AtModifyApplyVo []
  • atModifyApplyVOS
  • └ answer
  • String
  • 111
  • answer,忽略
  • at_modify_apply_detail_v_o_list
  • AtModifyApplyDetailVo []
  • atModifyApplyDetailVOList
  • └ airline_code
  • String
  • 111
  • 航司二字码
  • └ arr_airport
  • String
  • 111
  • 到达机场
  • └ arr_airport_code
  • String
  • 111
  • 到达机场代码
  • └ arr_time
  • String
  • 111
  • 到达时间
  • └ build_fee
  • Number
  • 111
  • 机场建设费
  • └ cabin
  • String
  • 111
  • 改签后的舱位
  • └ carrier
  • String
  • 111
  • 承运航空公司二字码
  • └ core_id
  • Number
  • 111
  • 人航段唯一id和机票结构中的对应
  • └ dep_airport
  • String
  • 111
  • 起飞机场
  • └ dep_airport_code
  • String
  • 111
  • 起飞机场代码
  • └ dep_time
  • String
  • 111
  • 起飞时间
  • └ flight_n_o
  • String
  • 111
  • 航班号
  • └ modify_fee
  • Number
  • 111
  • 改签费
  • └ oil_tax
  • Number
  • 111
  • 燃油费
  • └ ticket_no
  • String
  • 111
  • 票号
  • └ upgrade_fee
  • Number
  • 111
  • 升舱费
  • └ buyer_alipay_email
  • String
  • 111
  • 买家支付宝email
  • └ buyer_alipay_id
  • String
  • 111
  • 买家支付宝账号
  • └ gmt_create
  • Date
  • 2017-07-01 00:00:00
  • 创建时间
  • └ gmt_modified
  • Date
  • 2017-07-01 00:00:00
  • 修改时间
  • └ id
  • Number
  • 111
  • id
  • └ order_id
  • Number
  • 1
  • 订单id
  • └ pay_succ_time
  • Date
  • 111
  • 支付成功时间
  • └ reason
  • String
  • 111
  • 原因
  • └ seller_alipay_id
  • String
  • 111
  • 卖家支付宝id
  • └ seller_id
  • Number
  • 111
  • 卖家id
  • └ status
  • Number
  • 111
  • 状态码
  • └ total_fee
  • Number
  • 111
  • 总费用
  • at_refund_apply_v_o_s
  • AtRefundApplyVo []
  • atRefundApplyVOS
  • └ answer
  • String
  • 1111
  • answer
  • at_refund_apply_fee_list
  • AtRefundApplyFee []
  • atRefundApplyFeeList
  • └ apply_id
  • Number
  • 111
  • 退票申请单id
  • at_refund_apply_detail_v_o_s
  • AtRefundApplyDetailVo []
  • atRefundApplyDetailVOS
  • └ core_id
  • Number
  • 111
  • 人航段唯一id,和机票结构里面的对应
  • └ dep_time
  • Date
  • 2017-07-01 00:00:00
  • 起飞时间
  • └ flight_no
  • String
  • 111
  • 航班号
  • └ passenger_name
  • String
  • 111
  • 乘机人姓名
  • └ refund_fee
  • Number
  • 111
  • 退票手续费
  • └ ticket_no
  • String
  • 111
  • 票号
  • └ buyer_id
  • Number
  • 11
  • 买家id
  • └ fee
  • Number
  • 111
  • └ id
  • Number
  • 111
  • id
  • └ item_id
  • Number
  • 111
  • itemId
  • └ order_id
  • Number
  • 111
  • 订单id
  • └ passenger_name
  • String
  • 111
  • 乘机人姓名
  • └ refund_price
  • Number
  • 111
  • 退款总金额 =票价/基建燃油 -手续费 -活动优惠 -航意险优惠
  • └ seller_id
  • Number
  • 111
  • 卖家id
  • └ ticket_price
  • Number
  • 111
  • 票面价格
  • └ buyer_alipay_email
  • String
  • 111
  • 买家支付宝email
  • └ buyer_alipay_id
  • String
  • 111
  • 买家支付宝id
  • └ gmt_create
  • Date
  • 111
  • 创建时间
  • └ gmt_modified
  • Date
  • 1111
  • 修改时间
  • └ id
  • Number
  • 11
  • id
  • └ order_id
  • Number
  • 111
  • 订单id
  • └ reason
  • String
  • 111
  • 原因
  • └ seller_alipay_id
  • String
  • 111
  • 卖家支付宝id
  • └ seller_id
  • Number
  • 11
  • 卖家id
  • └ status
  • Number
  • 111
  • status
  • at_ticket_v_o_s
  • AtTicketVo []
  • atTicketVOS
  • └ arr_airport
  • String
  • 111
  • 到达机场
  • └ arr_time
  • String
  • 111
  • 到达时间 格式yyyy-MM-dd hh:mm
  • └ build_price
  • Number
  • 111
  • 机场建设费
  • └ carrier
  • String
  • 111
  • 承运航空公司二字码
  • └ carrier_airline_name
  • String
  • 111
  • 承运航公公司名称
  • └ cert_num
  • String
  • 111
  • 证件号
  • └ cert_type
  • Number
  • 1
  • 证件类型
  • └ core_id
  • Number
  • 111
  • 关联id,人航段的唯一id,和改签退票结构中的对应
  • └ dep_airport
  • String
  • 11
  • 起飞机场
  • └ dep_time
  • String
  • 111
  • 起飞时间 yyyy-MM-dd hh:mm
  • └ flight_n_o
  • String
  • 111
  • 航班号
  • └ oil_price
  • Number
  • 111
  • 燃油费
  • └ passenger_name
  • String
  • 111
  • 乘机人姓名
  • └ pat_price
  • Number
  • 111
  • patPrice
  • └ sell_price
  • Number
  • 111
  • sellPrice
  • └ ticket_n_o
  • String
  • 111
  • 票号
  • └ tkt_cabin
  • String
  • 111
  • 舱位
  • └ biz_type
  • Number
  • 1
  • 业务类型,1是国内
  • └ city
  • String
  • 北京市
  • 收货地址,城市,有可能为空,尽量拿地址字段
  • └ dep_time
  • Date
  • 2017-07-01 00:00:00
  • 起飞时间
  • └ district
  • String
  • 朝阳区
  • 收货地址,区,有可能为空,尽量拿地址字段
  • └ insurance_count
  • Number
  • 1
  • 保险数量
  • └ order_id
  • Number
  • 111
  • 订单id
  • └ order_success_time
  • Date
  • 2017-07-01 00:00:00
  • 成单时间
  • └ pay_time
  • Date
  • 2017-07-01 00:00:00
  • 支付时间
  • └ province
  • String
  • 河北
  • 收货地址,省,有可能为空,尽量拿地址字段
  • └ recipients_name
  • String
  • 111
  • 收件人
  • └ recipients_phone
  • String
  • 111
  • 收件人电话
  • └ remark
  • String
  • 111
  • 备注
  • └ shop_id
  • Number
  • 111
  • 店铺id
  • └ status
  • Number
  • 111
  • 状态:0待开票1开票中2开票成功3开票失败4已冲红/作废5待开票6已开票7过期作废8补寄删除9已关闭10已退款13已取消14超时退17已退作废15已支付已邮寄16已支付待邮寄
  • └ taxpayer_number
  • String
  • 111
  • 纳税人识别号
  • └ title
  • String
  • 111
  • 抬头
  • └ total_price
  • Number
  • 111
  • 总金额
  • └ total_tax
  • Number
  • 111
  • 总税费
  • └ is_merged
  • Boolean
  • true
  • 是否合并
  • └ main_order_id
  • Number
  • 111
  • 合并的主ID
  • └ relation_order_ids
  • Number []
  • true
  • 合并的外部订单号
  • └ return_item_count
  • Number
  • 1
  • 返回结果数量
  • └ success
  • Boolean
  • true
  • success

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTripvpAgentReceiptorderSearchRequest req = new AlitripTripvpAgentReceiptorderSearchRequest();
AlitripTripvpAgentReceiptorderSearchRequest.QueryReceiptOrderListRq obj1 = new AlitripTripvpAgentReceiptorderSearchRequest.QueryReceiptOrderListRq();
obj1.setAgentId(1111L);
obj1.setBeginTime(StringUtils.parseDateTime("2017-07-01 00:00:00"));
obj1.setCurrentPage(1L);
obj1.setEndTime(StringUtils.parseDateTime("2017-07-01 00:00:00"));
obj1.setOrderId(123L);
obj1.setPageSize(100L);
req.setParamQueryReceiptOrderListRQ(obj1);
AlitripTripvpAgentReceiptorderSearchResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_tripvp_agent_receiptorder_search_response>
    <result>
        <api_error_code>111</api_error_code>
        <api_error_msg>111</api_error_msg>
        <current_page>111</current_page>
        <err_trace>111</err_trace>
        <error>
            <code>111</code>
            <detail_info>1111</detail_info>
            <err_type>111</err_type>
            <ext_err_code>11</ext_err_code>
            <ext_err_msg>111</ext_err_msg>
            <msg_detail>111</msg_detail>
            <msg_for_client>111</msg_for_client>
            <msg_for_sys>111</msg_for_sys>
            <outer_code>111</outer_code>
            <raw_err_code>111</raw_err_code>
            <raw_err_msg>111</raw_err_msg>
            <std_err_code>111</std_err_code>
            <std_err_msg>111</std_err_msg>
        </error>
        <failure>true</failure>
        <has_next>false</has_next>
        <host_name>111</host_name>
        <page_size>111</page_size>
        <receipt_order4_api_v_o_list>
            <receipt_order4_api_vo>
                <address>111</address>
                <agent_flag>1</agent_flag>
                <all_receipt_details>等额行程单</all_receipt_details>
                <arr_time>2017-07-01 00:00:00</arr_time>
                <at_modify_apply_v_o_s>
                    <at_modify_apply_vo>
                        <answer>111</answer>
                        <at_modify_apply_detail_v_o_list>
                            <at_modify_apply_detail_vo>
                                <airline_code>111</airline_code>
                                <arr_airport>111</arr_airport>
                                <arr_airport_code>111</arr_airport_code>
                                <arr_time>111</arr_time>
                                <build_fee>111</build_fee>
                                <cabin>111</cabin>
                                <carrier>111</carrier>
                                <core_id>111</core_id>
                                <dep_airport>111</dep_airport>
                                <dep_airport_code>111</dep_airport_code>
                                <dep_time>111</dep_time>
                                <flight_n_o>111</flight_n_o>
                                <modify_fee>111</modify_fee>
                                <oil_tax>111</oil_tax>
                                <ticket_no>111</ticket_no>
                                <upgrade_fee>111</upgrade_fee>
                            </at_modify_apply_detail_vo>
                        </at_modify_apply_detail_v_o_list>
                        <buyer_alipay_email>111</buyer_alipay_email>
                        <buyer_alipay_id>111</buyer_alipay_id>
                        <gmt_create>2017-07-01 00:00:00</gmt_create>
                        <gmt_modified>2017-07-01 00:00:00</gmt_modified>
                        <id>111</id>
                        <order_id>1</order_id>
                        <pay_succ_time>111</pay_succ_time>
                        <reason>111</reason>
                        <seller_alipay_id>111</seller_alipay_id>
                        <seller_id>111</seller_id>
                        <status>111</status>
                        <total_fee>111</total_fee>
                    </at_modify_apply_vo>
                </at_modify_apply_v_o_s>
                <at_refund_apply_v_o_s>
                    <at_refund_apply_vo>
                        <answer>1111</answer>
                        <at_refund_apply_fee_list>
                            <at_refund_apply_fee>
                                <apply_id>111</apply_id>
                                <at_refund_apply_detail_v_o_s>
                                    <at_refund_apply_detail_vo>
                                        <core_id>111</core_id>
                                        <dep_time>2017-07-01 00:00:00</dep_time>
                                        <flight_no>111</flight_no>
                                        <passenger_name>111</passenger_name>
                                        <refund_fee>111</refund_fee>
                                        <ticket_no>111</ticket_no>
                                    </at_refund_apply_detail_vo>
                                </at_refund_apply_detail_v_o_s>
                                <buyer_id>11</buyer_id>
                                <fee>111</fee>
                                <id>111</id>
                                <item_id>111</item_id>
                                <order_id>111</order_id>
                                <passenger_name>111</passenger_name>
                                <refund_price>111</refund_price>
                                <seller_id>111</seller_id>
                                <ticket_price>111</ticket_price>
                            </at_refund_apply_fee>
                        </at_refund_apply_fee_list>
                        <buyer_alipay_email>111</buyer_alipay_email>
                        <buyer_alipay_id>111</buyer_alipay_id>
                        <gmt_create>111</gmt_create>
                        <gmt_modified>1111</gmt_modified>
                        <id>11</id>
                        <order_id>111</order_id>
                        <reason>111</reason>
                        <seller_alipay_id>111</seller_alipay_id>
                        <seller_id>11</seller_id>
                        <status>111</status>
                    </at_refund_apply_vo>
                </at_refund_apply_v_o_s>
                <at_ticket_v_o_s>
                    <at_ticket_vo>
                        <arr_airport>111</arr_airport>
                        <arr_time>111</arr_time>
                        <build_price>111</build_price>
                        <carrier>111</carrier>
                        <carrier_airline_name>111</carrier_airline_name>
                        <cert_num>111</cert_num>
                        <cert_type>1</cert_type>
                        <core_id>111</core_id>
                        <dep_airport>11</dep_airport>
                        <dep_time>111</dep_time>
                        <flight_n_o>111</flight_n_o>
                        <oil_price>111</oil_price>
                        <passenger_name>111</passenger_name>
                        <pat_price>111</pat_price>
                        <sell_price>111</sell_price>
                        <ticket_n_o>111</ticket_n_o>
                        <tkt_cabin>111</tkt_cabin>
                    </at_ticket_vo>
                </at_ticket_v_o_s>
                <biz_type>1</biz_type>
                <city>北京市</city>
                <dep_time>2017-07-01 00:00:00</dep_time>
                <district>朝阳区</district>
                <insurance_count>1</insurance_count>
                <order_id>111</order_id>
                <order_success_time>2017-07-01 00:00:00</order_success_time>
                <pay_time>2017-07-01 00:00:00</pay_time>
                <province>河北</province>
                <recipients_name>111</recipients_name>
                <recipients_phone>111</recipients_phone>
                <remark>111</remark>
                <shop_id>111</shop_id>
                <status>111</status>
                <taxpayer_number>111</taxpayer_number>
                <title>111</title>
                <total_price>111</total_price>
                <total_tax>111</total_tax>
                <is_merged>true</is_merged>
                <main_order_id>111</main_order_id>
                <relation_order_ids>
                    <number>true</number>
                </relation_order_ids>
            </receipt_order4_api_vo>
        </receipt_order4_api_v_o_list>
        <return_item_count>1</return_item_count>
        <success>true</success>
    </result>
</alitrip_tripvp_agent_receiptorder_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

返回
顶部