Java退货管理功能开发教程

• 订单是否已完成或已发货：只有已发货或已完成的订单才允许申请退货。未支付或已取消的订单不能发起退货。
• 是否在退货有效期内：比如系统规定签收后7天内可申请退货，需比对签收时间与当前时间。
• 商品是否支持退货：部分商品如虚拟商品、定制类商品可能不支持退货，需检查商品配置。
• 同一订单项是否已存在处理中的退货申请：防止重复提交，需查询退货表中是否存在status为“待审核”或“处理中”的记录。

if (!order.getStatus().equals("DELIVERED") && !order.getStatus().equals("COMPLETED")) {
    throw new BusinessException("该订单当前状态不支持退货");
}

long diffDays = ChronoUnit.DAYS.between(deliveryTime, LocalDateTime.now());
if (diffDays > 7) {
    throw new BusinessException("超过7天无理由退货期限");
}

if (!product.getReturnable()) {
    throw new BusinessException("该商品不支持退货");
}

• 仅退款（未收到货）：不涉及退货寄回，确认后直接走退款流程，需标记物流状态为异常。
• 退货退款（已收货）：需用户提供退货物流信息，后台审核通过后触发退款。
• 换货：需冻结原商品库存，新发货后释放原退货商品的库存。

enum ReturnType {
    REFUND_ONLY,     // 仅退款
    RETURN_REFUND,   // 退货退款
    EXCHANGE         // 换货
}

• 初始状态为“待审核”，管理员审核通过后变为“待用户退货”。
• 用户填写退货单号后更新为“待商家收货”。
• 仓库确认收货并验货无误后，进入“待退款”或“待换货发货”。
• 最终完成状态为“已完成”或“已关闭”（如验货不合格）。

• 退款：调用支付网关的退款接口，传入原始订单交易号和金额。需记录退款流水，防止重复退款。
• 库存回滚：将退货商品数量加回可用库存。若为部分退货，只增加对应数量。
• 优惠分摊计算：若订单使用了优惠券或参与满减，需按比例计算应退金额，不能简单按单价退还。