tuqin
2026-11-03 9494075e6d9d2a4b2b884b4ed740dee0c434734c
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
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);
 
}