文档中心 > API类目 > 电影票API

taobao.film.data.third.party.ticketorder.get (查询电影票订单详情)

锁座后先调出票接口,拿到tbOrderId后,可调该接口查询订单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
user_id Number 必须 123123123 淘票票分配给商户的userId
platform Number 必须 100 购票渠道
tb_order_id Number 必须 12345671232112 淘票票订单号
ext_user_id String 可选 1234567 商户userId
ext_order_id String 必须 123456743221 商户订单号
params Json 可选 null 扩展字段,目前未使用

响应参数

名称 类型 示例值 描述
result ResultGeneralModel 系统自动生成
  • └ return_code
  • String
  • 0
  • 0表示成功,其他均表示失败,需要根据具体值做相应处理;
  • return_value
  • TopOrderDetail
  • 接口返回值
  • top_sale_order_status_list
  • TopSaleOrderStatus []
  • 随票卖品订单
  • └ sale_content
  • String
  • 1
  • 取货码
  • └ sale_tb_order_id
  • Number
  • 1
  • 卖品订单号
  • └ sale_id
  • String
  • 1
  • 卖品ID
  • standard_code_list
  • TicketGbCodeVo []
  • 专资码数据,为null则表示影院或系统商未开通
  • └ seat_name
  • String
  • 6排5座
  • 座位名称
  • └ seat_code
  • String
  • 001234521017-6-8
  • 座位编号
  • └ ticket_no
  • String
  • 1456000620000000
  • 票号
  • └ gb_qr_code
  • String
  • 31093101egVF+/vKa2panmlJbP55eXSjwR8Oi3wgKGjWGn0EWkHuXMFzhVTzUdRqPbof+VN78LUI2duCfmzwi9yaFNSxqCp63Ay7dqZZC7J6lBiC1231231QGJZtB8hL3+Z6U5LBIlT+u0000000000DmxKG6Ud4VA=
  • 国标码
  • └ qrcode
  • String
  • 1456483368123123
  • 取票二维码,为null则表示影院或系统商不支持
  • └ ticket_contents
  • String
  • 取票号:1456483368123123
  • 取票码
  • └ message
  • String
  • 协议支付失败,账户余额不足
  • 出票状态描述(失败原因)
  • └ issue_date
  • Number
  • 1627355244000
  • 出票时间(ms)
  • └ status
  • String
  • TRADE_SUCCESS
  • 订单出票状态:TRADE_SUCCESS-交易(出票成功);REFUND-退款完成;DOING-出票中;FAILED-出票失败
  • └ ext_order_id
  • String
  • 1419856760706000000
  • 商户订单号
  • └ tb_order_id
  • Number
  • 1361378535547000000
  • 淘票票订单号
  • zhuanzi_report_data
  • ZhuanziReportDataVO []
  • 淘票票渠道编码:98150042。专资上报数据。因专资上报数据落库有短暂延迟,可能存在极端场景下 zhuanziReportData 为 null。可以间隔一定时间后,再次调用接口获取。
  • └ ticket_no
  • String
  • 340104000Gv0001
  • 电影票编码
  • └ zz_cinema_code
  • String
  • 34010400
  • 影院编码
  • └ zz_screen_code
  • String
  • 0000000000000003
  • 影厅编码
  • └ zz_seat_code
  • String
  • 3401040003#09#110911
  • 座位编码
  • └ zz_film_code
  • String
  • 001103532023
  • 影片编码
  • └ zz_session_code
  • String
  • 6429202311160059
  • 场次编码
  • └ ticket_price
  • String
  • 35.00
  • 票价。保留两位小数,精度为分。
  • └ screen_servic_fee
  • String
  • 0.00
  • 影厅服务费。保留两位小数,精度为分。
  • └ net_service_fee
  • String
  • 3.00
  • 网络代售服务费。保留两位小数,精度为分。
  • └ return_message
  • String
  • 参数校验失败
  • 返回结果描述信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FilmDataThirdPartyTicketorderGetRequest req = new FilmDataThirdPartyTicketorderGetRequest();
req.setUserId(123123123L);
req.setPlatform(100L);
req.setTbOrderId(12345671232112L);
req.setExtUserId("1234567");
req.setExtOrderId("123456743221");
req.setParamsString("null");
FilmDataThirdPartyTicketorderGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<film_data_third_party_ticketorder_get_response>
    <result>
        <return_code>0</return_code>
        <return_value>
            <top_sale_order_status_list>
                <top_sale_order_status>
                    <sale_content>1</sale_content>
                    <sale_tb_order_id>1</sale_tb_order_id>
                    <sale_id>1</sale_id>
                </top_sale_order_status>
            </top_sale_order_status_list>
            <standard_code_list>
                <ticket_gb_code_vo>
                    <seat_name>6排5座</seat_name>
                    <seat_code>001234521017-6-8</seat_code>
                    <ticket_no>1456000620000000</ticket_no>
                    <gb_qr_code>31093101egVF+/vKa2panmlJbP55eXSjwR8Oi3wgKGjWGn0EWkHuXMFzhVTzUdRqPbof+VN78LUI2duCfmzwi9yaFNSxqCp63Ay7dqZZC7J6lBiC1231231QGJZtB8hL3+Z6U5LBIlT+u0000000000DmxKG6Ud4VA=</gb_qr_code>
                </ticket_gb_code_vo>
            </standard_code_list>
            <qrcode>1456483368123123</qrcode>
            <ticket_contents>取票号:1456483368123123</ticket_contents>
            <message>协议支付失败,账户余额不足</message>
            <issue_date>1627355244000</issue_date>
            <status>TRADE_SUCCESS</status>
            <ext_order_id>1419856760706000000</ext_order_id>
            <tb_order_id>1361378535547000000</tb_order_id>
            <zhuanzi_report_data>
                <zhuanzi_report_data_v_o>
                    <ticket_no>340104000Gv0001</ticket_no>
                    <zz_cinema_code>34010400</zz_cinema_code>
                    <zz_screen_code>0000000000000003</zz_screen_code>
                    <zz_seat_code>3401040003#09#110911</zz_seat_code>
                    <zz_film_code>001103532023</zz_film_code>
                    <zz_session_code>6429202311160059</zz_session_code>
                    <ticket_price>35.00</ticket_price>
                    <screen_servic_fee>0.00</screen_servic_fee>
                    <net_service_fee>3.00</net_service_fee>
                </zhuanzi_report_data_v_o>
            </zhuanzi_report_data>
        </return_value>
        <return_message>参数校验失败</return_message>
    </result>
</film_data_third_party_ticketorder_get_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

返回
顶部