淘宝客高级API
淘宝联盟/饿了么订单查询api接口(订单号版)【即将下线】
需要授权
153人使用

可根据淘宝订单编号获取自己在订单侠开放平台授权的淘宝联盟订单详情,提高查询效率,告别轮训查询订单入库所带来的请求消耗,最快10秒极速同步,这一切都由订单侠帮您完成。

【此功能需开启订单同步功能】方可使用,开启方法 : 登录订单侠个人中心 - 授权管理 - 淘宝授权 - 开启同步


接口地址: http://api.tbk.dingdanxia.com/tbk/trade_detail 在线测试

接口支持https,非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

trade_id

String

订单号

type

Number

1

1-子订单号(单条数据),2-父订单号(会有多条数据)默认1

返回参数说明

标记

类型

例子

说明

tb_auth_id

String

订单所属联盟ID

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

口碑父订单号

service_fee_dto_list

ServiceFeeDto[]

服务费信息

L share_relative_rate

String

0.10

专项服务费率

L share_fee

String

11.11

结算专项服务费

L share_pre_fee

String

11.11

预估专项服务费

L tk_share_role_type

Number

122

专项服务费来源,122-渠道

lx_rid

String

12312312

激励池对应的rid

is_lx

String

1

订单是否为激励池订单 1,表征是 0,表征否

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"data": {
		"tb_auth_id": "797273728",
		"tb_paid_time": "2021-03-02 17:08:17",
		"tk_paid_time": "2021-03-02 17:08:27",
		"pay_price": "11.00",
		"pub_share_fee": "0.66",
		"trade_id": "2545014217",
		"tk_order_role": "2",
		"tk_earning_time": "2021-03-02 18:11:05",
		"adzone_id": "109651300400",
		"pub_share_rate": "100.00",
		"refund_tag": "0",
		"subsidy_rate": "6.00",
		"tk_total_rate": "6.00",
		"item_category_name": "小吃/烧烤",
		"seller_nick": "农家小吃(烧烤丨炒菜丨大排档店)",
		"pub_id": "30318832",
		"alimama_rate": "10.00",
		"subsidy_type": "饿了么",
		"item_img": "//cube.elemecdn.com/3/20/8E481D1604D2BA7E7E236A57645DBpng.png",
		"pub_share_pre_fee": "0.66",
		"alipay_total_price": "11.00",
		"item_title": "米饭等4件商品",
		"site_name": "xxx的博客",
		"item_num": "4",
		"subsidy_fee": "0.66",
		"alimama_share_fee": "0.07",
		"trade_parent_id": "5020047964210943173",
		"order_type": "饿了么",
		"tk_create_time": "2021-03-02 17:08:13",
		"flow_source": "--",
		"terminal_type": "无线",
		"click_time": "2021-03-02 16:51:11",
		"tk_status": "3",
		"item_price": "0",
		"item_id": "",
		"adzone_name": "nly_1111",
		"total_commission_rate": "0.00",
		"item_link": "",
		"site_id": "20348577",
		"seller_shop_title": "农家小吃(烧烤丨炒菜丨大排档店)",
		"income_rate": "6.00",
		"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",
		"special_id": "0",
		"relation_id": "0",
		"tk_deposit_time": "--",
		"tb_deposit_time": "--",
		"deposit_price": "0.00",
		"app_key": "",
		"alsc_id": "",
		"alsc_pid": "",
		"lx_rid": "",
		"is_lx": "0",
		"update_time": "2021-03-20 20:33:30"
	}
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。