主题
移动端交付管理
阶段说明
当前交付管理模块在文档治理台账中被标记为重构中、暂停系统治理推进。本文以下内容仅用于对齐当前移动端前端已落地实现，帮助一线用户先看懂现阶段手机端能做什么、不能做什么；它不应被视为交付管理模块的最终稳定口径。
页面定位
移动端 交付管理 当前不是完整的“现场交付中心”，而是一个围绕 发货单、发货单详情、发货记录 展开的手机端发货入口。
它更适合解决这些问题：
- 现场快速查看哪些订单还在待发货范围；
- 打开发货单详情，核对收货信息和齐套情况；
- 在订单已经进入
待发货状态时，暂存发货信息或直接确认发货； - 回看已经发货的订单记录。
它不适合替代：
- PC 端的集中交付管理、批量处理和打印场景；
- 更完整的车辆、线路、签收、回执等配送流程管理；
- 仍在重构中的交付管理最终业务流程说明。
谁会用到这个页面
当前更可能用到它的人包括：
- 发货员：现场确认某张单是否已经可以发出；
- 仓库人员：核对收货信息、配送方式、当前齐套情况；
- 管理人员：用手机快速查看待发货和已发货记录；
- 需要扫码直达发货详情的人：通过隐藏详情页进入单据。
建议你先看哪里
如果你第一次接触这个模块，建议按这个顺序理解：
- 先看 发货单，理解哪些单会出现在待处理列表；
- 再看 发货单详情，理解什么时候只能看、什么时候可以操作；
- 最后看 发货记录，理解移动端如何回看已经发出的订单。
页面整体结构
当前移动端 交付管理 工作空间的真实结构如下：
| 菜单 | 当前状态 | 作用 |
|---|---|---|
| 发货单 | 可见菜单 | 查看待处理发货单，支持搜索、状态筛选并进入详情 |
| 发货单详情 | 隐藏页 | 查看单张发货单详情，在待发货状态下可暂存或确认发货 |
| 发货记录 | 可见菜单 | 查看已发货订单历史记录 |
其中：
- 详情页不会出现在底部菜单中，而是通过点击列表条目进入
- 详情页支持扫码直达：扫描发货单二维码可直接跳转到对应发货单详情
这张图要帮你先看懂：当前移动端交付管理的真正分叉点在详情页状态。只有待发货时能操作，其他状态主要是查看。
发货单
这页不是“全部交付订单总表”，而是当前待处理发货单列表。页面头部注释已经明确说明：它主要展示 备货中 + 待发货 状态的单据。
顶部结构
搜索栏
搜索框占位文案是：搜索订单号/名称
这说明当前移动端前端明确提供的是：
- 按订单号搜索；
- 按订单名称搜索；
不应泛写成“按客户快速搜索”。
状态筛选
搜索栏下方有状态下拉筛选，真实选项只有三种：
| 选项 | 值 |
|---|---|
| 全部状态 | '' |
| 备货中 | 备货中 |
| 待发货 | 待发货 |
列表卡片结构
每条卡片当前会展示：
| 信息 | 说明 |
|---|---|
| 订单号 | 订单编号 |
| 状态标签 | 当前状态 |
| 订单名称 | 订单名称，无值时显示为空 |
| 齐套时间 | 齐套时间 |
当前前端状态映射文案为：
| 状态码 | 文案 |
|---|---|
| 备货中 | 备货中 |
| 待发货 | 待发货 |
| 已发货 | 已发货 |
交互方式
这个页面没有额外的按钮栏，主要交互是：
- 搜索；
- 按状态筛选；
- 下拉刷新；
- 上拉分页；
- 点击卡片进入详情。
空状态
当列表没有数据时，页面显示：
暂无发货单
发货单详情
这是一个隐藏页，一般从 发货单 或 发货记录 点击卡片进入，也支持通过扫码场景直达。
当前这页是整个移动端交付管理里最关键的页面，因为：
- 它既负责展示发货详情；
- 也负责在特定状态下执行移动端发货操作。
进入条件
页面根据订单编号加载对应数据。
详情页的真实状态分叉
当前前端把详情页分成 3 种典型状态理解：
| 状态 | 页面表现 |
|---|---|
| 备货中 | 只能查看详情，不能发货 |
| 待发货 | 可填写发货信息，支持暂存和确认发货 |
| 已发货 | 只读查看已发货结果 |
这点非常关键：不是进入详情就能现场处理，只有待发货状态才有操作按钮。
详情页上半部分：只读基础信息
订单信息卡片
显示：
| 信息 | 说明 |
|---|---|
| 订单号 | 订单编号 |
| 状态 | 当前状态 |
| 订单名称 | 订单名称，无值时显示为空 |
| 交付日期 | 交付日期，无值时显示为空 |
收货信息卡片
显示：
| 信息 | 说明 |
|---|---|
| 收货人 | 收货人 |
| 联系电话 | 联系电话 |
| 收货地址 | 收货地址 |
齐套状态卡片
显示：
| 信息 | 说明 |
|---|---|
| 打包 | 已完成 / 未完成 |
| 外协 | 已完成 / 未完成 |
这里需要特别注意：
- 页面会展示打包和外协是否完成；
- 但当前前端没有基于这两个字段直接禁用发货按钮或阻止提交。
所以正式教程里可以写“建议先核对齐套状态”，但不能直接写成“未齐套一定不能点发货”，除非后续再核到后端明确拦截规则。
关联子发货单
如果存在子发货单，页面会额外显示这块区域。
显示字段：
- 子发货单号；
- 子单状态。
已发货状态下的只读结果区
当订单状态已经是 已发货 时，页面会显示一块只读发货信息。
真实字段包括：
| 信息 | 说明 |
|---|---|
| 配送方式 | 配送方式 |
| 快递单号 | 快递单号 |
| 配送人 | 配送人 |
| 联系电话 | 联系电话 |
| 发货时间 | 发货时间 |
| 操作人 | 操作人 |
| 备注 | 备注，有值时显示 |
待发货状态下的发货表单
只有当状态是 待发货 时，详情页才会显示发货表单和底部按钮。
表单字段包括：
| 字段 | 说明 | 是否必填 |
|---|---|---|
| 配送方式 | 选择器 | 是 |
| 配送人 | 文本输入 | 是 |
| 联系电话 | 文本输入 | 否 |
| 快递单号 | 文本输入 | 否 |
| 备注 | 多行输入 | 否 |
配送方式的自动带入逻辑
当前页面不是纯手工填写。选择配送方式后，前端会尝试根据配送方式基础资料自动带入：
- 配送人；
- 联系电话。
底部操作按钮
待发货状态下，底部会出现两个按钮：
暂存确认发货
暂存
用于先保存当前填写的发货信息，但不直接发货。
成功提示：
保存成功
确认发货
点击后不会直接提交，而是会先弹确认框：
确定要发货订单 xxx 吗？发货后不可撤回。
确认后才调用发货接口。成功提示：
发货成功
然后页面会返回上一页。
当前前端明确做了哪些校验
发货前，页面当前只显式校验两项：
- 必须选择配送方式；
- 必须填写配送人。
当前前端没有看到这些显式校验：
- 联系电话格式校验；
- 快递单号必填校验；
- 备注长度校验；
- 基于打包/外协状态的前端阻断。
因此教程里不要把这些规则写成“当前页面一定会拦截”的既定事实。
发货记录
这页不是待处理页，而是已发货记录页。
页面头部注释已经明确说明：用于查询已发货订单历史。
页面结构
搜索栏
顶部只有一个搜索框，仍然是：搜索订单号/名称
列表卡片
每条卡片显示：
| 信息 | 说明 |
|---|---|
| 订单号 | 订单编号 |
| 状态标签 | 固定显示 已发货 |
| 订单名称 | 订单名称，无值时显示为空 |
| 配送方式 | 配送方式，无值时显示为空 |
| 发货时间 | 发货时间 |
交互方式
- 搜索；
- 下拉刷新；
- 上拉分页；
- 点击卡片进入发货单详情。
空状态
当没有数据时，页面显示：
暂无发货记录
页面里的真实流程
场景一：查看待处理发货单
- 进入掌上 ERP →
交付管理； - 打开
发货单； - 通过订单号/名称搜索，或按状态切换为
备货中 / 待发货； - 点击目标卡片进入详情。
场景二：在待发货状态下暂存或确认发货
- 从
发货单进入发货单详情； - 先核对订单信息、收货信息、齐套状态；
- 如果当前状态是
待发货，填写或补充发货表单； - 需要先保存时点击
暂存； - 准备正式发货时点击
确认发货； - 在确认弹窗中再次确认“发货后不可撤回”；
- 发货成功后返回上一页。
场景三：查看已发货记录
- 进入
交付管理→发货记录； - 搜索历史订单；
- 点击目标卡片进入详情；
- 在详情页查看配送方式、配送人、快递单号、发货时间等结果信息。
这张图要帮你理解：移动端交付管理真正可操作的核心，只发生在“待发货详情页”。
当前能力边界
为了避免把这篇文档写得过宽，下面把当前真实边界直接说明白。
当前移动端已经覆盖的能力
- 查看待处理发货单；
- 按订单号/名称搜索；
- 在发货单页按状态筛选；
- 查看发货单详情；
- 查看收货信息、齐套状态、子发货单；
- 在
待发货状态下暂存发货信息； - 在
待发货状态下确认发货； - 查看已发货记录。
当前移动端没有明确覆盖或不宜写成既定能力的内容
- 批量发货；
- 打印；
- 手动开启发货流程；
- 更完整的配送调度能力；
- 前端基于齐套状态的强制阻断；
- 详细失败提示文案；
- 最终稳定版交付管理全流程口径。
常见问题
为什么我能看到详情，但没有“暂存”和“确认发货”按钮？
先看当前订单状态。
只有当发货单状态是 待发货 时，详情页才会显示发货表单和底部操作按钮；如果还是 备货中，当前移动端只能查看，不能发货。
为什么页面里显示了打包、外协是否完成，却还能点发货？
因为当前前端只是把这两个状态展示出来，并没有直接把它们写成前端阻断条件。你应把它理解为“需要人工核对的参考信息”，而不是“页面已经自动替你卡住了不允许发货”。
为什么发货前还要再弹一次确认框？
因为当前页面明确把“确认发货”设计成不可直接回退的操作，确认框里的真实提示就是：发货后不可撤回。
为什么发货记录页看起来比发货单页简单？
因为 发货记录 的定位本来就是历史记录查询页，它只保留了搜索、分页、点进详情这些最基础的查看能力，没有再做状态筛选和现场处理入口。
这篇文档是不是最终稳定口径？
不是。当前文档只是对齐“现阶段移动端真实前端实现”。由于交付管理模块仍在重构期，后续正式教程口径可能还会调整。
使用建议与最佳实践
- 先在
发货单页锁定目标订单，再进入详情，不要把移动端当成完整交付总控台使用。 - 进入详情后优先看收货信息和齐套状态，再决定是否继续填写发货信息。
- 选择配送方式后，先确认系统自动带入的配送人和联系电话是否正确。
- 如果现场信息还没确认完，可以先用
暂存，不要急着直接发货。 - 点击
确认发货前，务必把它理解为不可撤回动作。 - 如果需要批量处理、打印或更完整交付控制，优先回到 PC 端交付管理模块。
相关页面
- 移动端 - 先理解移动端工作空间、隐藏页和扫码跳转结构
- 交付管理 / 发货单 - 查看 PC 端发货单与更完整交付流程说明
- 交付管理 / 发货历史 - 查看 PC 端已发货记录与查询口径