淘宝客高级API
淘宝联盟订单查询api接口,淘宝客订单查询api接口
需要授权
19482人使用

全新一代淘宝客订单查询接口,突破旧接口20分钟限制。该接口支持开始时间和结束时间查询,彻底告别频繁轮训查询。

查看详细说明
接口地址: http://api.tbk.dingdanxia.com/tbk/order_details 在线测试
请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

signature

string

接口签名,查看创建规则,(可在后台开启或关闭,关闭状态可不需要此参数)

start_time

Date

2019-05-24 12:00:00

开始时间

end_time

Date

2019-05-25 12:00:00

订单查询结束时间,订单开始时间至订单结束时间,中间时间段日常要求不超过3个小时,但如618、双11、年货节等大促期间预估时间段不可超过20分钟,超过会提示错误,调用时请务必注意时间段的选择,以保证亲能正常调用!

query_type

Number

1

查询时间类型,1:按照订单淘客创建时间查询,2:按照订单淘客付款时间查询,3:按照订单淘客结算时间查询

position_index

String

2222_334666

位点,除第一页之外,都需要传递;前端原样返回

page_size

Number

20

页大小,默认20,1~100

page_no

Number

1

第几页,默认1,1~100

member_type

Number

2

推广者角色类型,2:二方,3:三方,不传,表示所有角色

tk_status

Number

13

淘客订单状态,12-付款,13-关闭,14-确认收货,3-结算成功;不传,表示所有状态

jump_type

Number

1

跳转类型,当向前或者向后翻页必须提供,-1: 向前翻页,1:向后翻页

order_scene

Number

1

场景订单场景类型,1:常规订单,2:渠道订单,3:会员运营订单,默认为1

access_token

String

用户access_token,多用户版本使用

返回参数说明

标记

类型

例子

说明

has_pre

Boolean

false

是否还有上一页

position_index

String

1555904214_lGltNdNvSX2|1555917305_lJfPMeFmdt2

位点字段,由调用方原样传递

has_next

Boolean

false

是否还有下一页

page_no

Number

1

页码

page_size

Number

20

页大小

tb_paid_time

Date

2019-04-22 15:15:05

订单在淘宝拍下付款的时间

tk_paid_time

Date

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

Date

2019-04-22 15:15:05

订单确认收货后且商家完成佣金支付的时间

adzone_id

Number

123456

推广位管理下的推广位名称对应的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

12.5

提成=收入比率*分成比率。指实际获得收益的比率

item_category_name

String

淘小铺

商品所属的根类目,即一级类目的名称

seller_nick

String

--

掌柜旺旺

pub_id

Number

123456

推广者的会员id

alimama_rate

String

0

推广者赚取佣金后支付给阿里妈妈的技术服务费用的比率

subsidy_type

String

0

平台出资方,如天猫、淘宝、或聚划算等

item_img

String

//img.alicdn.com/bao/uploaded/i1/2200782262419/O1CN01b5qlop1TjwarUo8fo_!!2200782262419.jpg

商品图片

pub_share_pre_fee

String

0

付款预估收入=付款金额*提成。指买家付款金额为基数,预估您可能获得的收入。因买家退款等原因,可能与结算预估收入不一致

alipay_total_price

String

11.2

买家拍下付款的金额(不包含运费金额)

item_title

String

袜子

商品标题

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

Date

2019-04-22 15:15:05

订单创建的时间,该时间同步淘宝,可能会略晚于买家在淘宝的订单创建时间

flow_source

String

--

产品类型

terminal_type

String

无限

成交平台

click_time

Date

2019-04-22 15:14:55

通过推广链接达到商品、店铺详情页的点击时间

tk_status

Number

3

已付款:指订单已付款,但还未确认收货 已收货:指订单已确认收货,但商家佣金未支付 已结算:指订单已确认收货,且商家佣金已支付成功 已失效:指订单关闭/订单佣金小于0.01元,订单关闭主要有:1)买家超时未付款; 2)买家付款前,买家/卖家取消了订单;3)订单付款后发起售中退款成功;3:订单结算,12:订单付款, 13:订单失效,14:订单成功

item_price

String

12

商品单价

item_id

String

1234567

商品id

adzone_name

String

测试

推广位管理下的自定义推广位名称

total_commission_rate

String

30

佣金比率

item_link

String

--

商品链接

site_id

Number

45598009

媒体管理下的ID,同时也是pid=mm_1_2_3中的“2”这段数字

