接口地址: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;