订单列表支持多个订单号查询功能
网络货运平台 · 货主端PC · 进行中订单页订单号多值查询
1. 文档信息
| 项目 | 内容 |
| 文档名称 | 订单列表支持多个订单号查询功能 |
| 需求名称 | 订单列表支持多个订单号查询功能 |
| 需求编号 | RR20260903352430 |
| 所属端 | 货主端PC(货主端APP 范围待补充,见「6. 待确认项」) |
| 版本号 | V1.0 |
| 编写人 | 刘宁宁 |
| 编写日期 | 2026-09-16 |
| 管家 | 待定 |
| 上线时间 | 待定 |
修订记录
| 版本 | 日期 | 修订内容 | 修订人 |
| V1.0 | 2026-09-16 | 初稿:货主端PC「进行中订单」页订单号输入框支持多订单号(逗号分隔)查询。同日确认:重复订单号自动去重(上限按去重后数量校验);全部订单号查不到时弹框仅提示「全部订单无法查询」。 | 刘宁宁 |
2. 需求背景
入口路径:货主端PC → 业务管理 → 进行中订单 → 订单管理查询区「订单号」输入框。
现状:订单号输入框一次仅支持输入一个订单号查询。货主需要批量核对多个订单(如对账、跟单)时,只能逐一输入查询,操作重复、效率低。
目标:订单号输入框支持一次输入多个订单号查询,一次看到整批订单。
图1:货主端PC「进行中订单」页——订单管理查询区「订单号」输入框(现状,仅支持单个订单号)
3. 需求描述
「进行中订单」页订单号输入框支持多订单号输入:以逗号分隔,一次查询多个订单。
- 多订单号查询:订单号输入框支持输入多个订单号,以逗号分隔(半角、全角均支持),一次查询出多个订单;
- 单订单号不变:仅输入 1 个订单号时,维持现有查询逻辑不变;
- 数量上限:单次最多支持 99 个订单号,超出阻止查询并提示。
4. 功能规则
4.1 输入与解析规则
| 规则项 | 规则内容 |
| 分隔符 | 以逗号分隔,半角","与全角","均识别为分隔符 |
| 空格容错 | 自动去除每个订单号首尾的空格 |
| 空段容错 | 连续逗号产生的空段自动忽略(如"DD001,,DD002"按 2 个订单号解析) |
| 数量上限 | 单次最多 99 个订单号;超过时阻止查询并提示,提示文案:「单次最多支持查询 99 个订单号,请分批查询」(最终文案待确认) |
| 重复订单号 | 同一订单号多次输入时自动去重,数量上限按去重后的订单号个数校验 |
4.2 生效边界
| 场景 | 查询逻辑 |
| 输入 1 个订单号 | 维持现有逻辑:与其他查询条件叠加过滤(不改变现有规则) |
| 输入 ≥2 个订单号 | 多订单号查询:以订单号为准,其他查询条件不再参与过滤 |
说明:多订单号为本次新增能力,不改动现有单订单号查询规则。
4.3 多订单号查询时的筛选项联动
输入 ≥2 个订单号执行查询时,为避免条件矛盾,查询区所有筛选项统一重置为默认值:
- 订单状态、招投标状态、是否短路、货物类型、业务类型、计费方式、结算方式、定价模式等下拉项,切换为「全部 / 请选择 / 不限」等默认选项;
- 创建时间、发账账号等条件清空为默认状态;
- 仅保留订单号条件参与查询。
4.4 结果展示
| 场景 | 处理方式 |
| 部分订单号查不到 | ① 列表照常展示查到的订单;② 查询结束后立即弹框提示未查到的订单号,文案:「有 N 个订单未查询到,分别为 DD…;DD…;」(N 为未查到数量,逐一列出订单号) |
| 全部订单号查不到 | 列表按现有空态展示;查询结束后弹框提示,此时仅提示「全部订单无法查询」,不逐条列出订单号 |
| 结果排序 | 命中多条订单时,按用户输入订单号的顺序展示 |
5. 异常与边界处理
| 场景 | 处理方式 |
| 输入超过 99 个订单号 | 阻止查询并提示「单次最多支持查询 99 个订单号,请分批查询」(不自动截取) |
| 误用全角逗号、逗号后带空格、连续逗号 | 自动容错,正常解析查询 |
| 输入的订单号不存在 / 非本账号订单 / 已完结(不在本页范围) | 视为「未查询到」——部分查不到:列表展示查到的部分,弹框列出未查到的订单号;全部查不到:列表空态,弹框仅提示「全部订单无法查询」 |
| 输入 1 个订单号 | 维持现有查询逻辑(与其他条件叠加),本需求不改动 |
| 订单管理下其他页面(已完结订单等)的订单号输入框 | 不在本次范围,维持现状 |
| 货主端APP 订单列表 | 范围待补充,见「6. 待确认项」 |
6. 待确认项
| 序号 | 待确认内容 | 当前方案(PRD 暂按此编写) |
| 1 | 货主端APP 覆盖范围(仅进行中状态 / 所有状态 / 本期不做) | 待补充(宁宁 2026-09-16 明确「待补充」) |
| 2 | 超过 99 个的提示文案最终措辞 | 「单次最多支持查询 99 个订单号,请分批查询」 |
| 3 | APP 端弹框样式(命中端后确认) | — |