Merge branch 'feature/box/券包退款' into qa

order-management/src/main/java/cn/freemud/management/entities/dto/request/coupon/CodeInfoQueryDto.java

+package cn.freemud.management.entities.dto.request.coupon;
+
+import lombok.Data;
+import org.springframework.lang.Nullable;
+
+
+/**
+ * © All rights Reserved, Designed By www.freemud.cn
+ *
+ * @author wénkǎi.zhāng 2023-05-30
+ * @since 1.0
+ */
+@Data
+public class CodeInfoQueryDto {
+    /**
+     * 券名称
+     */
+    private String name;
+
+    /**
+     * 券号,目前最长23个字符
+     */
+    private String code;
+
+    /**
+     * 券Logo
+     */
+    private String logo;
+
+    /**
+     * 券类型
+     */
+    private Integer type;
+
+    /**
+     * 券状态：0可用，1已核销，2部分核销
+     */
+    private Integer state;
+
+    /**
+     * 当前剩余可用次数
+     */
+    private Integer leftAvailableTimes;
+
+    /**
+     * 最大剩余可用次数
+     */
+    private Integer maxLeftAvailableTimes;
+
+
+    /**
+     * 优惠券使用限制相关配置
+     */
+    private CouponCodeUseRuleModel couponUseRule;
+
+    @Data
+    public static class CouponCodeUseRuleModel {
+        /**
+         * 最大可核销次数，大于1时为频次券， 默认1次
+         */
+        private int maxRedeemTimes = 1;
+
+        /**
+         * 核销次数限制类型对应的可核销次数，频次券时有效，默认null不限
+         */
+        @Nullable
+        private Integer limitedRedeemTimes;
+    }
+
+}

order-management/src/main/java/cn/freemud/management/entities/dto/response/coupon/CouponBaseResponse.java

+package cn.freemud.management.entities.dto.response.coupon;
+
+import com.fasterxml.jackson.annotation.JsonAlias;
+import lombok.Data;
+
+/**
+ * @author : xh.Z
+ * @email : fisherman0510@163.com
+ * @Date : 2021/11/9 下午2:45
+ * @description :
+ */
+@Data
+public class CouponBaseResponse<T> {
+
+    private Integer statusCode;
+    /**
+     * 返回信息
+     */
+    private String msg;
+
+    @JsonAlias("data")
+    private T result;
+
+}

order-management/src/main/java/cn/freemud/management/enums/CouponStatus.java

+package cn.freemud.management.enums;
+
+public enum CouponStatus {
+    STATUS(-1, "未激活"),
+    STATUS_0(0, "可用"),
+    STATUS_1(1, "已使用"),
+    STATUS_2(2, "部分使用"),
+    STATUS_3(3, "取消"),
+    STATUS_6(6, "已过期"),
+    ;
+
+    private Integer code;
+    private String desc;
+
+    CouponStatus(Integer code, String desc) {
+        this.code = code;
+        this.desc = desc;
+    }
+
+    public static CouponStatus getByCode(Integer code) {
+        for (CouponStatus payType : values()) {
+            if (payType.getCode().equals(code)) {
+                return payType;
+            }
+        }
+        return null;
+    }
+
+    public Integer getCode() {
+        return code;
+    }
+
+    public void setCode(Integer code) {
+        this.code = code;
+    }
+
+    public String getDesc() {
+        return desc;
+    }
+
+    public void setDesc(String desc) {
+        this.desc = desc;
+    }
+}

order-management/src/main/java/cn/freemud/management/service/adapter/OrderBeanFactory.java

@@ -56,6 +56,11 @@ public class OrderBeanFactory {
             return applicationContext.getBean(NewMallOrderMangerServiceImpl.class);
         }
 
+        // 卖券订单，根据业务类型
+        if(Objects.equals(BizTypeEnum.SALE_COUPON.getBizType(),orderBean.getBizType())){
+            return applicationContext.getBean(SaleCouponOrderMangerServiceImpl.class);
+        }
+
         return applicationContext.getBean(SaasOrderMangerServiceImpl.class);
     }
 }

