mirror of
https://gitee.com/binary/weixin-java-tools.git
synced 2025-05-02 20:02:37 +08:00
✨ #1009 实现微信小程序物流助手相关接口
* 快递公司 * 绑定、解绑物流账号 * 配置面单打印员 * 获取打印员 * 增加微信文档地址说明 * 快递下单 * 快递下单和订单操作 * 补充文档地址
This commit is contained in:
mrxiao
Binary Wang
parent
010464e399
commit
80f885fbfb
@ -0,0 +1,203 @@
|
||||
package cn.binarywang.wx.miniapp.api;
|
||||
|
||||
import cn.binarywang.wx.miniapp.bean.express.WxMaExpressAccount;
|
||||
import cn.binarywang.wx.miniapp.bean.express.WxMaExpressDelivery;
|
||||
import cn.binarywang.wx.miniapp.bean.express.WxMaExpressPath;
|
||||
import cn.binarywang.wx.miniapp.bean.express.WxMaExpressPrinter;
|
||||
import cn.binarywang.wx.miniapp.bean.express.request.*;
|
||||
import cn.binarywang.wx.miniapp.bean.express.result.WxMaExpressOrderInfoResult;
|
||||
import me.chanjar.weixin.common.error.WxErrorException;
|
||||
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 小程序物流助手
|
||||
* @author <a href="https://github.com/mr-xiaoyu">xiaoyu</a>
|
||||
* @since 2019-11-26
|
||||
*/
|
||||
public interface WxMaExpressService {
|
||||
/**
|
||||
* 获取支持的快递公司列表
|
||||
*/
|
||||
String ALL_DELIVERY_URL = "https://api.weixin.qq.com/cgi-bin/express/business/delivery/getall";
|
||||
|
||||
/**
|
||||
* 获取所有绑定的物流账号
|
||||
*/
|
||||
String ALL_ACCOUNT_URL = "https://api.weixin.qq.com/cgi-bin/express/business/account/getall";
|
||||
|
||||
/**
|
||||
* 绑定、解绑物流账号
|
||||
*/
|
||||
String BIND_ACCOUNT_URL = "https://api.weixin.qq.com/cgi-bin/express/business/account/bind";
|
||||
|
||||
/**
|
||||
* 获取电子面单余额
|
||||
*/
|
||||
String GET_QUOTA_URL = "https://api.weixin.qq.com/cgi-bin/express/business/quota/get";
|
||||
|
||||
/**
|
||||
* 配置面单打印员
|
||||
*/
|
||||
String UPDATE_PRINTER_URL = "https://api.weixin.qq.com/cgi-bin/express/business/printer/update";
|
||||
|
||||
/**
|
||||
* 获取打印员
|
||||
*/
|
||||
String GET_PRINTER_URL = "https://api.weixin.qq.com/cgi-bin/express/business/printer/getall";
|
||||
|
||||
/**
|
||||
* 生成运单
|
||||
*/
|
||||
String ADD_ORDER_URL = "https://api.weixin.qq.com/cgi-bin/express/business/order/add";
|
||||
|
||||
/**
|
||||
* 批量获取运单数据
|
||||
*/
|
||||
String BATCH_GET_ORDER_URL = "https://api.weixin.qq.com/cgi-bin/express/business/order/batchget";
|
||||
|
||||
/**
|
||||
* 取消运单
|
||||
*/
|
||||
String CANCEL_ORDER_URL = "https://api.weixin.qq.com/cgi-bin/express/business/order/cancel";
|
||||
|
||||
/**
|
||||
* 获取运单数据
|
||||
*/
|
||||
String GET_ORDER_URL = "https://api.weixin.qq.com/cgi-bin/express/business/order/get";
|
||||
|
||||
/**
|
||||
* 查询运单轨迹
|
||||
*/
|
||||
String GET_PATH_URL = "https://api.weixin.qq.com/cgi-bin/express/business/path/get";
|
||||
|
||||
/**
|
||||
* 模拟快递公司更新订单状态
|
||||
*/
|
||||
String TEST_UPDATE_ORDER_URL = "https://api.weixin.qq.com/cgi-bin/express/business/test_update_order";
|
||||
|
||||
/**
|
||||
* 获取支持的快递公司列表
|
||||
* @return 快递公司列表
|
||||
* @throws WxErrorException 获取失败时返回
|
||||
* <pre>
|
||||
* <a href="https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/express/by-business/logistics.getAllDelivery.html">查看文档</a>
|
||||
* </pre>
|
||||
*/
|
||||
List<WxMaExpressDelivery> getAllDelivery() throws WxErrorException;
|
||||
|
||||
/**
|
||||
* 获取所有绑定的物流账号
|
||||
* @return 物流账号list
|
||||
* @throws WxErrorException 获取失败时返回
|
||||
* <pre>
|
||||
* <a href="https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/express/by-business/logistics.getAllAccount.html">查看文档</a>
|
||||
* </pre>
|
||||
*/
|
||||
List<WxMaExpressAccount> getAllAccount() throws WxErrorException;
|
||||
|
||||
/**
|
||||
* 绑定、解绑物流账号
|
||||
* @param wxMaExpressBindAccountRequest 物流账号对象
|
||||
* @throws WxErrorException 请求失败时返回
|
||||
* <pre>
|
||||
* <a href="https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/express/by-business/logistics.bindAccount.html">查看文档</a>
|
||||
* </pre>
|
||||
*/
|
||||
void bindAccount(WxMaExpressBindAccountRequest wxMaExpressBindAccountRequest) throws WxErrorException;
|
||||
|
||||
/**
|
||||
* 获取电子面单余额。仅在使用加盟类快递公司时，才可以调用。
|
||||
* @param wxMaExpressBindAccountRequest 物流账号对象
|
||||
* @return 电子面单余额
|
||||
* @throws WxErrorException 获取失败时返回
|
||||
* <pre>
|
||||
* <a href="https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/express/by-business/logistics.getQuota.html">查看文档</a>
|
||||
* </pre>
|
||||
*/
|
||||
Integer getQuota(WxMaExpressBindAccountRequest wxMaExpressBindAccountRequest) throws WxErrorException;
|
||||
|
||||
/**
|
||||
* 配置面单打印员，可以设置多个，若需要使用微信打单 PC 软件，才需要调用。
|
||||
* @param wxMaExpressPrinterUpdateRequest 面单打印员对象
|
||||
* @throws WxErrorException 请求失败时返回
|
||||
* <pre>
|
||||
* <a href="https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/express/by-business/logistics.updatePrinter.html">查看文档</a>
|
||||
* </pre>
|
||||
*/
|
||||
void updatePrinter(WxMaExpressPrinterUpdateRequest wxMaExpressPrinterUpdateRequest) throws WxErrorException;
|
||||
|
||||
/**
|
||||
* 获取打印员。若需要使用微信打单 PC 软件，才需要调用
|
||||
* @return 打印员
|
||||
* @throws WxErrorException 获取失败时返回
|
||||
* <pre>
|
||||
* <a href="https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/express/by-business/logistics.getPrinter.html">查看文档</a>
|
||||
* </pre>
|
||||
*/
|
||||
WxMaExpressPrinter getPrinter() throws WxErrorException;
|
||||
|
||||
/**
|
||||
* 生成运单
|
||||
* @param wxMaExpressAddOrderRequest 生成运单请求对象
|
||||
* @return 生成运单结果
|
||||
* @throws WxErrorException 请求失败时返回
|
||||
* <pre>
|
||||
* <a href="https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/express/by-business/logistics.addOrder.html">查看文档</a>
|
||||
* </pre>
|
||||
*/
|
||||
WxMaExpressOrderInfoResult addOrder(WxMaExpressAddOrderRequest wxMaExpressAddOrderRequest) throws WxErrorException;
|
||||
|
||||
/**
|
||||
* 批量获取运单数据
|
||||
* @param requests 获取运单请求对象集合，最多不能超过1000个
|
||||
* @return 运单信息集合
|
||||
* @throws WxErrorException 获取失败时返回
|
||||
* <pre>
|
||||
* <a href="https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/express/by-business/logistics.batchGetOrder.html">查看文档</a>
|
||||
* </pre>
|
||||
*/
|
||||
List<WxMaExpressOrderInfoResult> batchGetOrder(List<WxMaExpressGetOrderRequest> requests) throws WxErrorException;
|
||||
|
||||
/**
|
||||
* 取消运单
|
||||
* @param wxMaExpressGetOrderRequest 运单信息请求对象
|
||||
* @throws WxErrorException 取消失败时返回
|
||||
* <pre>
|
||||
* <a href="https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/express/by-business/logistics.cancelOrder.html">查看文档</a>
|
||||
* </pre>
|
||||
*/
|
||||
void cancelOrder(WxMaExpressGetOrderRequest wxMaExpressGetOrderRequest) throws WxErrorException;
|
||||
|
||||
/**
|
||||
* 获取运单数据
|
||||
* @param wxMaExpressGetOrderRequest 运单信息请求对象
|
||||
* @return 运单信息
|
||||
* @throws WxErrorException 获取失败时返回
|
||||
* <pre>
|
||||
* <a href="https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/express/by-business/logistics.getOrder.html">查看文档</a>
|
||||
* </pre>
|
||||
*/
|
||||
WxMaExpressOrderInfoResult getOrder(WxMaExpressGetOrderRequest wxMaExpressGetOrderRequest) throws WxErrorException;
|
||||
|
||||
/**
|
||||
* 查询运单轨迹
|
||||
* @param wxMaExpressGetOrderRequest 运单信息请求对象
|
||||
* @return 运单轨迹对象
|
||||
* @throws WxErrorException 查询失败时返回
|
||||
* <pre>
|
||||
* <a href="https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/express/by-business/logistics.getPath.html">查看文档</a>
|
||||
* </pre>
|
||||
*/
|
||||
WxMaExpressPath getPath(WxMaExpressGetOrderRequest wxMaExpressGetOrderRequest) throws WxErrorException;
|
||||
|
||||
/**
|
||||
* 模拟快递公司更新订单状态, 该接口只能用户测试
|
||||
* @param wxMaExpressTestUpdateOrderRequest 模拟快递公司更新订单状态请求对象
|
||||
* @throws WxErrorException 模拟更新订单状态失败时返回
|
||||
* <pre>
|
||||
* <a href="https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/express/by-business/logistics.testUpdateOrder.html">查看文档</a>
|
||||
* </pre>
|
||||
*/
|
||||
void testUpdateOrder(WxMaExpressTestUpdateOrderRequest wxMaExpressTestUpdateOrderRequest) throws WxErrorException;
|
||||
}
|
||||
@ -224,5 +224,9 @@ public interface WxMaService {
|
||||
*/
|
||||
RequestHttp getRequestHttp();
|
||||
|
||||
|
||||
/**
|
||||
* 获取物流助手接口服务对象
|
||||
* @return
|
||||
*/
|
||||
WxMaExpressService getExpressService();
|
||||
}
|
||||
|
||||
@ -0,0 +1,98 @@
|
||||
package cn.binarywang.wx.miniapp.api.impl;
|
||||
|
||||
import cn.binarywang.wx.miniapp.api.WxMaExpressService;
|
||||
import cn.binarywang.wx.miniapp.api.WxMaService;
|
||||
import cn.binarywang.wx.miniapp.bean.express.WxMaExpressAccount;
|
||||
import cn.binarywang.wx.miniapp.bean.express.WxMaExpressDelivery;
|
||||
import cn.binarywang.wx.miniapp.bean.express.WxMaExpressPath;
|
||||
import cn.binarywang.wx.miniapp.bean.express.WxMaExpressPrinter;
|
||||
import cn.binarywang.wx.miniapp.bean.express.request.*;
|
||||
import cn.binarywang.wx.miniapp.bean.express.result.WxMaExpressOrderInfoResult;
|
||||
import cn.binarywang.wx.miniapp.util.json.WxMaGsonBuilder;
|
||||
import lombok.AllArgsConstructor;
|
||||
import me.chanjar.weixin.common.error.WxErrorException;
|
||||
|
||||
import java.util.HashMap;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
|
||||
/**
|
||||
* @author <a href="https://github.com/mr-xiaoyu">xiaoyu</a>
|
||||
* @since 2019-11-26
|
||||
*/
|
||||
@AllArgsConstructor
|
||||
public class WxMaExpressServiceImpl implements WxMaExpressService {
|
||||
|
||||
private WxMaService wxMaService;
|
||||
|
||||
@Override
|
||||
public List<WxMaExpressDelivery> getAllDelivery() throws WxErrorException {
|
||||
String responseContent = this.wxMaService.get(ALL_DELIVERY_URL, null);
|
||||
return WxMaExpressDelivery.fromJson(responseContent);
|
||||
}
|
||||
|
||||
@Override
|
||||
public List<WxMaExpressAccount> getAllAccount() throws WxErrorException {
|
||||
String responseContent = this.wxMaService.get(ALL_ACCOUNT_URL, null);
|
||||
return WxMaExpressAccount.fromJsonList(responseContent);
|
||||
}
|
||||
|
||||
@Override
|
||||
public void bindAccount(WxMaExpressBindAccountRequest wxMaExpressBindAccountRequest) throws WxErrorException {
|
||||
this.wxMaService.post(BIND_ACCOUNT_URL,wxMaExpressBindAccountRequest.toJson());
|
||||
}
|
||||
|
||||
@Override
|
||||
public Integer getQuota(WxMaExpressBindAccountRequest wxMaExpressBindAccountRequest) throws WxErrorException {
|
||||
String responseContent = this.wxMaService.post(GET_QUOTA_URL,wxMaExpressBindAccountRequest.toJson());
|
||||
WxMaExpressAccount account = WxMaExpressAccount.fromJson(responseContent);
|
||||
return account.getQuotaNum();
|
||||
}
|
||||
|
||||
@Override
|
||||
public void updatePrinter(WxMaExpressPrinterUpdateRequest wxMaExpressPrinterUpdateRequest) throws WxErrorException {
|
||||
this.wxMaService.post(UPDATE_PRINTER_URL,wxMaExpressPrinterUpdateRequest.toJson());
|
||||
}
|
||||
|
||||
@Override
|
||||
public WxMaExpressPrinter getPrinter() throws WxErrorException {
|
||||
String responseContent = this.wxMaService.get(GET_PRINTER_URL, null);
|
||||
return WxMaExpressPrinter.fromJson(responseContent);
|
||||
}
|
||||
|
||||
@Override
|
||||
public WxMaExpressOrderInfoResult addOrder(WxMaExpressAddOrderRequest wxMaExpressAddOrderRequest) throws WxErrorException {
|
||||
String responseContent = this.wxMaService.post(ADD_ORDER_URL,wxMaExpressAddOrderRequest.toJson());
|
||||
return WxMaExpressOrderInfoResult.fromJson(responseContent);
|
||||
}
|
||||
|
||||
@Override
|
||||
public List<WxMaExpressOrderInfoResult> batchGetOrder(List<WxMaExpressGetOrderRequest> requests) throws WxErrorException {
|
||||
Map<String, Object> param = new HashMap<>(1);
|
||||
param.put("order_list", requests);
|
||||
String responseContent = this.wxMaService.post(BATCH_GET_ORDER_URL, WxMaGsonBuilder.create().toJson(param));
|
||||
return WxMaExpressOrderInfoResult.toList(responseContent);
|
||||
}
|
||||
|
||||
@Override
|
||||
public void cancelOrder(WxMaExpressGetOrderRequest wxMaExpressGetOrderRequest) throws WxErrorException {
|
||||
this.wxMaService.post(CANCEL_ORDER_URL,wxMaExpressGetOrderRequest.toJson());
|
||||
}
|
||||
|
||||
@Override
|
||||
public WxMaExpressOrderInfoResult getOrder(WxMaExpressGetOrderRequest wxMaExpressGetOrderRequest) throws WxErrorException {
|
||||
String responseContent = this.wxMaService.post(GET_ORDER_URL,wxMaExpressGetOrderRequest.toJson());
|
||||
return WxMaExpressOrderInfoResult.fromJson(responseContent);
|
||||
}
|
||||
|
||||
@Override
|
||||
public WxMaExpressPath getPath(WxMaExpressGetOrderRequest wxMaExpressGetOrderRequest) throws WxErrorException {
|
||||
String responseContent = this.wxMaService.post(GET_PATH_URL,wxMaExpressGetOrderRequest.toJson());
|
||||
return WxMaExpressPath.fromJson(responseContent);
|
||||
}
|
||||
|
||||
@Override
|
||||
public void testUpdateOrder(WxMaExpressTestUpdateOrderRequest wxMaExpressTestUpdateOrderRequest) throws WxErrorException {
|
||||
this.wxMaService.post(TEST_UPDATE_ORDER_URL,wxMaExpressTestUpdateOrderRequest.toJson());
|
||||
}
|
||||
}
|
||||
@ -54,6 +54,7 @@ public class WxMaServiceImpl implements WxMaService, RequestHttp<CloseableHttpCl
|
||||
private WxMaRunService runService = new WxMaRunServiceImpl(this);
|
||||
private WxMaSecCheckService secCheckService = new WxMaSecCheckServiceImpl(this);
|
||||
private WxMaPluginService pluginService = new WxMaPluginServiceImpl(this);
|
||||
private WxMaExpressService expressService = new WxMaExpressServiceImpl(this);
|
||||
|
||||
private int retrySleepMillis = 1000;
|
||||
private int maxRetryTimes = 5;
|
||||
@ -365,4 +366,7 @@ public class WxMaServiceImpl implements WxMaService, RequestHttp<CloseableHttpCl
|
||||
public WxMaPluginService getPluginService() {
|
||||
return this.pluginService;
|
||||
}
|
||||
|
||||
@Override
|
||||
public WxMaExpressService getExpressService() { return this.expressService; }
|
||||
}
|
||||
|
||||
@ -0,0 +1,103 @@
|
||||
package cn.binarywang.wx.miniapp.bean.express;
|
||||
|
||||
import cn.binarywang.wx.miniapp.util.json.WxMaGsonBuilder;
|
||||
import com.google.gson.JsonObject;
|
||||
import com.google.gson.JsonParser;
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import com.google.gson.reflect.TypeToken;
|
||||
import lombok.Data;
|
||||
|
||||
import java.io.Serializable;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 物流账号对象
|
||||
* </pre>
|
||||
* @author <a href="https://github.com/mr-xiaoyu">xiaoyu</a>
|
||||
* @since 2019-11-26
|
||||
*/
|
||||
@Data
|
||||
public class WxMaExpressAccount implements Serializable {
|
||||
|
||||
private static final JsonParser JSON_PARSER = new JsonParser();
|
||||
private static final long serialVersionUID = -4991983596742569736L;
|
||||
|
||||
/**
|
||||
* 快递公司客户编码
|
||||
*/
|
||||
@SerializedName("biz_id")
|
||||
private String bizId;
|
||||
|
||||
/**
|
||||
* 快递公司ID
|
||||
*/
|
||||
@SerializedName("delivery_id")
|
||||
private String deliveryId;
|
||||
|
||||
/**
|
||||
* 账号绑定时间
|
||||
*/
|
||||
@SerializedName("create_time")
|
||||
private Long createTime;
|
||||
|
||||
/**
|
||||
* 账号更新时间
|
||||
*/
|
||||
@SerializedName("update_time")
|
||||
private Long updateTime;
|
||||
|
||||
/**
|
||||
* 绑定状态
|
||||
* status_code 的合法值 : 0-绑定成功;1-审核中;2-绑定失败
|
||||
*/
|
||||
@SerializedName("status_code")
|
||||
private Integer statusCode;
|
||||
|
||||
/**
|
||||
* 账号别名
|
||||
*/
|
||||
@SerializedName("alias")
|
||||
private String alias;
|
||||
|
||||
/**
|
||||
* 账号绑定失败的错误信息（EMS审核结果）
|
||||
*/
|
||||
@SerializedName("remark_wrong_msg")
|
||||
private String remarkWrongMsg;
|
||||
|
||||
/**
|
||||
* 账号绑定时的备注内容（提交EMS审核需要）
|
||||
*/
|
||||
@SerializedName("remark_content")
|
||||
private String remarkContent;
|
||||
|
||||
/**
|
||||
* 电子面单余额
|
||||
*/
|
||||
@SerializedName("quota_num")
|
||||
private Integer quotaNum;
|
||||
|
||||
/**
|
||||
* 电子面单余额更新时间
|
||||
*/
|
||||
@SerializedName("quota_update_time")
|
||||
private Integer quotaUpdateTime;
|
||||
|
||||
/**
|
||||
* 支持的服务类型
|
||||
*/
|
||||
@SerializedName("service_type")
|
||||
private List<WxMaExpressDelivery.ServiceType> serviceType;
|
||||
|
||||
public static List<WxMaExpressAccount> fromJsonList(String json) {
|
||||
JsonObject jsonObject = JSON_PARSER.parse(json).getAsJsonObject();
|
||||
return WxMaGsonBuilder.create().fromJson(jsonObject.get("list").toString(),
|
||||
new TypeToken<List<WxMaExpressAccount>>() {
|
||||
}.getType());
|
||||
}
|
||||
|
||||
public static WxMaExpressAccount fromJson(String json) {
|
||||
return WxMaGsonBuilder.create().fromJson(json, WxMaExpressAccount.class);
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,83 @@
|
||||
package cn.binarywang.wx.miniapp.bean.express;
|
||||
|
||||
import cn.binarywang.wx.miniapp.util.json.WxMaGsonBuilder;
|
||||
import com.google.gson.JsonObject;
|
||||
import com.google.gson.JsonParser;
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import com.google.gson.reflect.TypeToken;
|
||||
import lombok.Data;
|
||||
|
||||
import java.io.Serializable;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 快递公司对象
|
||||
* </pre>
|
||||
* @author <a href="https://github.com/mr-xiaoyu">xiaoyu</a>
|
||||
* @since 2019-11-26
|
||||
*/
|
||||
@Data
|
||||
public class WxMaExpressDelivery implements Serializable {
|
||||
private static final JsonParser JSON_PARSER = new JsonParser();
|
||||
private static final long serialVersionUID = -8394544895730223810L;
|
||||
|
||||
/**
|
||||
* 快递公司 ID
|
||||
*/
|
||||
@SerializedName("delivery_id")
|
||||
private String deliveryId;
|
||||
|
||||
/**
|
||||
* 快递公司名称
|
||||
*/
|
||||
@SerializedName("delivery_name")
|
||||
private String deliveryName;
|
||||
|
||||
/**
|
||||
* 是否支持散单, 1表示支持
|
||||
*/
|
||||
@SerializedName("can_use_cash")
|
||||
private Integer canUseCash;
|
||||
|
||||
/**
|
||||
* 是否支持查询面单余额, 1表示支持
|
||||
*/
|
||||
@SerializedName("can_get_quota")
|
||||
private Integer canGetQuota;
|
||||
|
||||
/**
|
||||
* 散单对应的bizid，当can_use_cash=1时有效
|
||||
*/
|
||||
@SerializedName("cash_biz_id")
|
||||
private String cashBizId;
|
||||
|
||||
/**
|
||||
* 支持的服务类型
|
||||
*/
|
||||
@SerializedName("service_type")
|
||||
private List<ServiceType> serviceType;
|
||||
|
||||
public static List<WxMaExpressDelivery> fromJson(String json) {
|
||||
JsonObject jsonObject = JSON_PARSER.parse(json).getAsJsonObject();
|
||||
return WxMaGsonBuilder.create().fromJson(jsonObject.get("data").toString(),
|
||||
new TypeToken<List<WxMaExpressDelivery>>() {
|
||||
}.getType());
|
||||
}
|
||||
|
||||
@Data
|
||||
public static class ServiceType{
|
||||
|
||||
/**
|
||||
* 服务类型ID
|
||||
*/
|
||||
@SerializedName("service_type")
|
||||
private Integer serviceType;
|
||||
|
||||
/**
|
||||
* 服务类型名称
|
||||
*/
|
||||
@SerializedName("service_name")
|
||||
private String serviceName;
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,75 @@
|
||||
package cn.binarywang.wx.miniapp.bean.express;
|
||||
|
||||
import cn.binarywang.wx.miniapp.util.json.WxMaGsonBuilder;
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Data;
|
||||
|
||||
import java.io.Serializable;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 运单轨迹对象
|
||||
* @author <a href="https://github.com/mr-xiaoyu">xiaoyu</a>
|
||||
* @since 2019-11-26
|
||||
*/
|
||||
@Data
|
||||
public class WxMaExpressPath implements Serializable {
|
||||
|
||||
private static final long serialVersionUID = 5643624677715536605L;
|
||||
|
||||
/**
|
||||
* 用户openid
|
||||
*/
|
||||
private String openid;
|
||||
|
||||
/**
|
||||
* 快递公司 ID
|
||||
*/
|
||||
@SerializedName("delivery_id")
|
||||
private String deliveryId;
|
||||
|
||||
/**
|
||||
* 运单 ID
|
||||
*/
|
||||
@SerializedName("waybill_id")
|
||||
private String waybillId;
|
||||
|
||||
/**
|
||||
* 轨迹节点数量
|
||||
*/
|
||||
@SerializedName("path_item_num")
|
||||
private Integer pathItemNum;
|
||||
|
||||
/**
|
||||
* 轨迹节点列表
|
||||
*/
|
||||
@SerializedName("path_item_list")
|
||||
private List<PathItem> pathItemList;
|
||||
|
||||
public static WxMaExpressPath fromJson(String json) {
|
||||
return WxMaGsonBuilder.create().fromJson(json, WxMaExpressPath.class);
|
||||
}
|
||||
|
||||
@Data
|
||||
private static class PathItem{
|
||||
|
||||
/**
|
||||
* 轨迹节点 Unix 时间戳
|
||||
*/
|
||||
@SerializedName("action_time")
|
||||
private Long actionTime;
|
||||
|
||||
/**
|
||||
* 轨迹节点类型
|
||||
*/
|
||||
@SerializedName("action_type")
|
||||
private Integer actionType;
|
||||
|
||||
/**
|
||||
* 轨迹节点详情
|
||||
*/
|
||||
@SerializedName("action_msg")
|
||||
private String actionMsg;
|
||||
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,44 @@
|
||||
package cn.binarywang.wx.miniapp.bean.express;
|
||||
|
||||
import cn.binarywang.wx.miniapp.util.json.WxMaGsonBuilder;
|
||||
import com.google.gson.JsonParser;
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Data;
|
||||
|
||||
import java.io.Serializable;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 面单打印员对象
|
||||
* </pre>
|
||||
* @author <a href="https://github.com/mr-xiaoyu">xiaoyu</a>
|
||||
* @since 2019-11-26
|
||||
*/
|
||||
@Data
|
||||
public class WxMaExpressPrinter implements Serializable {
|
||||
|
||||
private static final JsonParser JSON_PARSER = new JsonParser();
|
||||
private static final long serialVersionUID = 7164449984700322531L;
|
||||
|
||||
/**
|
||||
* 数量
|
||||
*/
|
||||
private Integer count;
|
||||
|
||||
/**
|
||||
* 打印员openid
|
||||
*/
|
||||
private List<String> openid;
|
||||
|
||||
/**
|
||||
* 打印员面单打印权限
|
||||
*/
|
||||
@SerializedName("tagid_list")
|
||||
private List<String> tagidList;
|
||||
|
||||
|
||||
public static WxMaExpressPrinter fromJson(String json) {
|
||||
return WxMaGsonBuilder.create().fromJson(json, WxMaExpressPrinter.class);
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,169 @@
|
||||
package cn.binarywang.wx.miniapp.bean.express.request;
|
||||
|
||||
|
||||
import cn.binarywang.wx.miniapp.bean.express.*;
|
||||
import cn.binarywang.wx.miniapp.util.json.WxMaGsonBuilder;
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Builder;
|
||||
import lombok.Data;
|
||||
|
||||
import java.io.Serializable;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 生成运单请求对象
|
||||
* </pre>
|
||||
* @author <a href="https://github.com/mr-xiaoyu">xiaoyu</a>
|
||||
* @since 2019-11-26
|
||||
*/
|
||||
@Data
|
||||
@Builder
|
||||
public class WxMaExpressAddOrderRequest implements Serializable {
|
||||
|
||||
private static final long serialVersionUID = -7538739003766268386L;
|
||||
|
||||
|
||||
/**
|
||||
* 订单来源
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 0为小程序订单，2为App或H5订单，填2则不发送物流服务通知
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("add_source")
|
||||
private Integer addSource;
|
||||
|
||||
/**
|
||||
* App或H5的appid
|
||||
* <pre>
|
||||
* 是否必填： 否
|
||||
* 描述： add_source=2时必填，需和开通了物流助手的小程序绑定同一open帐号
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("wx_appid")
|
||||
private String wxAppid;
|
||||
|
||||
/**
|
||||
* 订单ID
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 须保证全局唯一，不超过512字节
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("order_id")
|
||||
private String orderId;
|
||||
|
||||
/**
|
||||
* 用户openid
|
||||
* <pre>
|
||||
* 是否必填： 否
|
||||
* 描述： 当add_source=2时无需填写（不发送物流服务通知）
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("openid")
|
||||
private String openid;
|
||||
|
||||
/**
|
||||
* 快递公司ID
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 可通过getAllDelivery查询
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("delivery_id")
|
||||
private String deliveryId;
|
||||
|
||||
/**
|
||||
* 快递客户编码或者现付编码
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("biz_id")
|
||||
private String bizId;
|
||||
|
||||
/**
|
||||
* 快递备注信息
|
||||
* <pre>
|
||||
* 是否必填： 否
|
||||
* 描述： 比如"易碎物品"，不超过1024字节
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("custom_remark")
|
||||
private String customRemark;
|
||||
|
||||
/**
|
||||
* 订单标签id
|
||||
* <pre>
|
||||
* 是否必填： 否
|
||||
* 描述： 用于平台型小程序区分平台上的入驻方，tagid须与入驻方账号一一对应，非平台型小程序无需填写该字段
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("tagid")
|
||||
private Integer tagid;
|
||||
|
||||
/**
|
||||
* 预期的上门揽件时间
|
||||
* <pre>
|
||||
* 是否必填： 否
|
||||
* 描述： 顺丰必须传,0表示已事先约定取件时间；否则请传预期揽件时间戳，需大于当前时间，收件员会在预期时间附近上门。例如expect_time为“1557989929”，表示希望收件员将在2019年05月16日14:58:49-15:58:49内上门取货。说明：若选择 了预期揽件时间，请不要自己打单，由上门揽件的时候打印。
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("expect_time")
|
||||
private Long expectTime;
|
||||
|
||||
/**
|
||||
* 发件人信息
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
private WxMaExpressOrderPerson sender;
|
||||
|
||||
/**
|
||||
* 收件人信息
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
private WxMaExpressOrderPerson receiver;
|
||||
|
||||
/**
|
||||
* 包裹信息
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 将传递给快递公司
|
||||
* </pre>
|
||||
*/
|
||||
private WxMaExpressOrderCargo cargo;
|
||||
|
||||
/**
|
||||
* 商品信息
|
||||
* <pre>
|
||||
* 是否必填： 否
|
||||
* 描述： 会展示到物流服务通知和电子面单中
|
||||
* </pre>
|
||||
*/
|
||||
private WxMaExpressOrderShop shop;
|
||||
|
||||
/**
|
||||
* 保价信息
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
private WxMaExpressOrderInsured insured;
|
||||
|
||||
/**
|
||||
* 服务类型
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
private WxMaExpressDelivery.ServiceType service;
|
||||
|
||||
|
||||
public String toJson() {
|
||||
return WxMaGsonBuilder.create().toJson(this);
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,73 @@
|
||||
package cn.binarywang.wx.miniapp.bean.express.request;
|
||||
|
||||
import cn.binarywang.wx.miniapp.util.json.WxMaGsonBuilder;
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Builder;
|
||||
import lombok.Data;
|
||||
|
||||
import java.io.Serializable;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 绑定、解绑物流账号请求对象
|
||||
* </pre>
|
||||
* @author <a href="https://github.com/mr-xiaoyu">xiaoyu</a>
|
||||
* @since 2019-11-26
|
||||
*/
|
||||
@Data
|
||||
@Builder
|
||||
public class WxMaExpressBindAccountRequest implements Serializable {
|
||||
|
||||
private static final long serialVersionUID = 3868003945297939946L;
|
||||
|
||||
/**
|
||||
* 类型
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： bind表示绑定，unbind表示解除绑定
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("type")
|
||||
private String type;
|
||||
|
||||
/**
|
||||
* 快递公司客户编码
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("biz_id")
|
||||
private String bizId;
|
||||
|
||||
/**
|
||||
* 快递公司ID
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("delivery_id")
|
||||
private String deliveryId;
|
||||
|
||||
/**
|
||||
* 快递公司客户密码
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("password")
|
||||
private String password;
|
||||
|
||||
/**
|
||||
* 备注内容（提交EMS审核需要）
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("remark_content")
|
||||
private String remarkContent;
|
||||
|
||||
public String toJson() {
|
||||
return WxMaGsonBuilder.create().toJson(this);
|
||||
}
|
||||
|
||||
}
|
||||
@ -0,0 +1,63 @@
|
||||
package cn.binarywang.wx.miniapp.bean.express.request;
|
||||
|
||||
import cn.binarywang.wx.miniapp.util.json.WxMaGsonBuilder;
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Builder;
|
||||
import lombok.Data;
|
||||
|
||||
import java.io.Serializable;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 获取运单请求对象
|
||||
* </pre>
|
||||
* @author <a href="https://github.com/mr-xiaoyu">xiaoyu</a>
|
||||
* @since 2019-11-26
|
||||
*/
|
||||
@Data
|
||||
@Builder
|
||||
public class WxMaExpressGetOrderRequest implements Serializable {
|
||||
|
||||
private static final long serialVersionUID = 8239315305577639778L;
|
||||
|
||||
/**
|
||||
* 订单ID
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("order_id")
|
||||
private String orderId;
|
||||
|
||||
/**
|
||||
* 用户openid
|
||||
* <pre>
|
||||
* 是否必填： 否
|
||||
* 描述： 当add_source=2时无需填写（不发送物流服务通知）
|
||||
* </pre>
|
||||
*/
|
||||
private String openid;
|
||||
|
||||
/**
|
||||
* 快递公司ID
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("delivery_id")
|
||||
private String deliveryId;
|
||||
|
||||
/**
|
||||
* 运单ID
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("waybill_id")
|
||||
private String waybillId;
|
||||
|
||||
|
||||
public String toJson() {
|
||||
return WxMaGsonBuilder.create().toJson(this);
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,74 @@
|
||||
package cn.binarywang.wx.miniapp.bean.express.request;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Data;
|
||||
|
||||
import java.io.Serializable;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 包裹信息对象
|
||||
* @author <a href="https://github.com/mr-xiaoyu">xiaoyu</a>
|
||||
* @since 2019-11-26
|
||||
*/
|
||||
@Data
|
||||
public class WxMaExpressOrderCargo implements Serializable {
|
||||
|
||||
private static final long serialVersionUID = 6642536671375396150L;
|
||||
|
||||
/**
|
||||
* 包裹数量
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 需要和detail_list size保持一致
|
||||
* </pre>
|
||||
*/
|
||||
private Integer count;
|
||||
/**
|
||||
* 包裹总重量
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 单位是千克(kg)
|
||||
* </pre>
|
||||
*/
|
||||
private Integer weight;
|
||||
|
||||
/**
|
||||
* 包裹长度
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 单位是厘米(cm)
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("space_x")
|
||||
private Integer spaceLength;
|
||||
|
||||
/**
|
||||
* 包裹宽度
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 单位是厘米(cm)
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("space_y")
|
||||
private Integer spaceWidth;
|
||||
|
||||
/**
|
||||
* 包裹高度
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 单位是厘米(cm)
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("space_z")
|
||||
private Integer spaceHeight;
|
||||
|
||||
/**
|
||||
* 包裹中商品详情列表
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("detail_list")
|
||||
private List<WxMaExpressOrderCargoDetail> detailList;
|
||||
}
|
||||
@ -0,0 +1,33 @@
|
||||
package cn.binarywang.wx.miniapp.bean.express.request;
|
||||
|
||||
import lombok.Data;
|
||||
|
||||
import java.io.Serializable;
|
||||
|
||||
/**
|
||||
* 包裹商品详情对象
|
||||
* @author <a href="https://github.com/mr-xiaoyu">xiaoyu</a>
|
||||
* @since 2019-11-26
|
||||
*/
|
||||
@Data
|
||||
public class WxMaExpressOrderCargoDetail implements Serializable {
|
||||
|
||||
private static final long serialVersionUID = 5988620921216969796L;
|
||||
|
||||
/**
|
||||
* 商品名
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 不超过128字节
|
||||
* </pre>
|
||||
*/
|
||||
private String name;
|
||||
|
||||
/**
|
||||
* 商品数量
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
private Integer count;
|
||||
}
|
||||
@ -0,0 +1,43 @@
|
||||
package cn.binarywang.wx.miniapp.bean.express.request;
|
||||
|
||||
|
||||
import cn.binarywang.wx.miniapp.constant.WxMaConstants;
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Builder;
|
||||
import lombok.Data;
|
||||
|
||||
import java.io.Serializable;
|
||||
|
||||
/**
|
||||
* 保价信息对象
|
||||
* @author <a href="https://github.com/mr-xiaoyu">xiaoyu</a>
|
||||
* @since 2019-11-26
|
||||
*/
|
||||
@Data
|
||||
@Builder
|
||||
public class WxMaExpressOrderInsured implements Serializable {
|
||||
|
||||
private static final long serialVersionUID = -8636857630937445422L;
|
||||
|
||||
/**
|
||||
* 是否保价
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 0 表示不保价，1 表示保价
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("use_insured")
|
||||
private final Integer useInsured = WxMaConstants.OrderAddInsured.INSURED_PROGRAM;
|
||||
|
||||
/**
|
||||
* 保价金额
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 单位是分，比如: 10000 表示 100 元
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("insured_value")
|
||||
@Builder.Default
|
||||
private final Integer insuredValue = WxMaConstants.OrderAddInsured.DEFAULT_INSURED_VALUE;
|
||||
|
||||
}
|
||||
@ -0,0 +1,110 @@
|
||||
package cn.binarywang.wx.miniapp.bean.express.request;
|
||||
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Data;
|
||||
|
||||
import java.io.Serializable;
|
||||
|
||||
/**
|
||||
* 发件人/收件人信息对象
|
||||
* @author <a href="https://github.com/mr-xiaoyu">xiaoyu</a>
|
||||
* @since 2019-11-26
|
||||
*/
|
||||
@Data
|
||||
public class WxMaExpressOrderPerson implements Serializable {
|
||||
|
||||
private static final long serialVersionUID = -7816060207882761506L;
|
||||
|
||||
/**
|
||||
* 发件人/收件人姓名
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 不超过64字节
|
||||
* </pre>
|
||||
*/
|
||||
private String name;
|
||||
|
||||
/**
|
||||
* 发件人/收件人座机号码
|
||||
* <pre>
|
||||
* 是否必填： 否
|
||||
* 描述： 若不填写则必须填写 mobile，不超过32字节
|
||||
* </pre>
|
||||
*/
|
||||
private String tel;
|
||||
|
||||
/**
|
||||
* 发件人/收件人手机号码
|
||||
* <pre>
|
||||
* 是否必填： 否
|
||||
* 描述： 若不填写则必须填写 tel，不超过32字节
|
||||
* </pre>
|
||||
*/
|
||||
private String mobile;
|
||||
|
||||
/**
|
||||
* 发件人/收件人公司名
|
||||
* <pre>
|
||||
* 是否必填： 否
|
||||
* 描述： 不超过64字节
|
||||
* </pre>
|
||||
*/
|
||||
private String company;
|
||||
|
||||
/**
|
||||
* 发件人/收件人邮编
|
||||
* <pre>
|
||||
* 是否必填： 否
|
||||
* 描述： 不超过10字节
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("post_code")
|
||||
private String postCode;
|
||||
|
||||
/**
|
||||
* 发件人/收件人所在国家
|
||||
* <pre>
|
||||
* 是否必填： 否
|
||||
* 描述： 不超过64字节
|
||||
* </pre>
|
||||
*/
|
||||
private String country;
|
||||
|
||||
/**
|
||||
* 发件人/收件人省份
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 比如："广东省"，不超过64字节
|
||||
* </pre>
|
||||
*/
|
||||
private String province;
|
||||
|
||||
/**
|
||||
* 发件人/收件人地区或市
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 比如："广州市"，不超过64字节
|
||||
* </pre>
|
||||
*/
|
||||
private String city;
|
||||
|
||||
/**
|
||||
* 发件人/收件人区或县
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 比如："天河区"，不超过64字节
|
||||
* </pre>
|
||||
*/
|
||||
private String area;
|
||||
|
||||
/**
|
||||
* 发件人/收件人详细地址
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 比如："XX路XX号XX大厦XX"，不超过512字节
|
||||
* </pre>
|
||||
*/
|
||||
private String address;
|
||||
|
||||
}
|
||||
@ -0,0 +1,55 @@
|
||||
package cn.binarywang.wx.miniapp.bean.express.request;
|
||||
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Data;
|
||||
|
||||
import java.io.Serializable;
|
||||
|
||||
/**
|
||||
* 商品信息对象
|
||||
* @author <a href="https://github.com/mr-xiaoyu">xiaoyu</a>
|
||||
* @since 2019-11-26
|
||||
*/
|
||||
@Data
|
||||
public class WxMaExpressOrderShop implements Serializable {
|
||||
|
||||
private static final long serialVersionUID = 7256509453502211830L;
|
||||
|
||||
/**
|
||||
* 商家小程序的路径
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 建议为订单页面
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("wxa_path")
|
||||
private String wxaPath;
|
||||
|
||||
/**
|
||||
* 商品缩略图url
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("img_url")
|
||||
private String imgUrl;
|
||||
|
||||
/**
|
||||
* 商品名称
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("goods_name")
|
||||
private String goodsName;
|
||||
|
||||
/**
|
||||
* 商品数量
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("goods_count")
|
||||
private Integer goodsCount;
|
||||
|
||||
}
|
||||
@ -0,0 +1,54 @@
|
||||
package cn.binarywang.wx.miniapp.bean.express.request;
|
||||
|
||||
import cn.binarywang.wx.miniapp.util.json.WxMaGsonBuilder;
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Builder;
|
||||
import lombok.Data;
|
||||
|
||||
import java.io.Serializable;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 配置面单打印员请求对象
|
||||
* </pre>
|
||||
* @author <a href="https://github.com/mr-xiaoyu">xiaoyu</a>
|
||||
* @since 2019-11-26
|
||||
*/
|
||||
@Data
|
||||
@Builder
|
||||
public class WxMaExpressPrinterUpdateRequest implements Serializable {
|
||||
|
||||
private static final long serialVersionUID = 9119040050963924127L;
|
||||
|
||||
/**
|
||||
* 打印员 openid
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
private String openid;
|
||||
|
||||
/**
|
||||
* 更新类型
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： bind表示绑定，unbind表示解除绑定
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("update_type")
|
||||
private String updateType;
|
||||
|
||||
/**
|
||||
* 打印员面单打印权限
|
||||
* <pre>
|
||||
* 是否必填： 否
|
||||
* 描述： 用于平台型小程序设置入驻方的打印员面单打印权限，同一打印员最多支持10个tagid，使用逗号分隔，如填写123,456，表示该打印员可以拉取到tagid为123和456的下的单，非平台型小程序无需填写该字段
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("tagid_list")
|
||||
private String tagidList;
|
||||
|
||||
public String toJson() {
|
||||
return WxMaGsonBuilder.create().toJson(this);
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,94 @@
|
||||
package cn.binarywang.wx.miniapp.bean.express.request;
|
||||
|
||||
import cn.binarywang.wx.miniapp.util.json.WxMaGsonBuilder;
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import lombok.Builder;
|
||||
import lombok.Data;
|
||||
|
||||
import java.io.Serializable;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 模拟快递公司更新订单状态请求对象
|
||||
* </pre>
|
||||
* @author <a href="https://github.com/mr-xiaoyu">xiaoyu</a>
|
||||
* @since 2019-11-26
|
||||
*/
|
||||
@Data
|
||||
@Builder
|
||||
public class WxMaExpressTestUpdateOrderRequest implements Serializable {
|
||||
|
||||
private static final long serialVersionUID = -3701602332580704140L;
|
||||
|
||||
/**
|
||||
* 商户id
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 需填test_biz_id,默认值已设置
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("biz_id")
|
||||
@Builder.Default
|
||||
private final String bizId = "test_biz_id";
|
||||
|
||||
/**
|
||||
* 快递公司id
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* 描述： 需填TEST,默认值已设置
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("delivery_id")
|
||||
@Builder.Default
|
||||
private final String deliveryId = "TEST";
|
||||
|
||||
/**
|
||||
* 订单号
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("order_id")
|
||||
private String orderId;
|
||||
|
||||
/**
|
||||
* 运单号
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("waybill_id")
|
||||
private String waybillId;
|
||||
|
||||
/**
|
||||
* 轨迹变化 Unix 时间戳
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("action_time")
|
||||
private Long actionTime;
|
||||
|
||||
/**
|
||||
* 轨迹变化类型
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("action_type")
|
||||
private Integer actionType;
|
||||
|
||||
/**
|
||||
* 轨迹变化具体信息说明,使用UTF-8编码
|
||||
* <pre>
|
||||
* 是否必填： 是
|
||||
* </pre>
|
||||
*/
|
||||
@SerializedName("action_msg")
|
||||
private String actionMsg;
|
||||
|
||||
public String toJson() {
|
||||
return WxMaGsonBuilder.create().toJson(this);
|
||||
}
|
||||
|
||||
}
|
||||
@ -0,0 +1,70 @@
|
||||
package cn.binarywang.wx.miniapp.bean.express.result;
|
||||
|
||||
import cn.binarywang.wx.miniapp.util.json.WxMaGsonBuilder;
|
||||
import com.google.gson.JsonObject;
|
||||
import com.google.gson.JsonParser;
|
||||
import com.google.gson.annotations.SerializedName;
|
||||
import com.google.gson.reflect.TypeToken;
|
||||
import lombok.Data;
|
||||
|
||||
import java.io.Serializable;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
|
||||
/**
|
||||
* <pre>
|
||||
* 运单信息返回结果对象
|
||||
* </pre>
|
||||
* @author <a href="https://github.com/mr-xiaoyu">xiaoyu</a>
|
||||
* @since 2019-11-26
|
||||
*/
|
||||
@Data
|
||||
public class WxMaExpressOrderInfoResult implements Serializable {
|
||||
private static final JsonParser JSON_PARSER = new JsonParser();
|
||||
private static final long serialVersionUID = -9166603059965942285L;
|
||||
|
||||
/**
|
||||
* 错误码
|
||||
*/
|
||||
private Integer errcode;
|
||||
|
||||
/**
|
||||
* 错误信息
|
||||
*/
|
||||
private String errmsg;
|
||||
/**
|
||||
* 订单ID
|
||||
*/
|
||||
@SerializedName("order_id")
|
||||
private String orderId;
|
||||
|
||||
/**
|
||||
* 运单ID
|
||||
*/
|
||||
@SerializedName("waybill_id")
|
||||
private String waybillId;
|
||||
|
||||
/**
|
||||
* 运单 html 的 BASE64 结果
|
||||
*/
|
||||
@SerializedName("print_html")
|
||||
private String printHtml;
|
||||
|
||||
/**
|
||||
* 运单信息
|
||||
*/
|
||||
@SerializedName("waybill_data")
|
||||
private List<Map<String,String>> waybillData;
|
||||
|
||||
|
||||
public static WxMaExpressOrderInfoResult fromJson(String json) {
|
||||
return WxMaGsonBuilder.create().fromJson(json, WxMaExpressOrderInfoResult.class);
|
||||
}
|
||||
|
||||
public static List<WxMaExpressOrderInfoResult> toList(String json) {
|
||||
JsonObject jsonObject = JSON_PARSER.parse(json).getAsJsonObject();
|
||||
return WxMaGsonBuilder.create().fromJson(jsonObject.get("order_list").toString(),
|
||||
new TypeToken<List<WxMaExpressOrderInfoResult>>() {
|
||||
}.getType());
|
||||
}
|
||||
}
|
||||
@ -85,4 +85,56 @@ public class WxMaConstants {
|
||||
*/
|
||||
public static final int IMAGE = 2;
|
||||
}
|
||||
|
||||
/**
|
||||
* 快递账号绑定类型
|
||||
*/
|
||||
public static final class BindAccountType{
|
||||
|
||||
/**
|
||||
* 绑定
|
||||
*/
|
||||
public static final String BIND = "bind";
|
||||
|
||||
/**
|
||||
* 解绑
|
||||
*/
|
||||
public static final String UNBIND = "unbind";
|
||||
}
|
||||
|
||||
/**
|
||||
* 快递下单订单来源
|
||||
*/
|
||||
public static final class OrderAddSource{
|
||||
|
||||
/**
|
||||
* 小程序
|
||||
*/
|
||||
public static final int MINI_PROGRAM = 0;
|
||||
|
||||
/**
|
||||
* APP或H5
|
||||
*/
|
||||
public static final int APP_OR_H5 = 2;
|
||||
}
|
||||
|
||||
/**
|
||||
* 快递下单保价
|
||||
*/
|
||||
public static final class OrderAddInsured{
|
||||
/**
|
||||
* 不保价
|
||||
*/
|
||||
public static final int INSURED_PROGRAM = 0;
|
||||
|
||||
/**
|
||||
* 保价
|
||||
*/
|
||||
public static final int USE_INSURED = 1;
|
||||
|
||||
/**
|
||||
* 默认保价金额
|
||||
*/
|
||||
public static final int DEFAULT_INSURED_VALUE = 0;
|
||||
}
|
||||
}
|
||||
|
||||
@ -0,0 +1,231 @@
|
||||
package cn.binarywang.wx.miniapp.api.impl;
|
||||
|
||||
import cn.binarywang.wx.miniapp.api.WxMaExpressService;
|
||||
import cn.binarywang.wx.miniapp.api.WxMaService;
|
||||
import cn.binarywang.wx.miniapp.bean.express.*;
|
||||
import cn.binarywang.wx.miniapp.bean.express.request.*;
|
||||
import cn.binarywang.wx.miniapp.bean.express.result.WxMaExpressOrderInfoResult;
|
||||
import cn.binarywang.wx.miniapp.constant.WxMaConstants;
|
||||
import cn.binarywang.wx.miniapp.test.ApiTestModule;
|
||||
import cn.binarywang.wx.miniapp.util.json.WxMaGsonBuilder;
|
||||
import com.google.inject.Inject;
|
||||
import me.chanjar.weixin.common.error.WxErrorException;
|
||||
import org.apache.commons.lang3.StringUtils;
|
||||
import org.testng.annotations.Guice;
|
||||
import org.testng.annotations.Test;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.List;
|
||||
|
||||
|
||||
@Guice(modules = ApiTestModule.class)
|
||||
public class WxMaExpressServiceImplTest {
|
||||
|
||||
@Inject
|
||||
private WxMaService wxMaService;
|
||||
|
||||
@Test
|
||||
public void testGetAllDelivery() throws WxErrorException {
|
||||
final WxMaExpressService service = wxMaService.getExpressService();
|
||||
List<WxMaExpressDelivery> list = service.getAllDelivery();
|
||||
System.out.println(WxMaGsonBuilder.create().toJson(list));
|
||||
}
|
||||
|
||||
@Test
|
||||
public void testGetAllAccount() throws WxErrorException {
|
||||
final WxMaExpressService service = wxMaService.getExpressService();
|
||||
List<WxMaExpressAccount> list = service.getAllAccount();
|
||||
System.out.println(WxMaGsonBuilder.create().toJson(list));
|
||||
}
|
||||
|
||||
@Test
|
||||
public void testBindAccount() throws WxErrorException {
|
||||
final WxMaExpressService service = wxMaService.getExpressService();
|
||||
WxMaExpressBindAccountRequest request = WxMaExpressBindAccountRequest.builder()
|
||||
.deliveryId("YUNDA")
|
||||
.bizId("******")
|
||||
.password("*********")
|
||||
.remarkContent("####")
|
||||
.type(WxMaConstants.BindAccountType.BIND)
|
||||
.build();
|
||||
service.bindAccount(request);
|
||||
}
|
||||
|
||||
@Test
|
||||
public void testGetQuota() throws WxErrorException {
|
||||
final WxMaExpressService service = wxMaService.getExpressService();
|
||||
WxMaExpressBindAccountRequest request = WxMaExpressBindAccountRequest.builder()
|
||||
.deliveryId("YUNDA")
|
||||
.bizId("******")
|
||||
.build();
|
||||
Integer quotaNum = service.getQuota(request);
|
||||
System.out.println(quotaNum);
|
||||
}
|
||||
|
||||
|
||||
|
||||
@Test
|
||||
public void testUpdatePrinter() throws WxErrorException {
|
||||
final WxMaExpressService service = wxMaService.getExpressService();
|
||||
WxMaExpressPrinterUpdateRequest request = WxMaExpressPrinterUpdateRequest.builder()
|
||||
.openid("*************")
|
||||
.updateType(WxMaConstants.BindAccountType.UNBIND)
|
||||
.build();
|
||||
service.updatePrinter(request);
|
||||
}
|
||||
|
||||
@Test
|
||||
public void testGetPrinter() throws WxErrorException {
|
||||
final WxMaExpressService service = wxMaService.getExpressService();
|
||||
WxMaExpressPrinter printer = service.getPrinter();
|
||||
System.out.println(WxMaGsonBuilder.create().toJson(printer));
|
||||
}
|
||||
|
||||
@Test
|
||||
public void testAddOrder() throws WxErrorException {
|
||||
final WxMaExpressService service = wxMaService.getExpressService();
|
||||
|
||||
WxMaExpressOrderPerson sender = new WxMaExpressOrderPerson();
|
||||
sender.setName("张三");
|
||||
sender.setMobile("177****9809");
|
||||
sender.setProvince("北京市");
|
||||
sender.setCity("朝阳区");
|
||||
sender.setArea("朝阳区");
|
||||
sender.setAddress("西坝河****C-102");
|
||||
|
||||
WxMaExpressOrderPerson receiver = new WxMaExpressOrderPerson();
|
||||
receiver.setName("李四");
|
||||
receiver.setMobile("180****8772");
|
||||
receiver.setProvince("北京市");
|
||||
receiver.setCity("朝阳区");
|
||||
receiver.setArea("朝阳区");
|
||||
receiver.setAddress("西坝河北里****101");
|
||||
|
||||
|
||||
WxMaExpressOrderCargo cargo = new WxMaExpressOrderCargo();
|
||||
List<WxMaExpressOrderCargoDetail> detailList = new ArrayList<>();
|
||||
List<String> shopNames = new ArrayList<>();
|
||||
Integer goodsCount = 0;
|
||||
for (int i = 0; i < 4; i++) {
|
||||
WxMaExpressOrderCargoDetail detail = new WxMaExpressOrderCargoDetail();
|
||||
String shopName = "商品_"+i;
|
||||
detail.setName(shopName);
|
||||
detail.setCount(1);
|
||||
detailList.add(detail);
|
||||
shopNames.add(shopName);
|
||||
goodsCount ++;
|
||||
}
|
||||
cargo.setCount(detailList.size());
|
||||
cargo.setWeight(5);
|
||||
cargo.setSpaceHeight(10);
|
||||
cargo.setSpaceLength(10);
|
||||
cargo.setSpaceWidth(10);
|
||||
cargo.setDetailList(detailList);
|
||||
|
||||
|
||||
WxMaExpressOrderShop shop = new WxMaExpressOrderShop();
|
||||
shop.setWxaPath("/index/index?from=waybill&id=01234567890123456789");
|
||||
shop.setGoodsName(StringUtils.join(shopNames,"&"));
|
||||
shop.setGoodsCount(goodsCount);
|
||||
shop.setImgUrl("https://mmbiz.qpic.cn/mmbiz_png/OiaFLUqewuIDNQnTiaCInIG8ibdosYHhQHPbXJUrqYSNIcBL60vo4LIjlcoNG1QPkeH5GWWEB41Ny895CokeAah8A/640");
|
||||
|
||||
WxMaExpressDelivery.ServiceType serviceType = new WxMaExpressDelivery.ServiceType();
|
||||
serviceType.setServiceName("test_service_name");
|
||||
serviceType.setServiceType(1);
|
||||
|
||||
WxMaExpressAddOrderRequest request = WxMaExpressAddOrderRequest.builder()
|
||||
.addSource(WxMaConstants.OrderAddSource.MINI_PROGRAM)
|
||||
.orderId("test201911271429004")
|
||||
.openid("oAg_-0PDUPuLbQw9V9kXE9OkU-Vo")
|
||||
.deliveryId("TEST")
|
||||
.bizId("test_biz_id")
|
||||
.customRemark("")
|
||||
.expectTime(0L)
|
||||
.sender(sender)
|
||||
.receiver(receiver)
|
||||
.cargo(cargo)
|
||||
.shop(shop)
|
||||
.insured(WxMaExpressOrderInsured.builder().build())
|
||||
.service(serviceType)
|
||||
.build();
|
||||
|
||||
WxMaExpressOrderInfoResult result = service.addOrder(request);
|
||||
System.out.println(WxMaGsonBuilder.create().toJson(result));
|
||||
}
|
||||
|
||||
@Test
|
||||
public void testBatchGetOrder() throws WxErrorException {
|
||||
final WxMaExpressService service = wxMaService.getExpressService();
|
||||
List<WxMaExpressGetOrderRequest> requests = new ArrayList<>();
|
||||
|
||||
List<String> orderIds = new ArrayList<>();
|
||||
orderIds.add("test201911271429000");
|
||||
|
||||
List<String> waybillIds = new ArrayList<>();
|
||||
waybillIds.add("test201911271429000_1574836404_waybill_id");
|
||||
for (int i = 0; i < orderIds.size(); i++) {
|
||||
WxMaExpressGetOrderRequest request = WxMaExpressGetOrderRequest.builder()
|
||||
.orderId(orderIds.get(i))
|
||||
.deliveryId("TEST")
|
||||
.waybillId(waybillIds.get(i))
|
||||
.build();
|
||||
requests.add(request);
|
||||
}
|
||||
|
||||
List<WxMaExpressOrderInfoResult> results = service.batchGetOrder(requests);
|
||||
System.out.println(WxMaGsonBuilder.create().toJson(results));
|
||||
}
|
||||
|
||||
@Test
|
||||
public void testCancelOrder() throws WxErrorException {
|
||||
final WxMaExpressService service = wxMaService.getExpressService();
|
||||
WxMaExpressGetOrderRequest request = WxMaExpressGetOrderRequest.builder()
|
||||
.orderId("test201911271429000")
|
||||
.deliveryId("TEST")
|
||||
.waybillId("test201911271429000_1574836404_waybill_id")
|
||||
.openid("oAg_-0PDUPuLbQw9V9kXE9OkU-Vo")
|
||||
.build();
|
||||
service.cancelOrder(request);
|
||||
}
|
||||
|
||||
|
||||
@Test
|
||||
public void testGetOrder() throws WxErrorException {
|
||||
final WxMaExpressService service = wxMaService.getExpressService();
|
||||
WxMaExpressGetOrderRequest request = WxMaExpressGetOrderRequest.builder()
|
||||
.orderId("test201911271429000")
|
||||
.deliveryId("TEST")
|
||||
.waybillId("test201911271429000_1574836404_waybill_id")
|
||||
.openid("oAg_-0PDUPuLbQw9V9kXE9OkU-Vo")
|
||||
.build();
|
||||
WxMaExpressOrderInfoResult result = service.getOrder(request);
|
||||
System.out.println(WxMaGsonBuilder.create().toJson(result));
|
||||
}
|
||||
|
||||
|
||||
@Test
|
||||
public void testGetPath() throws WxErrorException {
|
||||
final WxMaExpressService service = wxMaService.getExpressService();
|
||||
WxMaExpressGetOrderRequest request = WxMaExpressGetOrderRequest.builder()
|
||||
.orderId("test201911271429000")
|
||||
.deliveryId("TEST")
|
||||
.waybillId("test201911271429000_1574836404_waybill_id")
|
||||
.openid("oAg_-0PDUPuLbQw9V9kXE9OkU-Vo")
|
||||
.build();
|
||||
WxMaExpressPath path = service.getPath(request);
|
||||
System.out.println(WxMaGsonBuilder.create().toJson(path));
|
||||
}
|
||||
|
||||
@Test
|
||||
public void testTestUpdateOrder() throws WxErrorException {
|
||||
final WxMaExpressService service = wxMaService.getExpressService();
|
||||
WxMaExpressTestUpdateOrderRequest request = WxMaExpressTestUpdateOrderRequest.builder()
|
||||
.orderId("test201911271429000")
|
||||
.waybillId("test201911271429000_1574836404_waybill_id")
|
||||
.actionTime(1574850455L)
|
||||
.actionType(300002)
|
||||
.actionMsg("开始派送")
|
||||
.build();
|
||||
service.testUpdateOrder(request);
|
||||
}
|
||||
}
|
||||
Loading…
Reference in New Issue
Block a user