STORY #12257 海外仓-递四方物流对接 - 技术中心-需求池

业务需求

需求描述

背景：

盛宝隆需要使用这家物流商

API文档：http://open.4px.com/apiInfo/api#

单据类型范围：
• 客户订单
• 按箱产品中转出库单
• 按箱（不换标）中转出库单
• 预约转运单（即中转即发）
注意：按产品中转出库单、按箱（换标)中转出库单不支持这个API，这些单预生成时返回失败和异常
API服务代码定义：4PX
袋标签
ds.xms.bag.create接口返回的袋标签，同子跟踪号维度，用100*100mm标签尺寸打印
涉及功能点：
（1）《打印操作》/《打印物流Label》，打印物流面单时，与袋标签也一起打印；每箱/每客户订单的袋标签与物流面单作为一份，一份一份地打印
场景：订单提交时的预生成
物流商范围：
4PX
调用的API接口（按顺序）
（1）ds.xms.order.create(创建直发委托单)
http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=96
（2）ds.xms.label.get(获取标签)
http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=102
场景：生成拣货单时
订单状态范围：
• 海外仓代发
• 主状态：处理中、已出库
• 处理状态：不等于已提交
（3）ds.xms.bag.create——完成大包打包，获取大包号码和大包Label
http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=164
（4）ds.xms.batch_outbound.create——批次出库数据对接，4PX对接服务商预报数据
http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=134

验收标准

价值描述

xxx

历史记录

2022-09-21 10:14:04, 由 李源肇 创建。
2022-09-21 10:17:51, 由 李源肇 变更。
修改了 版本号 ，旧值为 "1"，新值为 "2"。
修改了 需求描述，区别为：
001-
001+ 背景：
002+
003+ 盛宝隆需要使用这家物流商
004+
005+ <a href="https://i0dpwo.axshare.com/#g=1&p=%EF%BC%88api%EF%BC%89%E5%AF%B9%E6%8E%A54px%E7%89%A9%E6%B5%81%EF%BC%889%E6%9C%88%E5%88%86%E6%94%AF%E7%89%88%E6%9C%AC%EF%BC%89">（API）对接4PX物流（9月分支版本） (axshare.com)
006+
007+ API文档：<a href="http://open.4px.com/apiInfo/api" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/api#
008+ 单据类型范围：
009+ • 客户订单• 按箱产品中转出库单• 按箱（不换标）中转出库单• 预约转运单（即中转即发）注意：按产品中转出库单、按箱（换标)中转出库单不支持这个API，这些单预生成时返回失败和异常API服务代码定义：4PX袋标签ds.xms.bag.create接口返回的袋标签，同子跟踪号维度，用100*100mm标签尺寸打印涉及功能点：（1）《打印操作》/《打印物流Label》，打印物流面单时，与袋标签也一起打印；每箱/每客户订单的袋标签与物流面单作为一份，一份一份地打印场景：订单提交时的预生成物流商范围：4PX调用的API接口（按顺序）（1）ds.xms.order.create(创建直发委托单)<a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=96" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=96（2）ds.xms.label.get(获取标签)<a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=102" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=102场景：生成拣货单时订单状态范围：• 海外仓代发• 主状态：处理中、已出库• 处理状态：不等于已提交（3）ds.xms.bag.create——完成大包打包，获取大包号码和大包Label<a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=164" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=164（4）ds.xms.batch_outbound.create——批次出库数据对接，4PX对接服务商预报数据<a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=134" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=134

