接入流程

如果是首次对接聚水潭API的,请先花几分钟阅读一下以下内容,谢谢配合~

 

一、API对接须知


1.自研开发者请先在测试环境确认接口调通后,再切换正式环境,测试环境授权可加QQ群:616641589(申请入群请写商家(自己)公司名称,否则不通过)群公告中自取;


2.如果还没有正式公司账号的,请联系对应销售同学(无销售同学,可到聚水潭官方网站联系客服咨询,进入官网),由销售同学向公司申请正式公司账号后,才能申请开发者参数;


3.已经有公司账号的,且测试环境已经对接完成的商家,请按照文档中步骤申请正式授权参数:https://open.jushuitan.com/document/2122.html


4.测试环境上的消息推送均不可实现,请在正式环境测试消息推送模块 ,测试环境账号索要请QQ群:616641589(申请入群请写商家(自己)公司名称,否则不通过,此群作为聚水潭接口对接的官方群)群公告中自取;


5.错误码列表:http://open.jushuitan.com/document/2021.html


6.接口调用频次:https://open.jushuitan.com/document/2273.html


7.正式接口的Token默认有效期一年,定期可用刷新接口,刷新之后token值不变,只是顺延有效期:http://open.jushuitan.com/document/2135.html


注意事项:

1.API属于收费服务,需要提供API服务对接聚水潭ERP,请先联系销售同学;

2.如果有不明确业务对接的,可先找聚水潭相关人员确定一下,涉及对接问题咨询的,可加QQ群:616641589(申请入群请写商家(自己)公司名称,否则不通过);

3.ERP操作和功能使用的疑问,请咨询系统首页在线的售后客服,联系电话:400-660-4298;

 

二、技术对接API

1.接口调用说明及sign算法:http://open.jushuitan.com/document/8.html

2.关于消息推送的调用方式,请看说明:http://open.jushuitan.com/document/2119.html

3.聚水潭提供了部分调用示例, 有需要的可加QQ群:616641589(申请入群请写商家(自己)公司名称,否则不通过)群文件有提供以下语言的调用示例

Demo(C#)

Demo(Java)

Demo(Python)

Demo(PHP)


 

三、常见部分业务场景及对应接口

商家自有商城类型:

场景一:需要上传自有商城订单到ERP里,由ERP发货,物流信息需同步到自有商城

订单上传接口路径:订单API----->订单上传

物流同步接口路径:物流API----->发货信息查询 或者 消息推送----->物流同步

同步商品接口路径:商品API----->商品上传(新) 


场景二:需要同步自有商城库存

库存查询接口路径:库存API----->库存查询

或者

同步商品接口路径:商品API----->商品上传(新)

同步店铺商品接口路径:商品API----->店铺商品资料上传(新)

库存同步接口路径:库存API----->库存查询 或者 消息推送----->库存同步

 

线下ERP类型:

场景一:获取ERP里的订单,到自有系统里去发货,物流信息需同步到ERP

订单查询接口路径:订单API----->订单查询

物流同步接口路径:订单API----->订单发货(不扣减ERP中库存)  或者  出库API----->出库发货(扣减ERP中库存)

 

四、注意事项

  1.向ERP推送单据时,如果请求参数涉及店铺编号,可以通过接口拉取或者系统里查看

    系统相关界面:【设置】----业务设置----【店铺设置】的编号

  2.涉及到分仓编码的,可以通过接口拉取:http://open.jushuitan.com/document/2064.html

  3.部分接口上传时提示 “店铺编号[xxx]的站点类型不是自有商城,无法上传”,请去店铺设置里新增一个站点,类型为“商家自有商城”


 




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

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