OPC/goauto
2
0
Fork 0
Code Issues 192 Pull Requests Actions Packages Projects Releases Wiki Activity

T35 服务端物流调度与货运宝自动回填 #37

New Issue
Open
opened 2026-08-17 10:00:50 +08:00 by ila · 0 comments
ila commented 2026-08-17 10:00:50 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：需求 / 服务端 / 外部接口
  • 所属总体设计：#32
  • 阶段：待实施（受 #32 QuantUX 原型审核门禁阻塞）

依赖与并行

  • 前置工单：#33、#34
  • 是否允许并行：可与Android物流采集在共享契约确认后并行

子项目影响

  • 交付单元：server / shared-docs
  • 是否跨子项目：是
  • 验证：Go单元、幂等、外部接口桩和MySQL集成测试

做什么

  • 为采购人员已确认支付且已选择为回填候选的采购任务创建/调度物流采集工作。
  • 按PDD账号分配物流任务，不要求原设备，但设备必须登录创建订单的同一PDD账号。
  • 接收并保存pdd_order_no对应的快递单号和采集时间。
  • 不同采购任务取得相同快递单号时允许保存并继续回填，不阻断流程。
  • 调用货运宝ERP接口自动回填快递单号，支持重复调用幂等和失败重试/人工重触发。
  • 回填成功后事务更新syb_products.effective_purchase_task_id；采购人员重新选择的新任务允许覆盖之前回填结果，但不能因先发货自动替换。
  • 记录待回填、回填中、成功和失败状态及脱敏错误，不记录凭据或原始外部数据。

不做什么

  • 不实现Android PDD页面遍历，不自动确认支付，不阻止重复快递单号。
  • 不删除旧采购任务、旧订单号或旧快递记录。

验收标准

  • 未人工确认支付或未人工选择的任务不会触发自动回填。
  • 同一回填请求重复执行不会产生不一致结果。
  • 相同快递单号可分别回填多个SYB商品明细。
  • 覆盖回填只发生在采购人员明确选择新任务之后。
  • 外部接口失败时任务不标记有效，错误可在Admin查看并可安全重触发。
  • 回填成功后有效任务指针与外部结果一致。

风险和回退

货运宝ERP属于外部系统；先使用桩验证，不在工单、日志或仓库保存Token和生产响应。支持关闭自动回填调度并保留待处理记录。

## 基本信息 - 类型：需求 / 服务端 / 外部接口 - 所属总体设计：#32 - 阶段：待实施（受 #32 QuantUX 原型审核门禁阻塞） ## 依赖与并行 - 前置工单：#33、#34 - 是否允许并行：可与Android物流采集在共享契约确认后并行 ## 子项目影响 - 交付单元：server / shared-docs - 是否跨子项目：是 - 验证：Go单元、幂等、外部接口桩和MySQL集成测试 ## 做什么 - 为采购人员已确认支付且已选择为回填候选的采购任务创建/调度物流采集工作。 - 按PDD账号分配物流任务，不要求原设备，但设备必须登录创建订单的同一PDD账号。 - 接收并保存pdd_order_no对应的快递单号和采集时间。 - 不同采购任务取得相同快递单号时允许保存并继续回填，不阻断流程。 - 调用货运宝ERP接口自动回填快递单号，支持重复调用幂等和失败重试/人工重触发。 - 回填成功后事务更新syb_products.effective_purchase_task_id；采购人员重新选择的新任务允许覆盖之前回填结果，但不能因先发货自动替换。 - 记录待回填、回填中、成功和失败状态及脱敏错误，不记录凭据或原始外部数据。 ## 不做什么 - 不实现Android PDD页面遍历，不自动确认支付，不阻止重复快递单号。 - 不删除旧采购任务、旧订单号或旧快递记录。 ## 验收标准 - [ ] 未人工确认支付或未人工选择的任务不会触发自动回填。 - [ ] 同一回填请求重复执行不会产生不一致结果。 - [ ] 相同快递单号可分别回填多个SYB商品明细。 - [ ] 覆盖回填只发生在采购人员明确选择新任务之后。 - [ ] 外部接口失败时任务不标记有效，错误可在Admin查看并可安全重触发。 - [ ] 回填成功后有效任务指针与外部结果一致。 ## 风险和回退 货运宝ERP属于外部系统；先使用桩验证，不在工单、日志或仓库保存Token和生产响应。支持关闭自动回填调度并保留待处理记录。
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: OPC/goauto#37