前言
最近,公司需要拉取自家京东店铺的订单数据,方便做月结和销售汇总,以及实现自动拉单和自动推单给物流发货的整个的链路。
一、对接京东平台的调研
第1步:就是创建应用
但是,现在有一个问题是,2022年最新的规则,就是需要花钱在买京东的一个所谓的安全包,才能够创建应用了,有点坑
第2步,需要去购买安全包
一般来说,买个初级版本的安全包就可以了,它没什么多大的作用
第3步,下载SDK
由于应用要先有API的访问权限,才能调用此API,所有SDK的下载是与应用拥有的权限组相关联,不同的应用下载到的SDK也是不一样的。
具体的操作是,登录京东商家开放平台,进入控制中心,点击应用管理进入其中一个应用的页面,并选择SDK下载页面,点击下载相对应的语言的版本即可。
第4步,api 调用
开放平台 API是基于HTTP/S协议来调用
二、拉取京东店铺的订单数据
1.获取订单列表
如图,所示,首先,我们需要拉取这几天内的京东的订单列表,获取到这时间段内的订单号。
说明:这个api,是需要收费的,鼎内调用,每100次,收费0.01元;
鼎外也是需要收费的,鼎外调用,每100次,收费0.1元。
代码如下(示例):
/**
* 获取京东订单列表
* @throws
*/
JdClient client=new DefaultJdClient("http://api.jd.com/routerjson",accessToken,appKey,appSecret);
PopOrderSearchRequest request=new PopOrderSearchRequest();
// 设置京东店铺订单的拉取订单时间(默认为2天)
LocalDateTime currentTime = LocalDateTime.now();
LocalDateTime startTime = currentTime.minusDays(2);
Long endSecond = currentTime.atZone(ZoneOffset.systemDefault()).toEpochSecond();
Long startSecond = startTime.atZone(ZoneOffset.systemDefault()).toEpochSecond();
request.setEndDate(endSecond.intValue()); // 结束时间
request.setStartDate(startSecond.intValue()); // 开始拉单时间
request.setOrderState("WAIT_SELLER_STOCK_OUT"); // 等待出库的订单
request.setOptionalFields("itemInfoList,orderId,isShipmenttype,scDT,idSopShipmenttype,orderStartTime"); // 需返回的字段列表,可选
request.setPage("1");
request.setPageSize("20"); // 每页的条数
request.setSortType(1); // 排序方式,默认升序,1是降序,其它数字都是升序
request.setDateType(0); // 0按修改时间
PopOrderSearchResponse response=client.execute(request); //发送请求
2.拉取订单详情
如图所示,我们根据前面的订单号,遍历调用订单详情的api,获取到单个订单的详情。
代码如下(示例):
/**
* 获取京东单个订单详情
* @throws
*/
JdClient client=new DefaultJdClient("http://api.jd.com/routerjson",accessToken,appKey,appSecret);
// 遍历循环列表
List<OrderSearchInfo> orderInfoList = response.getOrderInfoList(); // 获取京东列表响应返回体
if (CollectionUtils.isNotEmpty(orderInfoList)) {
List<OrderSearchInfo> payedOrders = orderInfoList.stream().filter(item -> !todayExistOrderIds.contains(item.getOrderId())).collect(Collectors.toList());
for (OrderSearchInfo item : payedOrders) {
PopOrderGetRequest request=new PopOrderGetRequest();
request.setOptionalFields("venderld,orderType,payType"); // 需返回的字段列表,可选
request.setOrderId(item.getOrderId()); // 订单号,并且有效的订单号
PopOrderGetResponse res =client.execute(request); //发送订单详情的请求
}
}
3. 定时任务
开通一个定时任务,规定时间来执行京东的拉单
总结
主要是拉取京东订单的内容