业务需求
需求描述
一、功能:JAVA物流系统-运输统计-增加运费计算状态和税费计算状态
问题:
  1. 规则设置运费单价为0,所以包裹计算的运费是0。但是包裹运费计算服务会一直检测运费为0的包裹重复执行,导致这类包裹占用服务器资源,影响服务性能。
  2. 税费计算服务的问题同问题1
方案:
  1. 运输统计表增加2个字段运费计算状态和税费计算状态,状态分三种:0、未计算 1、计算成功 2、计算失败。

影响功能:JAVA运输统计-列表界面数据展示和导出


2. 自动执行运费计算服务和税费计算服务的时候,查询数据需要过滤掉运费和税费已计算的数据,就算当前的运费是0。如果计算税费和运费失败的话需要记录运输统计日志

影响功能:自动计算运费和税费服务


3. 增加服务,如果检测到包裹的运费或税费大于0,但是状态还是未计算的话,直接将状态更新为计算成功,并记录运输统计日志


二、 功能:JAVA物流系统--物流商对账单分析服务
问题:财务确认状态同步很慢
方案:将同步财务确认状态功能单独拆分一个独立服务,避免多个功能聚合在一个服务里面,执行很慢
服务频率:2分钟执行一次,服务入口增加redis锁,避免服务卡顿情况下,上一轮服务还没结束,下一轮服务又开始,导致重复执行
代码:com.zhcxkj.bus.tms.application.executor.cmd.logistics.LogisticsReconciliationFreightCmdExe#financialConfirmQueueExecute ,financialConfirmQueueExecute就是更新财务确认状态的方法


三、功能:JAVA物流系统-财务确认队列自行执行服务

问题:
1、财务确认状态同步很慢
2、原服务执行完财务确认队列后,未处理ERP队列状态,导致同一个队列重复执行
方案:
1、 财务确认队列自动执行服务独立出来,每5分钟执行一次,但是服务代码中增加redis缓存,避免上次任务还未执行完成,下次任务又开始了
2、服务执行成功后需要将erp队列执行状态更改为成功


四、ERP-财务审核-取消确认
问题:操作取消确认后,物流提交批次状态会更新为已提交,财务审核状态会更新为未确认,但是数据未回写到JAVA
方案:
操作取消确认后,实时调用java接口更新java物流提交批次状态


五、功能:erp操作财务审核确认或异常冲账界面操作确认和主干审核
问题:如果操作的物流提交批次在java不存在且打开了java数据处理开关,就会报错,提示“未找到可更新的对账单或无权操作”
方案:如果物流提交批次在java不存在,java接口直接返回成功


六、功能:运输方式检查公共方法,备货运费计算公共方法,直发运费计算 功能方法
问题:精确邮编匹配的时候未去掉前后空格导致匹配异常
方案:精确邮编匹配的时候去掉前后空格


