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

查询推广订单及佣金信息,可查询最近90天内下单的订单,会随着订单状态变化同步更新数据。支持按下单时间、完成时间或更新时间查询。建议按更新时间每分钟调用一次,查询最近一分钟的订单更新数据。

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

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

查看详细说明
接口地址: http://api.tbk.dingdanxia.com/jd/order_details2 在线测试

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

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

pageIndex

int

1

页码

pageSize

int

20

每页包含条数,上限为500

type

int

1

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

startTime

String

2020-01-02 21:23:00

开始时间 格式yyyy-MM-dd HH:mm:ss,与endTime间隔不超过1小时

endTime

String

2020-01-02 21:24:00

结束时间 格式yyyy-MM-dd HH:mm:ss,与startTime间隔不超过1小时

key

String

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

appkey

String

自己京东应用的appkey

secretkey

String

自己京东应用的secretkey

fields

String

sign

出参数据筛选,多项逗号分隔

返回参数说明

标记

类型

例子

说明

id

String

415900297816660001

标记唯一订单行

orderId

long

108618000005

订单号

parentId

long

0

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

orderTime

String

2020-01-02 15:50:16

下单时间,格式yyyy-MM-dd HH:mm:ss

finishTime

String

2020-01-03 15:59:16

完成时间(购买用户确认收货时间),格式yyyy-MM-dd HH:mm:ss

modifyTime

String

2020-01-02 16:01:03

更新时间,格式yyyy-MM-dd HH:mm:ss

orderEmt

int

2

下单设备 1.pc 2.无线

plus

int

0

plus会员 1:是,0:否

unionId

long

1000618618

推客ID

skuId

long

44303679033

商品ID

skuName

String

朴坊 WAZZUPbaby 变色龙盲盒第三弹 第三代龙出没注意盲盒 单个盲盒,款式随机

商品名称

skuNum

int

1

商品数量

skuReturnNum

int

0

商品已退货数量

skuFrozenNum

int

0

商品售后中数量

price

double

69.0

商品单价

commissionRate

double

5.0

佣金比例(投放的广告主计划比例)

subSideRate

double

90.0

一级分成比例

subsidyRate

double

0.0

一级补贴比例

finalRate

double

90.0

最终比例( (一级分佣比例+一级分成比例)*二级分佣比例)

estimateCosPrice

double

54.0

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

estimateFee

double

2.43

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

actualCosPrice

double

0.0

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

actualFee

double

0.0

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

validCode

int

16

