接口地址：
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
出参数据筛选，多项逗号分隔
orderId
String
否
415900297816660001
订单号，当orderId不为空时，其他参数非必填
返回参数说明
标记
类型
例子
说明
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.已完成（购买用户确认收货）,19.无效-佣金比例为0,20.无效-此复购订单对应的首购订单无效,21.无效-云店订单,22.无效-PLUS会员佣金比例为0,23.无效-支付有礼,24.已付定金,25. 违规订单-流量劫持,26. 违规订单-流量异常,27. 违规订单-违反京东平台规则,28. 违规订单-多笔交易异常,29.无效-跨屏跨店,30.无效-累计件数超出类目上限,31.无效-黑名单sku
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
请求拒绝
调用请求被拒绝，您的账号状态存在异常，请联系平台管理员解除限制。