文档中心 > API类目 > 机票API

alitrip.agent.flight.sell.ticketing.detail (销售出票详情)

销售出票详情

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
domestic_intl	Number	可选	1		国内国际标识
order_id	String	可选	123		飞猪订单号

响应参数

名称	类型	示例值	描述
result	ResultDto		出参对象
data TicketingDetailDTO 出参对象 └ agent_id Number 2052 店铺id └ domestic_intl Number 1 国内国际标识 └ order_id String 1106919681756 飞猪订单号 └ pay_time Date 1616048524000 支付时间 └ issue_time Date 1616048524000 出票时间 issue_list IssueList [] 出票对象 └ cert_no String 360424199509072839 证件信息 └ passenger_name String 施军忠乘机人姓名 └ cert_type Number 0 0 身份证 1 护照 2 学生证 3 军官证 4 回乡证 5 台胞证 6 港澳通行证 7 国际海员 8 外国人永久居留证 9 其他证件 10 警官证 11 士兵证件 12 台湾通行证 13 入台证 14 户口簿 15 出生证 16 驾驶证 17 港澳居民居住证 18 台湾居民居住证 └ tickets String [] 票号 └ passenger_type Number 1 乘客类型: 1:成人, 2:儿童, 3:婴儿, 4:留学生 └ ticket_price Number 500 票面价 └ pnr String KPB1ZH pnr taxes Taxes [] 税项对象 └ amount Number 5000 税值 └ tax_code String CN 税项二字码 └ promotion Number 123 优惠价格 segments Segments [] 航段 └ cabin_class String 2 舱等 (0:头等舱 1:商务舱 2:经济舱 3:超值经济舱 4:标准经济舱 5:超级经济舱) └ flight_no String MU5132 航班号 └ dep_time Date 1617159300000 起飞时间 └ arr_city String HGH 到达城市 └ dep_city String BJS 出发城市 └ cabin String R 舱位 └ segment_index Number 0 航段序号 └ arr_airport String HGH 到达机场 └ dep_airport String PKX 出发机场 └ od_index Number 0 航程序号 └ arr_time Date 1617166800000 到达时间 └ operating_airline String CA 航班实际承运航司 └ seg_pat_price Number 1200 公布票面价 └ operating_flight_no String CA1234 共享航班 └ flight_no_show String CA1234 共享出主飞 └ mobile String 13233311118 联系电话 └ birthday String 1996-12-28 乘机人生日 sell_policy_list SellPolicyDto [] 政策信息 └ policy_id String 10086 政策ID └ remark String 测试销售政策备注 └ policy_code String KLJIU 政策代码-新后台使用字段 └ policy_type Number 0 机票政策类型：0，默认；1，自定义 └ sale_mode_code Number 1 销售方式：1-3 机+X，4-5返现 └ memo String 测试政策备注 └ out_id String OKOOO 政策代码-老后台单子使用 └ product_code String COMMON 多端产品码 └ big_pnr String KPB1ZH 大编码 └ sur_name String ZHANG 姓氏 └ given_name String SAN 名字 └ cert_period String 2026-03-15 乘机人证件有效期 └ nationality String CN 乘机人国籍 └ cert_issue_country String CN 乘机人证件颁发国家 └ gender Number 1 乘机人性别:1表示男性，2表示女性 └ ticket_airline String "某某航司" 航司名称 └ product_tags String [] 产品类型 └ book_office String GLS111 预定office号 └ issue_office String GLS222 开票office号 ticket_info TicketInfoDTO [] 票信息集合 └ ticket_no String 000-1111111 票号 └ pnr String pnr pnr └ big_pnr String bigPnr bigPnr └ fare_basis_code String [] QWEQWEQWE 运价基础 └ account_code String TAOPIAO5 大客户码 └ sla String 2022-04-11 20:41:00 服务时效 └ commission Number 123 佣金 └ currency String CNY 币种 └ tags String [] 订单标签 └ status Number 2 订单状态 └ refund_modify_rule String “退改签规则内容” 退改签规则 baggage_list BaggageDTO [] 行李 └ dep_arr_desc String CTU-SHA 航段 └ passenger_type_desc String 成人乘机人类型 └ baggage_type_desc String 免费托运行李类型 └ rule_desc String 每人/每件尺寸/总重0KG 规则描述 └ intention_id String 123456 意向单id └ sla_desc String 支付成功后30分钟内出票支付成功后30分钟内出票 └ trip_type Number 1 1:"单程", 2:"往返", 3:"多程" └ correlation_out_id String 关联单号 xxx └ urge_sla Date 1616048524000 催出后服务时效 └ urge_sla_desc String 催出后风险描述 2023-05-26 20:13:08后存在订单被取消的风险 └ fare_source Number 运价类型运价类型：国内：1 自有政策\|2 航司直连\|3 公布运价\|4 AMADUES\|5 SEARCH_ONE\|6 代理人直连；国际：0 自有政策\|2 航司直连\|3 公布运价\|10 AMADUES\|16 SEARCH_ONE\|9 代理人直连 └ ticket_identify_status String 0 0.验真中 1.验真成功 2.验真失败 └ ticket_identify_desc String 验真描述验真结果描述 └ payment String 3 支付宝 28 易宝CAE 30 微信支付 33云闪付支付方式 ancillary_list AncillaryItemDTO [] 辅营信息 └ item_type Number 2 辅营类型 └ passenger_name String 张小二乘客名 └ mobile String 13333333333 联系电话 └ passenger_type Number 0 乘客类型 └ cert_type Number 0 证件类型 └ cert_number String 210101199001010101 证件号 └ birthday String 1990-01-01 生日 └ given_name String 小二名字 └ sur_name String 张姓氏 └ cert_period String 2025-01-01 证件有效期 └ nationality String 中国大陆乘机人国籍 └ cert_issue_country String 中国大陆乘机人证件办发国家 └ gender Number 0 性别 └ ticketing_airline String CA 出票航司 └ price Number 1000 价格 └ tickets String [] 票信息 segments TicketingSegmentDTO [] 航段信息 └ od_index Number 0 航程序号 └ segment_index Number 0 航段序号 └ dep_city String BJS 出发城市 └ arr_city String BJS 到达城市 └ dep_airport String SHA 出发机场 └ arr_airport String SHA 到达机场 └ dep_time Date 2024-01-01 18:00:00 起飞时间 └ arr_time Date 2024-01-01 18:00:00 到达时间 └ flight_no String CZ6216 航班号 └ cabin String Y 舱位 └ cabin_class String 头等舱舱等 └ operating_air_line String CA 航班实际承运航司 └ seg_pat_price Number 100 公布票面价 └ operating_flight_no String CA 共享航班 └ flight_no_show String CA1234 共享出主飞 └ extra String "extra": "{\"baggageNum\":\"1\",\"baggageUnit\":\"KG\",\"baggageWeight\":20,\"outItemId\":\"****"}", 扩展信息 └ correlation_ticket_no String [] 000-123456789 集中履约 - 关联机票票号 └ correlation_ticket_pnr String [] QWERTY 集中履约 - 关联机票pnr penalty_list PenaltyDTO [] 结构化退改签规则 └ dep_arr_desc String PKX-DLC 航段信息 └ penalty_type_desc String 退票费用规则类型 └ passenger_type_desc String 成人乘客类型 └ ticket_segments_status_desc String 全程未使用票航段状态 └ fee_desc String 结构化的：135CNY 40% * 非结构化的：只有描述 * 不支持的：退票不支持费用描述 └ start_time Date 时间戳开始时间 └ end_time Date 时间戳结束时间 └ time_desc String 2022-06-22 15:00前时间描述 └ raw_time_desc String 起飞前7天对起飞时间描述 └ is_out_date Boolean true 是否过期 └ remark String 说明说明 └ actual_commission Number 0 实际佣金字段 └ service_level Number 0 1-普通订单 2-金牌订单 3-极速订单 4-限时免费退 5-延时订单 6-精选 └ emphasis_serve_tags String [] 重点服务标识：EMPHASIS_PASSENGER：重点保障客户 └ luggage_centralize_delivery Boolean true 集中履约标识，true表示集中履约，会透出机票的关联信息 └ can_do_repeat_delivery Number 1 当前订单是否支持二次回填 └ bpnr_required Number 0 值机编码是否必填 └ success Boolean true 执行结果 └ error_code String demo 错误码 └ error_msg String demo 错误信息

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripAgentFlightSellTicketingDetailRequest req = new AlitripAgentFlightSellTicketingDetailRequest();
req.setDomesticIntl(1L);
req.setOrderId("123");
AlitripAgentFlightSellTicketingDetailResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

