1. 背景

新物流，美通物流备货渠道对接

沟通渠道

钉钉群【美通系统对接】---确定好开发人员后进群

账号信息（正式环境账号，测试前请先沟通）

域名：http://aafexp.nextsls.com

token：62d6787d3ac7ac04952a2ddc62d6787db4d637962

api文档
见附件

2. 功能设计

1）【备库订单包裹（新）-待发货】页面，操作功能中，增加以下3个按钮：

预报至美通物流
获取标签
取消预报

2）预报至美通物流

接口地址：http://<域名>/api/v4/shipment/create

3）获取标签

接口地址：

http://<域名>/api/v4/shipment/get_labels

4）取消预报

接口地址：http://<域名>/api/v4/shipment/void

验收标准

价值描述

美通物流对接，新的物流商有价格优势

附件

历史记录

2022-08-01 15:59:47, 由 田子豪 创建。
2022-08-02 09:26:48, 由 田子豪 编辑。
修改了 关键词，旧值为 "预计8月2日发版"，新值为 ""。
2022-08-03 19:52:31, 由 田子豪 变更。
修改了 版本号 ，旧值为 "1"，新值为 "2"。
修改了 需求名称，区别为：
001- ~~美通物流对接（8月2版本）~~
001+ 美通物流对接-备货渠道（8月2版本）

001- ~~美通物流对接（8月2版本）~~
001+ 美通物流对接-备货渠道（8月2版本）
修改了 需求描述，区别为：
003- ~~新物流，美通物流对接~~
003+ 新物流，美通物流备货渠道对接
004-
004+
005- ~~2. 功能设计~~
005+ 沟通渠道
006-
006+ 钉钉群【美通系统对接】---确定好开发人员后进群
007- ~~账号信息（正式环境账号，测试前请先沟通）~~
007+
009-
009+ 账号信息（正式环境账号，测试前请先沟通）
010-
010+ 域名：<a href="http://aafexp.nextsls.com/" target="_blank" rel="noreferrer noopener">http://aafexp.nextsls.com
011-
011+ token：62d6787d3ac7ac04952a2ddc62d6787db4d637962
012-
012+
013-
013+ api文档见附件
014+
015+
016+ 2. 功能设计
017+
018+ 1）【备库订单包裹（新）-待发货】页面，操作功能中，增加以下3个按钮：
019+
020+ 预报至美通物流
021+ 获取标签
022+ 取消预报
023+
024+
025+ 2）预报至美通物流
026+ 接口地址：http://<域名>/api/v4/shipment/create
027+
028+ 3）获取标签
029+ 接口地址：
030+ http://<域名>/api/v4/shipment/get_labels
031+
032+
033+ 4）取消预报
034+ 接口地址：http://<域名>/api/v4/shipment/void
035+
036+
037+
038+
039+

003- ~~新物流，美通物流对接~~
003+ 新物流，美通物流备货渠道对接
004- ~~ ~~
004+ 
005- ~~2. 功能设计~~
005+ 沟通渠道
006- ~~ ~~
006+ 钉钉群【美通系统对接】---确定好开发人员后进群
007- ~~账号信息（正式环境账号，测试前请先沟通）~~
007+ 
009- ~~ ~~
009+ 账号信息（正式环境账号，测试前请先沟通）
010- ~~ ~~
010+ 域名：<a href="http://aafexp.nextsls.com/" target="_blank" rel="noreferrer noopener">http://aafexp.nextsls.com</a>
011- ~~ ~~
011+ token：62d6787d3ac7ac04952a2ddc62d6787db4d637962
012- ~~ ~~
012+ 
013- ~~ ~~
013+ api文档 见附件
014+ 
015+ 
016+ 2. 功能设计
017+ 
018+ 1）【备库订单包裹（新）-待发货】页面，操作功能中，增加以下3个按钮：
019+ 
020+ <ul><li>预报至美通物流</li>
021+ <li>获取标签</li>
022+ <li>取消预报</li>
023+ </ul> 
024+ 
025+ 2）预报至美通物流
026+ 接口地址：http://<域名>/api/v4/shipment/create
027+ 
028+ 3）获取标签
029+ 接口地址：
030+ <div>http://<域名>/api/v4/shipment/get_labels</div>
031+ 
032+ 
033+ 4）取消预报
034+ 接口地址：http://<域名>/api/v4/shipment/void
035+ 
036+ 
037+ 
038+ 
039+ 

