...
文档目的
在对接ERP对外接口-三方物流/海外仓的业务中,提高外部开发效率。服务商API业务中,提高外部开发效率。
涉及对接步骤指引、接口对应业务场景释义、特殊业务点同步等。文档涉及对接步骤指引、接口对应业务场景释义、对接注意事项等。
文档阅读人员:
文档阅读人员
需要对接ERP对外接口-三方物流/海外仓业务的ERP客户 或者 服务商API业务的ERP客户 或 三方服务商。
对接指引:
建议对接流程
1、实现步骤
步骤1:完成下方红框 对外接口文档 阅读
对接指引
注意事项
下方链接归纳三方系统接口对接过程中,遇到的常见问题。
针对该部分的重点阅读,能有效提高功能开发效率。
实现步骤
步骤1:完成下方红框 对外接口文档 阅读。
三方物流/海外仓标准业务,关注【服务商API】模块即可。
补充说明:
P.S. 相关接口对接规范,可以辅助参考下方模块内容。
步骤2:对接过程中,根据不同阶段,在API文档中获取 测试 / 生产信息生产信息。
...
以下数据属于有效测试信息,测试阶段可进行使用,以便调通接口。
测试地址:
三方海外仓http:/物流 其余对接逻辑,需关注【三方物流/三方仓库API】模块
步骤3:完成对应接口后,需要在ERP客户端对应位置进行信息设置
可向易仓客成同事或者实施同事需求协助
以魔方海外仓为例子:魔方海外仓对接操作手册
2、关于当前接口业务介绍:
【三方物流】
- 获取订单 - getPreShippingOrder
场景:调取该接口,可以查询当前ERP从平台拉取回到ERP系统的订单数据。
- 订单交运接口 - orderConfirm
场景:???
- 订单状态变更 (取消订单)- orderStatusModify
场景:调取该接口,支持取消订单。
- 上传跟踪单号和标签 - uploadTrackingNo
场景:调取该接口,支持将订单跟踪号和标签上传至ERP系统 。
注意:关于上传跟踪单号和标签操作,仅能上传一次。
/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系统的订单数据拉取到自身系统中。上传跟踪单号和标签 场景:调取该接口,可以查询当前ERP从平台拉取回来的ERP系统订单数据。 - 上传跟踪号(三方物流还需上传标签) - uploadTrackingNo
场景:调取该接口,支持将订单跟踪号和标签上传至ERP系统 。
注意:是否支持上传多次? - 订单状态信息变更 - orderStatusModify
场景:外部系统,针对订单状态进行状态同步至ERP系统。变更跟踪号 - modifyTrackingNo
场景: 调取该接口,支持变更订单跟踪号。
3、注意事项
3.1 ....
- 场景:将外部系统订单状态同步至ERP系统 (取消/出库状态更新)。
注意:
以上接口对接,可完成海外仓/物流业务最小闭环:订单拉取、跟踪号/面单上传、订单状态变更;
如果需要对接其他接口以满足业务场景,可与实施/客成同事进行沟通,以便确定对应业务接口。