001-
001+ <div class="detail-title" style="background-color:#FFFFFF;">背景：</div>
002+ <div class="detail-content article-content" style="font-size:14px;background-color:#FFFFFF;">
003+ 盛宝隆需要使用这家物流商
004+ 
005+ <a href="https://i0dpwo.axshare.com/#g=1&p=%EF%BC%88api%EF%BC%89%E5%AF%B9%E6%8E%A54px%E7%89%A9%E6%B5%81%EF%BC%889%E6%9C%88%E5%88%86%E6%94%AF%E7%89%88%E6%9C%AC%EF%BC%89">（API）对接4PX物流（9月分支版本） (axshare.com)</a>
006+ 
007+ API文档：<a href="http://open.4px.com/apiInfo/api" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/api</a>#
008+ 单据类型范围： 
009+ • 客户订单 • 按箱产品中转出库单 • 按箱（不换标）中转出库单 • 预约转运单（即中转即发） 注意：按产品中转出库单、按箱（换标)中转出库单不支持这个API，这些单预生成时返回失败和异常 API服务代码定义：4PX 袋标签 ds.xms.bag.create接口返回的袋标签，同子跟踪号维度，用100*100mm标签尺寸打印 涉及功能点： （1）《打印操作》/《打印物流Label》，打印物流面单时，与袋标签也一起打印；每箱/每客户订单的袋标签与物流面单作为一份，一份一份地打印 场景：订单提交时的预生成 物流商范围： 4PX 调用的API接口（按顺序） （1）ds.xms.order.create(创建直发委托单) <a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=96" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=96</a> （2）ds.xms.label.get(获取标签) <a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=102" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=102</a> 场景：生成拣货单时 订单状态范围： • 海外仓代发 • 主状态：处理中、已出库 • 处理状态：不等于已提交 （3）ds.xms.bag.create——完成大包打包，获取大包号码和大包Label <a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=164" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=164</a> （4）ds.xms.batch_outbound.create——批次出库数据对接，4PX对接服务商预报数据 <a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=134" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=134</a></div>
2022-09-21 10:20:24, 由 李源肇 编辑。
修改了 所属模块，旧值为 "1683"，新值为 "1684"。
2022-09-21 19:42:03, 由刘灿记录评审结果，结果为 确认通过。
修改了 评审时间，旧值为 "0000-00-00"，新值为 "2022-09-21"。
修改了 指派给 ，旧值为 "Admin186"，新值为 "liyuanzhao"。
修改了 当前状态，旧值为 "draft"，新值为 "active"。
修改了 由谁评审，旧值为 ""，新值为 "Admin186"。
2022-09-21 20:43:28, 由 李源肇 变更。
修改了 指派给 ，旧值为 "liyuanzhao"，新值为 "Admin186"。
修改了 当前状态，旧值为 "active"，新值为 "changed"。
修改了 版本号 ，旧值为 "2"，新值为 "3"。
修改了 由谁评审，旧值为 "Admin186"，新值为 ""。
修改了 评审时间，旧值为 "2022-09-21"，新值为 "0000-00-00"。
修改了 需求描述，区别为：
001- ~~背景：~~
001+ 一、背景和价值 1.背景 4PX渠道物流价格比原渠道低10%左右 2.价值现英国一件代发运费成本平均在16-24万人民币/月，相当于每月大概可以增加1.6-2.4万人民币的收入。二、需求描述 2.1. 功能清单 1.新增4PX物流客户订单对接 2.2.影响点 1.客户订单
002-
002+ 2.打印操作/打印物流Label
003- ~~盛宝隆需要使用这家物流商~~
003+ 2.3. 功能描述：
004-
004+ 2.3.1.API服务代码定义：4PX ,API文档：<a href="http://open.4px.com/apiInfo/api" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/api#
005- <a href="https://i0dpwo.axshare.com/#g=1&p=%EF%BC%88api%EF%BC%89%E5%AF%B9%E6%8E%A54px%E7%89%A9%E6%B5%81%EF%BC%889%E6%9C%88%E5%88%86%E6%94%AF%E7%89%88%E6%9C%AC%EF%BC%89">（API）对接4PX物流（9月分支版本） (axshare.com)
005+ 2.3.3.场景：生成拣货单时 1)订单状态范围：• 海外仓代发,
006-
006+ 2)主状态：处理中、已出库,处理状态：不等于已提交
007- ~~API文档：<a href="http://open.4px.com/apiInfo/api" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/api#~~
007+ 2.3.4.涉及的相关功能
008- ~~单据类型范围：~~
008+ 1.《打印操作》/《打印物流Label》，打印物流面单时，与袋标签也一起打印；每箱/每客户订单的袋标签与物流面单作为一份，一份一份地打印 2.场景：订单提交时的预生成，物流商范围：4PX，接口调用顺序 1) ds.xms.order.create(创建直发委托单):<a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=96" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=96<a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=102" target="_blank" rel="noreferrer noopener">
009- • 客户订单• 按箱产品中转出库单• 按箱（不换标）中转出库单• 预约转运单（即中转即发）注意：按产品中转出库单、按箱（换标)中转出库单不支持这个API，这些单预生成时返回失败和异常API服务代码定义：4PX袋标签ds.xms.bag.create接口返回的袋标签，同子跟踪号维度，用100*100mm标签尺寸打印涉及功能点：（1）《打印操作》/《打印物流Label》，打印物流面单时，与袋标签也一起打印；每箱/每客户订单的袋标签与物流面单作为一份，一份一份地打印场景：订单提交时的预生成物流商范围：4PX调用的API接口（按顺序）（1）ds.xms.order.create(创建直发委托单)<a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=96" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=96（2）ds.xms.label.get(获取标签)<a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=102" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=102场景：生成拣货单时订单状态范围：• 海外仓代发• 主状态：处理中、已出库• 处理状态：不等于已提交（3）ds.xms.bag.create——完成大包打包，获取大包号码和大包Label<a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=164" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=164（4）ds.xms.batch_outbound.create——批次出库数据对接，4PX对接服务商预报数据<a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=134" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=134
009+ 2)ds.xms.label.get(获取标签):<a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=102" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=102
010+