上传了附件智慧物流系统-API文档V4.pdf
2022-08-03 20:09:14, 由 田子豪 变更。
修改了 版本号 ，旧值为 "2"，新值为 "3"。
修改了 需求描述，区别为：
018- ~~1）【备库订单包裹（新）-待发货】页面，操作功能中，增加以下3个按钮：~~
018+ 1）【备库订单包裹（新）-待发货】页面，操作功能中，增加以下3个按钮，展示位置在已有按钮上面：
023-
023+
024-
024+
025- ~~2）预报至美通物流~~
025+ 2）预报至美通物流（对应文档中接口：创建运单）
026- ~~接口地址：http://<域名>/api/v4/shipment/create~~
026+
027-
027+ 接口地址：http://<域名>/api/v4/shipment/create
028- ~~3）获取标签~~
028+
029- ~~接口地址：~~
029+ 重要事项说明：
030- ~~http://<域名>/api/v4/shipment/get_labels~~
030+
031-
031+
032-
032+ 按照包裹维度进行预报，产品信息和装箱信息，取包裹上的数据进行同步。
033- ~~4）取消预报~~
033+ 参考号：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号，并且将合并发货下面的所有的包裹装箱信息及产品基础信息进行同步。
034- ~~接口地址：http://<域名>/api/v4/shipment/void~~
034+ 如果是组合sku，取组合sku的报关价/报关金额/数量（产品库）中取进行同步预报。
035-
035+ 箱编号：如果存在合并发货，包裹2的编号在包裹1的基础上进行累加。
036-
036+
037-
037+
039-
039+
040+ 重要参数说明：
041+ CustomerOrderNumber ：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号。PackageCount：总共的箱子数Weight：总箱子实际重Receiver：包裹收货地址Sender：运输方式的回邮地址信息Parcels：非必填可以传的也都需要传，如海关编码等（组合产品取产品库中组合sku的信息）ChildOrders：取装箱清单中的数据BoxNumber：用包裹号加箱号进行传入，比如D23564-1,D23564-2,D569898-1
042+
043+ 返参说明：
044+ WayBillNumber：存在物流商单号TrackingNumber ：存在追踪号ShipperBoxs中的ShipperHawbcode：依照对照返回的箱号，存储在箱追踪号上
045+
046+
047+ 3）获取标签（对应文档中接口：标签获取）
048+ 接口地址：
049+ http://<域名>/api/v4/shipment/get_labels
050+
051+ 将接口返回的URL面单进行打印
052+
053+
054+ 4）取消预报（对应文档中接口：取消订单）
055+ 接口地址：http://<域名>/api/v4/shipment/void
056+
057+ 根据接口返回进行处理：
058+ 如果返回异常：弹窗提示；
059+ 如果成功，则清除包裹/订单追踪号；
060+
061+
062+
063+
064+
065+

018- ~~1）【备库订单包裹（新）-待发货】页面，操作功能中，增加以下3个按钮：~~
018+ 1）【备库订单包裹（新）-待发货】页面，操作功能中，增加以下3个按钮，展示位置在已有按钮上面：
023- ~~</ul> ~~
023+ </ul><img src="{209099.png}" alt="" />
024- ~~ ~~
024+ 
025- ~~2）预报至美通物流~~
025+ 2）预报至美通物流（对应文档中接口：创建运单）
026- ~~接口地址：http://<域名>/api/v4/shipment/create~~
026+ 
027- ~~ ~~
027+ 接口地址：http://<域名>/api/v4/shipment/create
028- ~~3）获取标签~~
028+ 
029- ~~接口地址：~~
029+ 重要事项说明：
030- ~~<div>http://<域名>/api/v4/shipment/get_labels</div>~~
030+ 
031- ~~ ~~
031+ 
032- ~~ ~~
032+ <ul><li>按照包裹维度进行预报，产品信息和装箱信息，取包裹上的数据进行同步。</li>
033- ~~4）取消预报~~
033+ <li>参考号：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号，并且将合并发货下面的所有的包裹装箱信息及产品基础信息进行同步。</li>
034- ~~接口地址：http://<域名>/api/v4/shipment/void~~
034+ <li>如果是组合sku，取组合sku的报关价/报关金额/数量（产品库）中取进行同步预报。</li>
035- ~~ ~~
035+ <li>箱编号：如果存在合并发货，包裹2的编号在包裹1的基础上进行累加。</li>
036- ~~ ~~
036+ </ul> 
037- ~~ ~~
037+ 
039- ~~ ~~
039+ 
040+ 重要参数说明：
041+ CustomerOrderNumber ：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号。 PackageCount：总共的箱子数 Weight：总箱子实际重 Receiver：包裹收货地址 Sender：运输方式的回邮地址信息 Parcels：非必填可以传的也都需要传，如海关编码等（组合产品取产品库中组合sku的信息） ChildOrders：取装箱清单中的数据 BoxNumber：用包裹号加箱号进行传入，比如D23564-1,D23564-2,D569898-1
042+ 
043+ 返参说明：
044+ WayBillNumber：存在物流商单号 TrackingNumber ：存在追踪号 ShipperBoxs中的ShipperHawbcode：依照对照返回的箱号，存储在箱追踪号上
045+ 
046+ 
047+ 3）获取标签（对应文档中接口：标签获取）
048+ 接口地址：
049+ http://<域名>/api/v4/shipment/get_labels
050+ 
051+ 将接口返回的URL面单进行打印
052+ 
053+ 
054+ 4）取消预报（对应文档中接口：取消订单）
055+ 接口地址：http://<域名>/api/v4/shipment/void
056+ 
057+ 根据接口返回进行处理：
058+ 如果返回异常：弹窗提示；
059+ 如果成功，则清除包裹/订单追踪号；
060+ 
061+ 
062+ 
063+ 
064+ 
065+
2022-08-03 20:11:55, 由 田子豪 变更。
修改了 版本号 ，旧值为 "3"，新值为 "4"。
修改了 需求描述，区别为：
032- ~~按照包裹维度进行预报，产品信息和装箱信息，取包裹上的数据进行同步。~~
032+ 按照包裹维度进行预报，产品信息和装箱信息，取包裹上的数据进行同步；
033- 参考号：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号，并且将合并发货下面的所有的包裹装箱信息及产品基础信息进行同步。
033+ 参考号：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号，并且将合并发货下面的所有的包裹装箱信息及产品基础信息进行同步；
034- ~~如果是组合sku，取组合sku的报关价/报关金额/数量（产品库）中取进行同步预报。~~
034+ 如果是组合sku，取组合sku的报关价/报关金额/数量（产品库）中取进行同步预报；
035- ~~箱编号：如果存在合并发货，包裹2的编号在包裹1的基础上进行累加。~~
035+ 箱编号：如果存在合并发货，包裹2的编号在包裹1的基础上进行累加；
061-
061+ 5）运输方式API管理
063-
063+ 6）运输方式管理
065-
065+
066+
067+

