taobao.bill.bills.get (查询账单明细数据(自研发商家专用))

查询账单明细数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String [] 必须 bid,account_id,trade_id,order_id
  • 最大列表长度:20
  • 传入需要返回的字段,参见Bill结构体
    time_type Number 可选 1 查询条件中的时间类型:1-交易订单完成时间biz_time 2-支付宝扣款时间pay_time 如果不填默认为2即根据支付时间查询,查询的结果会根据该时间倒排序
    end_time Date 必须 2013-01-14 08:27:30 结束时间,限制:结束时间-开始时间不能大于1天(根据order_id或者trade_id查询除外)
    trade_id Number 可选 115813163 交易编号
    account_id Number 可选 10001011 科目编号
    start_time Date 必须 2013-01-14 08:27:30 开始时间
    page_no Number 可选 2
  • 默认值:1
  • 页数,建议不要超过100页,越大性能越低,有可能会超时
    page_size Number 可选 40
  • 默认值:40
  • 每页大小,默认40条,可选范围 :40~100
    order_id Number 可选 115813163 子订单编号

    响应参数

    名称 类型 示例值 描述
    has_next Boolean false 是否存在下一页
    total_results Number 20 当前页查询返回的结果数(0-100)。相同的查询时间段条件下,最大只能获取总共5000条记录。所以当大于等于5000时 ISV可以通过start_time及end_time来进行拆分,以保证可以查询到全部数据
    bills Bill [] 账单列表
    • └ total_amount
    • Number
    • 21100
    • 交易金额
    • └ obj_alipay_id
    • String
    • 20887017343856590156
    • 目标支付宝账户编号
    • └ account_id
    • Number
    • 10002011
    • 科目编号
    • └ status
    • Number
    • 1
    • 0-未支付,1-支付成功,2-支付失败
    • └ book_time
    • Date
    • 2013-01-14 08:27:30
    • 记账时间
    • └ gmt_modified
    • String
    • 2013-01-14 08:26:21
    • 修改时间
    • └ alipay_notice
    • String
    • 聚划算佣金,{115823163}扣款,
    • 支付宝备注
    • └ pay_time
    • Date
    • 2013-01-14 08:27:30
    • 支付时间,收取佣金时支付宝的扣款时间
    • └ order_id
    • String
    • 216696433326455
    • 交易子订单编号
    • └ biz_time
    • Date
    • 2013-01-14 08:27:30
    • 业务时间,订单交易完成的时间
    • └ amount
    • Number
    • 179
    • 账单金额,退款时返回的是负数
    • └ obj_alipay_mail
    • String
    • ju.tuangou@service.taobao.com
    • 目标支付宝账户名称
    • └ gmt_create
    • Date
    • 2013-01-14 08:26:21
    • 创建时间
    • └ trade_id
    • String
    • 216696433326455
    • 交易订单编号
    • └ alipay_outno
    • String
    • HJCOM==3200036031==1005158716220211==115813163
    • 支付宝商户订单号
    • └ alipay_mail
    • String
    • xxxx@xxx.com
    • 支付宝账户名称
    • └ bid
    • Number
    • 1001205838220018
    • 账单编号
    • └ alipay_id
    • String
    • 20880012765902710156
    • 支付宝账户编号
    • └ num_iid
    • String
    • 13394023856
    • 所属商品编号
    • └ alipay_no
    • String
    • 2013011600001000220030311205
    • 支付宝交易号,暂不提供

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    BillBillsGetRequest req = new BillBillsGetRequest();
    req.setFields("bid,account_id,trade_id,order_id");
    req.setTimeType(1L);
    req.setEndTime(StringUtils.parseDateTime("2013-01-14 08:27:30"));
    req.setTradeId(115813163L);
    req.setAccountId(10001011L);
    req.setStartTime(StringUtils.parseDateTime("2013-01-14 08:27:30"));
    req.setPageNo(2L);
    req.setPageSize(40L);
    req.setOrderId(115813163L);
    BillBillsGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <bill_bills_get_response>
        <has_next>false</has_next>
        <total_results>20</total_results>
        <bills>
            <bill>
                <total_amount>21100</total_amount>
                <obj_alipay_id>20887017343856590156</obj_alipay_id>
                <account_id>10002011</account_id>
                <status>1</status>
                <book_time>2013-01-14 08:27:30</book_time>
                <gmt_modified>2013-01-14 08:26:21</gmt_modified>
                <alipay_notice>聚划算佣金,{115823163}扣款,</alipay_notice>
                <pay_time>2013-01-14 08:27:30</pay_time>
                <order_id>216696433326455</order_id>
                <biz_time>2013-01-14 08:27:30</biz_time>
                <amount>179</amount>
                <obj_alipay_mail>ju.tuangou@service.taobao.com</obj_alipay_mail>
                <gmt_create>2013-01-14 08:26:21</gmt_create>
                <trade_id>216696433326455</trade_id>
                <alipay_outno>HJCOM==3200036031==1005158716220211==115813163</alipay_outno>
                <alipay_mail>xxxx@xxx.com</alipay_mail>
                <bid>1001205838220018</bid>
                <alipay_id>20880012765902710156</alipay_id>
                <num_iid>13394023856</num_iid>
                <alipay_no>2013011600001000220030311205</alipay_no>
            </bill>
        </bills>
    </bill_bills_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>

    错误码解释

    错误码 错误描述 解决方案
    isp.remote-service-timeout API调用远程服务超时 1. 每次返回50条以下,时间跨度小于半个小时 2. 避开交易高峰期上午9:30-11:00,下午14:00-17:00,晚上20:00-22:30,凌晨:1:00-3:00
    isv.invalid-parameter:date too long 查询时间跨度过长 缩小查询时间跨度,跨度建议小于1天

    API工具

    如何获得此API

    FAQ

    返回
    顶部