业务需求
需求描述

背景

获取转单号,目前的逻辑是需要根据预生成时物流商返回的标识,再轮询获取转单号;

越来越多物流商不使用这种模式,即预生成时不返回特定标识,而是采取物流渠道来确定是否需要获取转单号;


优化转单号获取模式,并对接全和悦的转单号接口;


需求


1、优化转单号获取模式,通过物流渠道进行获取;


在【IrobotBox-物流商运输方式管理】中,物流渠道“添加”,“编辑”页面,增加是否获取转单号选项;


  • 该选项为单选;
  • 默认为否;
  • 添加的位置在揽收方式下方;

当物流渠道选择了“是”,则对应物流渠道所有的预报的单,都需要加入到获取转单号服务中,继续获取转单号;

当物流渠道选择了“否”,则对应物流渠道预报的单,不需要获取转单号;



2、对接全和悦物流获取转单号接口;

接口地址:devdoc.alljoylogistics.com/detail?action=getTrackNumber


物流商的need_change_service_no字段,已弃用,使用预生成返回的reference_no,请求接口,将获取到的接口保存到:


  • 追踪号字段;---如果预生成时没有返回追踪号,则保存到追踪号字段,文档未写,需和物流商联调看实际报文;
  • 转单号字段;---如果预生成时已经返回追踪号,则保存到转单号字段,文档未写,需和物流商联调看实际报文;




3、本次更新,只针对全和悦使用新的逻辑,以前对接的物流商,如云途等,依然使用预报返回特定标识的逻辑,不要影响了其他物流商的预生成;


