001- ~~<div class="detail-title" style="background-color:#FFFFFF;">背景：</div>~~
001+ 一、背景和价值 1.背景 4PX渠道物流价格比原渠道低10%左右 2.价值 现英国一件代发运费成本平均在16-24万人民币/月，相当于每月大概可以增加1.6-2.4万人民币的收入。 二、需求描述 2.1. 功能清单 1.新增4PX物流客户订单对接 2.2.影响点 1.客户订单
002- ~~<div class="detail-content article-content" style="font-size:14px;background-color:#FFFFFF;">~~
002+ 2.打印操作/打印物流Label
003- ~~盛宝隆需要使用这家物流商~~
003+ 2.3. 功能描述：
004- ~~ ~~
004+ 2.3.1.API服务代码定义：4PX ,API文档：<a href="http://open.4px.com/apiInfo/api" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/api</a>#
005- <a href="https://i0dpwo.axshare.com/#g=1&p=%EF%BC%88api%EF%BC%89%E5%AF%B9%E6%8E%A54px%E7%89%A9%E6%B5%81%EF%BC%889%E6%9C%88%E5%88%86%E6%94%AF%E7%89%88%E6%9C%AC%EF%BC%89">（API）对接4PX物流（9月分支版本） (axshare.com)</a>
005+ 2.3.3.场景：生成拣货单时 1)订单状态范围：• 海外仓代发,
006- ~~ ~~
006+ 2)主状态：处理中、已出库,处理状态：不等于已提交
007- ~~API文档：<a href="http://open.4px.com/apiInfo/api" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/api</a>#~~
007+ 2.3.4.涉及的相关功能
008- ~~单据类型范围： ~~
008+ 1.《打印操作》/《打印物流Label》，打印物流面单时，与袋标签也一起打印；每箱/每客户订单的袋标签与物流面单作为一份，一份一份地打印 2.场景：订单提交时的预生成，物流商范围：4PX，接口调用顺序 1) ds.xms.order.create(创建直发委托单):<a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=96" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=96</a> <a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=102" target="_blank" rel="noreferrer noopener"></a>
009- • 客户订单 • 按箱产品中转出库单 • 按箱（不换标）中转出库单 • 预约转运单（即中转即发） 注意：按产品中转出库单、按箱（换标)中转出库单不支持这个API，这些单预生成时返回失败和异常 API服务代码定义：4PX 袋标签 ds.xms.bag.create接口返回的袋标签，同子跟踪号维度，用100*100mm标签尺寸打印 涉及功能点： （1）《打印操作》/《打印物流Label》，打印物流面单时，与袋标签也一起打印；每箱/每客户订单的袋标签与物流面单作为一份，一份一份地打印 场景：订单提交时的预生成 物流商范围： 4PX 调用的API接口（按顺序） （1）ds.xms.order.create(创建直发委托单) <a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=96" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=96</a> （2）ds.xms.label.get(获取标签) <a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=102" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=102</a> 场景：生成拣货单时 订单状态范围： • 海外仓代发 • 主状态：处理中、已出库 • 处理状态：不等于已提交 （3）ds.xms.bag.create——完成大包打包，获取大包号码和大包Label <a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=164" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=164</a> （4）ds.xms.batch_outbound.create——批次出库数据对接，4PX对接服务商预报数据 <a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=134" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=134</a></div>
009+ 2)ds.xms.label.get(获取标签):<a href="http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=102" target="_blank" rel="noreferrer noopener">http://open.4px.com/apiInfo/apiDetail?itemId=2&mainId=102</a>
010+
2022-09-21 20:43:35, 由 李源肇 编辑。
修改了 每月价值量，旧值为 "提升物流渠道多样化"，新值为 "每月大概可以增加1.6-2.4万人民币的收入"。
2022-09-22 12:00:59, 由刘灿记录评审结果，结果为 确认通过。
修改了 评审时间，旧值为 "0000-00-00"，新值为 "2022-09-22"。
修改了 指派给 ，旧值为 "Admin186"，新值为 "liyuanzhao"。
修改了 当前状态，旧值为 "changed"，新值为 "active"。
修改了 由谁评审，旧值为 ""，新值为 "Admin186"。
2022-09-22 13:43:20, 由 zhengqiao 关联到迭代 技术研发中心 10月第1版本（2022年） 。
2022-10-20 10:38:50, 由 zhengqiao 关联到迭代 技术研发中心 10月分支版本（2022年） 。
2022-10-20 10:40:01, 由 zhengqiao 从迭代 #653 技术研发中心 10月第1版本（2022年） 移除。
2022-10-31 13:46:59, 由 zhengqiao 编辑。
修改了 操作手册 ，旧值为 ""，新值为 "no"。
修改了 所处阶段 ，旧值为 "tested"，新值为 "released"。
修改了 设置阶段者，旧值为 ""，新值为 "zhengqiao"。
2022-10-31 13:49:31, 由 zhengqiao 关闭，原因为 已完成 。
修改了 由谁关闭，旧值为 ""，新值为 "zhengqiao"。
修改了 关闭日期，旧值为 "0000-00-00 00:00:00"，新值为 "2022-10-31 13:49:31"。
修改了 指派给 ，旧值为 "liyuanzhao"，新值为 "closed"。
修改了 当前状态，旧值为 "active"，新值为 "closed"。
修改了 所处阶段，旧值为 "released"，新值为 "closed"。
修改了 关闭原因，旧值为 ""，新值为 "done"。
2023-03-04 15:24:38, 由周杰编辑。
修改了 所属模块，旧值为 "1684"，新值为 "1742"。
2023-11-16 20:27:15, 由周杰编辑。
修改了 所属模块，旧值为 "1742"，新值为 "1854"。

