文档目的

在对接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】公共请求参数补充