业务需求
需求描述

业务背景

AI 服务创建任务后无法主动获知该任务最终是否下单、下单号是多少、成交价是多少、由哪家供应商承接，只能由人工回到 PMS 页面查看，AI 议价的自动化闭环在最后一步断掉。

同时，「创建议价任务接口」只传递了产品标识，未传递每个产品对应的议价数量，AI 侧按产品维度拆分数量的诉求无法满足，导致议价结果与下单数量对不上，需要人工二次核对。

业务价值

提高人效：1.5/8*600*2人*30天=6750元/月

需求概述

文档地址：https://alidocs.dingtalk.com/i/nodes/QOG9lyrgJP3QkpgatlvpN6wAVzN67Mw4?utm_scene=team_space

项目

内容

需求目标

① 新增「下单信息查询接口」，按 taskid 返回下单号、下单价、供应商；② 创建议价任务接口新增 productnum_details 入参，支持按产品名称传递议价数量

目标用户

AI 议价服务（接口调用方）；间接受益：供应链采购员、技术研发中心对接人（胡晓燕）

使用场景

AI 服务创建议价任务后，轮询或回调触发查询接口，拿到下单结果回写到 AI 侧对话/记录中，无需人工查 PMS

本期范围

新增查询接口（入参 taskid，返参 下单号/下单价/供应商）；创建议价任务接口新增 productnum_details 入参及校验

非本期范围

议价算法优化、任务状态机改造、回调推送机制、批量查询接口、AI 侧改造、历史任务数据补录

成功标准

查询接口 P95 响应 ≤1 秒、成功率 ≥99.5%；productnumdetails 传入 100 条任务落库数量一致率 100%

验收标准

编号

验收项

前置条件

操作步骤

预期结果

异常校验

AC1

查询接口返回正确

存在已下单任务，task_id 已知

调用查询接口 100 次

下单号、下单价、供应商与 PMS 页面一致率 100%

字段缺失时返回空并标记

AC2

响应时效

生产量级数据

连续调用 1000 次统计耗时

P95 ≤1 秒，成功率 ≥99.5%

超时计入失败并告警

AC3

未下单返回

任务处于议价中

调用查询接口

返回 200 + dataStatus=NOT_ORDERED，不报错

不返回 404 或 500

AC4

任务不存在

使用不存在的 task_id

调用查询接口 20 次

20 次均返回 404 + TASKNOTFOUND

不返回 500

AC5

鉴权拦截

使用无效凭证

调用 10 次

10 次均返回 401，无数据返回

不返回 200

AC6

创建接口带明细

合法 productnumdetails（3 个产品）

创建任务 100 条

100 条任务落库的产品数量与传入值一致率 100%

校验失败不创建任务

AC7

明细非法拦截

数量为 0 / 负数 / 非整数 / 超 999999

各调用 5 次

20 次均返回 400 + PRODUCTNUMINVALID，系统中无新增任务

不得产生半成品任务

AC8

向后兼容

不传 productnumdetails

调用创建接口 20 次

20 次均成功返回 task_id，行为与改造前一致

不返回参数错误

AC9

创建幂等

同一业务请求号

连续重复调用 20 次

仅创建 1 条任务，20 次返回同一 task_id

并发场景下结果一致

AC10

限流生效

压测 500 QPS

持续压测 1 分钟

超限请求返回 429 + retryAfter，服务不雪崩、不返回 5xx

未超限请求正常返回

AC11

日志完整

任意调用

抽查 100 条调用日志

task_id、耗时、结果码字段完整率 100%

日志缺失时告警

AC12

接口文档一致

接口上线

对照文档逐字段核对实现

入参、返参、错误码、示例与实现 100% 一致

