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

taobao.film.saleinfo.terminal.approval (淘宝卖品券核销接口)

为了实现机具卖品券的打印,在打印完成后需要调用该接口进行核销

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
approvals SaleInfoApproval [] 可选
  • 最大列表长度:20
  • 卖品核销列表
    • └ print_count
    • Number
    • 可选
    • 2
    • 已打印卖品券张数
    • └ sale_id
    • Number
    • 可选
    • 1
    • 卖品套餐唯一标识,用于核销区别
    • └ sale_count
    • Number
    • 可选
    • 3
    • 卖品券总张数
    • └ type
    • String
    • 可选
    • 1
    • 卖品类型:0-赠送卖品,1-有价卖品
    • └ tb_order_id
    • String
    • 可选
    • 1492158596751999
    • 淘宝订单id
    fetch_code String 可选 W45W345 取票码
    partner_no String 可选 lien 机具提供商编号
    print_count Number 可选 2 总共已打印卖品券数量
    sale_count Number 可选 3 卖品券总数量
    terminal_no String 可选 TB01001 机具编号
    verify_code String 可选 11123 验票码

    响应参数

    名称 类型 示例值 描述
    data SaleInfoApprovalResponse 卖品券核销结果集
    • └ print_count
    • Number
    • 123
    • 已打印卖品数量
    result_code String 卖品核销异常 错误代码
    status Number 1 交易是否有异常

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    FilmSaleinfoTerminalApprovalRequest req = new FilmSaleinfoTerminalApprovalRequest();
    List<FilmSaleinfoTerminalApprovalRequest.SaleInfoApproval> list2 = new ArrayList<FilmSaleinfoTerminalApprovalRequest.SaleInfoApproval>();
    FilmSaleinfoTerminalApprovalRequest.SaleInfoApproval obj3 = new FilmSaleinfoTerminalApprovalRequest.SaleInfoApproval();
    list2.add(obj3);
    obj3.setPrintCount(2L);
    obj3.setSaleId(1L);
    obj3.setSaleCount(3L);
    obj3.setType("1");
    obj3.setTbOrderId("1492158596751999");
    req.setApprovals(list2);
    req.setFetchCode("W45W345");
    req.setPartnerNo("lien");
    req.setPrintCount(2L);
    req.setSaleCount(3L);
    req.setTerminalNo("TB01001");
    req.setVerifyCode("11123");
    FilmSaleinfoTerminalApprovalResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <film_saleinfo_terminal_approval_response>
        <data>
            <print_count>123</print_count>
        </data>
        <result_code>卖品核销异常</result_code>
        <status>1</status>
    </film_saleinfo_terminal_approval_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

    返回
    顶部