V兔API开放平台

参数	类型	必选	示例	描述
shop_id	Number	true	123	店铺 id
query_start_date	Date	true	2015-03-05 11:10:30	开始时间
p_trade_id	Number	false	123	交易编号
trade_id	Number	false	123	子订单编号
page_size	Number	false	123	每页大小，默认 40 条，可选范围：40~100
query_date_type	Number	false	123	查询条件中的时间类型：1-交易订单完成时间 biz_time 2-支付宝扣款时间 pay_time 如果不填默认为 2 即根据支付时间查询，查询的结果会根据该时间倒排序
current_page	Number	false	123	页数，建议不要超过 100 页，越大性能越低，有可能会超时
item_id	Number	false	123	科目编号
query_end_date	Date	true	2015-03-05 11:10:30	结束时间，限制：结束时间-开始时间不能大于 1 天(根据 order_id 或者 trade_id 查询除外)
fields	String[]	true	bid,account_id,trade_id,order_id	传入需要返回的字段，参见 Bill 结构体
vvtype	Number	false	2	2 高级版（必须填 2,不填默认是 2）

请求示例

shop_id:123

请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

响应参数

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

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1460,
    "time": 1617273033,
    "data": {
        "withholding_money": 1
		 "tae_bills_get_response":{
        "total_results":20,
        "has_next":false,
        "bills":{
            "bill_dto":[
                {
                    "total_amount":100,
                    "gmt_modified":"2013-01-14 08:26:21",
                    "gmt_create":"2015-03-05 13:44:34",
                    "status":1,
                    "order_id":"123",
                    "biz_time":"2015-03-05 13:44:34",
                    "amount":123,
                    "alipay_notice":"聚划算佣金,{115823163}扣款,",
                    "alipay_outno":"HJCOM==3200036031==1005158716220211==115813163",
                    "obj_alipay_id":"20887017343856590156",
                    "trade_id":"123",
                    "alipay_id":"20880012765902710156",
                    "account_id":123,
                    "alipay_mail":"xxxx@xxx.com",
                    "obj_alipay_mail":"ju.tuangou@service.taobao.com",
                    "pay_time":"2015-03-05 13:43:02",
                    "bid":123,
                    "book_time":"2015-03-05 13:43:02",
                    "num_iid":"13394023856",
                    "alipay_no":"2013011600001000220030311205"
                }
            ]
        }
    }
    }
    
}

响应代码

代码	代码描述	解决方案
0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
103	旺旺账号不存在	检查您输入的旺旺号是否正确
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
202	系统错误，请稍后再试	稍后重试，或者联系对接群
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API 调用次数不足，请前往网站兑换次数。	前往官网充值该接口调用次数
302	未授权店铺	根据返回链接进行扫码授权
401	身份凭证无效	在请求头中添加 access_token，重新更新 token
404	请求路径或请求方式错误	请更换请求方式或者检查路径是否正确