消息推送说明

如果是首次对接消息推送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文档接口返回示例中参数返回


聚水潭官网 | 百科 | 开放平台

版权所有© 2016 上海聚水潭网络科技有限公司 沪ICP备14047939号-1 Copyright © 2016 JUSHUITAN Network Technology CO.,LTD. All Rights Reserved.