京东联盟订单查询接口
9384人使用

查询推广订单及佣金信息,会随着订单状态变化更新数据,支持按下单时间、完成时间或状态更新时间查询,通常可按更新时间每分钟或者每小时调用一次来获取订单的最新状态。支持subunionid、推广位、PID、

当validCode=17且payMonth不为空时,订单为可结算状态,由于订单结算状态不再回写,当前时间大于paymonth时可表示已结算状态

因为京东应用流量有限,订单接口大家有应用的尽量调用自己的应用。

key参数和appkey、secretkey必须选一个传入


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

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

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

参数接口

参数类型

必填

示例

说明

apikey

string

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

time

String

2018110312

查询时间,建议使用分钟级或者小时级查询,格式:yyyyMMddHH、yyyyMMddHHmm或yyyyMMddHHmmss,如201811031212 的查询范围从12:12:00--12:12:59,2018110312 查询的范围是12:00:00-13:00:00

pageNo

int

1

页码,返回第几页结果

pageSize

int

20

每页包含条数,上限为500

type

int

1

订单时间查询类型(1:下单时间,2:完成时间,3:更新时间)

key

String

如果不传会走后台默认设置的,授权key,获取方式 京东联盟=》我的推广=》我的工具=》我的API

childUnionId

long

61800001

子站长ID(需要联系运营开通PID账户权限才能拿到数据),childUnionId和key不能同时传入

appkey

String

自己京东应用的appkey

secretkey

String

自己京东应用的secretkey

返回参数说明

标记

类型

例子

说明

finishTime

long

1529271683000

订单完成时间(时间戳,毫秒)

orderEmt

int

1

下单设备(1:PC,2:无线)

orderId

long

61861861866

订单ID

orderTime

long

1529271683000

下单时间(时间戳,毫秒)

parentId

long

66661861866

父单的订单ID,仅当发生订单拆分时返回, 0:未拆分,有值则表示此订单为子订单

payMonth

String

20180618

订单维度预估结算时间,不建议使用,可以用订单行sku维度paymonth字段参考,(格式:yyyyMMdd),0:未结算,订单'预估结算时间'仅供参考。账号未通过资质审核或订单发生售后,会影响订单实际结算时间。

plus

int

1

下单用户是否为PLUS会员 0:否,1:是

popId

long

1000066618

商家ID

skuList

SkuInfo[]

订单包含的商品信息列表

LskuInfo

SkuInfo

订单包含的商品信息列表

L actualCosPrice

double

6.88

实际计算佣金的金额。订单完成后,会将误扣除的运费券金额更正。如订单完成后发生退款,此金额会更新

L actualFee

double

6.18

推客获得的实际佣金(实际计佣金额*佣金比例*最终比例)。如订单完成后发生退款,此金额会更新。

L commissionRate

double

2.50

佣金比例

L estimateCosPrice

double

618.18

预估计佣金额,即用户下单的金额(已扣除优惠券、白条、支付优惠、进口税,未扣除红包和京豆),有时会误扣除运费券金额,完成结算时会在实际计佣金额中更正。如订单完成前发生退款,此金额也会更新。

L estimateFee

double

6.18

推客的预估佣金(预估计佣金额*佣金比例*最终比例),如订单完成前发生退款,此金额也会更新。

L finalRate

double

100.00

最终比例(分成比例+补贴比例)

L cid1

long

737

一级类目ID

L frozenSkuNum

long

1

商品售后中数量

L pid

String

618_618_6018

联盟子站长身份标识,格式:子站长ID_子站长网站ID_子站长推广位ID

L positionId

long

66

推广位ID,0代表无推广位

L price

double

61.8

商品单价

L cid2

long

738

二级类目ID

L siteId

long

6000618

网站ID,0:无网站

L skuId

long

5487565

商品ID

L skuName

String

空气净化器 除雾霾 除甲醛 空气质量屏幕显示 三层净化

商品名称

L skuNum

long

2

商品数量

L skuReturnNum

long

1

商品已退货数量

L subSideRate

double

90

分成比例

L subsidyRate

double

10

补贴比例

L cid3

long

749

三级类目ID

L unionAlias

String

**平台

PID所属母账号平台名称(原第三方服务商来源)

L unionTag

String

00000100

