活码:让印出去的码还能改内容、收表单、推状态

码印出去就改不了了,这是大部分工厂对二维码的印象。活码不是——它指向一个可编辑的页面,内容随时能换。

学完能做到 跑通「建模板 → 绑表单 → 生码 → 打印 → 状态自动推进 → 召回」这条完整链路,让客户扫码看到的不只是一个编号。

开始之前

  • 专业版起(一物一码是独立模块,起步版不含)
  • 工序与报工已稳定运行
  • 已执行过基础篇的一物一码上线

操作步骤

先想清楚客户扫码要看到什么

「一物一码 → 页面模板」新建。五个组件可按需组合:文本(产品介绍、注意事项)、图片(产品图、安装示意)、PDF(说明书、合格证、检测报告)、数据绑定(产品名、规格、批次、生产日期,自动填充)、表单入口(售后报修、安装登记)。先只有文本和数据绑定也能上线,别一次做全。

设计表单,决定提交后码往哪个状态走

「一物一码 → 表单设计」新建,字段按实际问的来。关键配置是「提交后状态」:安装登记表单配成「入库」,售后报修配成「维修」。这样客户一提交,码状态自动变化,厂内不用有人再去手点。只有需要人工核实的表单才配审批。

配流转规则,把不可接受的路径堵掉

「一物一码 → 流转规则」。系统内置 8 个状态(待生产、生产中、待质检、合格、入库、出库、维修、报废召回),默认规则是终态不倒退、质检判不良可打回维修。如果业务上有一条绝对不能走的路(比如「出库」不能直接回「生产中」),在这里显式禁用。注意:一旦配置就是硬规则,自动流转和人工改状态都会被拦。

工单类型绑定,让生码少选几次

「一物一码 → 工单类型绑定」把工单类型和模板、表单绑起来。绑定后生码自动带默认模板,不用每次手选——手选就会选错,选错就是客户扫出来看到别人的产品介绍。

生码:单品码还是批次码

「一物一码 → 码管理」批量生成。要追到单件选单品码,同批质量一致选批次码。已有件次记录的走「件次补码」,给每件补挂一个码;外部已有码号清单的走「导入」。码号规则是 IQ 加租户号加序号,全租户唯一。

打印标签

码管理里选码打印,系统服务端渲染标签并支持导出 PDF 批量打。打印次数会累计进履历——重复打印不被拦,但次数看得见,这是防「标签被偷偷多印」的取证手段。

让状态自己动起来

「流转规则」里的自动流转默认开启。报工合格且后面还有非质检工序 → 生产中;只剩质检工序 → 待质检;质检或末道工序 → 合格;判不良 → 维修;成品入库 → 入库;挂发货单发货 → 出库。质检工序靠工序编码或名称识别(含 QC、INSPECT、IPQC、OQC、FAI,或名称含质检、检验、巡检),所以工序命名别乱写。

出问题时一键召回

「一物一码 → 单品档案」找到码,点召回。码状态推到「报废召回」,客户立刻扫码,页面显示的是红色警示「该产品已召回,请勿使用」,不是笼统的查询失败。召回的码不重复处理,作废的码不能再召回。返工完成后走「返工放行」把码放回生产流程。

给客户一个轻量的验真入口

客户只想确认真假,不需要看完整履历。验真入口只回答三件事:是不是本厂发的、还能不能用、有没有被召回。故意不返回完整工艺流程,避免被竞争对手批量爬走产品结构。

配周期巡检,把定期要看的物件管起来

「一物一码 → 周期巡检」建计划(周期、下次到期)。到期生成任务,员工用手机扫码执行。到期与逾期都能推到飞书、钉钉、企微,适合消防器材、量具、样品这类「每隔一段时间要看一眼」的东西。

接 Webhook,把事件推给别的系统

「一物一码 → Webhook 回调」可订阅 9 类事件:扫码、表单提交、状态变更、码作废、审批通过、驳回、退回、巡检到期、巡检逾期。投递失败可在「Webhook 投递日志」查原因,签名与重试机制与标准 Webhook 一致。

容易踩的坑

码印出去了才发现模板里产品名写错,要重印吗?
不用。改模板即时生效,已印的码打开就是新内容——这正是活码相对「固定内容二维码」的核心差别。所以模板里的内容宁可先少写,别一次写死一堆。
客户扫码提示「该码已失效」怎么办?
去「扫码打印日志」按码号搜,看结果是作废还是召回。作废的码不能恢复,只能重新生码;召回的码如果确认没问题,可以走返工放行回到生产流程。
报工了但码状态还是「待生产」?
三个可能:自动流转开关被关了;工序没被识别成质检工序,导致末道工序判定错误;报工还没审核通过。按这个顺序查。
状态改不动,提示不允许流转?
去「流转规则」看这条边是否被显式禁用。租户配置是硬规则,会同时拦住自动流转和人工改状态。用「重置」可以恢复默认规则。
车间集中扫同一个码,有人报错?
公开接口对单个码有每分钟 5 次的限制,这是防刷设计。正常作业应该各扫各自任务码上的码,不要让一个班组围着一个码扫。
客户说表单提交要重新扫码?
扫码页签发的提交凭证只有 30 分钟且与码号绑定。页面放太久或换了码提交都会失败,重新扫一下即可。这是防止拿到链接后绕过扫码灌数据。
客户上传的照片在页面上看不到?
只有随表单提交的附件才会对外可见,单独上传没提交的不会暴露(防越权)。所以让客户在表单里一次性传完,别先传后填。

接着看

还有别的问题?

先看常见问题,或者在系统内提工单,我们会回。