跳转到正文

小储云系统对接 购印网络

先看这篇教程能帮你做什么

照着本教程操作,你可以完成下面这整套流程:

  1. 在小储云添加货源
  2. 去购印权益获取接口信息
  3. 把小储云服务器公网 IP 加入购印权益白名单
  4. 回到小储云填写 API 信息
  5. 点击测试,确认对接成功
  6. 同步商品并完成发货配置

这篇文档适合谁?

  • 已经在使用 小储云
  • 想把 购印权益 接入为货源
  • 第一次做这类接口对接,希望有完整的新手步骤

开始前先准备

准备项说明
小储云后台账号能进入 商品相关 -> 货源管理
购印权益后台账号能进入 用户中心 -> 账户管理 -> 接口管理
小储云服务器公网 IP用来加入购印权益白名单
验证方式短信、邮箱或交易密码,至少能用一种
余额购印权益余额需要充足,否则后续下单可能失败

先别被“卡卡云系统”这个选项吓到

在小储云里,对接购印权益这类货源时,页面里可能要选择 卡卡云系统 这个模板。

这是正常的,照着选就行,不代表你接错了平台。

这些字段是什么意思?

字段简单理解
API Key接口账号标识,页面里也可能叫 Key、AppKey
API Secret接口密钥,页面里也可能叫 Secret、AppSecret
站点域名 / API 地址小储云请求购印权益接口时使用的地址
IP 白名单只允许白名单里的服务器访问接口
如果字段名称和你后台不完全一样怎么办?

不同版本后台的命名可能略有区别,但只要意思对应即可。

你可以记住一条最简单的规则:

  • Key 类字段一般对应身份标识
  • Secret 类字段一般对应接口密钥
  • 站点域名 一般对应接口地址

第一步:先在小储云添加货源

  1. 登录小储云后台
  2. 进入 商品相关 -> 货源管理 -> 添加货源
  3. 在货源类型里选择 卡卡云系统

小储云-货源管理-添加货源

小储云-选择卡卡云系统

小提醒

这一步先把货源入口建出来就行,接口信息稍后再回来填写。

第二步:去购印权益获取接口信息

  1. 打开购印权益
  2. 点击 用户中心
  3. 进入 账户管理 -> 接口管理
  4. 选择验证方式进入接口管理页

购印权益-用户中心入口

购印权益-进入接口管理

购印权益-选择验证方式

如果你需要重新生成密钥,就按下面做:

  1. 点击 重置
  2. 点击 获取验证码
  3. 输入验证码后点击 确定
  4. 复制并保存新的 API 信息

购印权益-重置接口信息

购印权益-获取验证码

购印权益-输入验证码并确定

购印权益-API信息展示与保存

注意

重置后旧密钥会立即失效。

如果你之前已经在小储云填过旧值,后面一定要同步更新成新的。

第三步:先把小储云服务器公网 IP 加入白名单

  1. 仍然停留在购印权益 接口管理 页面
  2. 找到 白名单IP
  3. 填入小储云部署服务器的公网 IP
  4. 点击 保存信息

购印权益-填写白名单IP并保存

购印权益-保存成功提示

不知道公网 IP 怎么办?

  • 优先联系你的服务器提供商或运维人员确认
  • 也可以在服务器上访问 IP 查询网站获取
  • 如果有多个出口 IP,建议全部加入,且一行一个填写

第四步:回到小储云,填写 API 信息

回到小储云刚刚添加的货源页面,填写下面几项:

小储云字段这里填什么
API Key购印权益提供的账号标识
API Secret购印权益提供的接口密钥
站点域名 / API 地址购印权益当前可用的接口地址

小储云-填写API信息

填好后点击保存,再返回列表。

小储云-返回列表

关于接口地址

站点域名 / API 地址有可能调整。

如果你发现之前能用、现在突然连不上,优先核对这里是不是需要更新。

第五步:先点一次测试,确认已经打通

  1. 在货源列表中点击
  2. 看到“测试成功”或“连接成功”等提示,就代表接口已经打通

小储云-测试按钮

小储云-测试结果

为什么建议先测试?

先把接口打通,再去同步商品,会省掉很多无效排错时间。

第六步:同步商品并完成发货配置

接口测试成功后,再继续做商品同步:

  1. 进入 商品管理 -> 添加商品
  2. 打开 发货配置
  3. 选择 对接第三方内置对接货源
  4. 选择你刚添加的货源
  5. 点击 获取数据
  6. 在可对接商品中选择要同步的商品并确认

小储云-商品管理-添加商品

小储云-发货配置入口

小储云-发货配置页面

小储云-选择第三方内置货源

小储云-选择货源对接

小储云-获取数据按钮

小储云-确认获取数据

小储云-获取成功提示

小储云-确认同步商品

同步完成后,回到基础配置确认商品信息已经带出来。

小储云-基础配置已同步

如果失败,按这个顺序排查

  1. 先看购印权益 白名单IP 是否已经加上小储云服务器公网 IP
  2. 再看小储云里填写的 API Key / API Secret 是否正确
  3. 再看 站点域名 / API 地址 是否还是最新可用地址
  4. 如果测试成功但同步失败,优先检查商品权限或商品数据本身
  5. 还是不行,再截图报错信息联系技术支持

常见问题

1. 点击“测”测试失败,怎么查?

优先检查这 4 项:

  • 白名单 IP 是否正确
  • API Key / Secret 是否填错
  • 接口地址是否最新
  • 服务器网络是否能正常访问外网

2. 测试成功了,但“获取数据”为空

这通常不是接口没通,而是商品层面的问题。

你可以继续检查:

  • 购印权益账号下是否有可用商品
  • 当前商品是否具备同步权限
  • 是否只是临时波动,稍后再试一次

3. 用户下单后发货失败

优先检查:

  • 购印权益余额是否足够支付拿货价
  • 商品是否已经正确同步到小储云
  • 发货配置里是否已经选中了正确货源

最后再提醒 3 件事

安全建议

  • API Key / API Secret 属于敏感信息,不要随意截图外传
  • 如果怀疑密钥泄露,立即去购印权益重置,并同步更新小储云
  • 每次改完接口地址或密钥,最好先重新点一次 再继续同步商品