联盟标签数据(整型的二进制字符串(32位),目前只返回8位:00000001。数据从右向左进行,每一位为1表示符合联盟的标签特征,第1位:优惠券,第2位:组合推广订单,第3位:拼购订单,第5位:有效首次购订单(00011XXX表示有效首购,最终奖励活动结算金额会结合订单状态判断,以联盟后台对应活动效果数据报表https://union.jd.com/active为准)。例如:00000001:优惠券,00000010:组合推广订单,00000100:拼购订单,00011000:有效首购,00000111:优惠券+组合推广+拼购等)

L unionTrafficGroup

int

1

渠道组 1:1号店,其他:京东

L validCode

int

18

sku维度的有效码(-1:未知,2.无效-拆单,3.无效-取消,4.无效-京东帮帮主订单,5.无效-账号异常,6.无效-赠品类目不返佣,7.无效-校园订单,8.无效-企业订单,9.无效-团购订单,10.无效-开增值税专用发票订单,11.无效-乡村推广员下单,12.无效-自己推广自己下单,13.无效-违规订单,14.无效-来源与备案网址不符,15.待付款,16.已付款,17.已完成,18.已结算(5.9号不再支持结算状态回写展示))注:自2018/7/13起,自己推广自己下单已经允许返佣,故12无效码仅针对历史数据有效

L subUnionId

String

子联盟ID(需要联系运营开放白名单才能拿到数据)

L traceType

int

3

2:同店;3:跨店

L payMonth

int

20180618

订单行维度预估结算时间(格式:yyyyMMdd) ,0:未结算。订单'预估结算时间'仅供参考。账号未通过资质审核或订单发生售后,会影响订单实际结算时间。

L popId

long

30871

商家ID。'订单行维度'

L ext1

String

1_1255413_0_XXXX

推客生成推广链接时传入的扩展字段(需要联系运营开放白名单才能拿到数据)。'订单行维度'

L cpActId

long

618

招商团活动id,正整数,为0时表示无活动

L unionRole

int

1

站长角色,1: 推客、 2: 团长

unionId

long

2018618618

推客的联盟ID

ext1

String

100_618_大促

推客生成推广链接时传入的扩展字段,订单维度(需要联系运营开放白名单才能拿到数据)

validCode

int

18

订单维度的有效码(-1:未知,2.无效-拆单,3.无效-取消,4.无效-京东帮帮主订单,5.无效-账号异常,6.无效-赠品类目不返佣,7.无效-校园订单,8.无效-企业订单,9.无效-团购订单,10.无效-开增值税专用发票订单,11.无效-乡村推广员下单,12.无效-自己推广自己下单,13.无效-违规订单,14.无效-来源与备案网址不符,15.待付款,16.已付款,17.已完成,18.已结算(5.9号不再支持结算状态回写展示))注:自2018/7/13起,自己推广自己下单已经允许返佣,故12无效码仅针对历史数据有效

hasMore

Boolean

true

是否还有更多,true:还有数据;false:已查询完毕,没有数据

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"data": [{
		"ext1": "",
		"finishTime": 1568110886000,
		"orderEmt": 2,
		"orderId": 102345177250,
		"orderTime": 1567750299000,
		"parentId": 0,
		"payMonth": 20191018,
		"plus": 0,
		"popId": 789438,
		"skuList": [{
			"actualCosPrice": 23,
			"actualFee": 2.28,
			"cid1": 1672,
			"cid2": 2599,
			"cid3": 13667,
			"commissionRate": 11,
			"cpActId": 0,
			"estimateCosPrice": 23,
			"estimateFee": 2.28,
			"ext1": "",
			"finalRate": 90,
			"frozenSkuNum": 0,
			"payMonth": 20191018,
			"pid": "",
			"popId": 789438,
			"positionId": 1152810895,
			"price": 23,
			"siteId": 0,
			"skuId": 27916941095,
			"skuName": "沉香倒流香佛系流云檀香香粒高山流水瀑布塔香卧室熏香艾草倒流香炉创意摆件沉香炉倒流 香薰 樱花 玻璃瓶装 送小荷花",
			"skuNum": 1,
			"skuReturnNum": 0,
			"subSideRate": 90,
			"subUnionId": "",
			"subsidyRate": 0,
			"traceType": 2,
			"unionAlias": "",
			"unionRole": 1,
			"unionTag": "00000100",
			"unionTrafficGroup": 4,
			"validCode": 17
		}],
		"unionId": 1000521676,
		"validCode": 17
	}]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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