* 快递公司 * 绑定、解绑物流账号 * 配置面单打印员 * 获取打印员 * 增加微信文档地址说明 * 快递下单 * 快递下单和订单操作 * 补充文档地址dev1
@@ -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(); | 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 WxMaRunService runService = new WxMaRunServiceImpl(this); | ||||
private WxMaSecCheckService secCheckService = new WxMaSecCheckServiceImpl(this); | private WxMaSecCheckService secCheckService = new WxMaSecCheckServiceImpl(this); | ||||
private WxMaPluginService pluginService = new WxMaPluginServiceImpl(this); | private WxMaPluginService pluginService = new WxMaPluginServiceImpl(this); | ||||
private WxMaExpressService expressService = new WxMaExpressServiceImpl(this); | |||||
private int retrySleepMillis = 1000; | private int retrySleepMillis = 1000; | ||||
private int maxRetryTimes = 5; | private int maxRetryTimes = 5; | ||||
@@ -365,4 +366,7 @@ public class WxMaServiceImpl implements WxMaService, RequestHttp<CloseableHttpCl | |||||
public WxMaPluginService getPluginService() { | public WxMaPluginService getPluginService() { | ||||
return this.pluginService; | 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 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); | |||||
} | |||||
} |