黑湖小工单 系统配置常见问题汇总

分为基础档案导入、工艺路线 & BOM 配置、工单生产参数、报工参数、库存扣料配置、权限角色、自定义字段、打印助手配置、审批流程、ERP 对接配置十大模块，适合实施、售前答疑、客户排查。

一、基础档案导入配置（物料 / 产品 / 工序 / 员工 / 仓库）

1. Excel 导入失败，部分行报错

• 编码重复、编码为空；名称带特殊符号、换行空格；引用的工序 / 仓库 / 不良项在系统不存在；数字列填文本；超出系统数据条数上限。
• 模板版本不对，使用旧版导入模板；导入后看导入日志，下载错误行修改重导。

1. 物料导入后，BOM 选不到该物料

• 物料档案状态为【禁用】；物料类型选错；过滤条件筛选；多组织隔离。

1. 员工账号创建后，手机登录不了

• 未绑定手机号；角色未分配；账号状态禁用；手机号重复；企业代码输入错误。

1. 仓库建好，领料时看不到仓库

• 账号角色缺少该仓库权限；工单领料仓库固定；仓库状态停用。

高频踩坑：物料编码是唯一主键，名称可以重复，编码不能重复。

二、工艺路线 & 工序配置

1. 工艺路线绑定工单后，报工任务不显示工序

• 工艺路线内工序没有启用；工序维护了【报工权限人员】，操作人不在权限列表，就算管理员也看不到该工序报工任务黑湖小工单。

1. 工序设置工价，报工没有生成计件工资

• 工序工价为空；工艺路线引用的不是这套带工价的工序；报工类型选错；工单没有绑定正确工艺路线；员工没有分配计件规则。

1. 工单已经报工，修改工艺路线，历史报工不更新

已经产生报工记录的工单，修改工艺路线不会回溯修改历史报工，只对后续新报工生效黑湖小工单。

1. 报工配比设置错误，工序计划数量不对报工数配比默认 1；多半成品场景配比填错，工序计划数量成倍放大 / 缩小黑湖小工单。
2. 不良品选不到对应原因工序没有勾选对应不良品项；不良品档案状态停用。

三、BOM 物料配置

1. BOM 保存报错，无法建立多级 BOM

• 子件编码不存在；循环 BOM（A 的子件是 A 自己）；损耗率填负数；BOM 版本冲突。

1. 工单引用 BOM 之后，修改 BOM，旧工单不更新物料

工单一旦创建，会快照一份 BOM；后台修改 BOM 不会自动回改已存在工单，需要工单内重新选择 BOM。

1. BOM 子件 “不参与报工扣料” 配置不生效已经生成工单的 BOM，修改该选项，不会改变已有工单行为，需要重建工单。

四、工单全局参数配置（系统设置‑生产参数）

1. 报工自动扣料开启但是不扣料核对：①开启总开关；②BOM 子件允许报工扣料；③工单绑定 BOM；④报工工序为 BOM 消耗工序；⑤不是手工领料模式。

总开关开启，单颗物料依然可以在 BOM 子件关闭扣料。

1. 是否允许超 BOM 领料开关不生效开关修改后，已经创建的工单沿用旧参数，新工单才读取新配置。
2. 不良品是否扣料参数系统参数控制不良品是否同步扣减物料；修改只针对新报工，历史报工不会重算。
3. 是否允许负库存关闭后，库存不足时报工扣料、领料直接拦截；开启允许账面库存为负数。

五、报工相关配置问题

1. 手机端报工字段和 PC 不一样，部分字段看不到移动端表单配置隐藏字段；自定义字段未勾选移动端显示。
2. 报工校验规则不生效校验规则未启用；公式语法错误；字段变量写错；只对新报工生效，历史数据不校验黑湖小工单。
3. 工人只能看到自己的任务，看不到全部工单角色权限：任务查看范围，分为【仅本人任务】/ 全部任务；很多客户配置完管理员能看，普通工人看不到其他工单。
4. 报工二维码扫出来不是对应工单工单二维码是工单维度；流转卡二维码是工序任务维度；打印错二维码；工单重复编码。

六、角色 & 权限配置高频坑

1. 管理员之外账号，按钮灰色（打印、报工、领料、修改工单）角色权限模块，对应功能按钮没有勾选；数据权限控制仓库、工单范围。

注意：工序报工还有独立的【工序报工权限】，和角色权限两套控制，双重校验黑湖小工单。

1. A 角色配置完，新建账号没有继承权限新建用户需要分配角色；修改角色权限，已经分配该角色的账号自动生效。
2. 能查看单据，但是不能导出报表角色权限单独有【导出】权限开关，查看≠导出。

七、自定义字段配置（产品 / 工单 / 报工 / 物料）

1. 导入 / 保存时报错，自定义字段必填为空把不用的自定义字段取消【必填】；导入模板必须带上必填自定义字段值。
2. 关联字段选编码还是名称产品对象传产品编码；用户对象传用户名；仓库传仓库编码，填错导入直接失败。
3. 自定义字段打印模板不显示打印模板没有添加该自定义字段控件；字段未保存生效。

八、打印助手 & 打印系统配置

1. 打印助手已连接，套打标签 / 流转卡一直转圈浏览器插件拦截 websocket；端口冲突；内网防火墙拦截本地端口；助手版本低。
2. 模板配置纸张尺寸，打印出来还是 A4系统模板尺寸≠Windows 打印机驱动纸张尺寸，两处必须完全一致。
3. 打印助手更换电脑后，旧电脑模板不会同步到新电脑打印模板存在云端；打印助手只是本地代理；只需要登录账号即可；但是本机打印机选择是本地电脑保存。

九、审批流程配置

1. 单据提交后不触发审批审批流未启用；单据类型没有绑定审批流程；提交人是审批人自己，自动跳过审批；单据是草稿状态。
2. 审批完成库存数量不变只有审批通过之后，出入库、调整单才生效；草稿、待审批不参与库存计算。
3. 找不到审批人，收不到审批消息消息通知开关关闭；账号没有分配审批角色；消息推送只在网页 / 小程序，没有短信。

十、ERP 对接 / API 配置

1. 物料、BOM 同步过来，工单扣料成本异常两边物料编码不一致；BOM 层级不同；单位换算系数错误；同步后小工单没有刷新 BOM 快照。
2. 接口同步部分数据丢失需要申请 API 白名单；网络超时重试；字段映射错误；特殊字符导致解析失败。
3. 两边库存对不上明确权责：ERP 管财务账，小工单管车间执行；小工单报工扣料不会自动回写 ERP，需要接口配置推送消耗单据。

十一、网络 & 移动端配置

1. 车间手机报工提交慢、保存转圈 车间 WiFi 信号差；建议工位可用 4G/5G；不要完全依赖车间内网 WiFi黑湖小工单。 2. 微信浏览器打开网页版，套打打印不可用 网页版必须 Edge/Chrome；微信内置浏览器不支持打印助手组件。

系统配置通用排查步骤

1. 区分：系统全局参数、单据快照参数

全局参数修改，已经创建好的工单、单据大多不回溯，只对新单据生效，这是 80% 配置问题根源。 2. 配置完之后，用新建测试工单验证，不要拿旧工单测试新参数。 3. 权限问题：双重校验：【角色功能权限】+【工序报工权限】+【仓库数据权限】三层。 4. 导入报错优先看【导入日志】，下载错误行，看报错文字。