1.    背景

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

沟通渠道

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

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

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

token：62d6787d3ac7ac04952a2ddc62d6787db4d637962

渠道代码：BL-G

api文档
见附件

2.    功能设计

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

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

2）预报至美通物流（对应文档中接口：创建运单）

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

重要事项说明：

• 按照包裹维度进行预报，产品信息和装箱信息，取包裹上的数据进行同步；
• 参考号：如果是合并发货的，则取合并单号作为参考号，如果是单个包裹的，已包裹作为参考号，并且将合并发货下面的所有的包裹装箱信息及产品基础信息进行同步；
• 如果是组合sku，取组合sku的报关价/报关金额/数量（产品库）中  取进行同步预报；
• 箱编号：如果存在合并发货，包裹2的编号在包裹1的基础上进行累加；

重要参数说明：

service：运输方式对应的服务代码；
client_reference：如果存在合并单号，则用合并单号进行传值；如果是单包裹，则用单包裹号进行传值；

parcel_count：合并组或者单个包裹对应的装箱数量；
vat_number：默认传为1；
declaration_currency：默认为美元；
amazon_ref_id：如果是亚马逊备库包裹，则传值“shipmentid”；
to_address：订单收货地址，字段与订单地址一一对应；
parcels：取装箱清单上数据及包裹编辑页面的产品库数据；
is_battery：传值逻辑为产品配置，具体产品物流属性为用户配置；

is_magnetic：传值逻辑为产品配置，具体产品物流属性为用户配置；

battery_label：文档为非必填，暂不传值；

battery_description：文档为非必填，暂不传值；

传值逻辑：

is_battery和is_magnetic配置方式，【IrobotBox-物流商API管理-物流属性API配置】中，将1开头的传值给is_battery，2开头的传值给is_magnetic，传值为物流属性CODE；

用户配置逻辑：

配置产品物流属性，形成ERP产品物流属性和物流商之间的映射关系

注：同一个产品物流属性可以既带电，又带磁，但是不能既带电，又不带电；---这块逻辑比较细节比较多，开发可参考查看橙联的对接代码；

返回参数处理：将运单号保存为追踪号；

3）获取标签（对应文档中接口：标签获取）

接口地址：

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

将接口返回的URL面单进行打印

4）取消预报（对应文档中接口：取消订单）

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

根据接口返回进行处理：

如果返回异常：弹窗提示；

如果成功，则清除包裹/订单追踪号；

5）运输方式API管理

对应字段：

api地址名称：api链接的域名部分，即http://<域名>/api/v4/shipment/create中的域名

交税方式：taxwith，不选择传0，不包税传1，包税传2，自主税号传3

报关方式：exportwith，不选择传0，买单报关传1，报关退税传2

清关方式：importwith，不选择传0，一般贸易清关传1，快件清关传2

交货条款：deliverywith，不选择传空，ddu传DDU，ddp传DDP

6）运输方式管理

业务方将渠道发给产品后，产品配置

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