| docs/project-business/data/business.json | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| docs/project-business/data/flows.json | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| docs/project-business/data/modules.json | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| docs/project-business/data/objects.json | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| docs/project-business/mermaid/02-sales-flow.mmd | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| docs/project-business/mermaid/04-production-flow.mmd | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| docs/project-business/mermaid/08-module-relation.mmd | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/controller/admin/sale/ErpSaleOrderController.java | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/service/sale/ErpSaleOrderService.java | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/service/sale/ErpSaleOrderServiceImpl.java | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 |
docs/project-business/data/business.json
@@ -43,7 +43,7 @@ ], [ "销售如何影响生产", "销售订单审批通过后,需生产明细自动创建 MES 主生产计划(MPS),MPS 下发驱动工单与任务" "销售订单提交生效后,需生产明细自动创建 MES 主生产计划(MPS),MPS 下发驱动工单与任务" ], [ "采购如何影响库存", docs/project-business/data/flows.json
@@ -5,7 +5,7 @@ "name": "销售流程", "mermaid": "mermaid/02-sales-flow.mmd", "color": "#4f9cff", "summary": "线索转化客户 → 商机推进 → 报价(可AI识别) → 合同 BPM 审批 → 生成 ERP 销售订单(合同转来的订单提交免审批直接生效,提交后不可修改;台账含销售类型、手工合同号、产品编号与生产数量) → 需生产行自动建 MPS → 发货通知(物流公司/快递费/开票状态,审批默认物流) → 发货台账按产品平铺 → 销售出库提交(需检验行转待检测) → 独立录入 OQC 后按物料+盘号+数量关联回写 → 拣货发运 → 开票(BPM) → 录入发票与款项节点 → 回款(先开票校验,创建为未提交,显式提交 BPM 协同审批,审批通过才回写回款计划);发货单/成品出库单可导出带电子章的 Word 供手填签字归档;客户档案支持多收货地址。", "summary": "线索转化客户 → 商机推进 → 报价(可AI识别) → 合同 BPM 审批 → 生成 ERP 销售订单(提交即生效、不走 BPM,提交后不可修改;台账含销售类型、手工合同号、产品编号与生产数量) → 需生产行自动建 MPS → 发货通知(物流公司/快递费/开票状态,审批默认物流) → 发货台账按产品平铺 → 销售出库提交(需检验行转待检测) → 独立录入 OQC 后按物料+盘号+数量关联回写 → 拣货发运 → 开票(BPM) → 录入发票与款项节点 → 回款(先开票校验,创建为未提交,显式提交 BPM 协同审批,审批通过才回写回款计划);发货单/成品出库单可导出带电子章的 Word 供手填签字归档;客户档案支持多收货地址。", "steps": [ { "stage": "获客", @@ -38,7 +38,7 @@ }, { "stage": "接单", "action": "合同一键生成销售订单(XSDD)后在销售管理提交:合同转来的订单免 BPM 直接生效(20),提交后不可修改;手工/导入订单仍走 BPM。生效后自动为 needProduction 明细创建 MPS 流转生产,无需生产的订单可直接生成仓储发货通知单", "action": "销售订单(XSDD)提交即生效(20)、不再走 BPM 审批,提交后不可修改(手工/导入/合同转来订单一致)。生效后自动为 needProduction 明细创建 MPS 流转生产,无需生产的订单可直接生成仓储发货通知单", "roles": [ "销售", "计划员" docs/project-business/data/modules.json
@@ -164,7 +164,7 @@ "采购来票(绑定采购订单+MES采购入库单·双层剩余额度校验)", "付款单(必须关联来票·BPM)", "供应商往来(订单/来票/付款三流水·左右展示开票金额)", "销售订单(BPM·审批通过自动建MPS)", "销售订单(提交即生效·自动建MPS)", "出库状态回写", "收款单(关联CRM客户)", "结算账户", docs/project-business/data/objects.json
@@ -388,7 +388,7 @@ "name": "销售订单", "module": "进销存", "table": "erp_sale_order", "doc": "XSDD编号,BPM 审批,需生产行自动建 MPS,出库状态:未0已预留1部分2全部3,生产完成事件回写", "doc": "XSDD编号,提交即生效(不走 BPM),需生产行自动建 MPS,出库状态:未0已预留1部分2全部3,生产完成事件回写", "upstream": [ "合同" ], docs/project-business/mermaid/02-sales-flow.mmd
@@ -13,8 +13,7 @@ D -->|直接建合同| G Q[合同 Excel 导入·一合同多产品明细行] -->|批量建草稿合同| G G -->|BPM审批通过20| H[生成 ERP 销售订单 XSDD] H -->|手工/导入订单·提交BPM| I[销售订单·合同转来订单提交免BPM直通20·提交后不可修改] H -->|合同转来订单·提交免审批·直接生效| I H -->|手工/导入/合同转来订单·提交即生效·不走BPM| I[销售订单·提交后直接20·生成MPS·不可修改] H -.->|销售台账展示| H1[销售类型 1内销2外销3样品4其他·合同号可手工填·产品编号·生产数量] I -->|明细需生产·自动创建| J[MES 主生产计划 MPS] I --> K[发货通知单·物流公司/快递费/开票状态·审批流默认物流审批] docs/project-business/mermaid/04-production-flow.mmd
@@ -1,5 +1,5 @@ flowchart TD P0[销售订单明细 needProduction=1] -->|审批通过自动创建| P1[MPS 主生产计划·草稿0→已下发1] P0[销售订单明细 needProduction=1] -->|销售订单提交生效后自动创建| P1[MPS 主生产计划·草稿0→已下发1] P1 -->|下发或合并下发·仅创建人或超管可操作| P2[生产工单·草稿0→已确认1] P2 -->|按工艺路线工序自动生成| P3[生产任务×N·预备0→生产中1→部分完成2→完成4·可暂停9] P3 --> P4[生产领料 或 线边虚拟库备料] docs/project-business/mermaid/08-module-relation.mmd
@@ -6,7 +6,7 @@ SRM[SRM 供应商档案·询价比价] -->|询价确认生成采购订单草稿| ERP ERP -.->|供应商往来读取供应商名称| SRM ERP -->|确认收货生成到货通知| MES ERP -->|销售订单审批生成MPS| MES ERP -->|销售订单提交生效生成MPS| MES MES -->|入库出库回写单据进度| ERP MES -->|ProductionFinishedEvent| ERP MES -->|MesProFeedbackWageApi·按报工人汇总核算周期内已审批报工工资| HRM yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/controller/admin/sale/ErpSaleOrderController.java
@@ -99,7 +99,7 @@ } @PostMapping("/submit") @Operation(summary = "提交销售订单(合同转来的订单免审批直接生效,其余走协同办公审批)") @Operation(summary = "提交销售订单(提交即生效,不再走协同办公审批)") @PreAuthorize("@ss.hasPermission('erp:sale-order:update-status')") public CommonResult<Boolean> submitSaleOrder(@RequestParam("id") Long id, @RequestParam("processDefinitionKey") String processDefinitionKey) { yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/service/sale/ErpSaleOrderService.java
@@ -45,13 +45,13 @@ void updateSaleOrder(@Valid ErpSaleOrderSaveReqVO updateReqVO); /** * 提交销售订单审批(协同办公 BPM) * 提交销售订单(不再走协同办公 BPM 审批) * * 未提交或已驳回的销售订单可提交,提交后进入协同办公审批流程 * 未提交或已驳回的销售订单可提交,提交后直接生效并生成 MPS * * @param id 编号 * @param processDefinitionKey 流程定义的标识 * @param userId 提交人编号 * @param processDefinitionKey 流程定义的标识(已废弃,保留参数兼容旧前端/接口调用) * @param userId 提交人编号(已废弃,保留参数兼容旧前端/接口调用) */ void submitSaleOrder(Long id, String processDefinitionKey, Long userId); yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/service/sale/ErpSaleOrderServiceImpl.java
@@ -8,8 +8,6 @@ import cn.iocoder.yudao.framework.common.util.number.MoneyUtils; import cn.iocoder.yudao.framework.common.util.object.BeanUtils; import cn.iocoder.yudao.framework.operatelog.core.util.OperateLogUtils; import cn.iocoder.yudao.module.bpm.api.task.BpmProcessInstanceApi; import cn.iocoder.yudao.module.bpm.api.task.dto.BpmProcessInstanceCreateReqDTO; import cn.iocoder.yudao.module.bpm.dal.dataobject.definition.BpmCategoryDO; import cn.iocoder.yudao.module.bpm.dal.dataobject.definition.BpmProcessDefinitionInfoDO; import cn.iocoder.yudao.module.bpm.enums.task.BpmTaskStatusEnum; @@ -114,8 +112,6 @@ @Resource private StorageAttachmentApi storageAttachmentApi; @Resource private BpmProcessInstanceApi processInstanceApi; @Resource private BpmCategoryService bpmCategoryService; @Resource @@ -418,44 +414,18 @@ throw exception(SALE_ORDER_SUBMIT_FAIL_ITEM_EMPTY, saleOrder.getNo()); } // 4. 合同转来的销售订单(contractId 非空)无需再走审批: // 合同在 CRM 已审批通过,订单内容由合同带入,提交即生效。 // 4. 销售订单不走审批流程:业务校验通过后直接生效(不再创建 BPM 流程实例) // 生效后:需要生产的明细自动创建 MPS 流转生产模块;无需生产的明细可直接在仓储生成发货通知单。 // 历史合同生成的订单明细可能未维护“是否需要生产”,按系统默认(需要生产)补齐后再生效。 if (saleOrder.getContractId() != null) { items.stream() .filter(item -> item.getNeedProduction() == null) .forEach(item -> saleOrderItemMapper.updateById( new ErpSaleOrderItemDO().setId(item.getId()).setNeedProduction(1))); saleOrderMapper.updateById(new ErpSaleOrderDO() .setId(id) .setStatus(ErpAuditStatus.APPROVING.getStatus()) .setProcessInstanceId("")); updateSaleOrderAuditStatus(id, cn.iocoder.yudao.module.bpm.enums.task.BpmProcessInstanceStatusEnum.APPROVE.getStatus()); return; } // 5. 创建 BPM 流程实例(审批在协同办公完成) // 全局免审批:业务校验通过后直接执行审批通过逻辑,无需流程模型。 if (processInstanceApi.isGlobalAutoApprove()) { saleOrderMapper.updateById(new ErpSaleOrderDO() .setId(id) .setStatus(ErpAuditStatus.APPROVING.getStatus()) .setProcessInstanceId("")); updateSaleOrderAuditStatus(id, cn.iocoder.yudao.module.bpm.enums.task.BpmProcessInstanceStatusEnum.APPROVE.getStatus()); return; } String processInstanceId = processInstanceApi.createProcessInstance(userId, new BpmProcessInstanceCreateReqDTO() .setProcessDefinitionKey(processDefinitionKey) .setBusinessKey(String.valueOf(id))); // 6. 更新销售订单状态为审批中,记录流程实例编号 // 历史订单/接口调用可能未维护“是否需要生产”,按系统默认(需要生产)补齐后再生效。 items.stream() .filter(item -> item.getNeedProduction() == null) .forEach(item -> saleOrderItemMapper.updateById( new ErpSaleOrderItemDO().setId(item.getId()).setNeedProduction(1))); saleOrderMapper.updateById(new ErpSaleOrderDO() .setId(id) .setStatus(ErpAuditStatus.APPROVING.getStatus()) .setProcessInstanceId(processInstanceId)); .setProcessInstanceId("")); updateSaleOrderAuditStatus(id, cn.iocoder.yudao.module.bpm.enums.task.BpmProcessInstanceStatusEnum.APPROVE.getStatus()); } @Override