sku维度的有效码(-1:未知,2.无效-拆单,3.无效-取消,4.无效-京东帮帮主订单,5.无效-账号异常,6.无效-赠品类目不返佣,7.无效-校园订单,8.无效-企业订单,9.无效-团购订单,11.无效-乡村推广员下单,13.无效-违规订单,14.无效-来源与备案网址不符,15.待付款,16.已付款,17.已完成(购买用户确认收货),20.无效-此复购订单对应的首购订单无效,21.无效-云店订单,22. 无效-PLUS会员佣金比例为0

traceType

int

2

同跨店:2同店 3跨店

positionId

long

0

推广位ID

siteId

long

61866

应用id(网站id、appid、社交媒体id)

unionAlias

String

**平台

母账号简称

pid

String

618_618_618

格式:子推客ID_子站长应用ID_子推客推广位ID

cid1

long

1620

一级类目id

cid2

long

11158

二级类目id

cid3

long

11969

三级类目id

subUnionId

String

331967

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

unionTag

String

0000000000000001

联盟标签数据(整型的二进制字符串,目前返回16位:0000000000000001。数据从右向左进行,每一位为1表示符合联盟的标签特征,第1位:红包,第2位:组合推广,第3位:拼购,第5位:有效首次购(0000000000011XXX表示有效首购,最终奖励活动结算金额会结合订单状态判断,以联盟后台对应活动效果数据报表https://union.jd.com/active为准),第8位:复购订单,第9位:礼金,第10位:联盟礼金,第11位:推客礼金。例如:0000000000000001:红包订单,0000000000000010:组合推广订单,0000000000000100:拼购订单,0000000000011000:有效首购,0000000000000111:红包+组合推广+拼购等)

popId

long

709982

商家ID

ext1

String

hello_world

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

payMonth

String

0

预估结算时间 格式:yyyyMMdd,默认:0,表示最新的预估结算日期

cpActId

long

0

招商团活动id

unionRole

int

1

站长角色:1 推客 2 团长

giftCouponOcsAmount

double

0

礼金分摊金额

giftCouponKey

String

xxx_coupon_key

礼金批次ID

balanceExt

String

{20191020:10,20191120:-2}

计佣扩展信息,表示结算月:每月实际佣金变化情况,格式:{20191020:10,20191120:-2},注意:有完成时间的,才会有这个值

sign

String

B44C0FC3F104167FEC8A53DFD2B26E40

数据签名,用来核对出参数据是否被修改,入参fields中写入sign时返回

expressStatus

Integer

10

发货状态(10:待发货,20:已发货)

hasMore

Boolean

true

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

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"total_results": 0,
	"hasMore": false,
	"data": [{
		"actualCosPrice": 0,
		"actualFee": 0,
		"balanceExt": "",
		"cid1": 6233,
		"cid2": 21813,
		"cid3": 21876,
		"commissionRate": 1.5,
		"cpActId": 0,
		"estimateCosPrice": 243,
		"estimateFee": 0,
		"ext1": "",
		"finalRate": 100,
		"finishTime": "",
		"giftCouponKey": "",
		"giftCouponOcsAmount": 0,
		"id": "492046328450301952",
		"modifyTime": "2020-07-30 19:00:34",
		"orderEmt": 2,
		"orderId": 129487980482,
		"orderTime": "2020-07-30 18:56:25",
		"parentId": 0,
		"payMonth": 0,
		"pid": "",
		"plus": 1,
		"popId": 0,
		"positionId": 0,
		"price": 293,
		"siteId": 0,
		"skuFrozenNum": 0,
		"skuId": 3236610,
		"skuName": "马博士(DOCTOR MA)婴儿游泳池家用儿童长方形充气浴缸洗澡盆游泳桶(蓝色方形泳池+可分离式脖圈套装)",
		"skuNum": 1,
		"skuReturnNum": 0,
		"subSideRate": 90,
		"subUnionId": "",
		"subsidyRate": 10,
		"traceType": 2,
		"unionAlias": "",
		"unionId": 1000141445,
		"unionRole": 1,
		"unionTag": "0000000000000000",
		"validCode": 3
	}, {
		"actualCosPrice": 0,
		"actualFee": 0,
		"balanceExt": "",
		"cid1": 6233,
		"cid2": 21813,
		"cid3": 21876,
		"commissionRate": 1.5,
		"cpActId": 0,
		"estimateCosPrice": 243,
		"estimateFee": 0,
		"ext1": "",
		"finalRate": 100,
		"finishTime": "",
		"giftCouponKey": "",
		"giftCouponOcsAmount": 0,
		"id": "492046281931243520",
		"modifyTime": "2020-07-31 18:56:19",
		"orderEmt": 2,
		"orderId": 123672098937,
		"orderTime": "2020-07-30 18:56:14",
		"parentId": 0,
		"payMonth": 0,
		"pid": "",
		"plus": 1,
		"popId": 0,
		"positionId": 0,
		"price": 293,
		"siteId": 0,
		"skuFrozenNum": 0,
		"skuId": 3236610,
		"skuName": "马博士(DOCTOR MA)婴儿游泳池家用儿童长方形充气浴缸洗澡盆游泳桶(蓝色方形泳池+可分离式脖圈套装)",
		"skuNum": 1,
		"skuReturnNum": 0,
		"subSideRate": 90,
		"subUnionId": "",
		"subsidyRate": 10,
		"traceType": 2,
		"unionAlias": "",
		"unionId": 1000141445,
		"unionRole": 1,
		"unionTag": "0000000000000000",
		"validCode": 3
	}]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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