XML示例
JSON示例

<alitrip_agent_flight_sell_ticketing_detail_response>
    <result>
        <data>
            <agent_id>2052</agent_id>
            <domestic_intl>1</domestic_intl>
            <order_id>1106919681756</order_id>
            <pay_time>1616048524000</pay_time>
            <issue_time>1616048524000</issue_time>
            <issue_list>
                <issue_list>
                    <cert_no>360424199509072839</cert_no>
                    <passenger_name>施军忠</passenger_name>
                    <cert_type>0</cert_type>
                    <tickets>
                        <string></string>
                    </tickets>
                    <passenger_type>1</passenger_type>
                    <ticket_price>500</ticket_price>
                    <pnr>KPB1ZH</pnr>
                    <taxes>
                        <taxes>
                            <amount>5000</amount>
                            <tax_code>CN</tax_code>
                        </taxes>
                    </taxes>
                    <promotion>123</promotion>
                    <segments>
                        <segments>
                            <cabin_class>2</cabin_class>
                            <flight_no>MU5132</flight_no>
                            <dep_time>1617159300000</dep_time>
                            <arr_city>HGH</arr_city>
                            <dep_city>BJS</dep_city>
                            <cabin>R</cabin>
                            <segment_index>0</segment_index>
                            <arr_airport>HGH</arr_airport>
                            <dep_airport>PKX</dep_airport>
                            <od_index>0</od_index>
                            <arr_time>1617166800000</arr_time>
                            <operating_airline>CA</operating_airline>
                            <seg_pat_price>1200</seg_pat_price>
                            <operating_flight_no>CA1234</operating_flight_no>
                            <flight_no_show>CA1234</flight_no_show>
                        </segments>
                    </segments>
                    <mobile>13233311118</mobile>
                    <birthday>1996-12-28</birthday>
                    <sell_policy_list>
                        <sell_policy_dto>
                            <policy_id>10086</policy_id>
                            <remark>测试</remark>
                            <policy_code>KLJIU</policy_code>
                            <policy_type>0</policy_type>
                            <sale_mode_code>1</sale_mode_code>
                            <memo>测试</memo>
                            <out_id>OKOOO</out_id>
                            <product_code>COMMON</product_code>
                        </sell_policy_dto>
                    </sell_policy_list>
                    <big_pnr>KPB1ZH</big_pnr>
                    <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>
                    <gender>1</gender>
                    <ticket_airline>&quot;某某航司&quot;</ticket_airline>
                    <book_office>GLS111</book_office>
                    <issue_office>GLS222</issue_office>
                    <ticket_info>
                        <ticket_info_d_t_o>
                            <ticket_no>000-1111111</ticket_no>
                            <pnr>pnr</pnr>
                            <big_pnr>bigPnr</big_pnr>
                        </ticket_info_d_t_o>
                    </ticket_info>
                    <fare_basis_code>
                        <string>QWEQWEQWE</string>
                    </fare_basis_code>
                    <account_code>TAOPIAO5</account_code>
                </issue_list>
            </issue_list>
            <sla>2022-04-11 20:41:00</sla>
            <commission>123</commission>
            <currency>CNY</currency>
            <tags>
                <string></string>
            </tags>
            <status>2</status>
            <refund_modify_rule>“退改签规则内容”</refund_modify_rule>
            <baggage_list>
                <baggage_d_t_o>
                    <dep_arr_desc>CTU-SHA</dep_arr_desc>
                    <passenger_type_desc>成人</passenger_type_desc>
                    <baggage_type_desc>免费托运</baggage_type_desc>
                    <rule_desc>每人/每件尺寸/总重0KG</rule_desc>
                </baggage_d_t_o>
            </baggage_list>
            <intention_id>123456</intention_id>
            <sla_desc>支付成功后30分钟内出票</sla_desc>
            <trip_type>1</trip_type>
            <correlation_out_id>关联单号</correlation_out_id>
            <urge_sla>1616048524000</urge_sla>
            <urge_sla_desc>催出后风险描述</urge_sla_desc>
            <fare_source>运价类型</fare_source>
            <ticket_identify_status>0</ticket_identify_status>
            <ticket_identify_desc>验真描述</ticket_identify_desc>
            <payment>3 支付宝  28 易宝CAE  30 微信支付  33云闪付</payment>
            <ancillary_list>
                <ancillary_item_d_t_o>
                    <item_type>2</item_type>
                    <passenger_name>张小二</passenger_name>
                    <mobile>13333333333</mobile>
                    <passenger_type>0</passenger_type>
                    <cert_type>0</cert_type>
                    <cert_number>210101199001010101</cert_number>
                    <birthday>1990-01-01</birthday>
                    <given_name>小二</given_name>
                    <sur_name>张</sur_name>
                    <cert_period>2025-01-01</cert_period>
                    <nationality>中国大陆</nationality>
                    <cert_issue_country>中国大陆</cert_issue_country>
                    <gender>0</gender>
                    <ticketing_airline>CA</ticketing_airline>
                    <price>1000</price>
                    <segments>
                        <ticketing_segment_d_t_o>
                            <od_index>0</od_index>
                            <segment_index>0</segment_index>
                            <dep_city>BJS</dep_city>
                            <arr_city>BJS</arr_city>
                            <dep_airport>SHA</dep_airport>
                            <arr_airport>SHA</arr_airport>
                            <dep_time>2024-01-01 18:00:00</dep_time>
                            <arr_time>2024-01-01 18:00:00</arr_time>
                            <flight_no>CZ6216</flight_no>
                            <cabin>Y</cabin>
                            <cabin_class>头等舱</cabin_class>
                            <operating_air_line>CA</operating_air_line>
                            <seg_pat_price>100</seg_pat_price>
                            <operating_flight_no>CA</operating_flight_no>
                            <flight_no_show>CA1234</flight_no_show>
                        </ticketing_segment_d_t_o>
                    </segments>
                    <extra>&quot;extra&quot;: &quot;{\&quot;baggageNum\&quot;:\&quot;1\&quot;,\&quot;baggageUnit\&quot;:\&quot;KG\&quot;,\&quot;baggageWeight\&quot;:20,\&quot;outItemId\&quot;:\&quot;*****&quot;}&quot;,</extra>
                    <correlation_ticket_no>
                        <string>000-123456789</string>
                    </correlation_ticket_no>
                    <correlation_ticket_pnr>
                        <string>QWERTY</string>
                    </correlation_ticket_pnr>
                </ancillary_item_d_t_o>
            </ancillary_list>
            <penalty_list>
                <penalty_d_t_o>
                    <dep_arr_desc>PKX-DLC</dep_arr_desc>
                    <penalty_type_desc>退票费用</penalty_type_desc>
                    <passenger_type_desc>成人</passenger_type_desc>
                    <ticket_segments_status_desc>全程未使用</ticket_segments_status_desc>
                    <fee_desc>* 结构化的：135CNY 40%      * 非结构化的：只有描述      * 不支持的：退票不支持</fee_desc>
                    <start_time>时间戳</start_time>
                    <end_time>时间戳</end_time>
                    <time_desc>2022-06-22 15:00前</time_desc>
                    <raw_time_desc>起飞前7天</raw_time_desc>
                    <is_out_date>true</is_out_date>
                    <remark>说明</remark>
                </penalty_d_t_o>
            </penalty_list>
            <actual_commission>0</actual_commission>
            <service_level>0</service_level>
            <luggage_centralize_delivery>true</luggage_centralize_delivery>
            <can_do_repeat_delivery>1</can_do_repeat_delivery>
            <bpnr_required>0</bpnr_required>
        </data>
        <success>true</success>
        <error_code>demo</error_code>
        <error_msg>demo</error_msg>
    </result>
