# 所有订单查询 - 淘宝订单查询接口
# 接口描述
该接口是同步淘宝账号的订单接口,接口和阿里妈妈的订单查询,阿里妈妈订单同步接口一样,用于同步客户的下单数据,
举个例子:公司在抖音里面投了多个广告,想要通过淘宝订单同步接口追踪多个不同渠道下单的订单数量可使用本接口
该接口可以很清晰的知道不同抖音渠道所带来的广告转化
# 接口名称
taobao.tbk.sc.order.details.get
# 调用方法
https://api.taobaokeapi.com/?usertoken=[usertoken]&method=taobao.tbk.sc.order.details.get
# 请求参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
query_type | Number | false | 1 | 查询时间类型,1:按照订单淘客创建时间查询,2:按照订单淘客付款时间查询,3:按照订单淘客结算时间查询 |
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 |
# 响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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 |
has_pre | Boolean | false | 是否还有上一页 |
position_index | String | 1555904214_lGltNdNvSX2 | 1555917305_lJfPMeFmdt2 |
has_next | Boolean | true | 是否还有下一页 |
page_no | Number | 1 | 页码 |
page_size | Number | 11 | 页大小 |
# 响应示例
{
"tbk_sc_order_details_get_response":{
"data":{
"results":{
"publisher_order_dto":[
{
"tb_paid_time":"2019-04-22 15:15:05",
"tk_paid_time":"2019-04-22 15:15:05",
"pay_price":"9.11",
"pub_share_fee":"0",
"trade_id":"294159887445064307",
"tk_order_role":2,
"tk_earning_time":"2019-04-22 15:15:05",
"adzone_id":11,
"pub_share_rate":"100",
"refund_tag":0,
"subsidy_rate":"0",
"tk_total_rate":"9.99",
"item_category_name":"淘小铺",
"seller_nick":"--",
"pub_id":98836808,
"alimama_rate":"0",
"subsidy_type":"--",
"item_img":"\/\/img.alicdn.com\/bao\/uploaded\/i1\/2200782262419\/O1CN01b5qlop1TjwarUo8fo_!!2200782262419.jpg",
"pub_share_pre_fee":"0",
"alipay_total_price":"11.22",
"item_title":"tsh_rj_测试请不要拍_阶佣11.1",
"site_name":"合伙人",
"item_num":2,
"subsidy_fee":"0",
"alimama_share_fee":"0",
"trade_parent_id":"294159887445064307",
"order_type":"如意淘",
"tk_create_time":"2019-04-22 15:15:05",
"flow_source":"--",
"terminal_type":"无线",
"click_time":"2019-04-22 15:14:55",
"tk_status":13,
"item_price":"2.1",
"item_id":590141576510,
"adzone_name":"",
"total_commission_rate":"9.99",
"item_link":"",
"site_id":45598009,
"seller_shop_title":"--",
"income_rate":"9.99",
"total_commission_fee":"0",
"tk_commission_pre_fee_for_media_platform":"1.05",
"tk_commission_fee_for_media_platform":"1.05",
"tk_commission_rate_for_media_platform":"0.01",
"special_id":2323,
"relation_id":2323
}
]
},
"has_pre":false,
"position_index":"1555904214_lGltNdNvSX2|1555917305_lJfPMeFmdt2",
"has_next":true,
"page_no":1,
"page_size":11
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
# 异常示例
{
"error_response":{
"sub_msg":"非法参数",
"code":50,
"sub_code":"isv.invalid-parameter",
"msg":"Remote service error"
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
# 错误码解释
错误码 | 错误消息 | 解决方案 |
---|---|---|
2007 | ||
3001 | ||
2002 | ||
2005 | ||
1006 | ||
2003 | ||
2001 | ||
1008 | ||
2004 | ||
9999 |