order-management/src/main/java/cn/freemud/management/service/handle/CouponQueryHandle.java

+package cn.freemud.management.service.handle;
+
+import cn.freemud.management.entities.dto.request.coupon.CodeInfoQueryDto;
+import cn.freemud.management.entities.dto.response.coupon.CouponBaseResponse;
+import cn.freemud.management.enums.CouponStatus;
+import cn.freemud.management.thirdparty.CouponQueryClient;
+import cn.freemud.management.thirdparty.request.coupon.CodeInfoQueryReq;
+import com.alibaba.fastjson.JSONObject;
+import com.freemud.application.sdk.api.log.ApiLog;
+import com.google.common.collect.Lists;
+import lombok.RequiredArgsConstructor;
+import org.apache.commons.collections4.CollectionUtils;
+import org.springframework.stereotype.Component;
+
+import java.util.*;
+
+/**
+ * © All rights Reserved
+ *
+ * @author wénkǎi.zhāng 2024-01-02
+ * @since 1.0
+ */
+@Component
+@RequiredArgsConstructor
+public class CouponQueryHandle {
+    private final CouponQueryClient couponQueryClient;
+
+    private final int SUCCESS_CODE = 100;
+
+    /**
+     * 查询券信息
+     * <pre>
+     *   1. 本方法会忽略查询失败的券，因此可能传入的券号不一定都能在返回列表中找到与之对应的券信息
+     *   2. 同时，本方法会对入参中的codes去重，券码接口对已归档的券也不会返回，基于本条和上一条，
+     *   应注意传入集合的size可能和返回列表的size不同，也许是正常现象
+     *   3. 本方法不保证返回的券信息顺序和入参的券号顺序相同
+     * </pre>
+     * @param partnerId
+     * @param codes 券号列表，支持 非码券/微信商家券/支付宝商家券
+     * @return 对券号列表去重后，成功查到的券信息列表
+     */
+    public List<CodeInfoQueryDto> queryCodesInfo(String partnerId, Collection<String> codes) {
+        List<CodeInfoQueryDto> result = new ArrayList<>();
+
+        CodeInfoQueryReq request = new CodeInfoQueryReq();
+        request.setPartnerId(partnerId);
+
+        // 券码接口最大支持每次10个券号
+        Lists.partition(new ArrayList<>(new HashSet<>(codes)), 10).forEach(subList -> {
+            // 注意：如果改成并发调用，这里不能直接复用request
+            request.setCodes(subList);
+            try {
+                CouponBaseResponse<List<CodeInfoQueryDto>> resp = couponQueryClient.queryCodesInfo(request);
+                if (!Objects.equals(SUCCESS_CODE, resp.getStatusCode()) || CollectionUtils.isEmpty(resp.getResult())) {
+                    ApiLog.warnMessage("优惠券信息查询失败：{} {}", JSONObject.toJSONString(request), JSONObject.toJSONString(resp));
+                    return;
+                }
+                result.addAll(resp.getResult());
+            } catch (Throwable e) {
+                ApiLog.warnMessage("优惠券信息查询异常：{} {}", e.getMessage(), JSONObject.toJSONString(request));
+            }
+        });
+
+        return result;
+    }
+
+
+    /**
+     * 指定一组券号，判断这些券号中是否存在已使用的券
+     * <pre></pre>
+     * @param partnerId
+     * @param couponCodes
+     * @return 如果有一张或多张券没查到、或已使用、或已部分使用、或已锁定，返回true
+     */
+    public boolean isCouponUsed(String partnerId, Collection<String> couponCodes) {
+        boolean used;
+        List<CodeInfoQueryDto> codeInfoQueryDtos = this.queryCodesInfo(partnerId, couponCodes);
+        // 以下条件任意一个成立，说明券已使用：
+        // 1. 返回的数量和查询的不一致
+        // 2. 存在已使用或者部分使用的券状态
+        // 3. 存在锁定的券（剩余核销次数!=总核销次数）
+        used = couponCodes.size() != codeInfoQueryDtos.size()
+                || codeInfoQueryDtos.stream().anyMatch(o -> {
+            return CouponStatus.STATUS_1.getCode().equals(o.getState())
+                    || CouponStatus.STATUS_2.getCode().equals(o.getState())
+                    || !Objects.equals(o.getMaxLeftAvailableTimes(), o.getCouponUseRule().getMaxRedeemTimes());
+        });
+        return used;
+    }
+}

