package cn.iocoder.yudao.module.aftersales.api;
|
|
import cn.iocoder.yudao.framework.common.pojo.CommonResult;
|
import cn.iocoder.yudao.module.aftersales.api.dto.AfterSaleReturnRespDTO;
|
import cn.iocoder.yudao.module.aftersales.api.dto.AfterSaleTicketRespDTO;
|
import cn.iocoder.yudao.module.aftersales.api.dto.AfterSaleWarehouseReturnCreateReqDTO;
|
|
import java.math.BigDecimal;
|
|
/**
|
* 售后工单 API 接口（供 MES/ERP 跨模块调用）
|
*/
|
public interface AfterSaleTicketApi {
|
|
String PREFIX = "/rpc-api/aftersales/ticket";
|
|
/**
|
* MES 退货质检完成后回调
|
*
|
* @param returnId 退货申请编号
|
* @param qualityResult 质检结论
|
* @param reportUrl 质检报告 URL
|
*/
|
CommonResult<Boolean> onReturnQualityFinished(Long returnId, String qualityResult, String reportUrl);
|
|
/**
|
* MES 退货入库完成后回调
|
*
|
* @param returnId 退货申请编号
|
*/
|
CommonResult<Boolean> onReturnInboundFinished(Long returnId);
|
|
/**
|
* ERP 退款完成后回调
|
*
|
* @param returnId 退货申请编号
|
* @param actualRefundPrice 实退金额
|
*/
|
CommonResult<Boolean> onRefundCompleted(Long returnId, BigDecimal actualRefundPrice);
|
|
/**
|
* 仓储物流创建销售退货单后回调，用于在关联售后工单上留痕
|
*
|
* @param reqDTO 退货单信息（销售订单编号、退货单号、退货原因等）
|
*/
|
CommonResult<Boolean> onWarehouseReturnCreated(AfterSaleWarehouseReturnCreateReqDTO reqDTO);
|
|
/**
|
* 查询售后工单（供 MES/ERP 查询关联信息）
|
*
|
* @param id 工单编号
|
*/
|
CommonResult<AfterSaleTicketRespDTO> getTicket(Long id);
|
|
/**
|
* 查询退货申请（供 MES/ERP 查询关联信息）
|
*
|
* @param id 退货申请编号
|
*/
|
CommonResult<AfterSaleReturnRespDTO> getReturn(Long id);
|
|
}
|