基本信息
需求的一生

迭代版本
提报业务部门
提报人员	李源肇
需求来源	业务方迭代需求
所属项目	技术中心-需求池
所属模块	供应链仓储物流
所属计划
业务价值
开发组
受益业务部门	运营管理中心-新品类项目部
验收人员
业务目标类型
中心业务目标
业务价值	提升人效
每月价值量	每月大概可以增加1.6-2.4万人民币的收入
每月节省人数	0
优先级	P2
价值类型
预计工时	24
成本
ROI
操作手册	否
高价值
主被动
复杂度
工作流ID
工作流创建时间
更新点
是否高危	否
评分
当前状态	已关闭
所处阶段	已关闭
关键词
评审次数
计划上线
上线时间
计划验收时间
业务验收时间
满意度
价值验收
满意度分值
业务回填价值
验收达成价值
验收达成ROI
抄送给

由谁创建	李源肇于 2022-09-21 10:14:04
指派给	Closed 于 2022-10-31 13:49:31
由谁评审	刘灿
评审时间	2022-09-22
由谁关闭	zhengqiao 于 2022-10-31 13:49:31
关闭原因	已完成
最后修改	周杰于 2023-11-16 20:27:08

迭代任务
相关信息

相关Bug	[B] #32431 海外仓-4PX的皇家邮政没有生成跟踪号，但是物流商后台有跟踪号生成
相关用例
相关需求
细分需求