不一致时以文档为准修正实现
价值描述
提高人效：1.5/8*600*2人*30天=6750元/月
历史记录  
  1. 2026-09-23 14:31:14, 由 曾翔 创建。
  2. 2026-09-23 14:31:29, 由 曾翔 编辑。
    修改了 所属计划，旧值为 ""，新值为 "2792"。
    修改了 所处阶段，旧值为 "wait"，新值为 "planned"。
  3. 2026-09-23 16:02:36, 由 杨林军 记录评审结果，结果为 确认通过。
  4. 2026-09-24 14:26:46, 由 何建宝 编辑。
    修改了 预计工时，旧值为 "1"，新值为 "6"。
    修改了 成本 ，旧值为 "500"，新值为 "3000"。
    修改了 ROI ，旧值为 "81.00"，新值为 "13.50"。
    确认
  5. 2026-09-24 15:28:40, 由 周杰 关联到迭代 主干_10月V2版本_20261013 。
  6. 2026-09-29 10:47:59, 由 何建宝 编辑。
    修改了 预计工时，旧值为 "6"，新值为 "12"。
    修改了 成本 ，旧值为 "3000"，新值为 "6000"。
    修改了 ROI ，旧值为 "13.50"，新值为 "6.75"。
  7. 2026-10-08 09:55:51, 由 周杰 编辑。
    修改了 计划验收时间，旧值为 "0000-00-00"，新值为 "2026-10-16"。
  8. 2026-10-09 09:57:53, 由 刘超 编辑。
    修改了 测试人员，旧值为 ""，新值为 "liuchao"。
  9. 2026-10-13 14:35:50, 由 周杰 编辑。
    修改了 所处阶段，旧值为 "tested"，新值为 "bepending"。
  10. 2026-10-22 18:20:37, 由 胡晓燕 编辑。
    修改了 所处阶段，旧值为 "业务验收中"，新值为 "业务验收通过"。
    功能验收：验收通过
    满意度：非常满意
    价值验收：基本达成
    原因备注：无
  11. 2026-10-26 09:14:12, 由 周杰 关闭，原因为 已完成 。
    修改了 由谁关闭，旧值为 ""，新值为 "zhoujie"。
    修改了 关闭日期，旧值为 "0000-00-00 00:00:00"，新值为 "2026-10-26 09:14:09"。
    修改了 指派给 ，旧值为 "hejianbao"，新值为 "closed"。
    修改了 当前状态，旧值为 "active"，新值为 "closed"。
    修改了 所处阶段，旧值为 "verified"，新值为 "closed"。
    修改了 关闭原因，旧值为 ""，新值为 "done"。
迭代版本
提报业务部门 技术研发中心
提报人员 胡晓燕
需求来源 产品自主提报需求
所属项目 技术中心-需求池
所属模块 供应链   产品采购   产品库
所属计划
业务价值
开发组 产品采购开发组
受益业务部门 技术研发中心
验收人员 胡晓燕
业务目标类型
中心业务目标
业务价值 提升人效
每月价值量 6750
每月节省人数 15
优先级 P2
价值类型 长期价值
预计工时 12
成本 6000
ROI 6.75
操作手册 否
高价值 -
主被动 被动接收
复杂度 一般性
工作流ID
工作流创建时间 0000-00-00 00:00:00
更新点
是否高危 否
评分 65.5
当前状态 已关闭
所处阶段 已关闭
关键词
评审次数 一次
计划上线 0000-00-00
上线时间 2026-10-13
计划验收时间 2026-10-16
业务验收时间 2026-10-22 18:20:37
满意度 非常满意
价值验收 基本达成
满意度分值 100
业务回填价值
验收达成价值 32400.0
验收达成ROI 5.4
抄送给
由谁创建 曾翔 于 2026-09-23 14:31:14
指派给 Closed 于 2026-10-26 09:14:09
由谁评审 杨林军
评审时间 2026-09-23
由谁关闭 周杰 于 2026-10-26 09:14:09
关闭原因 已完成
最后修改 周杰 于 2026-10-26 09:14:09
相关Bug
相关用例
相关需求
细分需求