全部
淘宝客
在线测试

淘宝客-服务商-所有订单查询


接口地址: http://api.vv-tool.com/tool/taobaoke/tbkdetails


接口介绍: 服务商使用。可通过该接口查询推广者账号下对应的推广订单明细。点击查看详情


必须用户授权 : 需要用户的授权,才能拿到被授权的数据


请求方式: POST


返回格式: JSON


接口收费: 联系运营


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

名称 类型 必须 示例值 描述
query_type Number false 1 查询时间类型,1:按照订单淘客创建时间查询,2:按照订单淘客付款时间查询,3:按照订单淘客结算时间查询,4:按照订单更新时间;
position_index String false 2222_334666 位点,除第一页之外,都需要传递;前端原样返回。
page_size Number false 20 页大小,默认 20,1~100
member_type Number false 2 推广者角色类型,2:二方,3:三方,不传,表示所有角色
tk_status Number false 12 淘客订单状态,12-付款,13-关闭,14-确认收货,3-结算成功;不传,表示所有状态
end_time String true 2019-04-23 12:28:22 订单查询结束时间,订单开始时间至订单结束时间,中间时间段日常要求不超过 3 个小时,但如 618、双 11、年货节等大促期间预估时间段不可超过 20 分钟,超过会提示错误,调用时请务必注意时间段的选择,以保证亲能正常调用!
start_time String true 2019-04-05 12:18:22 订单查询开始时间
jump_type Number false 1 跳转类型,当向前或者向后翻页必须提供,-1: 向前翻页,1:向后翻页
page_no Number false 1 第几页,默认 1,1~100
order_scene Number false 1 场景订单场景类型,1:常规订单,2:渠道订单,3:会员运营订单,默认为 1
taobao_user_id Int true 123 授权的用户 ID

请求示例

{
    "start_time": "2022-08-05 17:00:22",
    "end_time": "2022-08-05 18:18:22",
    "taobao_user_id": "1053992881"
}

请求代码示例

cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/taobaoke/tbkdetails' \
--header 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--header 'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=23cb193174e4095b141ccd6f6007733f; _csrf=2cd19402adae1c3113d9f645faab88a25cbaa984b70d96822c180b7eb5a081e2a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22yN3ZzOyIK8RcBRyag4P7WS66SlTkGj-Q%22%3B%7D' \
--data-raw '{
    "start_time": "2022-08-01 11:00:22",
    "end_time": "2022-08-01 12:18:22",
    "taobao_user_id": "2208551696445"
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/taobaoke/tbkdetails',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "start_time": "2022-08-01 11:00:22",
    "end_time": "2022-08-01 12:18:22",
    "taobao_user_id": "2208551696445"
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXX',
    'Content-Type: application/json',
    'Cookie: __yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=23cb193174e4095b141ccd6f6007733f; _csrf=2cd19402adae1c3113d9f645faab88a25cbaa984b70d96822c180b7eb5a081e2a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22yN3ZzOyIK8RcBRyag4P7WS66SlTkGj-Q%22%3B%7D'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n    \"start_time\": \"2022-08-01 11:00:22\",\r\n    \"end_time\": \"2022-08-01 12:18:22\",\r\n    \"taobao_user_id\": \"2208551696445\"\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/taobaoke/tbkdetails")
  .method("POST", body)
  .addHeader("Authorization", "Bearer XXXXXXXXXXXXXXXXXXXXXXX")
  .addHeader("Content-Type", "application/json")
  .addHeader("Cookie", "__yjs_duid=1_631b442499ed9f835d199def5892e4091628487614220; PHPSESSID=23cb193174e4095b141ccd6f6007733f; _csrf=2cd19402adae1c3113d9f645faab88a25cbaa984b70d96822c180b7eb5a081e2a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22yN3ZzOyIK8RcBRyag4P7WS66SlTkGj-Q%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

名称 类型 示例值 描述
data OrderPage OrderPage PublisherOrderDto
results PublisherOrderDto[] PublisherOrderDto PublisherOrderDto
tb_paid_time String 2019-04-22 15:15:05 订单在淘宝拍下付款的时间
tk_paid_time String 2019-04-22 15:15:05 订单付款的时间,该时间同步淘宝,可能会略晚于买家在淘宝的订单创建时间
pay_price String 9.11 买家确认收货的付款金额(不包含运费金额)
pub_share_fee String 0 结算预估收入 = 结算金额*提成。以买家确认收货的付款金额为基数,预估您可能获得的收入。因买家退款、您违规推广等原因,可能与您最终收入不一致。最终收入以月结后您实际收到的为准
trade_id String 294159887445064307 买家通过购物车购买的每个商品对应的订单编号,此订单编号并未在淘宝买家后台透出
tk_order_role Number 2 二方:佣金收益的第一归属者; 三方:从其他淘宝客佣金中进行分成的推广者
tk_earning_time String 2019-04-22 15:15:05 订单确认收货后且商家完成佣金支付的时间
adzone_id Number 11 推广位管理下的推广位名称对应的 ID,同时也是 pid=mm_1_2_3 中的“3”这段数字
pub_share_rate String 100 从结算佣金中分得的收益比率
refund_tag Number 0 维权标签,0 含义为非维权 1 含义为维权订单
subsidy_rate String 0 平台给与的补贴比率,如天猫、淘宝、聚划算等
tk_total_rate String 9.99 提成 = 收入比率*分成比率。指实际获得收益的比率
item_category_name String 淘小铺 商品所属的根类目,即一级类目的名称
seller_nick String -- 掌柜旺旺
pub_id Number 98836808 推广者的会员 id
alimama_rate String 0 推广者赚取佣金后支付给阿里妈妈的技术服务费用的比率
subsidy_type String -- 平台出资方,如天猫、淘宝、或聚划算等
item_img String //img.alicdn.com/bao/uploaded/i1/2200782262419/O1CN01b5qlop1TjwarUo8fo_!!2200782262419.jpg 商品图片
pub_share_pre_fee String 0 付款预估收入 = 付款金额*提成。指买家付款金额为基数,预估您可能获得的收入。因买家退款等原因,可能与结算预估收入不一致
alipay_total_price String 11.22 买家拍下付款的金额(不包含运费金额)
item_title String tsh_rj_测试请不要拍_阶佣 11.1 商品标题
site_name String 合伙人 媒体管理下的对应 ID 的自定义名称
item_num Number 2 商品数量
subsidy_fee String 0 补贴金额 = 结算金额*补贴比率
alimama_share_fee String 0 技术服务费 = 结算金额收入比率技术服务费率。推广者赚取佣金后支付给阿里妈妈的技术服务费用
trade_parent_id String 294159887445064307 买家在淘宝后台显示的订单编号
order_type String 如意淘 订单所属平台类型,包括天猫、淘宝、聚划算等
tk_create_time String 2019-04-22 15:15:05 订单创建的时间,该时间同步淘宝,可能会略晚于买家在淘宝的订单创建时间
flow_source String -- 产品类型
terminal_type String 无线 成交平台
click_time String 2019-04-22 15:14:55 通过推广链接达到商品、店铺详情页的点击时间
tk_status Number 13 已付款:指订单已付款,但还未确认收货 已收货:指订单已确认收货,但商家佣金未支付 已结算:指订单已确认收货,且商家佣金已支付成功 已失效:指订单关闭/订单佣金小于 0.01 元,订单关闭主要有:1)买家超时未付款; 2)买家付款前,买家/卖家取消了订单;3)订单付款后发起售中退款成功;3:订单结算,12:订单付款, 13:订单失效,14:订单成功
item_price String 2.1 商品单价
item_id Number 590141576510 商品 id
adzone_name String 推广位管理下的自定义推广位名称
total_commission_rate String 9.99 佣金比率
item_link String 商品链接
site_id Number 45598009 媒体管理下的 ID,同时也是 pid=mm_1_2_3 中的“2”这段数字
seller_shop_title String -- 店铺名称
income_rate String 9.99 订单结算的佣金比率 + 平台的补贴比率
total_commission_fee String 0 佣金金额 = 结算金额*佣金比率
tk_commission_pre_fee_for_media_platform String 1.05 预估内容专项服务费:内容场景专项技术服务费,内容推广者在内容场景进行推广需要支付给阿里妈妈专项的技术服务费用。专项服务费 =付款金额*专项服务费率。
tk_commission_fee_for_media_platform String 1.05 结算内容专项服务费:内容场景专项技术服务费,内容推广者在内容场景进行推广需要支付给阿里妈妈专项的技术服务费用。专项服务费 =结算金额*专项服务费率。
tk_commission_rate_for_media_platform String 0.01 内容专项服务费率:内容场景专项技术服务费率,内容推广者在内容场景进行推广需要按结算金额支付一定比例给阿里妈妈作为内容场景专项技术服务费,用于提供与内容平台实现产品技术对接等服务。
special_id Number 2323 会员运营 id
relation_id Number 2323 渠道关系 id
tk_deposit_time String 2019-09-09 12:01:01 预售时期,用户对预售商品支付定金的付款时间,可能略晚于在淘宝付定金时间
tb_deposit_time String 2019-09-09 12:01:01 预售时期,用户对预售商品支付定金的付款时间
deposit_price String 122.22 预售时期,用户对预售商品支付的定金金额
app_key String 112121 开发者调用 API 的 appkey
alsc_id String 2332 口碑子订单号
alsc_pid String 32324 口碑父订单号
service_fee_dto_list ServiceFeeDto[] ServiceFeeDto 服务费信息
share_relative_rate String 0.10 专项服务费率
share_fee String 11.11 结算专项服务费
share_pre_fee String 11.11 预估专项服务费
tk_share_role_type Number 122 专项服务费来源,122-渠道
lx_rid String 13123 激励池对应的 rid
is_lx String 1 订单是否为激励池订单 1,表征是 0,表征否
marketing_type String 营销类型:该字段中视订单情况有单个或多个值。 例如:淘礼金(自助充值),特价版客户端染色,特价版客户端锁粉,特价版客户端推广。
modified_time String 订单更新时间
has_pre Boolean false 是否还有上一页
position_index String 1555904214_lGltNdNvSX2 1555917305_lJfPMeFmdt2
has_next Boolean true 是否还有下一页
page_no Number 1 页码
page_size Number 11 页大小
withholding_money INT 11 该接口扣费金额(点券)