order-management/src/main/java/cn/freemud/management/service/handle/OrderCouponHandle.java

+package cn.freemud.management.service.handle;
+
+import cn.freemud.base.entity.BaseResponse;
+import cn.freemud.management.entities.dto.request.order.OrderManagerRequest;
+import cn.freemud.management.entities.dto.response.coupon.CouponBaseResponse;
+import cn.freemud.management.enums.ResponseResult;
+import cn.freemud.management.thirdparty.CouponOnlineClient;
+import cn.freemud.management.thirdparty.request.coupon.BatchCouponDiscardReq;
+import cn.freemud.management.thirdparty.request.coupon.CouponUnFreezeReq;
+import cn.freemud.management.util.ResponseUtil;
+import com.alibaba.fastjson.JSONObject;
+import com.freemud.application.sdk.api.log.ApiLog;
+import com.freemud.application.sdk.api.ordercenter.entities.v1.OrderBeanV1;
+import com.freemud.application.sdk.api.ordercenter.enums.BizTypeEnum;
+import com.freemud.application.sdk.api.ordercenter.response.orderInfo.OrderSettlementResp;
+import lombok.RequiredArgsConstructor;
+import org.apache.commons.lang.StringUtils;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.stereotype.Component;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Objects;
+import java.util.Optional;
+import java.util.stream.Collectors;
+
+/**
+ * © All rights Reserved
+ *
+ * @author wénkǎi.zhāng 2024-01-02
+ * @since 1.0
+ */
+@Component
+@RequiredArgsConstructor
+public class OrderCouponHandle {
+    @Value("${coupon.partner.id:1983}")
+    private String couponPartnerId;
+
+    private final CouponQueryHandle couponQueryHandle;
+    private final CouponOnlineClient couponOnlineClient;
+
+    public BaseResponse discardOrderCoupon(String partnerId, OrderBeanV1 orderBean) {
+        if (BizTypeEnum.SALE_COUPON.getBizType().equals(orderBean.getBizType())) {
+            List<String> couponCodes = Optional.ofNullable(orderBean.getOrderSettlementDetailList()).orElse(new ArrayList<>()).stream()
+                    // 216 = 买券订单的券信息
+                    .filter(dto -> Objects.equals(216, dto.getSettlementType()) && StringUtils.isNotBlank(dto.getExternalObjectId()))
+                    .map(OrderSettlementResp::getExternalObjectId)
+                    .collect(Collectors.toList());
+
+            if (couponCodes.isEmpty()) {
+                return ResponseUtil.error(ResponseResult.SYSTEM_ERROR.getCode(), "订单中优惠券数据为空。");
+            }
+            // 校验券状态是否已被使用
+            if (couponQueryHandle.isCouponUsed(partnerId, couponCodes)) {
+                return ResponseUtil.error(ResponseResult.SYSTEM_ERROR.getCode(), "作废优惠券失败，部分券已被使用。");
+            }
+
+            BatchCouponDiscardReq discardReq = new BatchCouponDiscardReq();
+            discardReq.setCoupons(couponCodes.stream().map(code -> {
+                return new BatchCouponDiscardReq.CouponInfo(){{
+                    setCode(code);
+                    setMemberId(orderBean.getUserId());
+                }};
+            }).collect(Collectors.toList()));
+            discardReq.setPartnerId(partnerId);
+            discardReq.setProviderId(couponPartnerId);
+            discardReq.setCancelReason("券包订单退款");
+
+            CouponBaseResponse<Object> discardResp = couponOnlineClient.batchDiscard(discardReq);
+            if (!Objects.equals(discardResp.getStatusCode(), 100)) {
+                return ResponseUtil.error(ResponseResult.SYSTEM_ERROR.getCode(), "作废优惠券失败");
+            }
+        }
+        return ResponseUtil.success();
+    }
+
+    public void unfreezeOrderCoupon(String partnerId, OrderBeanV1 orderBean) {
+        if (BizTypeEnum.SALE_COUPON.getBizType().equals(orderBean.getBizType())) {
+            List<String> couponCodes = Optional.ofNullable(orderBean.getOrderSettlementDetailList()).orElse(new ArrayList<>()).stream()
+                    // 216 = 买券订单的券信息
+                    .filter(dto -> Objects.equals(216, dto.getSettlementType()) && StringUtils.isNotBlank(dto.getExternalObjectId()))
+                    .map(OrderSettlementResp::getExternalObjectId)
+                    .collect(Collectors.toList());
+
+            if (!couponCodes.isEmpty()) {
+                CouponUnFreezeReq unFreezeReq = new CouponUnFreezeReq();
+                unFreezeReq.setCoupons(couponCodes.stream().map(code -> {
+                    return new CouponUnFreezeReq.CouponInfo(){{
+                        setCode(code);
+                        setMemberId(orderBean.getUserId());
+                    }};
+                }).collect(Collectors.toList()));
+                unFreezeReq.setPartnerId(partnerId);
+                CouponBaseResponse<Object> unfreezeResp = couponOnlineClient.unfreeze(unFreezeReq);
+                if (!Objects.equals(unfreezeResp.getStatusCode(), 100)) {
+                    ApiLog.warnMessage("refundReject 解冻券失败:{}", JSONObject.toJSONString(unfreezeResp));
+                }
+            }
+        }
+    }
+}

