文档目的
在对接ERP对外接口-三方物流/海外仓的业务中,提高外部开发效率。
涉及对接步骤指引、接口对应业务场景释义、特殊业务点同步等。
文档阅读人员
需要对接ERP对外接口-三方物流/海外仓业务的ERP客户 或者 三方服务商。
对接指引
实现步骤
步骤1:完成下方红框 对外接口文档 阅读
步骤2:对接过程中,根据不同阶段,在API文档中获取 测试 / 生产信息
- 以下【调用示例】数据属于有效测试信息,测试阶段可进行使用,以便调通接口
三方物流/海外仓其余标准对接逻辑,需关注【三方物流/三方仓库API】模块
步骤3:测试完成之后,功能上线前,需要在ERP客户系统完成以下设置
可向易仓客成同事或者实施同事需求协助
海外仓例子:魔方海外仓
物流例子:等待补充
关于当前接口业务介绍
【三方物流】
- 获取订单 - getPreShippingOrder
场景:调取该接口,可以查询当前ERP从平台拉取回到ERP系统的订单数据。
- 订单状态变更 (取消订单)- orderStatusModify
场景:调取该接口,支持取消订单。
- 上传跟踪单号和标签 - uploadTrackingNo
场景:调取该接口,支持将订单跟踪号和标签上传至ERP系统 。
注意:关于上传跟踪单号和标签操作,仅能上传一次。
【三方海外仓】
- 获取订单 - getPreShippingOrder
场景:外部系统可以按照自身业务需要,将ERP从平台拉取回到ERP系统的订单数据拉取到自身系统中。
- 上传跟踪单号和标签 - uploadTrackingNo
场景:调取该接口,支持将订单跟踪号和标签上传至ERP系统 。
注意:是否支持上传多次?
- 订单状态信息变更 - orderStatusModify
场景:外部系统,针对订单状态进行状态同步至ERP系统。
- 上传跟踪号(三方物流还需上传标签) - uploadTrackingNo
场景: 调取该接口,支持变更订单跟踪号。
注意事项
1、关于请求地址-ERP系统存在两种
红框地址:
EB接入地址路径:http://订单系统域名/default/svc-open/web-service-v2
WMS接入地址路径:http://仓配系统域名/default/svc-open/web-service-v2
绿框地址(三方物流/三方仓库API ):
WMS接入地址路径:http://xxx.xxx.com/default/svc-open/web-service-api
2、关于【对接指引 -》实现步骤-》步骤3】公共请求参数补充