常见问题总结

一.基础类

    1.Q:接口授权参数如何申请?

       A: https://openweb.jushuitan.com/doc?docId=20

    2.Q:为什么partnerid无效?

        A:检查接口调用地址。正式授权参数匹配正式测试地址,测试授权测试匹配测试接口地址。

        测试接口调用地址:https://c.jushuitan.com/api/open/query.aspx

        正式接口调用地址:https://open.erp321.com/api/open/query.aspx

        如果地址没有问题检查partnerid前后是否有空格

    3.Q:返回token超时如何处理?

       A:通过测试工具https://open.jushuitan.com/tools.aspx 调用refresh.token接口https://open.jushuitan.com/document/2135.html,

       调用成功后过几分钟后生效。

    4.Q:测试工具

       A:接口测试工具:https://openweb.jushuitan.com/doc?docId=140&name=API%E6%B5%8B%E8%AF%95%E5%B7%A5%E5%85%B7  

    5.Q:API如何收费问题

       A:企业版免费,专业版已签约的合同金额*1000次是免费调用次数,超出部分调用1000次收取1元 

    6.Q: 如何获取店铺编码?

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

           或者从接口http://open.jushuitan.com/document/14.html 获取

    7.Q: 如何获取分仓/主仓公司编码?

       A:通过分仓查询的接口获取http://open.jushuitan.com/document/2064.html

    8.Q: 如何获取聚水潭系统里的所有快递公司编码?

       A: 通过物流公司查询接口获取http://open.jushuitan.com/document/2036.html  入参不传默认查所有快递编码。


二.操作类

    1.Q:消息推送接口如何使用?

       A:自有商城店铺才能设置消息推送地址。ERP的店铺设置界面,消息推送中配合对应的推送接口地址。库存推送和物流同步推送接口需要在店

        铺设置勾选自动上传库存、同步发货。另:测试环境无法进行推送测试。

    2.Q:自有商品店铺如何创建?

       A:店铺设置-添加店铺,搜索自有商城,选择填写店铺信息,保存。


三.订单类

   1.Q:  错误返回“店铺编号[xxx]的站点类型不是自有商城,无法上传”

      A: 在【店铺设置】中新增店铺,选择站点为“商家自有商城”,不会创建的可参考以下文档http://www.erp321.com/app/support/document.html#page=1865

   2.Q:  {"msg":"店铺编号[xxxxx]对应公司与系统配置的不一致,请检查配置!","code":170,"issuccess":false}  是什么意思

      A: 确认一下接口请求token所属的公司和店铺所属的公司不一致

   3.Q: 拆分订单,取消一个子订单的时候全部子订单取消

      A: 通过接口jushuitan.orders.cancel取消的话会出现这样的情况

   4.Q: 一个公司下面不同的店铺各自上传同一条订单号,其中一个店铺对订单做了发货处理,另一店铺的订单会同步更新么?

      A: 对于同一主体公司下不同店铺上传的同一订单号当做两个订单来处理,只发一个订单,另一个订单不会自动更新

   5.Q: 如果想查询出所有缺货的订单该怎么查

      A: 缺货的订单如果已经做审核处理在“异常缺货”中,那可以在查询的时候status参数传入Question,查出异常订单之后,可以再根据            question_desc二次过滤数据

   6.Q: 订单上传接口是否支持预售功能

      A: 支持。关于预售编码,自有商城的订单和其他平台是一样的,上传商品编码格式符合预售规则的,订单进入到系统也会自动标注为预售的;

   7.Q: 订单上传后,在ERP中取消后,再次上传还能上传成功吗

      A: 接口上因为做了幂等,会提示成功,但是订单的状态仍是取消

   8.Q: 正式环境中订单上传之后成功但是查不到

      A: 1、要确认【店铺设置】里是否开启该店铺;

          2、【业务流程设置】中是否开启下载所有订单,如果待付款的订单,会受到这个开关影响;

    9.Q: 上传订单时,线上订单号可以重复吗

        A: 每个店铺的订单,线上单号都是唯一的

    10.Q: 上传订单时 shop_status 为 WAIT_SELLER_SEND_GOODS,传到后台是待支付

          A: 1、检查一下上传是否有pay节点

              2、检查一下应付金额和实付金额是否正确

     11.Q: 订单查询的接口是任何状态的订单都可以查询到吗?

           A: 通过时间查询的话是可以查到任何状态的订单,但是不包括淘系的订单,淘系订单需要走奇门协议

     12.Q: 上传订单接口执行了很多次,但是ERP中只有一个订单

           A: 线上单号so_id以及店铺shop_id是一样的时候,是只有一个订单;

     13.Q: 自有商城,支付订单之后调用订单上传的接口然后ERP就可以发货了吗

          A: 支付之后调用订单上传的接口就可以变成已付款待审核状态,就可以去审核发货

     14.Q: 上传订单的时候,如何标记订单中的某一个商品是赠品

          A: 订单上传接口中目前没有这个赠品的标识,可以将赠品价格设置为0元上传,这个赠品和0元的区别只是多了一个标识,理论上是一样的

     15.Q: 怎么将订单从未付款状态变更成已付款待审核状态

          A: 再次调用订单上传接口,带上pay节点的支付信息,而且支付的金额amount要跟订单主表的应付金额pay_amount 一致

     16.Q: 订单相关金额解析

          A: sum(items下的amount) + freight = pay_amount

           商品总金额+运费=订单应付

           订单应付pay_amount - (pay下的amount) = 优惠金额; 订单应付-订单实付=优惠金额

     17.Q: 如何获取聚水潭系统里的淘宝订单?

          A: 1.可以从系统里的【导出订单】模块,导出所有平台的订单数据(包括淘系订单);

              2.通过奇门的相关业务场景可以对接聚水潭ERP系统,商家自研系统可充当WMS、POS、线下ERP从而对接奇门ERP-WMS场景,

              ERP-POS场景、线上ERP-线下ERP, 具体的根据外部自研系统获取数据的用途来选择对应的业务场景。奇门申请文档:                       https://shimo.im/docs/VWCrV68cDvKY66dq/read

      18.Q:淘系平台包括哪些?

           A:淘系的平台包括:淘宝天猫,天猫供销,考拉pop,考拉供应商直发,阿里巴巴,淘工厂,天猫超市,天猫国际直营,阿里健康直营,

           淘宝定制,速卖通,阿里巴巴国际站,lazada


   


  


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

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