032- ~~<ul><li>按照包裹维度进行预报，产品信息和装箱信息，取包裹上的数据进行同步。</li>~~
032+ <ul><li>按照包裹维度进行预报，产品信息和装箱信息，取包裹上的数据进行同步；</li>
033- <li>参考号：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号，并且将合并发货下面的所有的包裹装箱信息及产品基础信息进行同步。</li>
033+ <li>参考号：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号，并且将合并发货下面的所有的包裹装箱信息及产品基础信息进行同步；</li>
034- ~~<li>如果是组合sku，取组合sku的报关价/报关金额/数量（产品库）中取进行同步预报。</li>~~
034+ <li>如果是组合sku，取组合sku的报关价/报关金额/数量（产品库）中取进行同步预报；</li>
035- ~~<li>箱编号：如果存在合并发货，包裹2的编号在包裹1的基础上进行累加。</li>~~
035+ <li>箱编号：如果存在合并发货，包裹2的编号在包裹1的基础上进行累加；</li>
061- ~~ ~~
061+ 5）运输方式API管理
063- ~~ ~~
063+ 6）运输方式管理
065- ~~ ~~
065+ 
066+ 
067+
2022-08-03 20:16:09, 由 田子豪 变更。
修改了 版本号 ，旧值为 "4"，新值为 "5"。
修改了 需求描述，区别为：
012-
012+ 渠道代码：
013- ~~api文档见附件~~
013+ 渠道名称：
014-
014+
015-
015+ api文档见附件
016- ~~2. 功能设计~~
016+
017-
017+
018- ~~1）【备库订单包裹（新）-待发货】页面，操作功能中，增加以下3个按钮，展示位置在已有按钮上面：~~
018+ 2. 功能设计
020- ~~预报至美通物流~~
020+ 1）【备库订单包裹（新）-待发货】页面，操作功能中，增加以下3个按钮，展示位置在已有按钮上面：
021- ~~获取标签~~
021+
022- ~~取消预报~~
022+ 预报至美通物流
023-
023+ 获取标签
024-
024+ 取消预报
025- ~~2）预报至美通物流（对应文档中接口：创建运单）~~
025+
026-
026+
027- ~~接口地址：http://<域名>/api/v4/shipment/create~~
027+ 2）预报至美通物流（对应文档中接口：创建运单）
029- ~~重要事项说明：~~
029+ 接口地址：http://<域名>/api/v4/shipment/create
031-
031+ 重要事项说明：
032- ~~按照包裹维度进行预报，产品信息和装箱信息，取包裹上的数据进行同步；~~
032+
033- 参考号：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号，并且将合并发货下面的所有的包裹装箱信息及产品基础信息进行同步；
033+
034- ~~如果是组合sku，取组合sku的报关价/报关金额/数量（产品库）中取进行同步预报；~~
034+ 按照包裹维度进行预报，产品信息和装箱信息，取包裹上的数据进行同步；
035- ~~箱编号：如果存在合并发货，包裹2的编号在包裹1的基础上进行累加；~~
035+ 参考号：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号，并且将合并发货下面的所有的包裹装箱信息及产品基础信息进行同步；
036-
036+ 如果是组合sku，取组合sku的报关价/报关金额/数量（产品库）中取进行同步预报；
037-
037+ 箱编号：如果存在合并发货，包裹2的编号在包裹1的基础上进行累加；
038-
038+
039-
039+
040- ~~重要参数说明：~~
040+
041- CustomerOrderNumber ：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号。PackageCount：总共的箱子数Weight：总箱子实际重Receiver：包裹收货地址Sender：运输方式的回邮地址信息Parcels：非必填可以传的也都需要传，如海关编码等（组合产品取产品库中组合sku的信息）ChildOrders：取装箱清单中的数据BoxNumber：用包裹号加箱号进行传入，比如D23564-1,D23564-2,D569898-1
041+
042-
042+ 重要参数说明：
043- ~~返参说明：~~
043+ CustomerOrderNumber ：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号。PackageCount：总共的箱子数Weight：总箱子实际重Receiver：包裹收货地址Sender：运输方式的回邮地址信息Parcels：非必填可以传的也都需要传，如海关编码等（组合产品取产品库中组合sku的信息）ChildOrders：取装箱清单中的数据BoxNumber：用包裹号加箱号进行传入，比如D23564-1,D23564-2,D569898-1
044- ~~WayBillNumber：存在物流商单号TrackingNumber ：存在追踪号ShipperBoxs中的ShipperHawbcode：依照对照返回的箱号，存储在箱追踪号上~~
044+
045-
045+ 返参说明：
046-
046+ WayBillNumber：存在物流商单号TrackingNumber ：存在追踪号ShipperBoxs中的ShipperHawbcode：依照对照返回的箱号，存储在箱追踪号上
047- ~~3）获取标签（对应文档中接口：标签获取）~~
047+
048- ~~接口地址：~~
048+
049- ~~http://<域名>/api/v4/shipment/get_labels~~
049+ 3）获取标签（对应文档中接口：标签获取）
050-
050+ 接口地址：
051- ~~将接口返回的URL面单进行打印~~
051+ http://<域名>/api/v4/shipment/get_labels
052-
052+
053-
053+ 将接口返回的URL面单进行打印
054- ~~4）取消预报（对应文档中接口：取消订单）~~
054+
055- ~~接口地址：http://<域名>/api/v4/shipment/void~~
055+
056-
056+ 4）取消预报（对应文档中接口：取消订单）
057- ~~根据接口返回进行处理：~~
057+ 接口地址：http://<域名>/api/v4/shipment/void
058- ~~如果返回异常：弹窗提示；~~
058+
059- ~~如果成功，则清除包裹/订单追踪号；~~
059+ 根据接口返回进行处理：
060-
060+ 如果返回异常：弹窗提示；
061- ~~5）运输方式API管理~~
061+ 如果成功，则清除包裹/订单追踪号；
062-
062+
063- ~~6）运输方式管理~~
063+ 5）运输方式API管理
065-
065+ 6）运输方式管理
067-
067+
068+
069+

