alitrip.agent.flight.sell.refund.detail (销售退票单详情)

销售退票单详情

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
apply_id String 可选 123 申请单号
domestic_intl Number 可选 1 国际国内标识(1 国内,2 国际)

响应参数

名称 类型 示例值 描述
result ResultDto 异步获取历史数据接口返回结果
  • data
  • RefundDetailDto
  • 结果数据
  • └ apply_id
  • String
  • RdSDumQCBZ
  • 申请单号
  • └ voluntary
  • Number
  • 1
  • 自愿标识:0.非自愿,1.自愿
  • └ reason
  • String
  • 7VfozcVjFB
  • 申请原因
  • └ agent_id
  • Number
  • 1180023
  • 店铺id
  • └ domestic_intl
  • Number
  • 1
  • 国际国内标识(1国内,2国际)
  • └ order_id
  • String
  • cNkiP9AqRb
  • 关联飞猪订单号
  • refund_list
  • RefundList []
  • 退票数据集
  • └ passenger_name
  • String
  • hbIqVfWk69
  • 乘客姓名
  • └ refund_fee
  • Number
  • 2
  • 退票费,单位:分
  • └ tickets
  • String []
  • 票号
  • └ refund_upgrade_fee
  • Number
  • 99
  • 升舱手续费,单位:分
  • └ refund_modify_fee
  • Number
  • 99
  • 改期手续费,单位:分
  • refund_segments
  • RefundSegments []
  • 退票航段
  • └ cabin_class
  • String
  • mXAMw2RecA
  • 舱等
  • └ flight_no
  • String
  • mcmytpbwyy
  • 航班号
  • └ dep_time
  • Date
  • 1609748813406
  • 起飞时间
  • └ arr_city
  • String
  • PEFjkhEQJ9
  • 到达城市
  • └ dep_city
  • String
  • reRqNB53Br
  • 起飞城市
  • └ cabin
  • String
  • MQfSonazHQ
  • 舱位
  • └ segment_index
  • Number
  • 37
  • 航段序号
  • └ arr_airport
  • String
  • 24gsWJYBiB
  • 到达机场
  • └ dep_airport
  • String
  • xs6q8sSSWk
  • 起飞机场
  • └ arr_time
  • Date
  • 1609748813406
  • 到达时间
  • └ od_index
  • Number
  • 65
  • 航程序号
  • └ refund_amount
  • Number
  • 10000
  • 退款金额,单位:分(出后退:退款金额=实收金额-退票费;改后退:退款金额=实收金额+总改期费+总升舱费-退票费-改签手续费-升舱手续费)
  • └ ticket_price
  • Number
  • 10000
  • 票面价,单位:分
  • └ passenger_type
  • Number
  • 1
  • 乘客类型:1 成人 ,2 儿童,3 婴儿,4 留学生
  • taxes
  • Tax []
  • 税费,单位:分
  • └ tax_code
  • String
  • CN
  • 税费编码(CN:机场建设费 ,YQ 燃油附加税)
  • └ amount
  • Number
  • 100
  • 税费金额,单位:分
  • └ not_refund_amount
  • Number
  • 100
  • 不可退税费,单位:分
  • └ total_modify_fee
  • Number
  • 100
  • 升舱总费用,单位:分
  • └ total_upgrade_fee
  • Number
  • 100
  • 改签总费用,单位:分
  • └ real_price
  • Number
  • 10000
  • 实收金额:单位:分
  • └ refund_item_type
  • Number
  • 2
  • 1:出后退,2:改后退
  • └ pnr_xe
  • Number
  • 0
  • 0:没有xe,1:xe了
  • └ pnr_xe_time
  • Date
  • 1609748813397
  • xe时间
  • └ sur_name
  • String
  • ZHANG
  • 姓氏
  • └ given_name
  • String
  • SAN
  • 名字
  • └ cert_period
  • String
  • 2026-03-15
  • 乘机人证件有效期
  • └ nationality
  • String
  • CN
  • 乘机人国籍
  • └ cert_issue_country
  • String
  • CN
  • 乘机人证件颁发国家
  • └ birthday
  • String
  • 1987-04-05
  • 乘机人生日
  • └ gender
  • Number
  • 1
  • 乘机人性别:1表示男性,2表示女性
  • └ sla
  • String
  • RMpK6hrrRj
  • sla
  • └ currency
  • String
  • H6hvhlDEcf
  • 交易币种:CNY:人民币, USD:美元, HKD:港元
  • └ apply_time
  • Date
  • 1609748813397
  • 申请时间
  • └ status
  • Number
  • 43
  • 退票状态:待回填:1, 待退款:2, 退款中:3, 已完结:4, 已拒绝:5
  • └ refuse_reason
  • String
  • 拒绝
  • 拒绝原因
  • └ apply_reason_type
  • Number
  • 12
  • 申请原因类型:0:其他, 1:航变,2:病退 ,3:疫情,4:特殊提退
  • └ supplement
  • Number
  • 1
  • 补退单标识(1是补退单)
  • └ tags
  • String []
  • ["URGENT"]
  • 紧急标识:EPIDEMIC:疫情审核通过标, REASSURING_TICKET:安心票, FLIGHTCHANGE:航变审核通过标, CALCULATED:预计算, FLIGHTCHANGECANCEL:航班取消, FLIGHTCHANGEDELAY:航班延误, ILLWITHCERTIFICATE:病退, REFUSETOTAKE:航司拒载, PREVIOUSLATTERINTERFERENCE:前后段影响, OVERBOOKING:超售, AIRLINEAUTHORIZE:航司授权, CHANGENAME:改名, REPEATBUYTICKETS:重复购票, BUYWRONGTICKETS:错购, AIRLINEVIPCARDREFUND:航司金银卡退票
  • └ refund_way_type
  • Number
  • 1
  • 0:"原路退回",1:"退银行卡",2:"原路退回+退银行卡"
  • └ attachment
  • String []
  • xxx.xxx.xxx
  • xxx.xxx.xxx
  • └ trip_type
  • Number
  • 1
  • 1:"单程", 2:"往返", 3:"多程"
  • └ correlation_order_id
  • String
  • 1123123
  • 关联单号
  • └ involuntary_pass_type
  • Number
  • 0
  • 预审通过类型:0:航变预审通过;1:疫情预审通过;2:病退预审通过;3:航变预审通过(延误);4:航变预审通过(取消); 5:其他预审通过(拒载);6:其他预审通过(前后段影响);7:其他预审通过(超售);8:其他预审通过(航司授权); 9:其他预审通过(改名);10:其他预审通过(重复购票);11:其他预审通过(错购);12:其他预审通过(航司金银卡); 其他枚举值:预审通过
  • └ refund_service_type
  • Number
  • 1
  • 服务类型 -1 未知 1 极速退款 2 限时免费退 3 极速退款;限时免费退
  • └ ful_fill_ment_deadline
  • Date
  • 2024-04-19 18:00:00
  • 履约截止时效
  • └ fee_back_fill_deadline
  • Date
  • 2024-04-19 18:00:00
  • 费用回填截止日期
  • └ success
  • Boolean
  • true
  • 执行结果
  • └ error_code
  • String
  • 000
  • 错误码:000:系统异常, 001:请求参数不合法, 002:权限不足, 003:操作失败, 004:流量管控
  • └ error_msg
  • String
  • 异常信息
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripAgentFlightSellRefundDetailRequest req = new AlitripAgentFlightSellRefundDetailRequest();
req.setApplyId("123");
req.setDomesticIntl(1L);
AlitripAgentFlightSellRefundDetailResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_agent_flight_sell_refund_detail_response>
    <result>
        <data>
            <apply_id>RdSDumQCBZ</apply_id>
            <voluntary>1</voluntary>
            <reason>7VfozcVjFB</reason>
            <agent_id>1180023</agent_id>
            <domestic_intl>1</domestic_intl>
            <order_id>cNkiP9AqRb</order_id>
            <refund_list>
                <refund_list>
                    <passenger_name>hbIqVfWk69</passenger_name>
                    <refund_fee>2</refund_fee>
                    <tickets>
                        <string></string>
                    </tickets>
                    <refund_upgrade_fee>99</refund_upgrade_fee>
                    <refund_modify_fee>99</refund_modify_fee>
                    <refund_segments>
                        <refund_segments>
                            <cabin_class>mXAMw2RecA</cabin_class>
                            <flight_no>mcmytpbwyy</flight_no>
                            <dep_time>1609748813406</dep_time>
                            <arr_city>PEFjkhEQJ9</arr_city>
                            <dep_city>reRqNB53Br</dep_city>
                            <cabin>MQfSonazHQ</cabin>
                            <segment_index>37</segment_index>
                            <arr_airport>24gsWJYBiB</arr_airport>
                            <dep_airport>xs6q8sSSWk</dep_airport>
                            <arr_time>1609748813406</arr_time>
                            <od_index>65</od_index>
                        </refund_segments>
                    </refund_segments>
                    <refund_amount>10000</refund_amount>
                    <ticket_price>10000</ticket_price>
                    <passenger_type>1</passenger_type>
                    <taxes>
                        <tax>
                            <tax_code>CN</tax_code>
                            <amount>100</amount>
                            <not_refund_amount>100</not_refund_amount>
                        </tax>
                    </taxes>
                    <total_modify_fee>100</total_modify_fee>
                    <total_upgrade_fee>100</total_upgrade_fee>
                    <real_price>10000</real_price>
                    <refund_item_type>2</refund_item_type>
                    <pnr_xe>0</pnr_xe>
                    <pnr_xe_time>1609748813397</pnr_xe_time>
                    <sur_name>ZHANG</sur_name>
                    <given_name>SAN</given_name>
                    <cert_period>2026-03-15</cert_period>
                    <nationality>CN</nationality>
                    <cert_issue_country>CN</cert_issue_country>
                    <birthday>1987-04-05</birthday>
                    <gender>1</gender>
                </refund_list>
            </refund_list>
            <sla>RMpK6hrrRj</sla>
            <currency>H6hvhlDEcf</currency>
            <apply_time>1609748813397</apply_time>
            <status>43</status>
            <refuse_reason>拒绝</refuse_reason>
            <apply_reason_type>12</apply_reason_type>
            <supplement>1</supplement>
            <tags>
                <string>[&quot;URGENT&quot;]</string>
            </tags>
            <refund_way_type>1</refund_way_type>
            <attachment>
                <string>xxx.xxx.xxx</string>
            </attachment>
            <trip_type>1</trip_type>
            <correlation_order_id>1123123</correlation_order_id>
            <involuntary_pass_type>0</involuntary_pass_type>
            <refund_service_type>1</refund_service_type>
            <ful_fill_ment_deadline>2024-04-19 18:00:00</ful_fill_ment_deadline>
            <fee_back_fill_deadline>2024-04-19 18:00:00</fee_back_fill_deadline>
        </data>
        <success>true</success>
        <error_code>000</error_code>
        <error_msg>异常信息</error_msg>
    </result>
</alitrip_agent_flight_sell_refund_detail_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

返回
顶部