注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 电子凭证平台

taobao.vmarket.eticket.tasks.get (任务列表获取接口)

外部合作卖家获取任务列表的信息:如发码同通知失败或者回调失败的订单号

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
seller_id Number 可选 1531341313221 卖家家ID(信任卖家不必传,码商可选)
type Number 必须 1 返回结果类型: 1:返回通知失败的订单 2.返回通知成功回调失败的订单
page_no Number 可选 1
  • 默认值:1
  • 页码。取值范围:大于零的整数; 默认值:1
    page_size Number 可选 20
  • 默认值:40
  • 每页获取条数。默认值40,最小值1,最大值100。
    codemerchant_id Number 可选 12345 码商ID,如果是码商,必须传,如果是信任卖家,不需要传

    响应参数

    名称 类型 示例值 描述
    eticket_tasks EticketTask [] 任务列表查询结果信息
    • └ order_id
    • Number
    • 1111111111
    • 订单ID
    total_results Number 10 任务列表查询结果的总数

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    VmarketEticketTasksGetRequest req = new VmarketEticketTasksGetRequest();
    req.setSellerId(1531341313221L);
    req.setType(1L);
    req.setPageNo(1L);
    req.setPageSize(20L);
    req.setCodemerchantId(12345L);
    VmarketEticketTasksGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <vmarket_eticket_tasks_get_response>
        <eticket_tasks>
            <eticket_task>
                <order_id>1111111111</order_id>
            </eticket_task>
        </eticket_tasks>
        <total_results>10</total_results>
    </vmarket_eticket_tasks_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.eticket-invalid-parameter:invalid-type 无效的type参数 调用接口的时候必须传递type参数
    isv.eticket-seller-error:invalid-eticket-seller 码商/信任卖家没有入驻 入驻淘宝电子凭证平台
    isv.eticket-service-unavailable:op-failed 接口回调失败 参考具体的错误信息处理

    API工具

    如何获得此API

    FAQ

    返回
    顶部