order-management/src/main/java/cn/freemud/management/service/impl/SaleCouponOrderMangerServiceImpl.java

+package cn.freemud.management.service.impl;
+
+import cn.freemud.base.entity.BaseResponse;
+import cn.freemud.management.entities.dto.request.order.OrderManagerRequest;
+import cn.freemud.management.entities.dto.response.order.OrderManagerResponse;
+import cn.freemud.management.entities.dto.response.pay.PayRefundResponse;
+import cn.freemud.management.enums.OperateType;
+import cn.freemud.management.enums.ResponseResult;
+import cn.freemud.management.service.OrderBaseService;
+import cn.freemud.management.service.OrderManagerService;
+import cn.freemud.management.service.handle.OrderCouponHandle;
+import cn.freemud.management.service.handle.PaymentHandle;
+import cn.freemud.management.service.handle.SaasOrderHandle;
+import cn.freemud.management.service.handle.StockHandle;
+import cn.freemud.management.util.ResponseUtil;
+import com.freemud.application.sdk.api.log.ApiLog;
+import com.freemud.application.sdk.api.log.LogThreadLocal;
+import com.freemud.application.sdk.api.ordercenter.entities.v1.OrderBeanV1;
+import com.freemud.application.sdk.api.ordercenter.request.AfterSalesRefundFailReq;
+import com.freemud.application.sdk.api.ordercenter.service.OrderSdkService;
+import com.freemud.sdk.api.assortment.order.enums.PayRefundStatus;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+
+import java.util.Objects;
+import java.util.UUID;
+
+import static cn.freemud.management.enums.OperateType.ORDER_AGREE_REFUND;
+
+/**
+ * All rights Reserved, Designed By www.freemud.cn
+ *
+ * @version V1.0
+ * @Title: rrr
+ * @Package cn.freemud.management.service.impl
+ * @Description: saas订单履单操作
+ * @author: shuhu.hou
+ * @date: 2020/3/26 16:01
+ * @Copyright: 2020 www.freemud.cn Inc. All rights reserved.
+ * 注意：本内容仅限于上海非码科技内部传阅，禁止外泄以及用于其他的商业目
+ */
+@Service
+public class SaleCouponOrderMangerServiceImpl implements OrderManagerService {
+
+    @Autowired
+    private OrderCouponHandle orderCouponHandle;
+
+    @Autowired
+    private SaasOrderHandle saasOrderHandle;
+    @Autowired
+    private OrderBaseService orderBaseService;
+
+    @Autowired
+    private PaymentHandle paymentHandle;
+    @Autowired
+    private StockHandle stockHandle;
+
+    @Autowired
+    private OrderSdkService orderSdkService;
+
+
+    /**
+     * 同意退款
+     *
+     * @param request
+     * @param orderBean
+     * @return
+     */
+    @Override
+    public BaseResponse<OrderManagerResponse> orderAgreeRefund(OrderManagerRequest request, OrderBeanV1 orderBean) {
+        // 退款前先作废券
+        BaseResponse response = orderCouponHandle.discardOrderCoupon(request.getPartnerId(), orderBean);
+        if (!isSuccess(response)) {
+            return response;
+        }
+
+        // 支付退款 包括线上小程序付款的订单，订单宝其他支付方式收款（汇来米，收钱吧，现金，其他）老板通发起退款
+        PayRefundResponse refundResponse = this.payRefundCommon(request, orderBean);
+        // 退款异常
+        if (refundResponse.getPayRefundStatus().getCode().compareTo(PayRefundStatus.COMPATIBILITY_STATUS.getCode()) == 0) {
+            return ResponseUtil.error(refundResponse.getResult());
+        }
+        //退款失败终止下面的退款流程
+        if (refundResponse.getPayRefundStatus().getCode().compareTo(PayRefundStatus.FAIL.getCode()) == 0) {
+            return ResponseUtil.error(ResponseResult.REFUND_FAIL.getCode(), refundResponse.getMessage());
+        }
+
+        //订单同意退款
+        saasOrderHandle.refundAgree(request, refundResponse, orderBean);
+        // 推送pos、微信消息中心
+        orderBaseService.sendMessage(orderBean, ORDER_AGREE_REFUND, request.getReason());
+
+        // 退款冲正发送消息队列（部分退款不进行冲正）
+        if (!refundResponse.getPartRefund()) {
+            // todo 可以考虑基于订单回调异步实现
+            stockHandle.revert(request, orderBean);
+        }
+
+        if (refundResponse.getPayRefundStatus().getCode().compareTo(PayRefundStatus.RUNNING.getCode()) == 0) {
+            return ResponseUtil.error(ResponseResult.REFUND_FAIL.getCode(), refundResponse.getMessage());
+        }
+        return ResponseUtil.success();
+    }
+
+    /**
+     * 拒绝退款
+     *
+     * @param request
+     * @param orderBean
+     * @return
+     */
+    @Override
+    public BaseResponse<OrderManagerResponse> orderRejectRefund(OrderManagerRequest request, OrderBeanV1 orderBean) {
+        //拒绝退款
+        BaseResponse response = saasOrderHandle.refundReject(request, orderBean);
+        if (!isSuccess(response)) {
+            return response;
+        }
+        // 推送pos、微信消息中心
+        orderBaseService.sendMessage(orderBean, OperateType.ORDER_REJECT_REFUND, request.getReason());
+
+        // 拒绝后解冻券
+        try {
+            orderCouponHandle.unfreezeOrderCoupon(request.getPartnerId(), orderBean);
+        } catch (Exception e) {
+            ApiLog.warnMessage("refundReject 解冻券异常.error orderCode={}, ex:{}", request.getOrderId(), e.getMessage());
+        }
+        return ResponseUtil.success();
+    }
+
+
+
+
+    /**
+     * 拒单退款、同意退款、取消订单退款
+     * 小程序点餐订单退款，无单收银退款，订单宝扫码付、其他支付方式收款（汇来米，收钱吧，现金，其他）等有支付流水等退款
+     */
+    private PayRefundResponse payRefundCommon(OrderManagerRequest request, OrderBeanV1 orderBean) {
+        if (orderBean.getAmount() == 0) {
+            // 0元订单
+            PayRefundResponse refundResponse = new PayRefundResponse();
+            refundResponse.setRefundId(UUID.randomUUID().toString().replaceAll("-", ""));
+            refundResponse.setPayRefundStatus(PayRefundStatus.SUCCESS);
+            refundResponse.setMessage(PayRefundStatus.SUCCESS.getDesc());
+            return refundResponse;
+        }
+        PayRefundResponse refundResponse = paymentHandle.getCommonPayRefundResponse(request, orderBean);
+        // 同意退款退款失败记录到订单售后单
+        if (orderBean.getAfterSalesOrderResp() != null && Objects.equals(PayRefundStatus.FAIL.getCode(), refundResponse.getPayRefundStatus().getCode())) {
+            AfterSalesRefundFailReq refundFailReq = this.getAfterSalesRefundFailReq(orderBean,
+                    request.getOperator(),
+                    request.getOperationClient(),
+                    refundResponse.getMessage());
+            orderSdkService.refundFail(refundFailReq, LogThreadLocal.getTrackingNo());
+        }
+        return refundResponse;
+    }
+
+    private AfterSalesRefundFailReq getAfterSalesRefundFailReq(OrderBeanV1 orderBean, String operator, Integer operationClient, String refundFailReason) {
+        AfterSalesRefundFailReq refundFailReq = new AfterSalesRefundFailReq();
+        refundFailReq.setOrderCode(orderBean.getOid());
+        refundFailReq.setPartnerId(orderBean.getCompanyId());
+        refundFailReq.setRefundFailReason(refundFailReason);
+        refundFailReq.setAfterSalesCode(orderBean.getAfterSalesOrderResp().getAfterSalesCode());
+        refundFailReq.setOperationClient(operationClient);
+        refundFailReq.setOperator(operator);
+        return refundFailReq;
+    }
+
+
+    private boolean isSuccess(BaseResponse response) {
+        return Objects.equals("100", response.getCode());
+    }
+}