验收标准
价值描述
5000
历史记录  
  1. 2026-09-23 15:58:27, 由 彭祥发 创建。
  2. 2026-09-23 16:00:48, 由 杨林军 记录评审结果,结果为 确认通过。
    修改了 评审时间,旧值为 "0000-00-00",新值为 "2026-09-23"。
    修改了 指派给 ,旧值为 "yanglinjun",新值为 "pengxiangfa"。
    修改了 当前状态,旧值为 "draft",新值为 "active"。
    修改了 由谁评审,旧值为 "",新值为 "yanglinjun"。
  3. 2026-09-23 18:14:26, 由 彭祥发 变更。
    修改了 版本号 ,旧值为 "1",新值为 "2"。
    修改了 由谁评审,旧值为 "yanglinjun",新值为 ""。
    修改了 需求描述,区别为:
    001- 一、功能:JAVA物流系统-运输统计-增加运费计算状态和税费计算状态问题:
    001+ 一、功能:JAVA物流系统-运输统计-增加运费计算状态和税费计算状态问题:
    004- 方案:
    004+ 方案:
    008- 2. 自动执行运费计算服务和税费计算服务的时候,查询数据需要过滤掉运费和税费已计算的数据,就算当前的运费是0。如果计算税费和运费失败的话需要记录运输统计日志
    008+ 2. 自动执行运费计算服务和税费计算服务的时候,查询数据需要过滤掉运费和税费已计算的数据,就算当前的运费是0。如果计算税费和运费失败的话需要记录运输统计日志
    011- 3. 增加服务,如果检测到包裹的运费或税费大于0,但是状态还是未计算的话,直接将状态更新为计算成功,并记录运输统计日志
    011+ 3. 增加服务,如果检测到包裹的运费或税费大于0,但是状态还是未计算的话,直接将状态更新为计算成功,并记录运输统计日志
    013- 二、 功能:JAVA物流系统--物流商对账单分析服务问题:财务确认状态同步很慢方案:将同步财务确认状态功能单独拆分一个独立服务,避免多个功能聚合在一个服务里面,执行很慢服务频率:2分钟执行一次,服务入口增加redis锁,避免服务卡顿情况下,上一轮服务还没结束,下一轮服务又开始,导致重复执行代码:com.zhcxkj.bus.tms.application.executor.cmd.logistics.LogisticsReconciliationFreightCmdExe#financialConfirmQueueExecute ,financialConfirmQueueExecute就是更新财务确认状态的方法
    013+ 二、 功能:JAVA物流系统--物流商对账单分析服务问题:财务确认状态同步很慢方案:将同步财务确认状态功能单独拆分一个独立服务,避免多个功能聚合在一个服务里面,执行很慢服务频率:2分钟执行一次,服务入口增加redis锁,避免服务卡顿情况下,上一轮服务还没结束,下一轮服务又开始,导致重复执行代码:com.zhcxkj.bus.tms.application.executor.cmd.logistics.LogisticsReconciliationFreightCmdExe#financialConfirmQueueExecute ,financialConfirmQueueExecute就是更新财务确认状态的方法
    014+
    015+ 三、功能:JAVA物流系统-财务确认队列自行执行服务
    016+ 问题: 1、财务确认状态同步很慢 2、原服务执行完财务确认队列后,未处理ERP队列状态,导致同一个队列重复执行方案: 1、 财务确认队列自动执行服务独立出来,每5分钟执行一次,但是服务代码中增加redis缓存,避免上次任务还未执行完成,下次任务又开始了 2、服务执行成功后需要将erp队列执行状态更改为成功
    017+
    018+ 四、ERP-财务审核-取消确认问题:操作取消确认后,物流提交批次状态会更新为已提交,财务审核状态会更新为未确认,但是数据未回写到JAVA方案: 操作取消确认后,实时调用java接口更新java物流提交批次状态
    019+
    020+ 五、功能:erp操作财务审核确认或异常冲账界面操作确认和主干审核 问题:如果操作的物流提交批次在java不存在且打开了java数据处理开关,就会报错,提示“未找到可更新的对账单或无权操作” 方案:如果物流提交批次在java不存在,java接口直接返回成功
    021+
    022+ 六、功能:运输方式检查公共方法,备货运费计算公共方法,直发运费计算 功能方法 问题:精确邮编匹配的时候未去掉前后空格导致匹配异常 方案:精确邮编匹配的时候去掉前后空格
    001- 一、功能:JAVA物流系统-运输统计-增加运费计算状态和税费计算状态<br /><span>问题:</span>
    001+ 一、功能:JAVA物流系统-运输统计-增加运费计算状态和税费计算状态<br /><span>问题:</span>
    004- </ol><span>方案:</span>
    004+ </ol><span>方案:</span>
    008- <span>2. 自动执行运费计算服务和税费计算服务的时候,查询数据需要过滤掉运费和税费已计算的数据,就算当前的运费是0。如果计算税费和运费失败的话需要记录运输统计日志<br /></span>
    008+ <span>2. 自动执行运费计算服务和税费计算服务的时候,查询数据需要过滤掉运费和税费已计算的数据,就算当前的运费是0。如果计算税费和运费失败的话需要记录运输统计日志<br /></span>
    011- <span>3. 增加服务,如果检测到包裹的运费或税费大于0,但是状态还是未计算的话,直接将状态更新为计算成功,并记录运输统计日志</span>
    011+ <span>3. 增加服务,如果检测到包裹的运费或税费大于0,但是状态还是未计算的话,直接将状态更新为计算成功,并记录运输统计日志</span>
    013- <span>二、 功能:JAVA物流系统--物流商对账单分析服务<br /></span><span>问题:财务确认状态同步很慢<br /></span><span>方案:将同步财务确认状态功能单独拆分一个独立服务,避免多个功能聚合在一个服务里面,执行很慢<br /></span><span>服务频率:2分钟执行一次,服务入口增加redis锁,避免服务卡顿情况下,上一轮服务还没结束,下一轮服务又开始,导致重复执行<br /></span><span>代码:com.zhcxkj.bus.tms.application.executor.cmd.logistics.LogisticsReconciliationFreightCmdExe#financialConfirmQueueExecute ,financialConfirmQueueExecute就是更新财务确认状态的方法</span>
    013+ <span>二、 功能:JAVA物流系统--物流商对账单分析服务<br /></span><span>问题:财务确认状态同步很慢<br /></span><span>方案:将同步财务确认状态功能单独拆分一个独立服务,避免多个功能聚合在一个服务里面,执行很慢<br /></span><span>服务频率:2分钟执行一次,服务入口增加redis锁,避免服务卡顿情况下,上一轮服务还没结束,下一轮服务又开始,导致重复执行<br /></span><span>代码:com.zhcxkj.bus.tms.application.executor.cmd.logistics.LogisticsReconciliationFreightCmdExe#financialConfirmQueueExecute ,financialConfirmQueueExecute就是更新财务确认状态的方法<br /><br /></span>
    014+ <p><span><br /></span></p>
    015+ <p><span><span>三、功能:JAVA物流系统-财务确认队列自行执行服务</span></span></p>
    016+ <span>问题:<br /></span><span> 1、财务确认状态同步很慢<br /></span><span> 2、原服务执行完财务确认队列后,未处理ERP队列状态,导致同一个队列重复执行<br /></span><span>方案:<br /></span><span> 1、 财务确认队列自动执行服务独立出来,每5分钟执行一次,但是服务代码中增加redis缓存,避免上次任务还未执行完成,下次任务又开始了<br /></span><span> 2、服务执行成功后需要将erp队列执行状态更改为成功</span>
    017+ <p><br /></p>
    018+ <span>四、ERP-财务审核-取消确认<br /></span><span>问题:操作取消确认后,物流提交批次状态会更新为已提交,财务审核状态会更新为未确认,但是数据未回写到JAVA<br /></span><span>方案:<br /></span><span> 操作取消确认后,实时调用java接口更新java物流提交批次状态</span>
    019+ <p><br /></p>
    020+ <span>五、功能:erp操作财务审核确认或异常冲账界面操作确认和主干审核<br /></span><span> 问题:如果操作的物流提交批次在java不存在且打开了java数据处理开关,就会报错,提示“未找到可更新的对账单或无权操作”<br /></span><span> 方案:如果物流提交批次在java不存在,java接口直接返回成功</span>
    021+ <p><br /></p>
    022+ <span>六、功能:运输方式检查公共方法,备货运费计算公共方法,直发运费计算 功能方法<br /></span><span> 问题:精确邮编匹配的时候未去掉前后空格导致匹配异常<br /></span><span> 方案:精确邮编匹配的时候去掉前后空格</span><br /><p><br /></p>
  4. 2026-09-24 09:42:19, 由 周杰 关联到迭代 主干_10月V2版本_20261013 。
  5. 2026-09-24 17:22:39, 由 周杰 编辑。
    修改了 预计工时,旧值为 "1",新值为 "27"。
    修改了 ROI ,旧值为 "60.00",新值为 "2.22"。
    修改了 成本 ,旧值为 "500",新值为 "13500"。
  6. 2026-09-30 15:35:28, 由 彭祥发 变更。
    修改了 当前状态,旧值为 "active",新值为 "changed"。
    修改了 版本号 ,旧值为 "2",新值为 "3"。
    修改了 需求描述,区别为:
    013- 二、 功能:JAVA物流系统--物流商对账单分析服务问题:财务确认状态同步很慢方案:将同步财务确认状态功能单独拆分一个独立服务,避免多个功能聚合在一个服务里面,执行很慢服务频率:2分钟执行一次,服务入口增加redis锁,避免服务卡顿情况下,上一轮服务还没结束,下一轮服务又开始,导致重复执行代码:com.zhcxkj.bus.tms.application.executor.cmd.logistics.LogisticsReconciliationFreightCmdExe#financialConfirmQueueExecute ,financialConfirmQueueExecute就是更新财务确认状态的方法
    013+ 二、 功能:JAVA物流系统--物流商对账单分析服务问题:财务确认状态同步很慢方案:将同步财务确认状态功能单独拆分一个独立服务,避免多个功能聚合在一个服务里面,执行很慢服务频率:2分钟执行一次,服务入口增加redis锁,避免服务卡顿情况下,上一轮服务还没结束,下一轮服务又开始,导致重复执行代码:com.zhcxkj.bus.tms.application.executor.cmd.logistics.LogisticsReconciliationFreightCmdExe#financialConfirmQueueExecute ,financialConfirmQueueExecute就是更新财务确认状态的方法
    016- 问题: 1、财务确认状态同步很慢 2、原服务执行完财务确认队列后,未处理ERP队列状态,导致同一个队列重复执行方案: 1、 财务确认队列自动执行服务独立出来,每5分钟执行一次,但是服务代码中增加redis缓存,避免上次任务还未执行完成,下次任务又开始了 2、服务执行成功后需要将erp队列执行状态更改为成功
    016+ 问题: 1、财务确认状态同步很慢 2、原服务执行完财务确认队列后,未处理ERP队列状态,导致同一个队列重复执行方案: 1、 财务确认队列自动执行服务独立出来,每5分钟执行一次,但是服务代码中增加redis缓存,避免上次任务还未执行完成,下次任务又开始了 2、服务执行成功后需要将erp队列执行状态更改为成功
    018- 四、ERP-财务审核-取消确认问题:操作取消确认后,物流提交批次状态会更新为已提交,财务审核状态会更新为未确认,但是数据未回写到JAVA方案: 操作取消确认后,实时调用java接口更新java物流提交批次状态
    018+ 四、ERP-财务审核-取消确认问题:操作取消确认后,物流提交批次状态会更新为已提交,财务审核状态会更新为未确认,但是数据未回写到JAVA方案: 操作取消确认后,实时调用java接口更新java物流提交批次状态
    020- 五、功能:erp操作财务审核确认或异常冲账界面操作确认和主干审核 问题:如果操作的物流提交批次在java不存在且打开了java数据处理开关,就会报错,提示“未找到可更新的对账单或无权操作” 方案:如果物流提交批次在java不存在,java接口直接返回成功
    020+ 五、功能:erp操作财务审核确认或异常冲账界面操作确认和主干审核 问题:如果操作的物流提交批次在java不存在且打开了java数据处理开关,就会报错,提示“未找到可更新的对账单或无权操作” 方案:如果物流提交批次在java不存在,java接口直接返回成功
    022- 六、功能:运输方式检查公共方法,备货运费计算公共方法,直发运费计算 功能方法 问题:精确邮编匹配的时候未去掉前后空格导致匹配异常 方案:精确邮编匹配的时候去掉前后空格
    022+ 六、功能:运输方式检查公共方法,备货运费计算公共方法,直发运费计算 功能方法 问题:精确邮编匹配的时候未去掉前后空格导致匹配异常
    023+ 方案:精确邮编匹配的时候去掉前后空格
    024+
    025+ 七、功能:从158拉取物流对账数据到java,物流对账明细包裹数据需要增加FinalShippingFee,PackageCost、DeclarationPriceSum问题:现在从158拉取物流对账数据到JAVA的时候,物流对账明细 包裹数据没有同步FinalShippingFee,PackageCost、DeclarationPriceSum字段,导致处理异常冲账数据失败方案:从158拉取物流对账数据到java,物流对账明细包裹数据需要增加FinalShippingFee,PackageCost、DeclarationPriceSum。影响功能:物流商对账-异常冲账
    026+
    027+ 八、ERP包裹税费跟JAVA税费不一致的问题的数据修复 问题:JAVA调用回写运费和税费接口的时候,有些操作没有传递税费(重估订单利润-更新系统预估费用),会将erp的税费清零 方案: 1、接口处理数据的时候,如果运费或税费没有传递数据则不更新对应字段 2、修复数据
    028+
    013- <span>二、 功能:JAVA物流系统--物流商对账单分析服务<br /></span><span>问题:财务确认状态同步很慢<br /></span><span>方案:将同步财务确认状态功能单独拆分一个独立服务,避免多个功能聚合在一个服务里面,执行很慢<br /></span><span>服务频率:2分钟执行一次,服务入口增加redis锁,避免服务卡顿情况下,上一轮服务还没结束,下一轮服务又开始,导致重复执行<br /></span><span>代码:com.zhcxkj.bus.tms.application.executor.cmd.logistics.LogisticsReconciliationFreightCmdExe#financialConfirmQueueExecute ,financialConfirmQueueExecute就是更新财务确认状态的方法<br /><br /></span>
    013+ <span>二、 功能:JAVA物流系统--物流商对账单分析服务<br /></span><span>问题:财务确认状态同步很慢<br /></span><span>方案:将同步财务确认状态功能单独拆分一个独立服务,避免多个功能聚合在一个服务里面,执行很慢<br /></span><span>服务频率:2分钟执行一次,服务入口增加redis锁,避免服务卡顿情况下,上一轮服务还没结束,下一轮服务又开始,导致重复执行<br /></span><span>代码:com.zhcxkj.bus.tms.application.executor.cmd.logistics.LogisticsReconciliationFreightCmdExe#financialConfirmQueueExecute ,financialConfirmQueueExecute就是更新财务确认状态的方法<br /><br /></span>
    016- <span>问题:<br /></span><span> 1、财务确认状态同步很慢<br /></span><span> 2、原服务执行完财务确认队列后,未处理ERP队列状态,导致同一个队列重复执行<br /></span><span>方案:<br /></span><span> 1、 财务确认队列自动执行服务独立出来,每5分钟执行一次,但是服务代码中增加redis缓存,避免上次任务还未执行完成,下次任务又开始了<br /></span><span> 2、服务执行成功后需要将erp队列执行状态更改为成功</span>
    016+ <span>问题:<br /></span><span> 1、财务确认状态同步很慢<br /></span><span> 2、原服务执行完财务确认队列后,未处理ERP队列状态,导致同一个队列重复执行<br /></span><span>方案:<br /></span><span> 1、 财务确认队列自动执行服务独立出来,每5分钟执行一次,但是服务代码中增加redis缓存,避免上次任务还未执行完成,下次任务又开始了<br /></span><span> 2、服务执行成功后需要将erp队列执行状态更改为成功</span>
    018- <span>四、ERP-财务审核-取消确认<br /></span><span>问题:操作取消确认后,物流提交批次状态会更新为已提交,财务审核状态会更新为未确认,但是数据未回写到JAVA<br /></span><span>方案:<br /></span><span> 操作取消确认后,实时调用java接口更新java物流提交批次状态</span>
    018+ <span>四、ERP-财务审核-取消确认<br /></span><span>问题:操作取消确认后,物流提交批次状态会更新为已提交,财务审核状态会更新为未确认,但是数据未回写到JAVA<br /></span><span>方案:<br /></span><span> 操作取消确认后,实时调用java接口更新java物流提交批次状态</span>
    020- <span>五、功能:erp操作财务审核确认或异常冲账界面操作确认和主干审核<br /></span><span> 问题:如果操作的物流提交批次在java不存在且打开了java数据处理开关,就会报错,提示“未找到可更新的对账单或无权操作”<br /></span><span> 方案:如果物流提交批次在java不存在,java接口直接返回成功</span>
    020+ <span>五、功能:erp操作财务审核确认或异常冲账界面操作确认和主干审核<br /></span><span> 问题:如果操作的物流提交批次在java不存在且打开了java数据处理开关,就会报错,提示“未找到可更新的对账单或无权操作”<br /></span><span> 方案:如果物流提交批次在java不存在,java接口直接返回成功</span>
    022- <span>六、功能:运输方式检查公共方法,备货运费计算公共方法,直发运费计算 功能方法<br /></span><span> 问题:精确邮编匹配的时候未去掉前后空格导致匹配异常<br /></span><span> 方案:精确邮编匹配的时候去掉前后空格</span><br /><p><br /></p>
    022+ <span>六、功能:运输方式检查公共方法,备货运费计算公共方法,直发运费计算 功能方法<br /></span><span> 问题:精确邮编匹配的时候未去掉前后空格导致匹配异常<br /></span>
    023+ <p><span> 方案:精确邮编匹配的时候去掉前后空格</span></p>
    024+ <p><span><br /></span></p>
    025+ <p><span><span>七、功能:从158拉取物流对账数据到java,物流对账明细包裹数据需要增加FinalShippingFee,PackageCost、DeclarationPriceSum<br /></span><span>问题:</span></span>现在从158拉取物流对账数据到JAVA的时候,物流对账明细 包裹数据没有同步FinalShippingFee,PackageCost、DeclarationPriceSum字段,导致处理异常冲账数据失败<br /><span><span>方案:</span><span>从158拉取物流对账数据到java,物流对账明细包裹数据需要增加FinalShippingFee,PackageCost、DeclarationPriceSum。<br /></span><span>影响功能:</span><span>物流商对账-异常冲账</span>
    026+ </span></p><p><br /></p>
    027+ <span>八、ERP包裹税费跟JAVA税费不一致的问题的数据修复<br /></span><span> 问题:</span><span>JAVA调用回写运费和税费接口的时候,有些操作没有传递税费(重估订单利润-更新系统预估费用),会将erp的税费清零<br /></span><span> 方案:<br /></span><span> 1、接口处理数据的时候,如果运费或税费没有传递数据则不更新对应字段<br /></span><span> 2、修复数据</span><br />
    028+ <p><br /></p>
  7. 2026-10-08 09:55:51, 由 周杰 编辑。
    修改了 计划验收时间,旧值为 "0000-00-00",新值为 "2026-10-16"。
  8. 2026-10-08 09:57:04, 由 周杰 编辑。
    修改了 预计工时,旧值为 "27",新值为 "40"。
    修改了 ROI ,旧值为 "2.22",新值为 "1.5"。
    修改了 成本 ,旧值为 "13500",新值为 "20000"。
  9. 2026-10-09 09:58:24, 由 刘超 编辑。
    修改了 测试人员,旧值为 "",新值为 "nongjiwang"。
  10. 2026-10-13 19:21:48, 由 农基望 编辑。
    修改了 所处阶段 ,旧值为 "tested",新值为 "released"。
    修改了 设置阶段者,旧值为 "",新值为 "nongjiwang"。
  11. 2026-10-14 09:32:35, 由 李乐同 编辑。
    修改了 所处阶段 ,旧值为 "released",新值为 "bepending"。
    修改了 设置阶段者,旧值为 "nongjiwang",新值为 "liletong"。
迭代版本
提报业务部门 技术研发中心
提报人员 程伟
需求来源 技术自主提报需求
所属项目 技术中心-需求池
所属模块 供应链   仓储物流   仓储
所属计划
业务价值
开发组 仓储物流开发组
受益业务部门 技术研发中心
验收人员 杨林军
业务目标类型
中心业务目标
业务价值 控制风险
每月价值量 5000
每月节省人数 0
优先级 P2
价值类型 长期价值
预计工时 40
成本 20000
ROI 1.50
操作手册 否
高价值 -
主被动 被动接收
复杂度 一般性
工作流ID
工作流创建时间
更新点
是否高危 否
评分
当前状态 已变更
所处阶段 业务验收中
关键词
评审次数 一次
计划上线 0000-00-00
上线时间 2026-10-13
计划验收时间 2026-10-16
业务验收时间
满意度
价值验收
满意度分值
业务回填价值
验收达成价值
验收达成ROI
抄送给
由谁创建 彭祥发 于 2026-09-23 15:58:27
指派给 程伟 于 2026-10-10 14:53:38
由谁评审
评审时间
由谁关闭
关闭原因
最后修改 李乐同 于 2026-10-14 09:32:34
相关Bug
相关用例
相关需求
细分需求