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 getDocumentListByOrderId(Long orderId); /** 按出货模式校验必填单据(返回全部单据类型的 必填/已传 情况) */ List getRequiredDocs(Long orderId); /** * 计算缺失的必填单据名称 * * @param orderId 外贸订单编号 * @param excludeApprovalRequired 是否忽略「需审批通过后才能登记」的单据(提交审批前用;这些单据在审批后大才会补) * @return 缺失的必填单据名称列表(空列表表示齐全) */ List getMissingRequiredDocNames(Long orderId, boolean excludeApprovalRequired); /** 批量计算缺失的必填单据名称(订单编号 -> 缺失单据名称列表,全部必填口径),供列表缺件标识使用 */ Map> getMissingRequiredDocNamesByOrderIds(Collection orderIds); }