1. 背景
新物流,美通物流备货渠道对接
沟通渠道
钉钉群【美通系统对接】---确定好开发人员后进群
账号信息(正式环境账号,测试前请先沟通)
token:62d6787d3ac7ac04952a2ddc62d6787db4d637962
api文档
见附件
2. 功能设计
1)【备库订单包裹(新)-待发货】页面,操作功能中,增加以下3个按钮,展示位置在已有按钮上面:
- 预报至美通物流
- 获取标签
- 取消预报

2)预报至美通物流(对应文档中接口:创建运单)
接口地址:http://<域名>/api/v4/shipment/create
重要事项说明:
- 按照包裹维度进行预报,产品信息和装箱信息,取包裹上的数据进行同步;
- 参考号:如果是合并发货的,则取合并单号作为参考号,如果是单个包裹的,已包裹作为参考号,并且将合并发货下面的所有的包裹装箱信息及产品基础信息进行同步;
- 如果是组合sku,取组合sku的报关价/报关金额/数量(产品库)中 取进行同步预报;
- 箱编号:如果存在合并发货,包裹2的编号在包裹1的基础上进行累加;
重要参数说明:
CustomerOrderNumber :如果是合并发货的,则取合并单号作为参考号,如果是单个包裹的,已包裹作为参考号。
PackageCount :总共的箱子数
Weight:总箱子实际重
Receiver:包裹收货地址
Sender:运输方式的回邮地址信息
Parcels:非必填可以传的也都需要传,如海关编码等(组合产品取产品库中组合sku的信息)
ChildOrders:取装箱清单中的数据
BoxNumber:用包裹号加箱号进行传入,比如D23564-1,D23564-2,D569898-1
返参说明:
WayBillNumber:存在物流商单号
TrackingNumber :存在追踪号
ShipperBoxs中的ShipperHawbcode:依照对照返回的箱号,存储在箱追踪号上
3)获取标签(对应文档中接口:标签获取)
接口地址:
http://<域名>/api/v4/shipment/get_labels
将接口返回的URL面单进行打印
4)取消预报(对应文档中接口:取消订单)
接口地址:http://<域名>/api/v4/shipment/void
根据接口返回进行处理:
如果返回异常:弹窗提示;
如果成功,则清除包裹/订单追踪号;
5)运输方式API管理
6)运输方式管理


