手把手教你对接旺店通旗舰版API拉取国内电商店铺订单数据

前言

做国内电商的公司通常会使用比如旺店通这类ERP拉取和分析自己店铺的订单数据，并且可能需要进一步将ERP的订单数据拉取到公司自己做的后台做更个性化的数据分析和需求。这篇博客我以旺店通旗舰版为例，讲解如何通过他们API拉取订单数据到本地。

准备工作

应用创建：

在这里插入图片描述

获取API对接信息：

sid、appkey、appsecret以及旺店通调用环境http://wdt.wangdian.cn都是后面调用API需要用到的，需要注意的是，需要调用的API需要在操作中点新增申请对应API的权限。
在这里插入图片描述

旺店通 JAVA SDK：

从旺店通的SDK下载页面下载，里面有相关的接口和类文件，整合到自己项目中，里面的目录其实就对应着旺店通产品、订单、售后等API分类。
在这里插入图片描述

代码实现：

1、先给出客户端创建方法：

@Component
@Data
@Slf4j
public class WangDianUtils {@Value("${env.info}")private String envInfo;@Value("${wang-dian.sid}")private String sid;@Value("${wang-dian.app-key}")private String appKey;@Value("${wang-dian.app-secret}")private String appSecret;@Value("${wang-dian.url}")private String url;public Client getWangDianApiClientRealEnv() {Client client = DefaultClient.get(sid, url, appKey,appSecret);return client;}
}

2、调用销售出库单查询：
该接口对应的API是wms.stockout.Sales.queryWithDetail：
在这里插入图片描述

该接口我们使用时间和店铺编号（比如你有抖音和京东店铺，店铺编号不一样）过滤：

Client client = wangDianUtils.getWangDianApiClient();
StockOutAPI stockOutAPI = ApiFactory.get(client, StockOutAPI.class);
List<String> shopNos = new ArrayList<>();
shopNos.add("DP-XXXXXX");
// 分店铺查询销售出库单
for (String shopNo : shopNos) {log.info("[executeTask]:shop:{}.", shopNo);List<WangDianShippingOrderEntity> entities = new ArrayList<>();StockOutQueryResponse response = stockOutAPI.query(wangDianUtils.buildRequest(startTime, endTime, shopNo), new Pager(200, 0, true));if (response == null || response.getTotalCount() <= 0) {log.warn("[executeTask] No eligible results!");continue;}log.info("***************************************");log.info("[executeTask]response.getOrders():{}.", JSON.toJSON(response.getOrders()).toString());log.info("***************************************");// orders 即为查询到的订单数据List<StockOutQueryResponse.OrderItem> orders = response.getOrders();
}