验收标准
价值描述
适配更多物流商,提升物流对接效率,预计每个物流商节省1人天;
历史记录  
  1. 2023-01-13 16:00:18, 由 田子豪 创建。
  2. 2023-01-17 14:16:56, 由 田子豪 变更。
    修改了 版本号 ,旧值为 "1",新值为 "2"。
    修改了 需求描述,区别为:
    002- 获取转单号,目前的逻辑是需要根据预生成时物流商返回的标识,再轮询获取转单号,
    002+ 获取转单号,目前的逻辑是需要根据预生成时物流商返回的标识,再轮询获取转单号;
    003-
    003+ 越来越多物流商不使用这种模式,即预生成时不返回特定标识,而是采取物流渠道来确定是否需要获取转单号;
    004- 需求
    004+
    005-
    005+ 优化转单号获取模式,并对接全和悦的转单号接口;
    006-
    006+
    007+ 需求
    008+
    009+ 1、优化转单号获取模式,通过物流渠道进行获取;
    010+
    011+ 在【IrobotBox-物流商运输方式管理】中,物流渠道“添加”,“编辑”页面,增加是否获取转单号选项;
    012+
    013+ 该选项为单选;
    014+ 默认为否;
    015+ 添加的位置在揽收方式下方;
    016+ 当物流渠道选择了“是”,则对应物流渠道所有的预报的单,都需要加入到获取转单号服务中,继续获取转单号;
    017+ 当物流渠道选择了“否”,则对应物流渠道预报的单,不需要获取转单号;
    018+
    019+
    020+
    021+
    022+ 2、对接全和悦物流获取转单号接口;
    023+ 接口地址:devdoc.alljoylogistics.com/detail?action=getTrackNumber
    024+
    025+ 物流商的need_change_service_no字段,已弃用,使用预生成返回的reference_no,请求接口,将获取到的接口保存到:
    026+
    027+ 追踪号字段;---如果预生成时没有返回追踪号,则保存到追踪号字段,文档未写,需和物流商联调看实际报文;
    028+ 转单号字段;---如果预生成时已经返回追踪号,则保存到转单号字段,文档未写,需和物流商联调看实际报文;
    029+
    030+
    031+
    032+ 3、本次更新,只针对全和悦使用新的逻辑,以前对接的物流商,如云途等,依然使用预报返回特定标识的逻辑,不要影响了其他物流商的预生成;
    033+
    034+
    035+
    036+
    037+
    038+
    039+
    040+
    041+
    042+
    043+
    044+
    045+
    046+
    047+
    048+
    049+
    002- <p>获取转单号,目前的逻辑是需要根据预生成时物流商返回的标识,再轮询获取转单号,</p>
    002+ <p>获取转单号,目前的逻辑是需要根据预生成时物流商返回的标识,再轮询获取转单号;</p>
    003- <p><br /></p>
    003+ <p>越来越多物流商不使用这种模式,即预生成时不返回特定标识,而是采取物流渠道来确定是否需要获取转单号;</p>
    004- <p>需求</p>
    004+ <p><br /></p>
    005- <p><br /></p>
    005+ <p>优化转单号获取模式,并对接全和悦的转单号接口;</p>
    006- <p><br /></p>
    006+ <p><br /></p>
    007+ <p>需求</p>
    008+ <p><br /></p>
    009+ <p>1、优化转单号获取模式,通过物流渠道进行获取;</p>
    010+ <p><br /></p>
    011+ <p>在【IrobotBox-物流商运输方式管理】中,物流渠道“添加”,“编辑”页面,增加是否获取转单号选项;</p>
    012+ <p><br /></p>
    013+ <ul><li>该选项为单选;</li>
    014+ <li>默认为否;</li>
    015+ <li>添加的位置在揽收方式下方;</li>
    016+ </ul><p>当物流渠道选择了“是”,则对应物流渠道所有的预报的单,都需要加入到获取转单号服务中,继续获取转单号;</p>
    017+ <p>当物流渠道选择了“否”,则对应物流渠道预报的单,不需要获取转单号;</p>
    018+ <p><br /></p>
    019+ <p><img src="{238225.png}" alt="" /></p>
    020+ <p><img src="{238226.png}" alt="" /></p>
    021+ <p><br /></p>
    022+ <p>2、对接全和悦物流获取转单号接口;</p>
    023+ <p>接口地址:devdoc.alljoylogistics.com/detail?action=getTrackNumber</p>
    024+ <p><br /></p>
    025+ <p>物流商的need_change_service_no字段,已弃用,使用<span>预生成返回的<span style="color:#212529;font-family:'-apple-system', BlinkMacSystemFont;">reference_no,请求接口,将获取到的接口保存到:</span></span></p>
    026+ <p><br /></p>
    027+ <ul><li><span>追踪号字段;---如果预生成时没有返回追踪号,则保存到追踪号字段,文档未写,需和物流商联调看实际报文;</span></li>
    028+ <li><span>转单号字段;---如果预生成时已经返回追踪号,则保存到转单号字段,<span>文档未写,需和物流商联调看实际报文</span>;</span></li>
    029+ </ul><p><br /></p>
    030+ <p><br /></p>
    031+ <p><br /></p>
    032+ <p><span style="color:#E53333;">3、本次更新,只针对全和悦使用新的逻辑,以前对接的物流商,如云途等,依然使用预报返回特定标识的逻辑,不要影响了其他物流商的预生成;</span></p>
    033+ <p><br /></p>
    034+ <p><br /></p>
    035+ <p><br /></p>
    036+ <p><br /></p>
    037+ <p><br /></p>
    038+ <p><br /></p>
    039+ <p><br /></p>
    040+ <p><br /></p>
    041+ <p><br /></p>
    042+ <p><br /></p>
    043+ <p><br /></p>
    044+ <p><br /></p>
    045+ <p><br /></p>
    046+ <p><br /></p>
    047+ <p><br /></p>
    048+ <p><br /></p>
    049+ <p><br /></p>
  3. 2023-01-17 14:17:04, 由 田子豪 指派给 刘灿。
    修改了 指派给,旧值为 "tianzihao",新值为 "Admin186"。
  4. 2023-01-17 14:17:29, 由 田子豪 编辑。
    修改了 所属计划,旧值为 "",新值为 "696"。
    修改了 所处阶段,旧值为 "wait",新值为 "planned"。
  5. 2023-01-17 15:54:55, 由 刘灿 记录评审结果,结果为 确认通过。
    修改了 评审时间,旧值为 "0000-00-00",新值为 "2023-01-17"。
    修改了 指派给 ,旧值为 "Admin186",新值为 "tianzihao"。
    修改了 当前状态,旧值为 "draft",新值为 "active"。
    修改了 由谁评审,旧值为 "",新值为 "Admin186"。
  6. 2023-01-17 16:15:40, 由 田子豪 关联到迭代 技术研发中心 1月分支版本(2023年) 。
  7. 2023-01-18 21:27:37, 由 程伟 添加备注。

    预估工时:12H

    1. 编辑页面增加栏位和新增字段【2H】

    2. 对查询追踪号接口【6H】

    3. 转单号服务逻辑优化【4H】

  8. 2023-01-29 18:08:23, 由 周杰 编辑。
    修改了 预计工时,旧值为 "16",新值为 "10"。
    需求评审工时:10小时
  9. 2023-02-15 16:35:15, 由 zhengqiao 编辑。
    修改了 所处阶段 ,旧值为 "tested",新值为 "released"。
    修改了 设置阶段者,旧值为 "",新值为 "zhengqiao"。
  10. 2023-03-04 15:24:36, 由 周杰 编辑。
    修改了 所属模块,旧值为 "1684",新值为 "1742"。
  11. 2023-03-29 13:58:02, 由 田子豪 关闭,原因为 已完成 。
    修改了 由谁关闭,旧值为 "",新值为 "tianzihao"。
    修改了 关闭日期,旧值为 "0000-00-00 00:00:00",新值为 "2023-03-29 13:58:01"。
    修改了 指派给 ,旧值为 "tianzihao",新值为 "closed"。
    修改了 当前状态,旧值为 "active",新值为 "closed"。
    修改了 所处阶段,旧值为 "released",新值为 "closed"。
    修改了 关闭原因,旧值为 "",新值为 "done"。
  12. 2023-11-16 18:35:52, 由 周杰 编辑。
    修改了 关键词,旧值为 "",新值为 "2023-1-5"。
  13. 2023-11-16 20:27:19, 由 周杰 编辑。
    修改了 所属模块,旧值为 "1742",新值为 "1854"。
迭代版本 2023年2月第2个迭代
提报业务部门
提报人员 产品
需求来源 公司战略需求
所属项目 技术中心-需求池
所属模块 供应链   仓储物流
所属计划
业务价值
开发组
受益业务部门 供应链管理中心
验收人员
业务目标类型
中心业务目标
业务价值 提升人效
每月价值量 1人天/物流商对接
每月节省人数 0
优先级 P2
价值类型
预计工时 10
成本
ROI
操作手册 否
高价值
主被动
复杂度
工作流ID
工作流创建时间
更新点
是否高危 否
评分
当前状态 已关闭
所处阶段 已关闭
关键词 2023-1-5
评审次数
计划上线
上线时间 2023-01-05
计划验收时间
业务验收时间
满意度
价值验收
满意度分值
业务回填价值
验收达成价值
验收达成ROI
抄送给
由谁创建 田子豪 于 2023-01-13 16:00:18
指派给 Closed 于 2023-11-16 18:35:52
由谁评审 刘灿
评审时间 2023-01-17
由谁关闭 田子豪 于 2023-03-29 13:58:01
关闭原因 已完成
最后修改 周杰 于 2023-11-16 20:27:08