order-management/src/main/java/cn/freemud/management/thirdparty/CouponOnlineClient.java

+package cn.freemud.management.thirdparty;
+
+import cn.freemud.management.entities.dto.response.coupon.CouponBaseResponse;
+import cn.freemud.management.thirdparty.request.coupon.BatchCouponDiscardReq;
+import cn.freemud.management.thirdparty.request.coupon.CouponUnFreezeReq;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.PostMapping;
+
+//@IgnoreFeignLogAnnotation
+@FeignClient(contextId = "coupon-online-service-management", name = "OPEN-STORE-ONLINE-COUPON-SERVICE", url = "${saas.coupononlineclient.feign.url:}")
+public interface CouponOnlineClient {
+
+
+    /**
+     * 批量作废券（包括会员卡包中的券）
+     * <pre></pre>
+     * @param req
+     * @return
+     */
+    @PostMapping("coupon/standard/discard")
+    CouponBaseResponse<Object> batchDiscard(BatchCouponDiscardReq req);
+
+    /**
+     * 解冻券，请求券号列表中，所有券号尾号必须一样
+     * <pre></pre>
+     * @param req
+     * @return
+     */
+    @PostMapping("coupon/standard/ops/unfreeze")
+    CouponBaseResponse<Object> unfreeze(CouponUnFreezeReq req);
+}