012- ~~ ~~
012+ 渠道代码：
013- ~~api文档 见附件~~
013+ 渠道名称：
014- ~~ ~~
014+ 
015- ~~ ~~
015+ api文档 见附件
016- ~~2. 功能设计~~
016+ 
017- ~~ ~~
017+ 
018- ~~1）【备库订单包裹（新）-待发货】页面，操作功能中，增加以下3个按钮，展示位置在已有按钮上面：~~
018+ 2. 功能设计
020- ~~<ul><li>预报至美通物流</li>~~
020+ 1）【备库订单包裹（新）-待发货】页面，操作功能中，增加以下3个按钮，展示位置在已有按钮上面：
021- ~~<li>获取标签</li>~~
021+ 
022- ~~<li>取消预报</li>~~
022+ <ul><li>预报至美通物流</li>
023- ~~</ul><img src="{209099.png}" alt="" />~~
023+ <li>获取标签</li>
024- ~~ ~~
024+ <li>取消预报</li>
025- ~~2）预报至美通物流（对应文档中接口：创建运单）~~
025+ </ul><img src="{209099.png}" alt="" />
026- ~~ ~~
026+ 
027- ~~接口地址：http://<域名>/api/v4/shipment/create~~
027+ 2）预报至美通物流（对应文档中接口：创建运单）
029- ~~重要事项说明：~~
029+ 接口地址：http://<域名>/api/v4/shipment/create
031- ~~ ~~
031+ 重要事项说明：
032- ~~<ul><li>按照包裹维度进行预报，产品信息和装箱信息，取包裹上的数据进行同步；</li>~~
032+ 
033- <li>参考号：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号，并且将合并发货下面的所有的包裹装箱信息及产品基础信息进行同步；</li>
033+ 
034- ~~<li>如果是组合sku，取组合sku的报关价/报关金额/数量（产品库）中取进行同步预报；</li>~~
034+ <ul><li>按照包裹维度进行预报，产品信息和装箱信息，取包裹上的数据进行同步；</li>
035- ~~<li>箱编号：如果存在合并发货，包裹2的编号在包裹1的基础上进行累加；</li>~~
035+ <li>参考号：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号，并且将合并发货下面的所有的包裹装箱信息及产品基础信息进行同步；</li>
036- ~~</ul> ~~
036+ <li>如果是组合sku，取组合sku的报关价/报关金额/数量（产品库）中取进行同步预报；</li>
037- ~~~~
037+ <li>箱编号：如果存在合并发货，包裹2的编号在包裹1的基础上进行累加；</li>
038- ~~ ~~
038+ </ul> 
039- ~~ ~~
039+ 
040- ~~重要参数说明：~~
040+ 
041- CustomerOrderNumber ：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号。 PackageCount：总共的箱子数 Weight：总箱子实际重 Receiver：包裹收货地址 Sender：运输方式的回邮地址信息 Parcels：非必填可以传的也都需要传，如海关编码等（组合产品取产品库中组合sku的信息） ChildOrders：取装箱清单中的数据 BoxNumber：用包裹号加箱号进行传入，比如D23564-1,D23564-2,D569898-1
041+ 
042- ~~ ~~
042+ 重要参数说明：
043- ~~返参说明：~~
043+ CustomerOrderNumber ：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号。 PackageCount：总共的箱子数 Weight：总箱子实际重 Receiver：包裹收货地址 Sender：运输方式的回邮地址信息 Parcels：非必填可以传的也都需要传，如海关编码等（组合产品取产品库中组合sku的信息） ChildOrders：取装箱清单中的数据 BoxNumber：用包裹号加箱号进行传入，比如D23564-1,D23564-2,D569898-1
044- WayBillNumber：存在物流商单号 TrackingNumber ：存在追踪号 ShipperBoxs中的ShipperHawbcode：依照对照返回的箱号，存储在箱追踪号上
044+ 
045- ~~ ~~
045+ 返参说明：
046- ~~ ~~
046+ WayBillNumber：存在物流商单号 TrackingNumber ：存在追踪号 ShipperBoxs中的ShipperHawbcode：依照对照返回的箱号，存储在箱追踪号上
047- ~~3）获取标签（对应文档中接口：标签获取）~~
047+ 
048- ~~接口地址：~~
048+ 
049- ~~http://<域名>/api/v4/shipment/get_labels~~
049+ 3）获取标签（对应文档中接口：标签获取）
050- ~~ ~~
050+ 接口地址：
051- ~~将接口返回的URL面单进行打印~~
051+ http://<域名>/api/v4/shipment/get_labels
052- ~~ ~~
052+ 
053- ~~ ~~
053+ 将接口返回的URL面单进行打印
054- ~~4）取消预报（对应文档中接口：取消订单）~~
054+ 
055- ~~接口地址：http://<域名>/api/v4/shipment/void~~
055+ 
056- ~~ ~~
056+ 4）取消预报（对应文档中接口：取消订单）
057- ~~根据接口返回进行处理：~~
057+ 接口地址：http://<域名>/api/v4/shipment/void
058- ~~如果返回异常：弹窗提示；~~
058+ 
059- ~~如果成功，则清除包裹/订单追踪号；~~
059+ 根据接口返回进行处理：
060- ~~ ~~
060+ 如果返回异常：弹窗提示；
061- ~~5）运输方式API管理~~
061+ 如果成功，则清除包裹/订单追踪号；
062- ~~ ~~
062+ 
063- ~~6）运输方式管理~~
063+ 5）运输方式API管理
065- ~~ ~~
065+ 6）运输方式管理
067- ~~ ~~
067+ 
068+ 
069+
2022-08-04 15:13:38, 由 田子豪 编辑。
修改了 所属计划，旧值为 "548"，新值为 "605"。
2022-08-07 23:42:47, 由 田子豪 变更。
修改了 版本号 ，旧值为 "5"，新值为 "6"。
修改了 需求描述，区别为：
012- ~~渠道代码：~~
012+ 渠道代码：BL-G
013- ~~渠道名称：~~
013+
014-
014+ api文档见附件
015- ~~api文档见附件~~
015+
016-
016+
017-
017+ 2. 功能设计
018- ~~2. 功能设计~~
018+
019-
019+ 1）【备库订单包裹（新）-待发货】页面，操作功能中，增加以下3个按钮，展示位置在已有按钮上面：
020- ~~1）【备库订单包裹（新）-待发货】页面，操作功能中，增加以下3个按钮，展示位置在已有按钮上面：~~
020+
021-
021+ 预报至美通物流
022- ~~预报至美通物流~~
022+ 获取标签
023- ~~获取标签~~
023+ 取消预报
024- ~~取消预报~~
024+
025-
025+
026-
026+ 2）预报至美通物流（对应文档中接口：创建运单）
027- ~~2）预报至美通物流（对应文档中接口：创建运单）~~
027+
028-
028+ 接口地址：http://<域名>/api/v4/shipment/create
029- ~~接口地址：http://<域名>/api/v4/shipment/create~~
029+
030-
030+ 重要事项说明：
031- ~~重要事项说明：~~
031+
033-
033+ 按照包裹维度进行预报，产品信息和装箱信息，取包裹上的数据进行同步；
034- ~~按照包裹维度进行预报，产品信息和装箱信息，取包裹上的数据进行同步；~~
034+ 参考号：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号，并且将合并发货下面的所有的包裹装箱信息及产品基础信息进行同步；
035- 参考号：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号，并且将合并发货下面的所有的包裹装箱信息及产品基础信息进行同步；
035+ 如果是组合sku，取组合sku的报关价/报关金额/数量（产品库）中取进行同步预报；
036- ~~如果是组合sku，取组合sku的报关价/报关金额/数量（产品库）中取进行同步预报；~~
036+ 箱编号：如果存在合并发货，包裹2的编号在包裹1的基础上进行累加；
037- ~~箱编号：如果存在合并发货，包裹2的编号在包裹1的基础上进行累加；~~
037+
038-
038+
039-
039+
040-
040+
041-
041+ 重要参数说明：
042- ~~重要参数说明：~~
042+
043- CustomerOrderNumber ：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号。PackageCount：总共的箱子数Weight：总箱子实际重Receiver：包裹收货地址Sender：运输方式的回邮地址信息Parcels：非必填可以传的也都需要传，如海关编码等（组合产品取产品库中组合sku的信息）ChildOrders：取装箱清单中的数据BoxNumber：用包裹号加箱号进行传入，比如D23564-1,D23564-2,D569898-1
043+ service：运输方式对应的服务代码；client_reference：如果存在合并单号，则用合并单号进行传值；如果是单包裹，则用单包裹号进行传值；
044-
044+ parcel_count：合并组或者单个包裹对应的装箱数量；vat_number：默认传为1；declaration_currency：默认为美元；amazon_ref_id：如果是亚马逊备库包裹，则传值“shipmentid”；to_address：订单收货地址，字段与订单地址一一对应；parcels：取装箱清单上数据及包裹编辑页面的产品库数据；is_battery：传值逻辑为产品配置，具体产品物流属性为用户配置；
045- ~~返参说明：~~
045+ is_magnetic：传值逻辑为产品配置，具体产品物流属性为用户配置；
046- ~~WayBillNumber：存在物流商单号TrackingNumber ：存在追踪号ShipperBoxs中的ShipperHawbcode：依照对照返回的箱号，存储在箱追踪号上~~
046+ battery_label：文档为非必填，暂不传值；
047-
047+ battery_description：文档为非必填，暂不传值；
049- ~~3）获取标签（对应文档中接口：标签获取）~~
049+ 传值逻辑：
050- ~~接口地址：~~
050+ is_battery和is_magnetic配置方式，【IrobotBox-物流商API管理-物流属性API配置】中，将1开头的传值给is_battery，2开头的传值给is_magnetic，传值为物流属性CODE；
051- ~~http://<域名>/api/v4/shipment/get_labels~~
051+
052-
052+
053- ~~将接口返回的URL面单进行打印~~
053+ 用户配置逻辑：
054-
054+ 配置产品物流属性，形成ERP产品物流属性和物流商之间的映射关系
055-
055+
056- ~~4）取消预报（对应文档中接口：取消订单）~~
056+
057- ~~接口地址：http://<域名>/api/v4/shipment/void~~
057+ 注：同一个产品物流属性可以既带电，又带磁，但是不能既带电，又不带电；---这块逻辑比较细节比较多，开发可参考查看橙联的对接代码；
058-
058+ 返回参数处理：将运单号保存为追踪号；
059- ~~根据接口返回进行处理：~~
059+
060- ~~如果返回异常：弹窗提示；~~
060+
061- ~~如果成功，则清除包裹/订单追踪号；~~
061+ 3）获取标签（对应文档中接口：标签获取）
062-
062+ 接口地址：
063- ~~5）运输方式API管理~~
063+ http://<域名>/api/v4/shipment/get_labels
065- ~~6）运输方式管理~~
065+ 将接口返回的URL面单进行打印
066-
066+
067-
067+
068-
068+ 4）取消预报（对应文档中接口：取消订单）
069-
069+ 接口地址：http://<域名>/api/v4/shipment/void
070+
071+ 根据接口返回进行处理：
072+ 如果返回异常：弹窗提示；
073+ 如果成功，则清除包裹/订单追踪号；
074+
075+ 5）运输方式API管理
076+
077+
078+ 6）运输方式管理
079+
080+
081+
082+

