消息推送说明

如果是首次对接消息推送API的，请先花几分钟阅读一下以下内容，谢谢配合~

消息推送地址的配置说明:

       聚水潭ERP中的【店铺设置】->添加店铺->在所属站点中选择为“商家自有商城”保存。

       在店铺列表中打开此店铺的[消息推送].配置数据所要推送的地址，然后对于ERP所推送的数据进行解析处理。

测试环境上的消息推送均不可实现，请在正式环境测试消息推送模块 

推送类型:

      库存同步（ERP 到平台）--ERP【商品库存】页面，库存可用数变动触发同步

      取消订单（ERP 到平台）--ERP【订单】页面，订单取消触发同步

      物流同步（ERP 到平台）--ERP【订单】页面，订单发货触发同步

      售后收货（ERP 到平台）--ERP【售后（退货退款）】页面确认收到货物/取消收到货物触发同步

请求链接示例说明:

       A店铺类型为“商家自有商城”,  在消息推送里设置库存同步地址为 ：http://XXXX.com/open/callback  (ps:此地址为商家系统能接收物流同步数据的地址)

       此接口接收库存同步（ERP 到平台）的请求参数,收到推送商家自行处理数据即可

请求方式：

      Post

ERP推送组成规则：（以物流同步接口为例）

       1、获取商品配置地址、调用接口的接口名称以及系统参数

                url:                http://XXXX.com/open/callback

                method：     logistics.upload

                partnerid：   erp（ps：消息推送中partnerid、partnerkey固定为erp）

       2、根据当前时间获取时间戳 (Unix 纪元到当前时间的秒数，10位)

                ts：              1608000837

       3、以及根据sign计算规则组成源串并进行MD5 32位小写加密

                3.1、sign的组成方式:

                       3.1.1、ts为key、value键值对

                       3.1.2、key,value  为传入的系统参数，按url中的传递顺序)(加密 key 中排除sign，method，partnerid，partnerkey)

                       3.1.3、组成加密源串：

                            规则：method +partnerid + (key1+value1) +partnerkey

                            例：logistics.uploaderpts1608000837erp

                3.2、MD5 32位小写加密

                       sign：MD5(method +partnerid + (key1+value1) +partnerkey)；

                       加密结果：sign=8c33d804272823485218bbfd15a49569

      4、根据系统参数以及sign进行拼接链接

        http://XXXX.com/open/callback?ts=1608000837&partnerid=erp&method=logistics.upload&sign=8c33d804272823485218bbfd15a49569

      注:请求的业务参数以json格式放入http-body中且接口返回参数必须按照api文档接口返回示例中参数返回