京东联盟接口详解-订单行查询接口


订单行查询接口

接口地址:https://www.dingdanxia.com/doc/180/94

在线测试:https://www.dingdanxia.com/apitest/180/94

图片

关键入参:

Type:建议使用3更新时间,每1分钟更新一次最近2分钟订单数据;

startTime/ endTime:建议将查询时间区间设为最近2分钟;

关键出参:

基本信息:

orderId:京东商城展示的订单号;

parentId:用户一次买多个商品发生拆单时,子单将带有此参数;如不拆单则无此参数;

id:个别订单会拆分成两个相同订单号的订单,可用此参数区分,避免重复;

estimateFee:订单的预估佣金,与订单完成后的实际佣金可能存在差异;此参数订单完成前退货会更新,订单完成后退货不再更新;

actualFee:订单完成后的实际佣金,常见不计佣金的因素有非现金支付部分(优惠券/礼品卡/积分、余额)、税费、运费、赠品、售后退货;此参数订单完成后退货会更新;

订单状态:

modifyTime:订单更新时间,当用户下单、支付成功、确认收货、取消、发生售后、售后取消、售后完成、订单违规、取消订单违规时,此时间均会更新;

finishTime:订单完成时间,用户确认收货后才会返回;

payMonth:订单预估结算时间,订单完成后才会返回;

validCode:可区分订单当前状态和无效状态的详细描述;

可结算状态订单筛选方法:payMonth非空值且为未来时间时,该订单为可结算订单;

已结算状态订单筛选方法:payMonth非空值且为过去时间时,该订单为已结算订单;
注:已结算订单在订单完成90天内均可能发生退货,并扣除已结算佣金;

售后退货(媒体日常对账时需关注此信息)

skuFrozenNum:用户发起售后的商品数量,如退货成功将会扣除佣金;

skuReturnNum:商品退货成功数量,相应的佣金将被扣除;

balanceExt:订单完成后如发生退货,该字段会分别记录每月的佣金变化值,订单更新时间也会更新;

其他:

查询当月结算订单数据:payMonth为当月的订单;

查询时间范围为最近90天内,您需要自行保存全部历史订单记录,可根据订单更新时间、balanceExt字段判断是否需要更新该订单;

商品图片url:订单行接口暂不提供,需调用商品查询接口获取,或自行缓存url;