返回数据

{
    "code": 0,
    "msg": "成功",
    "msec": 374,
    "time": 1659950830,
    "data": {
        "request_id": "15rqapzkmv6ys",
        "Body": "",
        "data": {
            "results": [
                {
                    "tb_paid_time": "2022-08-05 17:07:02",
                    "tk_paid_time": "2022-08-05 17:07:14",
                    "pub_share_fee": "0.00",
                    "trade_id": "1634683908275542478",
                    "tk_order_role": 2,
                    "adzone_id": 74488900014,
                    "pub_share_rate": "100.00",
                    "refund_tag": 0,
                    "subsidy_rate": "0.00",
                    "tk_total_rate": "1.95",
                    "item_category_name": "咖啡/麦片/冲饮",
                    "seller_nick": "天猫超市",
                    "pub_id": 101807570,
                    "alimama_rate": "0.00",
                    "subsidy_type": "--",
                    "item_img": "//img.alicdn.com/tfscom/i4/6000000006296/O1CN01ANwKAS1wNcOyYkpkc_!!6000000006296-0-picassoopen.jpg",
                    "pub_share_pre_fee": "1.36",
                    "alipay_total_price": "69.66",
                    "item_title": "光明纯奶250mL*24盒苗条装早餐纯牛奶早餐奶牛奶",
                    "site_name": "技术随笔",
                    "item_num": 1,
                    "subsidy_fee": "0.00",
                    "alimama_share_fee": "0.00",
                    "trade_parent_id": "1634683908273542478",
                    "order_type": "聚划算",
                    "tk_create_time": "2022-08-05 17:07:02",
                    "flow_source": "--",
                    "terminal_type": "无线",
                    "click_time": "2022-08-05 16:33:25",
                    "tk_status": 12,
                    "item_price": "74.90",
                    "item_id": "583088863304",
                    "adzone_name": "推广链接94",
                    "total_commission_rate": "1.95",
                    "item_link": "http://item.taobao.com/item.htm?id=583088863304",
                    "site_id": 248750452,
                    "seller_shop_title": "天猫超市",
                    "income_rate": "1.95",
                    "total_commission_fee": "0.00",
                    "tk_commission_pre_fee_for_media_platform": "0.00",
                    "tk_commission_fee_for_media_platform": "0.00",
                    "tk_commission_rate_for_media_platform": "0.00",
                    "tk_deposit_time": "--",
                    "tb_deposit_time": "--",
                    "deposit_price": "0.00",
                    "is_lx": "0",
                    "marketing_type": "",
                    "modified_time": "2022-08-05 17:07:14"
                },
                {
                    "tb_paid_time": "2022-08-05 17:07:02",
                    "tk_paid_time": "2022-08-05 17:07:14",
                    "pub_share_fee": "0.00",
                    "trade_id": "1634683908274542478",
                    "tk_order_role": 2,
                    "adzone_id": 74488900014,
                    "pub_share_rate": "100.00",
                    "refund_tag": 0,
                    "subsidy_rate": "0.00",
                    "tk_total_rate": "1.35",
                    "item_category_name": "咖啡/麦片/冲饮",
                    "seller_nick": "天猫超市",
                    "pub_id": 101807570,
                    "alimama_rate": "0.00",
                    "subsidy_type": "--",
                    "item_img": "//img.alicdn.com/tfscom/i4/6000000005840/O1CN01Kv0aJQ1t0lnF0wOsp_!!6000000005840-0-picassoopen.jpg",
                    "pub_share_pre_fee": "0.17",
                    "alipay_total_price": "12.90",
                    "item_title": "怡宝饮用水 纯净水矿泉水 555ml*12瓶/组   量贩装包装瓶装",
                    "site_name": "技术随笔",
                    "item_num": 1,
                    "subsidy_fee": "0.00",
                    "alimama_share_fee": "0.00",
                    "trade_parent_id": "1634683908273542478",
                    "order_type": "天猫",
                    "tk_create_time": "2022-08-05 17:07:02",
                    "flow_source": "--",
                    "terminal_type": "无线",
                    "click_time": "2022-08-05 16:37:00",
                    "tk_status": 12,
                    "item_price": "19.90",
                    "item_id": "527894573302",
                    "adzone_name": "推广链接94",
                    "total_commission_rate": "1.35",
                    "item_link": "http://item.taobao.com/item.htm?id=527894573302",
                    "site_id": 248750452,
                    "seller_shop_title": "天猫超市",
                    "income_rate": "1.35",
                    "total_commission_fee": "0.00",
                    "tk_commission_pre_fee_for_media_platform": "0.00",
                    "tk_commission_fee_for_media_platform": "0.00",
                    "tk_commission_rate_for_media_platform": "0.00",
                    "tk_deposit_time": "--",
                    "tb_deposit_time": "--",
                    "deposit_price": "0.00",
                    "is_lx": "0",
                    "marketing_type": "",
                    "modified_time": "2022-08-05 17:07:14"
                }
            ],
            "has_pre": false,
            "position_index": "1659690422_1WKRUUbRkIe2|1659690422_1WKRUUbVwRg2",
            "has_next": false,
            "page_no": 1,
            "page_size": 20
        },
        "withholding_money": 0
    }
}

响应代码

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