观远社区 › 门户 ›电商连接器 › 查看内容

聚水潭连接器配置指南

2026-11-16 11:44| 发布者: 王佳林| 查看: 343| 评论: 0

摘要: 聚水潭连接器配置指南聚水潭连接器配置指南在观远API连接器中新增数据账户,所属平台选择聚水潭ERP,再按所需接口选择聚水潭-非奇门或聚水潭-奇门。接入类型使用方式需要准备非奇门聚水潭开放平台接口;支持服务商授 ...
聚水潭连接器配置指南

聚水潭连接器配置指南

在观远 API 连接器中新增数据账户,所属平台选择聚水潭ERP,再按所需接口选择聚水潭-非奇门或聚水潭-奇门。

接入类型使用方式需要准备
非奇门聚水潭开放平台接口;支持服务商授权和自有应用配置。服务商授权:页面完成授权;自有应用:appKey、appSecret、accessToken
奇门聚水潭奇门网关接口,需完成对应奇门场景授权。观远奇门资质(默认):customerId、targetAppKey。自有奇门应用配置:另需 appKey、appSecret。

两种类型的应用凭证不同,不要混用。可获取的数据以对应接口权限及商家授权范围为准。

IP 白名单

若应用启用了 IP 白名单,请在聚水潭开放平台对应应用的IP 白名单中添加以下两个观远连接器出口 IP,并保存:

119.13.94.136,124.70.196.23

支持英文逗号分隔时可直接复制;按条维护时分别添加。使用自有应用时,由应用管理员配置;使用观远服务商应用时,由观远管理员维护。

1. 创建数据账户

进入数据账户管理 → 新增数据账户,所属平台选择聚水潭ERP,填写便于识别的账户名称。

1.1 聚水潭-非奇门:服务商授权

  1. 选择聚水潭-非奇门 → 服务商授权,填写账户名称。
  2. 点击“立即授权”,使用商家聚水潭 ERP 管理员账号按授权页面提示完成授权。
  3. 返回数据账户页面,确认授权状态已完成,再点击“确定”保存。

此方式使用观远内置服务商应用,无需手动填写 appKey、appSecret。

聚水潭非奇门服务商授权表单
非奇门:服务商授权,点击“立即授权”完成授权

1.2 聚水潭-非奇门:自有应用配置

准备授权信息

  1. 使用自有应用时,进入聚水潭开放平台,在对应应用中获取appKey、appSecret,并确认已开通所需接口权限。
  2. 使用上述应用发起商家授权,可参考聚水潭官方用户授权工具。以实际接入应用的 appKey 生成授权链接,使用商家聚水潭 ERP 管理员账号完成授权,并按需确认仓库范围及授权有效期。
  3. 取得授权后的accessToken。若返回的是授权码,应由应用维护人员按官方授权流程换取 accessToken;授权码不能直接填入 accessToken。

若使用观远提供的非奇门应用,appKey 填写 8cdb416e778347f89ac1052d23edd78d,appSecret 向观远连接器管理员获取,无需自行申请应用。使用官方授权工具生成授权链接时,也填写此 appKey。

原文截图:非奇门授权链接生成工具,图中应用信息仅对应观远非奇门应用
原文截图:非奇门授权链接生成工具,图中应用信息仅对应观远非奇门应用
原文截图:商家授权时确认仓库范围及授权有效期
原文截图:商家授权时确认仓库范围及授权有效期

填写数据账户

选择聚水潭-非奇门 → 自有应用配置,填写以下必填字段:

连接器字段来源及填写说明
appKey自有应用填写其 app_key;使用观远非奇门应用时填写 8cdb416e778347f89ac1052d23edd78d。
appSecret与上述 appKey 配套的 app_secret。
accessToken该应用获得的商家授权令牌 access_token,须与 appKey 对应。
聚水潭非奇门自有应用配置表单
非奇门:自有应用配置

1.3 聚水潭-奇门

准备授权信息

  1. 先确认使用观远奇门资质还是自有奇门应用。使用自有应用时,向应用管理员获取 appKey 和 appSecret。
  2. 登录聚水潭 ERP 后台,进入设置 → 基础设置 → 开放平台 → 奇门自定义场景授权&配置。菜单以实际后台为准。
  3. 在“对方奇门应用 appkey”中,使用观远资质时填写34819619,按所需接口提交场景授权申请。使用自有奇门应用时填写自己的 appKey。
  4. 授权成功后,在该场景授权配置中查看customer_id及target_app_key,分别填入连接器的 customerId、targetAppKey。

customerId 是聚水潭奇门场景授权返回的标识,不是自行命名的账户编号;targetAppKey 与调用方 appKey 分别填写,不要互相替代。

原文截图:奇门自定义场景授权入口,观远奇门 appKey 填写 34819619
原文截图:奇门自定义场景授权入口,观远奇门 appKey 填写 34819619
原文截图:查看 customer_id 与 target_app_key;以实际申请成功状态为准
原文截图:查看 customer_id 与 target_app_key;以实际申请成功状态为准

填写数据账户

选择聚水潭-奇门,再选择认证方式。

customerId 和 targetAppKey 分别取自同一条奇门场景授权配置中的 customer_id 和 target_app_key。

观远奇门资质(默认)

填写 customerId 和 targetAppKey。连接器使用内置奇门应用,appKey 为 34819619。

观远奇门资质(默认)
观远奇门资质(默认)

自有奇门应用配置

填写 customerId、targetAppKey,以及自有应用的 appKey 和 appSecret。

自有奇门应用配置
自有奇门应用配置

1.4 测试并保存

自有应用配置及奇门方式,点击“测试连接”,成功后点击“确定”保存。后续接口及同步任务选择对应类型的数据账户。

2. 常见问题

  • 非奇门连接失败:检查 appKey、appSecret 是否配套,accessToken 是否属于该应用、是否仍有效。
  • 奇门连接失败:检查场景授权是否已成功,以及 customerId、targetAppKey、奇门应用凭证是否与同一授权配置对应。
  • IP 白名单:检查应用是否已放行上述两个出口 IP。
  • 连接成功但无数据:检查接口权限、商家及仓库授权范围、查询条件。淘系及其他平台数据还受源平台规则限制。

路过

雷人

握手

鲜花

鸡蛋

本文导航

评论

您需要登录后才可以发表言论 登录 或 立即注册
微信服务号
联系我们
电话:400-880-0750
邮箱:hello@guandata.com
Copyright © 2001-2026 观远社区 版权所有 All Rights Reserved. 浙 ICP 备15006424号-3
去评论 去发文 返回顶部
返回顶部