012- ~~渠道代码：~~
012+ 渠道代码：BL-G
013- ~~渠道名称：~~
013+ 
014- ~~ ~~
014+ api文档 见附件
015- ~~api文档 见附件~~
015+ 
016- ~~ ~~
016+ 
017- ~~ ~~
017+ 2. 功能设计
018- ~~2. 功能设计~~
018+ 
019- ~~ ~~
019+ 1）【备库订单包裹（新）-待发货】页面，操作功能中，增加以下3个按钮，展示位置在已有按钮上面：
020- ~~1）【备库订单包裹（新）-待发货】页面，操作功能中，增加以下3个按钮，展示位置在已有按钮上面：~~
020+ 
021- ~~ ~~
021+ <ul><li>预报至美通物流</li>
022- ~~<ul><li>预报至美通物流</li>~~
022+ <li>获取标签</li>
023- ~~<li>获取标签</li>~~
023+ <li>取消预报</li>
024- ~~<li>取消预报</li>~~
024+ </ul><img src="{209099.png}" alt="" />
025- ~~</ul><img src="{209099.png}" alt="" />~~
025+ 
026- ~~ ~~
026+ 2）预报至美通物流（对应文档中接口：创建运单）
027- ~~2）预报至美通物流（对应文档中接口：创建运单）~~
027+ 
028- ~~ ~~
028+ 接口地址：http://<域名>/api/v4/shipment/create
029- ~~接口地址：http://<域名>/api/v4/shipment/create~~
029+ 
030- ~~ ~~
030+ 重要事项说明：
031- ~~重要事项说明：~~
031+ 
033- ~~ ~~
033+ <ul><li>按照包裹维度进行预报，产品信息和装箱信息，取包裹上的数据进行同步；</li>
034- ~~<ul><li>按照包裹维度进行预报，产品信息和装箱信息，取包裹上的数据进行同步；</li>~~
034+ <li>参考号：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号，并且将合并发货下面的所有的包裹装箱信息及产品基础信息进行同步；</li>
035- <li>参考号：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号，并且将合并发货下面的所有的包裹装箱信息及产品基础信息进行同步；</li>
035+ <li>如果是组合sku，取组合sku的报关价/报关金额/数量（产品库）中取进行同步预报；</li>
036- ~~<li>如果是组合sku，取组合sku的报关价/报关金额/数量（产品库）中取进行同步预报；</li>~~
036+ <li>箱编号：如果存在合并发货，包裹2的编号在包裹1的基础上进行累加；</li>
037- ~~<li>箱编号：如果存在合并发货，包裹2的编号在包裹1的基础上进行累加；</li>~~
037+ </ul> 
038- ~~</ul> ~~
038+ 
039- ~~~~
039+ 
040- ~~ ~~
040+ 
041- ~~ ~~
041+ 重要参数说明：
042- ~~重要参数说明：~~
042+ 
043- CustomerOrderNumber ：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号。 PackageCount：总共的箱子数 Weight：总箱子实际重 Receiver：包裹收货地址 Sender：运输方式的回邮地址信息 Parcels：非必填可以传的也都需要传，如海关编码等（组合产品取产品库中组合sku的信息） ChildOrders：取装箱清单中的数据 BoxNumber：用包裹号加箱号进行传入，比如D23564-1,D23564-2,D569898-1
043+ service：运输方式对应的服务代码； client_reference：如果存在合并单号，则用合并单号进行传值；如果是单包裹，则用单包裹号进行传值；
044- ~~ ~~
044+ parcel_count：合并组或者单个包裹对应的装箱数量； vat_number：默认传为1； declaration_currency：默认为美元； amazon_ref_id：如果是亚马逊备库包裹，则传值“shipmentid”； to_address：订单收货地址，字段与订单地址一一对应； parcels：取装箱清单上数据及包裹编辑页面的产品库数据； is_battery：传值逻辑为产品配置，具体产品物流属性为用户配置；
045- ~~返参说明：~~
045+ is_magnetic：传值逻辑为产品配置，具体产品物流属性为用户配置；
046- WayBillNumber：存在物流商单号 TrackingNumber ：存在追踪号 ShipperBoxs中的ShipperHawbcode：依照对照返回的箱号，存储在箱追踪号上
046+ battery_label：文档为非必填，暂不传值；
047- ~~ ~~
047+ battery_description：文档为非必填，暂不传值；
049- ~~3）获取标签（对应文档中接口：标签获取）~~
049+ 传值逻辑：
050- ~~接口地址：~~
050+ is_battery和is_magnetic配置方式，【IrobotBox-物流商API管理-物流属性API配置】中，将1开头的传值给is_battery，2开头的传值给is_magnetic，传值为物流属性CODE；
051- ~~http://<域名>/api/v4/shipment/get_labels~~
051+ <img src="{209487.png}" alt="" />
052- ~~ ~~
052+ 
053- ~~将接口返回的URL面单进行打印~~
053+ 用户配置逻辑：
054- ~~ ~~
054+ 配置产品物流属性，形成ERP产品物流属性和物流商之间的映射关系
055- ~~ ~~
055+ <img src="{209488.png}" alt="" />
056- ~~4）取消预报（对应文档中接口：取消订单）~~
056+ 
057- ~~接口地址：http://<域名>/api/v4/shipment/void~~
057+ 注：同一个产品物流属性可以既带电，又带磁，但是不能既带电，又不带电；---这块逻辑比较细节比较多，开发可参考查看橙联的对接代码；
058- ~~ ~~
058+ 返回参数处理：将运单号保存为追踪号；
059- ~~根据接口返回进行处理：~~
059+ 
060- ~~如果返回异常：弹窗提示；~~
060+ 
061- ~~如果成功，则清除包裹/订单追踪号；~~
061+ 3）获取标签（对应文档中接口：标签获取）
062- ~~ ~~
062+ 接口地址：
063- ~~5）运输方式API管理~~
063+ http://<域名>/api/v4/shipment/get_labels
065- ~~6）运输方式管理~~
065+ 将接口返回的URL面单进行打印
066- ~~ ~~
066+ 
067- ~~ ~~
067+ 
068- ~~ ~~
068+ 4）取消预报（对应文档中接口：取消订单）
069- ~~ ~~
069+ 接口地址：http://<域名>/api/v4/shipment/void
070+ 
071+ 根据接口返回进行处理：
072+ 如果返回异常：弹窗提示；
073+ 如果成功，则清除包裹/订单追踪号；
074+ 
075+ 5）运输方式API管理
076+ 
077+ 
078+ 6）运输方式管理
079+ 
080+ 
081+ 
082+
2022-08-08 00:12:35, 由 田子豪 变更。
修改了 版本号 ，旧值为 "6"，新值为 "7"。
修改了 需求描述，区别为：
076-
076+
077-
077+ 对应字段：
078- ~~6）运输方式管理~~
078+ api地址名称：api链接的域名部分，即http://<域名>/api/v4/shipment/create中的域名
079-
079+
080-
080+ 交税方式：taxwith，不选择传0，不包税传1，包税传2，自主税号传3
081-
081+
082-
082+ 报关方式：exportwith，不选择传0，买单报关传1，报关退税传2
083+
084+ 清关方式：importwith，不选择传0，一般贸易清关传1，快件清关传2
085+
086+ 交货条款：deliverywith，不选择传空，ddu传DDU，ddp传DDP
087+
088+
089+ 6）运输方式管理
090+ 业务方将渠道发给产品后，产品配置
091+
092+
093+

