任务描述
暂无
需求描述

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）运输方式管理

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




验收标准
暂无
相关用例
历史记录  
  1. 2022-08-10 16:21:30, 由 程伟 创建。
  2. 2022-08-17 22:27:55, 由 李振宇 完成。
    修改了 总计消耗，旧值为 "0"，新值为 "27"。
    修改了 指派给 ，旧值为 "lizhenyu"，新值为 "chengwei"。
    修改了 实际完成，旧值为 ""，新值为 "2022-08-17 22:26:58"。
    修改了 任务状态，旧值为 "wait"，新值为 "done"。
    修改了 实际开始，旧值为 "0000-00-00 00:00:00"，新值为 "2022-08-17 22:27:55"。
    修改了 预计剩余，旧值为 "28"，新值为 "0"。
    修改了 由谁完成，旧值为 ""，新值为 "lizhenyu"。


  3. 2022-08-17 23:48:03, 由 李振宇 添加备注。

    备注：因为11582 异常拣货流程改造跟着八月第二版一起上线，测试这边测试时间不足，所以先不提交代码



    自测结果：

    预生成：

    获取标签：

    取消订单：

  4. 2022-08-18 09:24:59, 由 程伟 关闭。
    修改了 任务状态，旧值为 "done"，新值为 "closed"。
    修改了 指派给 ，旧值为 "chengwei"，新值为 "closed"。
    修改了 由谁关闭，旧值为 ""，新值为 "chengwei"。
    修改了 关闭时间，旧值为 "0000-00-00 00:00:00"，新值为 "2022-08-18 09:24:59"。
    修改了 关闭原因，旧值为 ""，新值为 "done"。
  5. 2022-08-18 15:49:54, 由 zhengqiao 编辑。
    修改了 所属迭代，旧值为 "643"，新值为 "640"。
    修改了 指派给 ，旧值为 "closed"，新值为 ""。
  6. 2022-08-18 15:55:02, 由 程伟 编辑。
    修改了 指派给，旧值为 ""，新值为 "juzhiming"。
  7. 2022-08-18 15:55:13, 由 程伟 编辑。
    修改了 指派给，旧值为 "juzhiming"，新值为 "lizhenyu"。
  8. 2022-08-23 09:24:10, 由 李振宇 激活。
    修改了 预计剩余，旧值为 "0"，新值为 "28"。
    修改了 任务状态，旧值为 "closed"，新值为 "doing"。
    修改了 由谁完成，旧值为 "lizhenyu"，新值为 ""。
    修改了 由谁关闭，旧值为 "chengwei"，新值为 ""。
    修改了 关闭原因，旧值为 "done"，新值为 ""。
    修改了 实际完成，旧值为 "2022-08-17 22:26:58"，新值为 "0000-00-00"。
    修改了 取消时间，旧值为 ""，新值为 "0000-00-00"。
    修改了 关闭时间，旧值为 "2022-08-18 09:24:59"，新值为 "0000-00-00"。
  9. 2022-08-23 09:25:11, 由 李振宇 编辑。
    修改了 任务状态，旧值为 "doing"，新值为 "closed"。
    修改了 由谁关闭，旧值为 ""，新值为 "lizhenyu"。
    修改了 关闭原因，旧值为 ""，新值为 "done"。
    修改了 关闭时间，旧值为 ""，新值为 "2022-08-23 09:25:11"。
  10. 2022-08-23 09:26:51, 由 李振宇 编辑。
    修改了 指派给，旧值为 "lizhenyu"，新值为 "chengwei"。
  11. 2023-06-19 09:43:13, 由 程伟 编辑。
    修改了 开发组 ，旧值为 ""，新值为 "1"。
    修改了 由谁取消，旧值为 ""，新值为 "chengwei"。
    修改了 取消时间，旧值为 ""，新值为 "2023-06-19 09:43"。
    修改了 关闭原因，旧值为 "done"，新值为 "cancel"。
  12. 2023-06-19 09:46:59, 由 程伟 编辑。
    修改了 指派给，旧值为 "chengwei"，新值为 "closed"。
所属迭代 技术研发中心 8月分支 版本（2022年）
所属模块 /
相关需求 美通物流对接-备货渠道
指派给 Closed 于 2023-06-19 09:46:59
任务类型 后端
任务标签 初始
开发组 百货开发组
任务状态 已关闭
进度 49%
优先级 P2
关键词
抄送给
由谁创建 程伟 于 2022-08-10 16:21:30
由谁完成 暂无
由谁取消 程伟 于 2023-06-19 09:43:00
由谁关闭 李振宇 于 2022-08-23 09:25:11
关闭原因 已取消
最后编辑 程伟 于 2023-06-19 09:46:59
团队 最初预计 总计消耗 预计剩余
工时信息
最初预计 28工时
总计消耗 27工时
预计剩余 28工时
预计开始 0000-00-00
实际开始 2022-08-17
截止日期 0000-00-00