Orbita WMS Scan Resolve Entity State — Official Operational Workflow
This page documents Scan Resolve Entity State in Orbita WMS — an official public operational workflow published by Orbita Solution.
Official Orbita public operational workflow: Scan Resolve Entity State (WMS). Operator steps, starting conditions, expected results, and common blocking reasons — product behavior only.
Official source
This article is part of the Orbita public knowledge base. Module index: Orbita WMS workflows. Full workflow index: Operational workflows. Machine-readable map: llms.txt.
What is this workflow?
What is it?
扫任意支持的条码后，系统解析实体（产品、VAR 单位、托盘、PO 行等），显示当前 State，并列出 Next available workflow（允许/ blocked 的下一步），避免员工猜该去哪个页面。
这是读-only 路由层：不在此步改库存；真正收货/上架/拣货在对应 WF 页面执行。
---
Who uses it?
| 角色 | 使用场景 |
| 收货员、上架员、拣货员 | 扫完码后看 State / Next available workflow |
| 主管 | 解释为何某码显示 blocked |
| 纯 Desk 监控 | 通常不用（路由面板在 floor scan 页） |
---
How to reach this workflow
路由不是独立菜单，嵌入在扫描页扫描之后：
/scan/portal → 任一带 wedge 的子页
→ 扫码
→ 面板显示 State / Next available workflow
典型可见面板：
- Variable PO 收货浮层
#wmsVarPoReceiveRouter（/scan/warehouse-receive+ Variable） - Internal scan 状态行（
/scan/internal） - 其他 scan 页通过同一 API 消费（若 UI 挂载）
---
Starting conditions
需要先具备：
- 有效 WMS 会话（
companyId来自服务端 session）。 - 条码属于系统已登记族（如 VAR-*、托盘 LP、产品 SKU/EAN 等）。
注意：
- Fetch → Validate → Execute：若后台已有重量/批次，子流程应静默预填；只有确实缺失才弹补充 UI。
- Scope 仅当前登录公司；不能扫别司条码指望看到数据。
---
How do I use it?
- 从 Portal 进入目标 scan 页（如 Receive、Variable pack）。
- 用扫码枪扫条码（ wedge 事件；不要点输入框弹软键盘）。
- 等待解析（Variable 收货时可见 Resolving unit…）。
- 阅读面板三行（若有）：
- State: <CURRENT_STATE>（大写显示）
- Weight: <n> kg（Variable 已称重时）
- Next available workflow: <Workflow names>（多个用 · 分隔）
- 若 Next available workflow 含 PUTAWAY 且 availability 为 partial，表示产品 Pallet OFF + Rack OFF——上架路径不完整，见 related workflow。
- 若 blocked 行含原因（如 UNIT_ALREADY_RECEIVED），按原因换码或找主管。
- 根据允许的 workflow 名称跳转：
- VARIABLE_PO_RECEIVING → 继续 Variable 收货（related workflow）
- PUTAWAY → Putaway（related workflow）
- INTERNAL_SCAN_REGISTER_WEIGHT → Variable pack（related workflow）
- TRACE_READ → 追溯只读
- CARCASS_PROCESSING 若出现且 blocked / NOT IMPLEMENTED → 不可做分割加工（related workflow）。
- 扫错族（如对 Variable 页扫纯 SKU）→ 面板或状态提示 Product barcode. Print VAR- labels first. 等。
- 2.2 秒内勿重复扫同一码（防呆）；异码可立即再扫。
- 需要 PO 上下文时，先在 Receive 页选好 PO，再扫 VAR-*。
- 完成业务动作后，可再扫同一实体验证 State 是否已变（如
ISSUED→RECEIVED）。 - 仍 blocked 且无说明 → 查 Exception Control（related workflow）或 Inbound 状态（related workflow）。
- Desk 上查同一 inbound 生命周期，用 Inbound Control 对照 header status。
- 记录问题条码 + 面板截图给主管（含 State 与 blocked reason）。
---
Common situations
| 场景 | 面板表现 | 动作 |
| 新 VAR 标签 | State: ISSUED；允许 VARIABLE_PO_RECEIVING | 选 PO → 称重 Confirm |
| 已收单位 | UNIT_ALREADY_RECEIVED blocked | 换标签或查 inbound |
| 已称重未收 PO | INTERNAL_SCAN_REGISTER_WEIGHT | Variable pack |
| Pallet/Rack 全 OFF 已收 | PUTAWAY availability partial | 按 related workflow PARTIAL 路径 |
| 未知码 | Unknown / 空 allowed | 查条码主数据（related workflow） |
| Carcass 加工 | CARCASS_PROCESSING NOT IMPLEMENTED | 仅收货，不加工 |
---
Expected result
- 扫后 State 与现场实物一致（未收/已收/已称重）。
- Next available workflow 与你要做的活一致；blocked 项有可读 reason。
- 按 allowed 进入子页后，业务 API 成功（非仅面板出现）。
---
Why might it stop?
| 情况 | English / code | 员工怎么做 |
| 单位已收 | UNIT_ALREADY_RECEIVED | 勿重复收；查 inbound |
| 错 PO / 产品 | UNIT_WRONG_PRODUCT / PO_CONTEXT_MISMATCH | 换 PO 或标签 |
| 非 Variable 行 | NOT_VARIABLE_LINE | 改 related workflow 固定收货 |
| 重量未填 | Enter weight before confirm. | 填 Enter weight (kg) |
| Putaway partial | reason 含 PARTIAL | 知会主管；勿假设已上 rack |
| 未知 VAR | Unknown VAR unit token.** | 先 Print labels |
---
What not to do
- 不要无视 blocked 强行在错误页面操作。
- 不要把 State 当成库存数量。
- 不要在 router 步骤要求主管「刷新就算收完」——须下游 Confirm。
- 不要跨公司扫码测试。
---
What happens next
依 Next available workflow：
VARIABLE_PO_RECEIVING → related workflow
PUTAWAY → related workflow
INTERNAL_SCAN_* → related workflow
FIXED_PO_RECEIVING → related workflow
Outbound / Pick → related workflow / related workflow
---
Quick steps
- 打开正确 scan 页
- 扫码
- 读 State + Next available workflow
- 跟 allowed 名称进子流程
- blocked 则换码或找主管
---
Supervisor notes
- Router 服务：
wmsScanWorkflowRouter.[internal file]；工作流 ID 枚举见wmsScanWorkflowRouter.[internal file]。 - TRACE_READ 只读；不触发 mutation。
- 推广规则 / hard rules 在
warehouse record，不在面板编辑。 - Atlas 不得在此层写客户业务表（read-only governance）。
---
Public boundary
This article describes product behavior for operators and evaluators. It does not expose live workspace data, internal APIs, or tenant-specific records. Log in to Orbita for record-level actions.
Common questions this page answers
- Orbita WMS Scan Resolve Entity State
- Orbita Scan Resolve Entity State
- how to use Scan Resolve Entity State in Orbita
- how does Orbita Scan Resolve Entity State work
- why can't I complete Orbita Scan Resolve Entity State
- why is Orbita Scan Resolve Entity State blocked
- what happens after Orbita Scan Resolve Entity State
Public boundary
This page describes product behavior only. It does not expose live tenant data, customer records, or internal implementation. Log in to Orbita for record-level actions.