版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已改变。

文档目的

在对接ERP对外接口-三方物流/海外仓的业务中,提高外部开发效率。服务商API业务中,提高外部开发效率。

...

文档涉及对接步骤指引、接口对应业务场景释义、对接注意事项等。

 

文档阅读人员

需要对接ERP对外接口-三方物流/海外仓业务的ERP客户 服务商API业务的ERP客户 或 三方服务商。

 

建议对接流程

Image Added

 

对接指引

(打勾) 注意事项

下方链接归纳三方系统接口对接过程中,遇到的常见问题。
针对该部分的重点阅读,能有效提高功能开发效率。

必看-常见问题

 

(打勾) 实现步骤

步骤1:完成下方红框 步骤1:完成下方红框 对外接口文档 阅读 

Image Removed

 

步骤2:对接过程中,根据不同阶段,在API文档中获取 阅读。

三方物流/海外仓标准业务,关注【服务商API】模块即可。

Image Added

补充说明:
P.S. 相关接口对接规范,可以辅助参考下方模块内容。

Image Added

 

步骤2:对接过程中,根据不同阶段,在API文档中获取 测试 / 生产信息。

...

以下数据属于有效测试信息,测试阶段可进行使用,以便调通接口。

Image Removed测试地址:

三方物流http:/海外仓其余标准业务,需关注【三方物流/三方仓库API】模块。

Image Removed

 

步骤3:测试完成之后,功能上线前,需要在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>

    <ns1:callService>

      <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>

    </ns1:callService>

  </SOAP-ENV:Body>

</SOAP-ENV:Envelope>

 

步骤3:测试完成之后,功能上线前,需要在ERP客户系统完成以下设置。

可向易仓实施/客成同事沟通,他们将协助打通

海外仓例子:魔方海外仓

物流例子:等待补充


(打勾) 关于当前接口业务介绍

【三方物流】

  • 获取订单 - getPreShippingOrder
    场景:调取该接口,可以查询当前ERP从平台拉取回来的ERP系统订单数据。

  • 上传跟踪单号和标签 上传跟踪号(三方物流还需上传标签) - uploadTrackingNo
    场景:调取该接口,支持将订单跟踪号和标签上传至ERP系统 。

  • 订单状态变更 (取消订单)订单状态变更(取消订单)orderStatusModify
    场景:调取该接口,支持取消订单。

...

  • 获取订单 - getPreShippingOrder
    场景:调取该接口,可以查询当前ERP从平台拉取回来的ERP系统订单数据。

  • 上传跟踪单号和标签 上传跟踪号(三方物流还需上传标签) - uploadTrackingNo
    场景:调取该接口,支持将订单跟踪号和标签上传至ERP系统 。

  • 订单状态信息变更 - orderStatusModify
    场景:将外部系统订单状态同步至ERP系统。

(打勾) 注意事项

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

 

Image Removed

 

2、关于【对接指引 -》实现步骤-》步骤3】公共请求参数补充

Image Removed

 

 

 

  • 场景:将外部系统订单状态同步至ERP系统 (取消/出库状态更新)。

注意:
以上接口对接,可完成海外仓/物流业务最小闭环:订单拉取、跟踪号/面单上传、订单状态变更;
如果需要对接其他接口以满足业务场景,可与实施/客成同事进行沟通,以便确定对应业务接口。