076- ~~ ~~
076+ <img src="{209491.png}" alt="" />
077- ~~ ~~
077+ 对应字段：
078- ~~6）运输方式管理~~
078+ api地址名称：api链接的域名部分，即http://<域名>/api/v4/shipment/create中的域名
079- ~~ ~~
079+ <img src="{209493.png}" alt="" />
080- ~~ ~~
080+ 交税方式：taxwith，不选择传0，不包税传1，包税传2，自主税号传3
081- ~~ ~~
081+ <img src="{209498.png}" alt="" />
082- ~~ ~~
082+ 报关方式：exportwith，不选择传0，买单报关传1，报关退税传2
083+ <img src="{209499.png}" alt="" />
084+ 清关方式：importwith，不选择传0，一般贸易清关传1，快件清关传2
085+ <img src="{209496.png}" alt="" />
086+ 交货条款：deliverywith，不选择传空，ddu传DDU，ddp传DDP
087+ <img src="{209497.png}" alt="" />
088+ 
089+ 6）运输方式管理
090+ 业务方将渠道发给产品后，产品配置
091+ 
092+ 
093+
2022-08-08 09:08:57, 由 田子豪 变更。
修改了 版本号 ，旧值为 "7"，新值为 "8"。
修改了 需求名称，区别为：
001- ~~美通物流对接-备货渠道（8月2版本）~~
001+ 美通物流对接-备货渠道