order-management/src/main/java/cn/freemud/management/thirdparty/CouponQueryClient.java

+/**
+ * All rights Reserved, Designed By www.freemud.cn
+ *
+ * @Title: CouponQueryClient
+ * @Package cn.freemud.service.thirdparty
+ * @Description:
+ * @author: song.cai
+ * @date: 2019/2/20 16:42
+ * @version V1.0
+ * @Copyright: 2019 www.freemud.cn Inc. All rights reserved.
+ * 注意：本内容仅限于上海非码科技内部传阅，禁止外泄以及用于其他的商业目
+ */
+
+package cn.freemud.management.thirdparty;
+
+import cn.freemud.management.entities.dto.request.coupon.CodeInfoQueryDto;
+import cn.freemud.management.entities.dto.response.coupon.CouponBaseResponse;
+import cn.freemud.management.thirdparty.request.coupon.CodeInfoQueryReq;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+
+import java.util.List;
+
+@FeignClient(name = "OPEN-STORE-COUPON-QUERY-SERVICE", url = "${saas.coupon-query-service.feign.url:}")
+@RequestMapping(produces = {"application/json;charset=UTF-8"})
+public interface CouponQueryClient {
+    /**
+     * 查询券信息
+     * <pre></pre>
+     * @param request
+     * @return
+     */
+    @PostMapping("coupon/query/info")
+    CouponBaseResponse<List<CodeInfoQueryDto>> queryCodesInfo(CodeInfoQueryReq request);
+}

