package cn.iocoder.yudao.module.trade.service.foreign;
|
|
import cn.iocoder.yudao.module.trade.controller.admin.foreign.vo.TradeForeignDocumentSaveReqVO;
|
import cn.iocoder.yudao.module.trade.controller.admin.foreign.vo.TradeForeignRequiredDocRespVO;
|
import cn.iocoder.yudao.module.trade.dal.dataobject.foreign.TradeForeignDocumentDO;
|
|
import java.util.Collection;
|
import java.util.List;
|
import java.util.Map;
|
|
/**
|
* 外贸订单单据 Service 接口
|
*
|
* @author mom
|
*/
|
public interface TradeForeignDocumentService {
|
|
/** 登记外贸单据(带单据类型),并把文件纳入订单统一附件区 */
|
Long addDocument(TradeForeignDocumentSaveReqVO reqVO);
|
|
/** 获得某订单的已上传单据列表(文件 url/name 从统一附件区回填) */
|
List<TradeForeignDocumentDO> getDocumentListByOrderId(Long orderId);
|
|
/** 按出货模式校验必填单据(返回全部单据类型的 必填/已传 情况) */
|
List<TradeForeignRequiredDocRespVO> getRequiredDocs(Long orderId);
|
|
/**
|
* 计算缺失的必填单据名称
|
*
|
* @param orderId 外贸订单编号
|
* @param excludeApprovalRequired 是否忽略「需审批通过后才能登记」的单据(提交审批前用;这些单据在审批后大才会补)
|
* @return 缺失的必填单据名称列表(空列表表示齐全)
|
*/
|
List<String> getMissingRequiredDocNames(Long orderId, boolean excludeApprovalRequired);
|
|
/** 批量计算缺失的必填单据名称(订单编号 -> 缺失单据名称列表,全部必填口径),供列表缺件标识使用 */
|
Map<Long, List<String>> getMissingRequiredDocNamesByOrderIds(Collection<Long> orderIds);
|
|
}
|