seller_shop_title

String

00

店铺名称

income_rate

String

9.9

订单结算的佣金比率+平台的补贴比率

total_commission_fee

String

0

佣金金额=结算金额*佣金比率

special_id

Number

1234567

会员运营ID(需要申请到私域会员权限才返回此ID)

relation_id

Number

8765432

渠道关系ID会员运营ID(需要申请到渠道管理权限才返回此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

预售时期,用户对预售商品支付的定金金额

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

1.05

专项服务费率:内容场景专项技术服务费率,内容推广者在内容场景进行推广需要按结算金额支付一定比例给阿里妈妈作为内容场景专项技术服务费,用于提供与内容平台实现产品技术对接等服务。

alsc_id

String

111111

口碑子订单号

alsc_pid

String

22222

口碑父订单号

返回示例
{
    "code": 200,
    "msg": "请求成功【success】",
    "has_next": false,
    "has_pre": false,
    "page_no": 1,
    "page_size": 20,
    "position_index": "1557662727_wBOtXU2A4H2|1557662727_wBOtXU6MdJ2",
    "data": [
        {
            "adzone_id": 44105700493,
            "adzone_name": "渠道专享",
            "alimama_rate": "0.00",
            "alimama_share_fee": "0.00",
            "click_time": "2019-05-12 20:04:42",
            "flow_source": "--",
            "income_rate": "1.50",
            "item_category_name": "女装",
            "item_id": 588868343018,
            "item_img": "//img.alicdn.com/bao/uploaded/i2/2858216695/O1CN01GAGLr31zKMAiYAHql_!!2858216695.jpg",
            "item_link": "http://item.taobao.com/item.htm?id=588868343018",
            "item_num": 1,
            "item_price": "298.00",
            "item_title": "欧洲站2019春夏装新款欧货潮韩版时尚修身蓝色收腰网纱连衣裙女装",
            "order_type": "淘宝",
            "pub_id": 128849468,
            "pub_share_fee": "0.00",
            "pub_share_pre_fee": "0.00",
            "pub_share_rate": "100.00",
            "refund_tag": 0,
            "seller_nick": "不吃鱼的大脸猫",
            "seller_shop_title": "BOBO 华尔兹666号街",
            "site_id": 45454135,
            "site_name": "立打折优惠券网",
            "subsidy_fee": "0.00",
            "subsidy_rate": "0.00",
            "subsidy_type": "--",
            "terminal_type": "PC",
            "tk_create_time": "2019-05-12 20:05:27",
            "tk_order_role": 2,
            "tk_status": 13,
            "tk_total_rate": "1.50",
            "total_commission_fee": "0.00",
            "total_commission_rate": "1.50",
            "trade_id": "441443136205144387",
            "trade_parent_id": "441443136203144387"
        },
        {
            "adzone_id": 44105700493,
            "adzone_name": "渠道专享",
            "alimama_rate": "0.00",
            "alimama_share_fee": "0.00",
            "click_time": "2019-05-12 20:04:42",
            "flow_source": "--",
            "income_rate": "1.50",
            "item_category_name": "女装",
            "item_id": 588868343018,
            "item_img": "//img.alicdn.com/bao/uploaded/i3/2858216695/O1CN01G0Ed1g1zKMAkviBPV_!!2858216695.jpg",
            "item_link": "http://item.taobao.com/item.htm?id=588868343018",
            "item_num": 1,
            "item_price": "397.00",
            "item_title": "欧洲站2019春夏装新款欧货潮韩版时尚修身蓝色收腰网纱连衣裙女装",
            "order_type": "淘宝",
            "pub_id": 128849468,
            "pub_share_fee": "0.00",
            "pub_share_pre_fee": "0.00",
            "pub_share_rate": "100.00",
            "refund_tag": 0,
            "seller_nick": "不吃鱼的大脸猫",
            "seller_shop_title": "BOBO 华尔兹666号街",
            "site_id": 45454135,
            "site_name": "立打折优惠券网",
            "subsidy_fee": "0.00",
            "subsidy_rate": "0.00",
            "subsidy_type": "--",
            "terminal_type": "PC",
            "tk_create_time": "2019-05-12 20:05:27",
            "tk_order_role": 2,
            "tk_status": 13,
            "tk_total_rate": "1.50",
            "total_commission_fee": "0.00",
            "total_commission_rate": "1.50",
            "trade_id": "441443136204144387",
            "trade_parent_id": "441443136203144387"
        }
    ]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。