库存调拨单 PDF 生成：仓库转移、在途状态与签收记录

搜索“库存调拨单 PDF”“Stock Transfer Note”“调拨单模板”时，真正目标通常不是手工导出一份文件，而是建立能够处理真实数据、版本和持续交付的业务文档流程。

库存调拨不是销售，但同样需要证明什么从哪里出发、应到哪里、谁交接、实际收到多少。调拨单连接出库、在途和入库三个状态。

本文面向 多仓零售、制造、连锁门店、第三方仓储和需要在库位或法人内部移动货物的团队，目标是把批准的调拨请求、实际发出、运输和接收数据生成可扫描文件，并对短缺损坏保持差异记录。最终交付仓库调拨单、门店转移单、内部配送清单、在途交接单和调拨签收记录，并让每份文件都能回溯到明确业务记录。

一、为什么这个场景适合模板化 PDF？

请求数量、发出数量和接收数量可能不同。若一张文件在整个过程中被覆盖，就失去每个节点的事实，也无法解释在途损失和批次变化。

二、先定义数据字段与边界

• transfer_number 与 revision：注明权威来源、数据类型和稳定业务含义。
• source_warehouse 与 destination_warehouse：区分必填、可选、空字符串、零值与 null。
• requested_at、dispatched_at 与 received_at：准备正常值和最长合法值验证换行与分页。
• items 数组：明确日期、时区、币种、单位或枚举格式。
• requested_qty、shipped_qty 与 received_qty：定义异常与缺失时的阻断或回退规则。
• lot、serial 与 unit：记录校验责任，不能让模板猜测业务事实。
• carrier、vehicle 与 tracking：加入多语言、特殊符号或真实设备测试样本。
• status、exceptions 与 signatures：规定文件命名、排序、版本和归档关联。

字段必须有示例、边界和责任系统。金额需要精度，日期需要时区，数组需要排序与最大数量，编号需要唯一规则；模板只负责表达已经批准的数据。

三、端到端实施流程

第1步：定义申请批准发出在途接收和关闭状态

先把“定义申请批准发出在途接收和关闭状态”写成可执行规则，明确数据负责人、批准人和异常处理人。对于仓库调拨单、门店转移单、内部配送清单、在途交接单和调拨签收记录，职责越早明确，后续返工越少。

第2步：从 WMS 读取批准 SKU 与来源目的库位

处理“从 WMS 读取批准 SKU 与来源目的库位”时，记录选择依据并保存代表性样本。模板或接口变化后，可用同一依据重新验证。

第3步：发出时锁定 shipped_qty、批次和序列号

围绕“发出时锁定 shipped_qty、批次和序列号”准备正常、空值、最长文本和最大数组，确认真实边界不会造成截断或错误分页。

第4步：生成带条码的调拨 PDF 随货交接

执行“生成带条码的调拨 PDF 随货交接”时设置业务标识、超时和失败分支；只有有效 PDF 完成验收后，才标记本次动作成功。

第5步：接收时记录 received_qty、时间和差异

验收“接收时记录 received_qty、时间和差异”不能只看第一页，还要检查金额、页序、字体、条码、打印或交互状态等场景细节。

第6步：关闭后保存文件版本与库存调整关系

最后通过“关闭后保存文件版本与库存调整关系”形成追溯闭环，保存业务 ID、模板版本、生成时间、页数、摘要与投递结果。

四、三个关键设计决定

1. 一份文件还是节点版本

可用同一 transfer_number，但发出和接收应有清晰版本或状态记录，不能静默覆盖。

2. 调拨价值是否显示

内部财务需要时可显示，仓库操作单可隐藏成本并保留数量。

3. 条码编码哪个 ID

编码稳定 transfer_number 或 shipment ID，并保留可读文字，避免编码临时页面号。

五、用 KeepMot 生成与维护

KeepMot 业务表单可组合来源目的仓、动态 SKU 表、批次序列号、条码、签字区域、水印和页眉页脚，适合调拨交接。

针对 库存调拨单 PDF，可在 KeepMot Studio 维护模板，通过 Template API 提交 template_id 与业务数据；程序拥有完整版式时使用 JSON Render，已有网页资产时使用 HTML to PDF。也可以从 模板库 开始。

六、上线验收清单

1. 来源与目的仓正确：保存源系统核对作为证据。
2. 发出数量来自实际拣货：保存真实页面样本作为证据。
3. 批次序列号一致：保存边界测试结果作为证据。
4. 条码对应调拨记录：保存响应与文件头作为证据。
5. 接收差异有原因：保存模板版本和摘要作为证据。
6. 关闭状态关联库存调整：保存补发或重放记录作为证据。

七、常见风险

风险 1：用请求数量代替实际发出

“用请求数量代替实际发出”会让早期看似灵活的实现快速积累维护成本，应在数据合同或状态机中直接阻止。

风险 2：接收后覆盖发出版本

出现“接收后覆盖发出版本”时，页面可能仍然看似正常。必须同时核对源记录、关键标识与最终文件。

风险 3：同一批次单位转换错误

“同一批次单位转换错误”往往只在边界数据出现，应保存触发样本并让无法安全生成的内容明确失败。

风险 4：调拨单顺序与货物不一致

“调拨单顺序与货物不一致”可能造成交付、隐私或运营事故，应缩小敏感数据范围并保留必要审计记录。

风险 5：差异未处理就关闭调拨

针对“差异未处理就关闭调拨”，先区分数据、版式、投递和版本问题，再制定纠正、重试、撤销或补发规则。

八、批量与日常运营

按路线或波次批量生成并保存页序。补打一张记录原因；接收差异进入独立处理，不通过重新生成文件来抹平数量。

批量任务应有输入清单、上限、幂等键和失败分类。只重放受影响的记录，避免一次超时重复全部文件；日志记录请求 ID、模板版本和结果，但不保存 API Key、密码或不必要个人数据。

九、常见问题 FAQ

Q：调拨单和送货单有什么区别？ A：调拨通常是组织内部库存移动，送货单通常面向客户交付。

Q：为什么显示三种数量？ A：申请、发出和接收分别代表计划、实际出库和实际入库。

Q：可以加入序列号吗？ A：可以，高价值或受控设备应保留序列号级映射。

Q：需要签字吗？ A：根据交接政策设置发出人与接收人签字或电子确认。

Q：在途状态如何表示？ A：由 WMS 状态机管理，PDF 展示生成时状态与时间。

Q：差异怎么办？ A：记录短缺、损坏或多收并创建库存调整或调查，不覆盖原数据。

十、总结

调拨 PDF 应完整连接申请、发出、在途、接收和差异，而不是只打印一张内部订单。