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

taobao.film.trade.terminal.info.get (查询票/卖品订单数据接口)

提供给机具客户端查询票/卖品订单数据接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
cinema_ext_id String 可选 32432 外部影院编号
verify_code String 可选 111 验证码
fetch_channel String 可选 web 出票渠道
terminal_no String 可选 TB00001 机具编号
partner_no String 可选 lien 厂商编号
fetch_entrance String 可选 ticket 用户机具操作入口
fetch_code String 可选 32332423 取票码

响应参数

名称 类型 示例值 描述
status Number 1 成功
data TradeInfoResponse data data
  • sale_infos
  • SaleInfo []
  • 卖品券集合
  • └ tb_order_id
  • String
  • 1492158596751999
  • 淘宝订单id
  • └ ext_order_id
  • String
  • 20090538
  • 外部订单id
  • └ print_count
  • Number
  • 1
  • 已经打印的卖品券数量
  • └ sale_count
  • Number
  • 2
  • 卖品券数量
  • └ price
  • String
  • 35.00
  • 卖品价格
  • └ content
  • String
  • 可乐*2
  • 卖品内容
  • └ sale_info
  • String
  • 卖品券说明信息
  • 卖品信息
  • └ verify_code
  • String
  • demo
  • 验票码
  • └ fetch_code
  • String
  • 222222
  • 取票码
  • └ cinema_name
  • String
  • 中影国际影城(杭州西溪印象城店)
  • 影院名称
  • └ sale_id
  • Number
  • 0
  • 卖品套餐id
  • └ type
  • String
  • 0
  • 卖品类型:0-赠送卖品,1-有价卖品
  • └ description
  • String
  • 描述
  • description
  • └ valid_time
  • String
  • 2014-10-31
  • validTime
  • └ sale_edition_pic
  • String
  • base64数据
  • 卖品票版图片,base64数据
  • └ sale_edition_id
  • String
  • 15
  • 卖品票版ID
  • ticket_info
  • TicketInfoResponse
  • 票订单信息
  • 票订单信息
  • └ cinema_name
  • String
  • 黄金影院
  • 影院名称
  • └ ticket_tips
  • String
  • 票纸专属语
  • ticketTips
  • └ hall_type
  • String
  • 贵宾区
  • 区域
  • └ show_time
  • String
  • 2014-10-31 21:00
  • 影片放映时间
  • └ token_info
  • String
  • AD212FSDC0
  • 加密信息,票据核销时需原样上传
  • └ seller_name
  • String
  • 淘宝电影
  • 卖家名称
  • └ user_birthday_status
  • Number
  • 1
  • userBirthdayStatus
  • └ sale_channel
  • String
  • 网售
  • 售票类型
  • └ show_version
  • String
  • IMAX-3D
  • 影片版本
  • └ hall_name
  • String
  • 3号厅
  • 影厅名称
  • └ show_name
  • String
  • 变形金刚
  • 影片名称
  • └ terminal_tips
  • String
  • 取票机具专属语
  • terminalTips
  • └ has_sale_info
  • String
  • 1
  • 是否有卖品券
  • └ ext_info
  • String
  • schedule_no:3
  • 扩展信息
  • └ sale_time
  • String
  • 2014-10-31 21:00:12
  • 销售时间
  • └ language
  • String
  • 英语
  • 语言
  • ticket_infos
  • TicketInfo []
  • tt
  • 可出票信息
  • └ ori_ticket_no
  • String
  • 1234567
  • 原始淘宝订单号
  • └ qr_code
  • String
  • 100
  • sadfals234ljasf
  • └ print_status
  • String
  • 100
  • 100
  • └ service_fee
  • String
  • 100
  • 100
  • └ price
  • String
  • 100
  • 100
  • └ seat_info
  • String
  • 100
  • 100
  • └ section_name
  • String
  • 分区一楼
  • 分区名称
  • └ ticket_no
  • String
  • 100
  • 100
  • └ net_service_fee
  • String
  • 100
  • 网络代售费(单位:元
  • └ screen_service_fee
  • String
  • 100
  • 影院服务费(单位:元
  • └ ticket_edition_pic
  • String
  • base64数据
  • 票版图片,base64数据
  • └ little_ticket_edition_pic
  • String
  • base64数据
  • 小票版图片,base64数据
  • └ ticket_edition_id
  • String
  • 10
  • 票版ID
  • └ member_level
  • String
  • V4
  • memberLevel
  • └ cinema_address
  • String
  • 北京市朝阳区望京街道125号
  • 影院地址
  • └ director_name
  • String
  • 彼得杰克逊
  • 导演
  • └ end_time
  • String
  • 2014-10-31 21:00
  • 散场时间
  • └ member_flag
  • String
  • 2021-07-19
  • 新版会员标识
  • └ ticket_edition_id
  • String
  • 10
  • 票版ID
  • └ ticket_edition_pic
  • String
  • base64数据
  • 票版图片,base64数据
  • └ show_end_time
  • Date
  • date类型
  • 影片结束时间
  • └ little_ticket_edition_pic
  • String
  • base64数据
  • 小票版图片,base64数据
  • └ terminal_tips_pic
  • String
  • url连接
  • 取票语动态图片URL
result_code String 1001 返回码
result_desc String 机具信息未配置 结果描述
trace_id String 213da4a616986554881586972d0d8a 请求的服务端traceId

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FilmTradeTerminalInfoGetRequest req = new FilmTradeTerminalInfoGetRequest();
req.setCinemaExtId("32432");
req.setVerifyCode("111");
req.setFetchChannel("web");
req.setTerminalNo("TB00001");
req.setPartnerNo("lien");
req.setFetchEntrance("ticket");
req.setFetchCode("32332423");
FilmTradeTerminalInfoGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<film_trade_terminal_info_get_response>
    <status>1</status>
    <data>
        <sale_infos>
            <sale_info>
                <tb_order_id>1492158596751999</tb_order_id>
                <ext_order_id>20090538</ext_order_id>
                <print_count>1</print_count>
                <sale_count>2</sale_count>
                <price>35.00</price>
                <content>可乐*2</content>
                <sale_info>卖品券说明信息</sale_info>
                <verify_code>demo</verify_code>
                <fetch_code>222222</fetch_code>
                <cinema_name>中影国际影城(杭州西溪印象城店)</cinema_name>
                <sale_id>0</sale_id>
                <type>0</type>
                <description>描述</description>
                <valid_time>2014-10-31</valid_time>
                <sale_edition_pic>base64数据</sale_edition_pic>
                <sale_edition_id>15</sale_edition_id>
            </sale_info>
        </sale_infos>
        <ticket_info>
            <cinema_name>黄金影院</cinema_name>
            <ticket_tips>票纸专属语</ticket_tips>
            <hall_type>贵宾区</hall_type>
            <show_time>2014-10-31 21:00</show_time>
            <token_info>AD212FSDC0</token_info>
            <seller_name>淘宝电影</seller_name>
            <user_birthday_status>1</user_birthday_status>
            <sale_channel>网售</sale_channel>
            <show_version>IMAX-3D</show_version>
            <hall_name>3号厅</hall_name>
            <show_name>变形金刚</show_name>
            <terminal_tips>取票机具专属语</terminal_tips>
            <has_sale_info>1</has_sale_info>
            <ext_info>schedule_no:3</ext_info>
            <sale_time>2014-10-31 21:00:12</sale_time>
            <language>英语</language>
            <ticket_infos>
                <ticket_info>
                    <ori_ticket_no>1234567</ori_ticket_no>
                    <qr_code>100</qr_code>
                    <print_status>100</print_status>
                    <service_fee>100</service_fee>
                    <price>100</price>
                    <seat_info>100</seat_info>
                    <section_name>分区一楼</section_name>
                    <ticket_no>100</ticket_no>
                    <net_service_fee>100</net_service_fee>
                    <screen_service_fee>100</screen_service_fee>
                    <ticket_edition_pic>base64数据</ticket_edition_pic>
                    <little_ticket_edition_pic>base64数据</little_ticket_edition_pic>
                    <ticket_edition_id>10</ticket_edition_id>
                </ticket_info>
            </ticket_infos>
            <member_level>V4</member_level>
            <cinema_address>北京市朝阳区望京街道125号</cinema_address>
            <director_name>彼得杰克逊</director_name>
            <end_time>2014-10-31 21:00</end_time>
            <member_flag>2021-07-19</member_flag>
            <ticket_edition_id>10</ticket_edition_id>
            <ticket_edition_pic>base64数据</ticket_edition_pic>
            <show_end_time>date类型</show_end_time>
            <little_ticket_edition_pic>base64数据</little_ticket_edition_pic>
        </ticket_info>
        <terminal_tips_pic>url连接</terminal_tips_pic>
    </data>
    <result_code>1001</result_code>
    <result_desc>机具信息未配置</result_desc>
    <trace_id>213da4a616986554881586972d0d8a</trace_id>
</film_trade_terminal_info_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

返回
顶部