目录
前言
这里主要是介绍一下抖音开放平台的这个消息退款的实际使用开发,抖音开发平台提供了一个实时退款的消息推送功能,那这时,我们需要对接这个推送功能,它如何通知到对接的系统里面就很关键,如果不通知到位的话,会造成我们的商品损失,因为不通过消息传递到我们的系统里面的话,那么我们的系统就会默认这个订单是整单发货出去的,那么物流就会整单发货出去,但这人家家已经退款了的,如果在整单发货出去,就是我们商家的损失了。
所以,实时的退款消息通知我们自研系统就显得很重要了。
一、抖音开发中的订单取消消息
买家发起订单取消消息:doudian_trade_TradeCanceled
这里先讲述一下消息的message,首先,它会触发的场景有如下:
1、货到付款订单且订单状态为「待确认」,买家和商家可取消订单
2、货到付款订单且订单状态为「备货中」,买家、商家和平台客服可取消订单
3、货到付款订单且订单状态为「已发货」,物流状态为拒收或退回
4、在线支付订单且订单状态为「待付款」,买家可取消该订单
5、在线支付订单因风控取消后
消息过来的整体数据参数如下:
这个是data里面所包含的参数如下:
在这里,我们主要是要用到父订单id
二、抖音运营反馈的业务需求分析
需求分析如下:
1. 第1种场景:
订单未被拉取到数据库中,在平台上仍然是“待发货”的状态, 客户已经取消整个订单;
解决方案:消息通知,查询订单表,如果没有查询到该订单号,则代表该订单还没拉入到数据库内,则消息无需处理,那最后,在抖音订单拉单这一个环节,需要设置过滤掉已退款状态的订单即可。
2.第2种场景:
订单已经被拉取到数据库中,但是物流快递单号还没回传,在平台上仍然是“待发货”的状态,客户已经取消整个订单:
解决方案:消息通知,查询到该订单,如果该订单已经推送到物流系统发货了,则发短信通知到抖音运营人员,人工拦截物流;如果该订单还没有推送到物流系统发货,则调用物流系统的相关接口,取消出库操作等等。
三、整体的业务开发思路
最终方案:
1.先开发消息推送的功能,先把过来的消息保存在第三方消息表中
2. 然后开启异步操作,在实时查询订单表,是否有该订单号,如果无,无需处理
3.如果有,则判断该订单是否已经推送到物流系统发货,如果无,则调用物流相关的接口,取消出库
4.如果有,则发短信通知抖音运营人员,人工拦截物流发货等操作。
四、订单取消消息的代码开发
1.订单取消消息的使用
代码如下(示例):
/**
* 接收抖音第三方开发平台推送过来的订单取消消息
* @param httpRequest
* @return
*/
@ApiOperation(tags = "TiktokEkOrder", value = "getDoudianEkShopDataPush", httpMethod = "POST",
notes = "接收抖音第三方开发平台推送过来的消息")
@AllowAnonymous
@ResponseBody
@PostMapping(value = "/getDoudianEkShopDataPush")
public DoudianEkPushResult doudianEkShopDataPush(HttpServletRequest httpRequest) {
DoudianEkPushResult result = tiktokEkOrderBiz.doudianEkShopDataPush(httpRequest);
return result;
}
2.实时保存抖音平台过来的订单取消消息
代码如下(示例):
public DoudianEkPushResult doudianEkShopDataPush(HttpServletRequest httpRequest){
DoudianPushResult result = new DoudianPushResult();
String msgId = pushDataTestList.get(0).getMsgId();
try {
DoudianPushMessage pushMessage = DoudianUtils.getPushMessage(httpRequest, APP_SECRET, APP_KEY);
// logger.info("获取到抖音售后订单消息:" + pushMessage);
if (!pushMessage.isSuccess()) {
// logger.error("接收抖音第三方开发平台推送过来的消息 解析推送数据失败");
result.setCode(40041);
result.setMsg("解析推送数据失败");
} else if (DoudianUtils.isEmpty(pushMessage.getData())) {
result.setCode(40041);
result.setMsg("解析推送数据为空");
// logger.error("接收抖音第三方开发平台推送过来的消息 解析推送数据为空");
} else {
logger.info("接收抖音第三方开发平台推送过来的消息 请求体;{}", Jack.toJson(pushMessage.getData()));
//存储消息操作
// TODO 消息
if(pushMessage.getData().get(0).getTag().equals("106")) {
TiktokMsgNotifyBean tiktokMsgNotifyBean = new TiktokMsgNotifyBean();
tiktokMsgNotifyBean.setMsgType("106"); // 取消订单类型消息
tiktokMsgNotifyBean.setMsgContent(pushMessage.getBody()); // 消息体
tiktokMsgNotifyBean.setProcResult("20"); // 待处理状态
Integer a = tiktokMsgNotifyService.save(tiktokMsgNotifyBean);
logger.info("新增了" + a + "条消息");
}
List<DoudianPushData> pushDataList = pushMessage.getData();
// 业务处理
createThead(pushDataList); // java 异步处理
// 接收处理成功
result.setCode(0);
result.setMsg("success");
// logger.info(" 接收抖音第三方开发平台推送过来的消息 接收处理成功");
}
// 回复抖音返回来的推送消息
return result;
} catch (Exception e) {
// 接收处理失败
result.setCode(40044);
result.setMsg("接收处理失败消息");
}
return result;
}
3.具体的订单业务处理
通过查询第三方消息表,遍历订单取消消息,获取到订单取消消息data数据,然后转化成java对象,在进行具体的业务处理
代码如下(示例):
List<TiktokMsgNotifyBean>tiktokMsgNotifyBeans=tiktokOrderService.findTiktokMsgNotifyBeans(); // 查询抖音消息表
for(int i = 0; i<tiktokMsgNotifyBeans.size(); i++ ){
String body = tiktokMsgNotifyBeans.get(i).getMsgContent();
List<DoudianPushData> pushDataList = getDatas(body);
for (DoudianPushData pushData : pushDataList) {
if ("106".equals(pushData.getTag())) {
try {
logger.info("获取到抖音取消订单消息106:" + pushData.getTag());
DoudianTradeTradeCanceled106 tradeTradeCanceled106 = pushData.toObject(DoudianTradeTradeCanceled106.class);
BizAssert.isTrue(tradeTradeCanceled106 != null, "接收抖音第三方开发平台推送过来的消息 消息体 TAG106 转Objecct失败");
// 具体业务处理
}
总结
这里主要是介绍一下抖音开放平台的这个消息退款的实际使用开发,抖音开发平台提供了一个实时退款的消息推送功能,那这时,我们需要对接这个推送功能,它如何通知到对接的系统里面就很关键,如果不通知到位的话,会造成我们的商品损失,因为不通过消息传递到我们的系统里面的话,那么我们的系统就会默认这个订单是整单发货出去的,那么物流就会整单发货出去,但这人家家已经退款了的,如果在整单发货出去,就是我们商家的损失了。
所以,实时的退款消息通知我们自研系统就显得很重要了。