</alitrip_agent_flight_sell_ticketing_detail_response>

{
    "alitrip_agent_flight_sell_ticketing_detail_response":{
        "result":{
            "data":{
                "agent_id":2052,
                "domestic_intl":1,
                "order_id":"1106919681756",
                "pay_time":"1616048524000",
                "issue_time":"1616048524000",
                "issue_list":{
                    "issue_list":[
                        {
                            "cert_no":"360424199509072839",
                            "passenger_name":"施军忠",
                            "cert_type":0,
                            "tickets":{
                                "string":[
                                    ""
                                ]
                            },
                            "passenger_type":1,
                            "ticket_price":500,
                            "pnr":"KPB1ZH",
                            "taxes":{
                                "taxes":[
                                    {
                                        "amount":5000,
                                        "tax_code":"CN"
                                    }
                                ]
                            },
                            "promotion":123,
                            "segments":{
                                "segments":[
                                    {
                                        "cabin_class":"2",
                                        "flight_no":"MU5132",
                                        "dep_time":"1617159300000",
                                        "arr_city":"HGH",
                                        "dep_city":"BJS",
                                        "cabin":"R",
                                        "segment_index":0,
                                        "arr_airport":"HGH",
                                        "dep_airport":"PKX",
                                        "od_index":0,
                                        "arr_time":"1617166800000",
                                        "operating_airline":"CA",
                                        "seg_pat_price":1200,
                                        "operating_flight_no":"CA1234",
                                        "flight_no_show":"CA1234"
                                    }
                                ]
                            },
                            "mobile":"13233311118",
                            "birthday":"1996-12-28",
                            "sell_policy_list":{
                                "sell_policy_dto":[
                                    {
                                        "policy_id":"10086",
                                        "remark":"测试",
                                        "policy_code":"KLJIU",
                                        "policy_type":0,
                                        "sale_mode_code":1,
                                        "memo":"测试",
                                        "out_id":"OKOOO",
                                        "product_code":"COMMON"
                                    }
                                ]
                            },
                            "big_pnr":"KPB1ZH",
                            "sur_name":"ZHANG",
                            "given_name":"SAN",
                            "cert_period":"2026-03-15",
                            "nationality":"CN",
                            "cert_issue_country":"CN",
                            "gender":1,
                            "ticket_airline":"\"某某航司\"",
                            "book_office":"GLS111",
                            "issue_office":"GLS222",
                            "ticket_info":{
                                "ticket_info_d_t_o":[
                                    {
                                        "ticket_no":"000-1111111",
                                        "pnr":"pnr",
                                        "big_pnr":"bigPnr"
                                    }
                                ]
                            },
                            "fare_basis_code":{
                                "string":[
                                    "QWEQWEQWE"
                                ]
                            },
                            "account_code":"TAOPIAO5"
                        }
                    ]
                },
                "sla":"2022-04-11 20:41:00",
                "commission":123,
                "currency":"CNY",
                "tags":{
                    "string":[
                        ""
                    ]
                },
                "status":2,
                "refund_modify_rule":"“退改签规则内容”",
                "baggage_list":{
                    "baggage_d_t_o":[
                        {
                            "dep_arr_desc":"CTU-SHA",
                            "passenger_type_desc":"成人",
                            "baggage_type_desc":"免费托运",
                            "rule_desc":"每人\/每件尺寸\/总重0KG"
                        }
                    ]
                },
                "intention_id":"123456",
                "sla_desc":"支付成功后30分钟内出票",
                "trip_type":1,
                "correlation_out_id":"关联单号",
                "urge_sla":"1616048524000",
                "urge_sla_desc":"催出后风险描述",
                "fare_source":运价类型,
                "ticket_identify_status":"0",
                "ticket_identify_desc":"验真描述",
                "payment":"3 支付宝  28 易宝CAE  30 微信支付  33云闪付",
                "ancillary_list":{
                    "ancillary_item_d_t_o":[
                        {
                            "item_type":2,
                            "passenger_name":"张小二",
                            "mobile":"13333333333",
                            "passenger_type":0,
                            "cert_type":0,
                            "cert_number":"210101199001010101",
                            "birthday":"1990-01-01",
                            "given_name":"小二",
                            "sur_name":"张",
                            "cert_period":"2025-01-01",
                            "nationality":"中国大陆",
                            "cert_issue_country":"中国大陆",
                            "gender":0,
                            "ticketing_airline":"CA",
                            "price":1000,
                            "segments":{
                                "ticketing_segment_d_t_o":[
                                    {
                                        "od_index":0,
                                        "segment_index":0,
                                        "dep_city":"BJS",
                                        "arr_city":"BJS",
                                        "dep_airport":"SHA",
                                        "arr_airport":"SHA",
                                        "dep_time":"2024-01-01 18:00:00",
                                        "arr_time":"2024-01-01 18:00:00",
                                        "flight_no":"CZ6216",
                                        "cabin":"Y",
                                        "cabin_class":"头等舱",
                                        "operating_air_line":"CA",
                                        "seg_pat_price":100,
                                        "operating_flight_no":"CA",
                                        "flight_no_show":"CA1234"
                                    }
                                ]
                            },
                            "extra":"  \"extra\": \"{\\\"baggageNum\\\":\\\"1\\\",\\\"baggageUnit\\\":\\\"KG\\\",\\\"baggageWeight\\\":20,\\\"outItemId\\\":\\\"*****\"}\",            ",
                            "correlation_ticket_no":{
                                "string":[
                                    "000-123456789"
                                ]
                            },
                            "correlation_ticket_pnr":{
                                "string":[
                                    "QWERTY"
                                ]
                            }
                        }
                    ]
                },
                "penalty_list":{
                    "penalty_d_t_o":[
                        {
                            "dep_arr_desc":"PKX-DLC",
                            "penalty_type_desc":"退票费用",
                            "passenger_type_desc":"成人",
                            "ticket_segments_status_desc":"全程未使用",
                            "fee_desc":"  * 结构化的：135CNY 40%      * 非结构化的：只有描述      * 不支持的：退票不支持",
                            "start_time":"时间戳",
                            "end_time":"时间戳",
                            "time_desc":"2022-06-22 15:00前",
                            "raw_time_desc":"起飞前7天",
                            "is_out_date":true,
                            "remark":"说明"
                        }
                    ]
                },
                "actual_commission":0,
                "service_level":0,
                "luggage_centralize_delivery":true,
                "can_do_repeat_delivery":1,
                "bpnr_required":0
            },
            "success":true,
            "error_code":"demo",
            "error_msg":"demo"
        }
    }
}

异常示例

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测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

淘宝开放平台

机票API

alitrip.agent.flight.sell.ticketing.detail (销售出票详情)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