feat(crm-invoice): 新增开票Excel批量导入功能

gaoluyang

2 天以前 298e948226a6773c5432f490f68c671af80dfc16

 docs/project-business/index.html

@@ -341,7 +341,7 @@
    {"key": "crm", "name": "销售管理（客户关系）", "color": "#4f9cff", "tag": "CRM", "flow": "sales",
     "positioning": "销售前端：从线索到回款的客户经营",
     "problem": "客户资产沉淀、商机转化、合同审批与开票回款管控",
     "features": ["线索转化客户", "公海池与领取上限", "联系人", "商机自定义阶段(状态组选填)", "跟进记录", "报价单(AI OCR)", "合同(BPM审批→生成销售订单)", "开票(BPM)→回款(先开票校验)", "回款计划", "销售目标", "数据权限三级(负责人/只读/读写)"],
     "features": ["线索转化客户", "公海池与领取上限", "联系人", "商机自定义阶段(状态组选填)", "跟进记录", "报价单(AI OCR)", "合同(BPM审批→生成销售订单)", "开票(BPM审批·支持Excel批量导入)→回款(先开票校验)", "回款计划", "销售目标", "数据权限三级(负责人/只读/读写)"],
     "objects": ["线索", "客户", "联系人", "商机", "报价单", "合同", "发票", "回款", "销售目标"],
     "roles": ["销售内勤", "销售经理", "财务(开票回款)"],
     "upstream": ["主数据(物料)"], "downstream": ["进销存(销售订单)", "售后(客户)", "AI(报价OCR)"],
@@ -381,8 +381,8 @@
    {"key": "qc", "name": "质量管理", "color": "#e06c6c", "tag": "MES-QC", "flow": "quality",
     "positioning": "四道检验闸口 + 不合格品闭环处置",
     "problem": "来料/过程/出货/退货检验标准化，不合格可追溯处置",
     "features": ["IQC 来料(到货/外协)", "IPQC 过程(联动报工)", "OQC 出货(联动销售出库)", "RQC 退货(联动退料/售后)", "质检方案·指标·缺陷库", "检测结果:IQC/IPQC/RQC 合格·特采·退货·报废 / OQC 1型·2型·废品", "NCR:评审→处置(退货/报废/返工/让步/降级)→关闭", "AI 判定建议"],
     "objects": ["IQC", "IPQC", "OQC", "RQC", "质检方案", "NCR", "缺陷记录"],
     "features": ["IQC 来料(到货/外协)", "IPQC 过程(联动报工)", "OQC 出货(联动销售出库)", "RQC 退货(联动退料/售后)", "质检方案·指标·缺陷库", "检测结果:IQC/IPQC/RQC 合格·特采·退货·报废 / OQC 1型·2型·废品", "NCR:评审→处置(退货/报废/返工/让步/降级)→关闭", "Excel批量导入(IQC/IPQC/OQC 各一个入口·逐行导入失败行互不影响)", "检测结果台账(跨四类检验单统一查询与导出)", "AI 判定建议"],
     "objects": ["IQC", "IPQC", "OQC", "RQC", "质检方案", "NCR", "缺陷记录", "检测结果台账"],
     "roles": ["质检员(IQC/IPQC/OQC)", "质量工程师"],
     "upstream": ["仓储(到货)", "生产(报工)", "销售(出库)", "售后(退货)"], "downstream": ["仓储(合格入库/报废出库)", "生产(NCR返工)"],
     "coreTables": ["mes_qc_iqc", "mes_qc_ipqc", "mes_qc_oqc", "mes_qc_rqc", "mes_qc_template", "mes_qc_indicator", "mes_qc_defect", "mes_qc_ncr"]},
@@ -443,7 +443,7 @@
    {"name": "商机", "module": "销售管理", "table": "crm_business", "doc": "销售机会，DB 配置式阶段推进（商机状态组/阶段为选填：不选状态组也能建单，此时无默认阶段、不可变更阶段、不参与状态组统计），结束态: 赢/输/无效", "upstream": ["客户"], "downstream": ["报价单", "合同"], "keywords": "商机 business 赢单 输单 阶段 状态组"},
    {"name": "报价单", "module": "销售管理", "table": "crm_sale_quotation", "doc": "QT编号，选 MDM 物料报价，AI OCR 录入，草稿→已转合同", "upstream": ["商机"], "downstream": ["合同"], "keywords": "报价 quotation QT"},
    {"name": "合同", "module": "销售管理", "table": "crm_contract", "doc": "HT编号(新增/编辑均可自定义，留空则新增自动生成、编辑保持原编号)，BPM 审批(0草稿/10审批中/20通过/30驳回/40取消/50作废)，通过后可生成销售订单", "upstream": ["报价单"], "downstream": ["销售订单", "回款计划", "开票"], "keywords": "合同 contract 审批"},
    {"name": "发票", "module": "销售管理", "table": "crm_invoice", "doc": "KP编号，BPM 审批，累计开票≤合同额，附件必传", "upstream": ["合同"], "downstream": ["回款"], "keywords": "开票 发票 invoice"},
    {"name": "发票", "module": "销售管理", "table": "crm_invoice", "doc": "KP编号，BPM 审批，累计开票≤合同额，附件必传；支持 Excel 批量导入（同一合同下同发票号码、或同「金额+抬头+开票日期」的行判重复并拒收，逐行回显失败原因）", "upstream": ["合同"], "downstream": ["回款"], "keywords": "开票 发票 invoice 导入"},
    {"name": "回款", "module": "销售管理", "table": "crm_receivable", "doc": "HK编号，创建即审批中(手动审核)，强制先开票，金额双校验", "upstream": ["合同", "发票"], "downstream": ["收款单(关联)"], "keywords": "回款 收款计划 receivable"},
    {"name": "销售目标", "module": "销售管理", "table": "crm_sales_target", "doc": "年/季/月×个人/部门/产品维度的合同回款等目标", "upstream": [], "downstream": ["业绩统计"], "keywords": "目标 target 业绩"},
    {"name": "供应商", "module": "供应商管理", "table": "srm_supplier", "doc": "供应商档案：执照/税号/银行/联系人，ERP 与 MES 共用", "upstream": ["准入申请"], "downstream": ["采购订单", "到货通知", "供应商退货", "绩效评价"], "keywords": "供应商 supplier vendor"},
@@ -470,10 +470,11 @@
    {"name": "盘点任务", "module": "仓储", "table": "mes_wm_stock_taking_task", "doc": "静态/动态盘点，行结果:正常/盘盈(ADJUST_IN)/盘亏(ADJUST_OUT)，可冻结库存、盲盘", "upstream": ["库存台账"], "downstream": ["库存台账(调整)"], "keywords": "盘点 盘盈 盘亏 stock taking"},
    {"name": "库存台账", "module": "仓储", "table": "mes_wm_material_stock", "doc": "物料×仓库×库区×库位×批次×供应商六元组，数量/冻结/占用/在途四量", "upstream": ["全部入库单"], "downstream": ["全部出库单", "事务流水"], "keywords": "库存 台账 stock 可用量"},
    {"name": "批次", "module": "仓储", "table": "mes_wm_batch", "doc": "关联物料/工单/供应商/客户/质量状态；SN 码含批次 uuid；条码支持18种业务对象", "upstream": ["入库单据"], "downstream": ["库存台账"], "keywords": "批次 batch SN 条码 追溯"},
    {"name": "IQC来料检验", "module": "质量", "table": "mes_qc_iqc", "doc": "到货通知/外协入库触发，草稿0→完成4，结论回写来源单据", "upstream": ["到货通知", "外协入库"], "downstream": ["采购入库", "供应商退货", "NCR"], "keywords": "IQC 来料检验"},
    {"name": "IPQC过程检验", "module": "质量", "table": "mes_qc_ipqc", "doc": "报工质检工序产出行触发，完成回调推进报工与产出入库；表头=来源单据(只读)+产品物料(MDM,必填)+批号(必填)+数量+检验信息，已去掉生产订单/工位/生产任务/工序", "upstream": ["报工"], "downstream": ["产出入库", "NCR"], "keywords": "IPQC 过程检验 巡检 批号"},
    {"name": "OQC出货检验", "module": "质量", "table": "mes_qc_oqc", "doc": "销售出库提交触发，草稿0→完成4；检测结果按产品等级判定(1型/2型/废品，必填)，1型/2型判行合格并推进出库单待拣货，废品判行不合格并取消销售出库单；发货数量/出货日期可空", "upstream": ["销售出库单"], "downstream": ["销售出库单(推进或取消)"], "keywords": "OQC 出货检验 出厂检验 1型 2型 废品"},
    {"name": "RQC退货检验", "module": "质量", "table": "mes_qc_rqc", "doc": "生产退料/销售退货/售后退货触发，结论回调售后；四类检验单均支持采样地点/证书编号/执行标准表头与复核·审核人，并可打印检验报告", "upstream": ["退料", "退货"], "downstream": ["退货入库", "售后回调", "检验报告打印"], "keywords": "RQC 退货检验"},
    {"name": "IQC来料检验", "module": "质量", "table": "mes_qc_iqc", "doc": "到货通知/外协入库触发，草稿0→完成4，结论回写来源单据；另支持 Excel 批量导入（物料按编码、供应商按名称精确匹配，供应商/供应商批次/来料日期参与去重），导入单直接落待检验、不回写来源单据", "upstream": ["到货通知", "外协入库"], "downstream": ["采购入库", "供应商退货", "NCR", "检测结果台账"], "keywords": "IQC 来料检验 导入"},
    {"name": "IPQC过程检验", "module": "质量", "table": "mes_qc_ipqc", "doc": "报工质检工序产出行触发，完成回调推进报工与产出入库；表头=来源单据(只读)+产品物料(MDM,必填)+批号(必填)+数量+检验信息，已去掉生产订单/工位/生产任务/工序；另支持 Excel 批量导入（物料编码+批号+检验类型+检测日期参与去重，工废+料废+其他废品 不得超过不合格品数量），导入单直接落待检验", "upstream": ["报工"], "downstream": ["产出入库", "NCR", "检测结果台账"], "keywords": "IPQC 过程检验 巡检 批号 导入"},
    {"name": "OQC出货检验", "module": "质量", "table": "mes_qc_oqc", "doc": "销售出库提交触发，草稿0→完成4；检测结果按产品等级判定(1型/2型/废品，必填)，1型/2型判行合格并推进出库单待拣货，废品判行不合格并取消销售出库单；发货数量/出货日期可空；另支持 Excel 批量导入（物料按编码、客户按名称匹配并校验在本人数据权限内，物料+客户+批次号+出货日期参与去重），导入单直接落待检验、不推进或取消销售出库单", "upstream": ["销售出库单"], "downstream": ["销售出库单(推进或取消)", "检测结果台账"], "keywords": "OQC 出货检验 出厂检验 1型 2型 废品 导入"},
    {"name": "RQC退货检验", "module": "质量", "table": "mes_qc_rqc", "doc": "生产退料/销售退货/售后退货触发，结论回调售后；四类检验单均支持采样地点/证书编号/执行标准表头与复核·审核人，并可打印检验报告", "upstream": ["退料", "退货"], "downstream": ["退货入库", "售后回调", "检验报告打印", "检测结果台账"], "keywords": "RQC 退货检验"},
    {"name": "检测结果台账", "module": "质量", "table": "mes_qc_iqc / mes_qc_ipqc / mes_qc_oqc / mes_qc_rqc (UNION ALL)", "doc": "四类检验单统一查询视图，一行一个检测项(检验单未录检测项时该组字段留空但保留行、不漏单)；判定依据由标准值与上下限拼装，筛选与列表共用同一套条件并可导出 Excel，只读页不提供增删改", "upstream": ["IQC来料检验", "IPQC过程检验", "OQC出货检验", "RQC退货检验"], "downstream": ["台账导出"], "keywords": "台账 检测结果 ledger 统一查询 导出"},
    {"name": "检验指标", "module": "质量", "table": "mes_qc_indicator", "doc": "支持两级分组树(itemType录入/分组+parentId)、公式文本展示、单位文本、同级排序；分组项不录值；有子项禁删；同层级名称可重复", "upstream": [], "downstream": ["质检方案", "检验报告打印"], "keywords": "检验指标 indicator 分组 公式 化工"},
    {"name": "检验报告打印", "module": "质量", "table": "mes_qc_indicator_result_detail", "doc": "化工报告范式：平行测量批次(measure_no)+分组矩阵+公式列+签字区；/mes/qc/indicator-result/report 聚合，前端浏览器打印", "upstream": ["IQC来料检验", "IPQC过程检验", "OQC出货检验", "RQC退货检验", "检验指标"], "downstream": [], "keywords": "打印 报告 测量批次 签字 正丁醇 GB/T6027"},
    {"name": "NCR不合格品", "module": "质量", "table": "mes_qc_ncr", "doc": "待评审0→已评审6→已处置7→已关闭8，处置:退货/报废/返工/让步接收/降级", "upstream": ["IQC/IPQC/OQC/RQC"], "downstream": ["退货/报废/返工(台账)"], "keywords": "NCR 不合格 处置 特采 报废"},
@@ -488,14 +489,14 @@
<script type="application/json" id="data-flows">{
  "flows": [
    {"id": "sales", "name": "销售流程", "mermaid": "mermaid/02-sales-flow.mmd", "color": "#4f9cff",
     "summary": "线索转化客户 → 商机推进 → 报价(可AI识别) → 合同 BPM 审批 → 生成 ERP 销售订单并审批 → 需生产行自动建 MPS → 发货通知 → 销售出库(OQC)回写 → 开票(BPM) → 回款(先开票校验)。",
     "summary": "线索转化客户 → 商机推进 → 报价(可AI识别) → 合同 BPM 审批 → 生成 ERP 销售订单并审批 → 需生产行自动建 MPS → 发货通知 → 销售出库(OQC)回写 → 开票(BPM审批·支持Excel批量导入) → 回款(先开票校验)。",
     "steps": [
       {"stage": "获客", "action": "线索转化客户、建联系人、立项商机（商机状态组/阶段选填，不选也能建单）", "roles": ["销售内勤"]},
       {"stage": "报价", "action": "商机赢单后建报价单(AI OCR 预填)，转合同", "roles": ["销售内勤"]},
       {"stage": "签约", "action": "合同提交 BPM 审批(可选流程定义)，通过=20", "roles": ["销售", "审批人"]},
       {"stage": "接单", "action": "合同一键生成销售订单(XSDD)，销售订单再走 BPM；审批通过自动为 needProduction 明细创建 MPS", "roles": ["销售", "计划员"]},
       {"stage": "交付", "action": "发货通知审核(占用)→ 销售出库 OQC → 发运 → 出库回写部分/全部出库", "roles": ["仓管", "质检"]},
       {"stage": "回款", "action": "开票 BPM(累计≤合同额) → 回款强制先开票(累计≤合同剩余与开票剩余)", "roles": ["财务", "销售"]}]},
       {"stage": "回款", "action": "开票 BPM(累计≤合同额；支持 Excel 批量导入，同一合同下同发票号码或同「金额+抬头+开票日期」的行判为重复并拒收，逐行回显失败原因) → 回款强制先开票(累计≤合同剩余与开票剩余)", "roles": ["财务", "销售"]}]},
    {"id": "purchase", "name": "采购流程", "mermaid": "mermaid/03-purchase-flow.mmd", "color": "#5fc79e",
     "summary": "SRM 准入/定标供源 → 采购申请 BPM → 采购订单 BPM → 确认收货生成 MES 到货通知 → IQC(合格/特采入库·退货/报废) → 采购入库回写订单与申请 → 来票(AI OCR) → 付款单 BPM。",
     "steps": [
@@ -516,13 +517,15 @@
       {"stage": "联动", "action": "审批通过按工序标记: 倒冲→自动物料消耗扣线边库(允许负库存)；质检→产出待检行等 IPQC；关键非检→直接产出入库", "roles": ["系统自动"]},
       {"stage": "完工", "action": "仅末道工序回写工单已生产数量，达标自动完成；MPS 累计判断完成并发事件给销售订单", "roles": ["系统自动"]}]},
    {"id": "quality", "name": "质量流程", "mermaid": "mermaid/05-quality-flow.mmd", "color": "#e06c6c",
     "summary": "四道检验闸口(IQC/IPQC/OQC/RQC，二态 0→4) + 判定四果(合格/特采/退货/报废；OQC 改按产品等级 1型/2型/废品，仅废品判不合格) + NCR 评审处置关闭；AI 提供判定建议；NCR 当前仅台账不触发返工单。支持化工报告范式：分组指标树+公式文本+平行测量批次+采样表头+签字区，浏览器打印检验报告；并可导出产品检验单 Word（纸质检验单版式，判定结论带出检验结果、检验·复核·批准签字带出检测人·复核人·审核人姓名、质检章留空盖章，Word 打印）。",
     "summary": "四道检验闸口(IQC/IPQC/OQC/RQC，二态 0→4) + 判定四果(合格/特采/退货/报废；OQC 改按产品等级 1型/2型/废品，仅废品判不合格) + NCR 评审处置关闭；AI 提供判定建议；NCR 当前仅台账不触发返工单。支持化工报告范式：分组指标树+公式文本+平行测量批次+采样表头+签字区，浏览器打印检验报告；并可导出产品检验单 Word（纸质检验单版式，判定结论带出检验结果、检验·复核·批准签字带出检测人·复核人·审核人姓名、质检章留空盖章，Word 打印）。另支持四类检验单 Excel 批量导入（IQC/IPQC/OQC 各一个入口，逐行解析、失败行互不影响，导入单一律「待检验」、不走来源单据回写、不生成 NCR）与「检测结果台账」（跨 IQC/IPQC/OQC/RQC 统一查询与导出，一行一个检测项）。",
     "steps": [
       {"stage": "来料", "action": "到货通知/外协入库→IQC，结论回写推进待入库或触发退货", "roles": ["IQC 质检员"]},
       {"stage": "过程", "action": "报工质检工序产出行→IPQC，合格拆行入库、不合格生成 NCR", "roles": ["IPQC 质检员"]},
       {"stage": "出货", "action": "销售出库提交→OQC(检测结果按产品等级 1型/2型/废品必填，1型/2型判行合格，废品判行不合格)，全部合格后出库单进入待拣货，出现废品则整单取消", "roles": ["OQC 质检员"]},
       {"stage": "退货", "action": "退料/销售退货/售后退货→RQC，结论回调单据与售后", "roles": ["RQC 质检员"]},
       {"stage": "报告", "action": "检验结果按分组树+测量批次录入，/indicator-result/report 聚合后前端打印检验报告(含采样地点/证书编号/执行标准/判定结论·质检专用章/复核·审核签字区；判定结论带出检验结果·质检章留空盖章·无平行测量时列头称测量值)；/indicator-result/export-product-word 导出产品检验单Word(无技术指标列·判定结论带出检验结果·检验·复核·批准签字带出检测人/复核人/审核人姓名·质检章留空盖章·平行测量顿号合并·下载后Word打印；质检单详情检测结果Tab可按样品查看只读检测值明细)", "roles": ["质检员", "复核人", "审核人"]},
       {"stage": "导入", "action": "IQC/IPQC/OQC 三个列表各提供「批量导入」入口(位于新增与导出之间)：下载模板→上传 xls/xlsx→逐行解析，物料按编码、供应商/客户按名称精确匹配，质检方案留空按「物料+检验类型」自动匹配，合格品+不合格品必须等于检测数量(留空取两者之和)；失败行返回行号与原因且不影响成功行，导入单直接落「待检验」，不走来源单据回写也不生成 NCR", "roles": ["质检员"]},
       {"stage": "台账", "action": "检测结果台账：对 mes_qc_iqc / mes_qc_ipqc / mes_qc_oqc / mes_qc_rqc 做 UNION ALL，一行一个检测项(检验单未录检测项时该组字段留空但保留行、不漏单)，判定依据由标准值与上下限拼装(如 10~20、≤20)；筛选与列表共用同一套条件并可导出 Excel；只读页，不提供增删改", "roles": ["质检员", "质量工程师"]},
       {"stage": "不合格", "action": "NCR: 待评审→评审→处置(退货/报废/返工/让步接收/降级)→关闭", "roles": ["质量工程师"]}]},
    {"id": "warehouse", "name": "仓储流程", "mermaid": "mermaid/06-warehouse-flow.mmd", "color": "#7e6bd6",
     "summary": "15 类单据驱动库存台账(六元组、四量)变动，全部经事务流水留痕；支持调拨在途、盘点调整、批次/SN 追溯、库存占用与四级冻结、线边虚拟库负库存；对外 WmsStockApi 供 ERP 收发。",
@@ -737,6 +740,25 @@
  T2[报工质检工序通过后产出行] --> A2[IPQC 过程检验·草稿0→完成4]
  T3[销售出库单提交] --> A3[OQC 出货检验·草稿0→完成4]
  T4[生产退料单 或 销售退货单 或 售后退货] --> A4[RQC 退货检验·草稿0→完成4]
  T5[Excel 批量导入·IQC IPQC OQC 三列表各一个入口·按钮在新增与导出之间] --> IMP{导入闸门·逐行解析·失败行互不影响}
  IMP -->|编号留空自动生成·编号重复或同一批数据重复则拒该行| A1
  IMP --> A2
  IMP --> A3
  IMP -.->|同一批数据不可重复导入·IQC 物料+供应商+供应商批次+来料日期 / IPQC 物料+批号+检验类型+检测日期 / OQC 物料+客户+批次号+出货日期·文件内重复行与库内已有单都拒并回显双方实际值| IMPDUP[导入去重·按业务键]
  IMP -.->|物料按编码 供应商与客户按名称 精确匹配·方案留空按物料+检验类型自动匹配| IMPR[引用解析·QC_NO_TEMPLATE 补物料与可执行动作]
  IMP -.->|合格+不合格 必须等于 检测或接收数量·不等等则拒该行| IMPQ[数量关系校验·两侧实际值都回显]
  IMP -.->|IPQC 工废+料废+其他废品 不得超过不合格品数量·三列留空按0| IMPQ
  IMP -.->|OQC 填客户时校验在本人数据权限内·留空则不属于任何客户·不受遮挡| IMPP[数据权限前置校验]
  IMP -.->|检测人员留空=当前登录用户·IQC 检测与来料日期、OQC 检测日期必填·IPQC 检测日期与 OQC 出货日期可留空| IMPD[人员与日期]
  IMP --> IMR[响应 createList 成功编号 + failureList 行号→原因·整行空自动跳过]
  IMR -.->|导入单一律待检验0·不走来源单据回写·不生成NCR| IMRNOTE[与触发式建单的区别·finish 才判定与回写]
  A1 -->|台账 UNION ALL| LG[检测结果台账·跨 IQC IPQC OQC RQC 统一查询与导出]
  A2 -->|台账 UNION ALL| LG
  A3 -->|台账 UNION ALL| LG
  A4 -->|台账 UNION ALL| LG
  LG -->|一行一个检测项·未录结果也保留一行不漏单| LGF[批次号按类型取来源·IQC 供应商批次号 / IPQC OQC RQC 批号]
  LG -->|判定依据由标准值与上下限拼装| LGB[同一套筛选条件导出 Excel 台账·只读页不提供增删改]
  LG -->|权限码| LGPERM["mes:qc-inspection-ledger:query 查询·:export 导出·菜单挂质量管理目录"]
  A1 --> R{检验判定 MesQcCheckResultEnum}
  A2 --> R
  A4 --> R