order-management/src/main/java/cn/freemud/management/thirdparty/request/coupon/BatchCouponDiscardReq.java

+package cn.freemud.management.thirdparty.request.coupon;
+
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import javax.validation.Valid;
+import javax.validation.constraints.NotBlank;
+import javax.validation.constraints.Size;
+import java.util.List;
+
+/**
+ * 作废券请求参数
+ *
+ * @author tony
+ */
+@Data
+public class BatchCouponDiscardReq {
+
+    @Size(min = 1, message = "作废的券信息不能为空")
+    private List<CouponInfo> coupons;
+
+    @NotBlank(message = "商户编号不能为空")
+    private String partnerId;
+
+    @NotBlank(message = "渠道编号不能为空")
+    private String providerId;
+
+    @NotBlank(message = "作废原因不能为空")
+    private String cancelReason;
+
+    @Valid
+    @Data
+    public static class CouponInfo {
+
+        @NotBlank(message = "会员ID不能为空")
+        private String memberId;
+
+        @NotBlank(message = "券号不能为空")
+        private String code;
+    }
+
+    @ApiModelProperty("接口版本，=1：不校验券是否属于传入的会员id。>1：校验")
+    private int ver = 1;
+}

order-management/src/main/java/cn/freemud/management/thirdparty/request/coupon/CodeInfoQueryReq.java

+package cn.freemud.management.thirdparty.request.coupon;
+
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * © All rights Reserved, Designed By www.freemud.cn
+ *
+ * @author wénkǎi.zhāng 2023-05-30
+ * @since 1.0
+ */
+@Data
+public class CodeInfoQueryReq {
+
+    @ApiModelProperty(value = "商户号", required = true, example = "1864")
+    private String partnerId;
+
+    @ApiModelProperty(value = "券号列表,最多支持10张券，支持 非码券/微信商家券/支付宝商家券", required = true, example = "[\"88600000001823678618\",\"88600000001823679226\"]")
+    private List<String> codes;
+}

order-management/src/main/java/cn/freemud/management/thirdparty/request/coupon/CouponUnFreezeReq.java

+package cn.freemud.management.thirdparty.request.coupon;
+
+import lombok.Data;
+
+import javax.validation.Valid;
+import javax.validation.constraints.NotBlank;
+import javax.validation.constraints.Size;
+import java.util.List;
+
+/**
+ * 冻结券请求参数
+ *
+ * @author tony
+ */
+@Data
+public class CouponUnFreezeReq {
+
+    @Size(min = 1, max = 20, message = "操作的券信息不能为空且最多支持20张")
+    private List<CouponInfo> coupons;
+
+    @NotBlank(message = "商户编号不能为空")
+    private String partnerId;
+
+
+    @Valid
+    @Data
+    public static class CouponInfo {
+
+        private String memberId;
+
+        @NotBlank(message = "券号不能为空")
+        private String code;
+    }
+}