001- ~~美通物流对接-备货渠道（8月2版本）~~
001+ 美通物流对接-备货渠道
2022-08-08 09:48:09, 由 田子豪 编辑。
修改了 指派给，旧值为 "tianzihao"，新值为 "Admin186"。
2022-08-08 11:33:25, 由 liangfengming 编辑。
修改了 预计工时，旧值为 "16"，新值为 "28"。
2022-08-08 18:38:07, 由刘灿记录评审结果，结果为 确认通过。
修改了 评审时间，旧值为 "0000-00-00"，新值为 "2022-08-08"。
修改了 指派给 ，旧值为 "Admin186"，新值为 "liangfengming"。
修改了 当前状态，旧值为 "draft"，新值为 "active"。
修改了 由谁评审，旧值为 ""，新值为 "Admin186"。
2022-08-09 11:54:01, 由李冠关联到迭代 技术研发中心 8月第 2 版本（2022年） 。
2022-08-09 15:00:41, 由 田子豪 编辑。
修改了 指派给，旧值为 "liangfengming"，新值为 "chengwei"。
2022-08-16 10:35:45, 由 田子豪 编辑。
修改了 所属计划，旧值为 "605"，新值为 "603"。
2022-08-17 19:41:17, 由 田子豪 添加备注。

品牌名称、品牌类型、型号，的取值如下：
2022-08-18 15:42:46, 由 zhengqiao 关联到迭代 技术研发中心 8月分支版本（2022年） 。
2022-08-18 15:44:00, 由 zhengqiao 从迭代 #643 技术研发中心 8月第 2 版本（2022年） 移除。
2022-08-19 10:25:34, 由刘超编辑。
修改了 所处阶段，旧值为 "testing"，新值为 "developed"。
2022-08-31 09:14:28, 由刘超编辑。
修改了 受益业务部门，旧值为 ""，新值为 "10"。
修改了 所处阶段 ，旧值为 "testing"，新值为 "developed"。
2022-09-09 10:39:51, 由程伟编辑。
修改了 指派给，旧值为 "chengwei"，新值为 "linhonggui"。
2022-09-09 16:41:54, 由 zhengqiao 编辑。
修改了 所处阶段 ，旧值为 "tested"，新值为 "released"。
修改了 关键词 ，旧值为 ""，新值为 "9月6日发版"。
修改了 设置阶段者，旧值为 "chengwei"，新值为 "zhengqiao"。
2022-09-12 09:57:45, 由 林鸿贵 指派给 田子豪。
修改了 指派给，旧值为 "linhonggui"，新值为 "tianzihao"。
2022-09-23 17:21:41, 由 田子豪 关闭，原因为 已完成 。
修改了 由谁关闭，旧值为 ""，新值为 "tianzihao"。
修改了 关闭日期，旧值为 "0000-00-00 00:00:00"，新值为 "2022-09-23 17:21:41"。
修改了 指派给 ，旧值为 "tianzihao"，新值为 "closed"。
修改了 当前状态，旧值为 "active"，新值为 "closed"。
修改了 所处阶段，旧值为 "released"，新值为 "closed"。
修改了 关闭原因，旧值为 ""，新值为 "done"。

