文档目的
在对接ERP对外接口-服务商API业务中，提高外部开发效率。
文档涉及对接步骤指引、接口对应业务场景释义、对接注意事项等。
文档阅读人员
需要对接ERP对外接口-服务商API业务的ERP客户 或 三方服务商。
建议对接流程
对接指引
注意事项
下方链接归纳三方系统接口对接过程中，遇到的常见问题。
针对该部分的重点阅读，能有效提高功能开发效率。
实现步骤
步骤1：完成下方红框 对外接口文档 阅读。
三方物流/海外仓标准业务，关注【服务商API】模块即可。
补充说明：
P.S. 相关接口对接规范，可以辅助参考下方模块内容。
步骤2：对接过程中，根据不同阶段，在API文档中获取 测试 / 生产信息。
以下数据属于有效测试信息，测试阶段可进行使用，以便调通接口。
测试地址：
http://kaifa2019.eccang.com/default/svc-open/web-service-api
测试请求参数：
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://www.example.org/Ec/">
<SOAP-ENV:Body>
<paramsJson>{"dateType":"2","achieve_type":"1","dateFor":"2021-06-10 00:00:00","dateTo":"2022-06-25 00:00:00","pageSize":"500"}</paramsJson>
<userName>apitest</userName>
<userPass>apitest123-</userPass>
<apiType>1</apiType>
<serviceTypeCode>YKDOMSNEW-WH</serviceTypeCode>
<serviceToken>YKDOMSNEW-WH</serviceToken>
<service>getPreShippingOrder</service>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
步骤3：测试完成之后，功能上线前，需要在ERP客户系统完成以下设置。
可向易仓实施/客成同事沟通，他们将协助打通
海外仓例子：魔方海外仓
物流例子：等待补充
关于当前接口业务介绍
【三方物流】
- 获取订单 - getPreShippingOrder
场景：调取该接口，可以查询当前ERP从平台拉取回来的ERP系统订单数据。 - 上传跟踪号(三方物流还需上传标签) - uploadTrackingNo
场景：调取该接口，支持将订单跟踪号和标签上传至ERP系统 。 - 订单状态变更（取消订单）- orderStatusModify
场景：调取该接口，支持取消订单。
【三方海外仓】
- 获取订单 - getPreShippingOrder
场景：调取该接口，可以查询当前ERP从平台拉取回来的ERP系统订单数据。 - 上传跟踪号(三方物流还需上传标签) - uploadTrackingNo
场景：调取该接口，支持将订单跟踪号和标签上传至ERP系统 。 - 订单状态信息变更 - orderStatusModify
场景：将外部系统订单状态同步至ERP系统 （取消/出库状态更新）。
注意：
以上接口对接，可完成海外仓/物流业务最小闭环：订单拉取、跟踪号/面单上传、订单状态变更；
如果需要对接其他接口以满足业务场景，可与实施/客成同事进行沟通，以便确定对应业务接口。
Add Comment