已上线
2023-03-04 15:24:38, 由周杰编辑。
修改了 所属模块，旧值为 "1684"，新值为 "1742"。
2023-11-16 20:27:14, 由周杰编辑。
修改了 所属模块，旧值为 "1742"，新值为 "1854"。

基本信息
需求的一生

迭代版本
提报业务部门
提报人员	温露芳
需求来源	业务方迭代需求
所属项目	技术中心-需求池
所属模块	供应链仓储物流
所属计划
业务价值
开发组
受益业务部门	技术研发中心
验收人员
业务目标类型
中心业务目标
业务价值	提升人效
每月价值量	2人天
每月节省人数	0
优先级	P2
价值类型
预计工时	28
成本
ROI
操作手册
高价值
主被动
复杂度
工作流ID
工作流创建时间
更新点
是否高危	否
评分
当前状态	已关闭
所处阶段	已关闭
关键词	9月6日发版
评审次数
计划上线
上线时间
计划验收时间
业务验收时间
满意度
价值验收
满意度分值
业务回填价值
验收达成价值
验收达成ROI
抄送给

由谁创建	田子豪于 2022-08-01 15:59:47
指派给	Closed 于 2022-09-23 17:21:41
由谁评审	刘灿
评审时间	2022-08-08
由谁关闭	田子豪于 2022-09-23 17:21:41
关闭原因	已完成
最后修改	周杰于 2023-11-16 20:27:08

迭代任务
相关信息

相关Bug	[B] #31449 【备库订单包裹（新）】已选择报关方式，预报至美通物流失败，提示报关方式必须填写
相关用例	[C] #50748 11881【备库订单包裹（新）】【待发货】预报至美通物流，传参校验 [C] #50749 11881【备库订单包裹（新）】【待发货】预报至美通物流，按包裹维度预报取值，如果是合并发货的，则取合并单号作为参考号 [C] #50750 11881【备库订单包裹（新）】【待发货】预报至美通物流，按包裹维度预报取值，如果是单个包裹的，已包裹作为参考号 [C] #50751 11881【备库订单包裹（新）】【待发货】预报至美通物流，按包裹维度预报取值，并且将合并发货下面的所有的包裹装箱信息及产品基础信息进行同步 [C] #50752 11881【备库订单包裹（新）】【待发货】预报至美通物流，按包裹维度预报取值，取组合sku的报关价/报关金额/数量（产品库）中取进行同步预报 [C] #50753 11881【备库订单包裹（新）】【待发货】预报至美通物流，按包裹维度预报取值，如果存在合并发货，包裹2的编号在包裹1的基础上进行累加 [C] #50754 11881【备库订单包裹（新）】【待发货】预报至美通物流，按包裹维度预报取值，按照包裹维度进行预报，产品信息和装箱信息，取包裹上的数据进行同步 [C] #50755 11881【备库订单包裹（新）】【待发货】预报至美通物流，按包裹维度预报取值，同一个产品物流属性可以既带电，又带磁，但是不能既带电，又不带电 [C] #50756 11881【备库订单包裹（新）】【待发货】获取标签，下载面单 [C] #50757 11881【备库订单包裹（新）】【待发货】取消预报，清空订单包裹追踪号
相关需求
细分需求