旺店通跨境对接指南
1. 适用范围
本文适用于在观远数据连接器中创建“旺店通跨境”数据账户，并通过旺店通跨境 ERP 开放 API 读取业务数据的场景。
客户需要先在旺店通跨境 ERP 侧完成第三方应用授权，获取应用标识和密钥信息，再在观远连接器中创建数据账户并测试连接。
本文参考的开放平台资料来自慧策语雀空间“旺店通跨境ERP开放api”。当前资料页为语雀文档，不是官网独立开放平台页面；正式操作时以旺店通/慧策实际后台和客户账号权限为准。
2. 申请平台对接资质
2.1 确认开放 API 资料入口
旺店通跨境的开放 API 资料位于慧策语雀空间的“跨境ERP开放api”目录。目录中与数据账户创建最相关的是：
上图来自 Call Guide 页面，展示了第三方平台调用 OpenAPI 时的鉴权链路。客户对接时重点确认应用、卖家主体和接口权限都已开通。
2.2 申请或配置第三方应用
根据 Auth 页面说明，第三方 ISV 或平台需要在旺店通 ERP 的应用授权页面上进行授权。对接方需要输入应用名称 appName，旺店通会为该应用颁发对应的 appkey，用于后续接口鉴权。
Auth 页面同时说明，正式环境的 appName 和 appKey 需要联系相关人员进行配置。因此客户在准备对接前，应先确认自己的旺店通跨境账号是否具备开放 API 调用权限，并向旺店通/慧策相关人员获取正式环境可用的应用信息。
2.3 需要保存的资质字段
| 资质字段 | 获取位置 | 用途 |
|---|
appName | 旺店通跨境 ERP 应用授权配置；Auth 页面说明该字段是唯一应用 key | 标识本次对接使用的第三方应用 |
appkey / appKey | 旺店通为该应用颁发；Auth 页面 Response Parameters 中说明该字段是应用所颁发的 key | 作为接口鉴权密钥 |
sid | Auth 页面 Common Parameter 中说明为第三方应用所属卖家 | 标识本次请求所属卖家/店铺主体 |
3. 创建连接器数据账户
3.1 打开数据账户创建页并选择平台
在观远连接器进入数据账户管理，新增数据账户，并选择“旺店通跨境”。
选择平台后，表单应展示旺店通跨境所需的验密字段。根据当前连接器平台配置，旺店通跨境需要填写 appName、sid 和 appKey。
3.2 字段映射关系
| 第三方平台字段 | 连接器字段 | 是否必填 | 说明 |
|---|
appName | appName | 是 | 旺店通跨境 ERP 应用授权时配置的唯一应用 key |
sid | sid | 是 | 第三方应用所属卖家；用于校验当前应用是否有权访问该卖家和接口 URI |
appkey / appKey | appKey | 是 | 旺店通为应用颁发的 key；连接器字段使用驼峰命名 appKey |
3.3 填写、测试连接并保存
按字段映射关系填写 appName、sid 和 appKey 后，点击测试连接。测试通过后保存数据账户。
如果测试连接失败，优先检查以下内容：
appName 是否为旺店通侧已配置的正式环境应用名称。appKey 是否与该 appName 匹配。sid 是否为该应用有权限访问的卖家主体。- 旺店通侧是否已开通对应接口 URI 权限。
4. 常见问题
| 问题 | 处理建议 |
|---|
| 找不到官网开放平台页面 | 当前旺店通跨境开放 API 资料来自慧策语雀空间“跨境ERP开放api”。可以先用语雀资料确认字段和调用规则，正式申请路径以旺店通/慧策实际后台为准。 |
不知道 appName 和 appKey 从哪里获取 | Auth 页面说明正式环境的 appName 和 appKey 需要联系相关人员配置。客户应联系旺店通/慧策侧确认应用授权和密钥发放。 |
sid 填写后仍测试失败 | 检查该 sid 是否属于当前第三方应用，并确认应用对该卖家和接口 URI 有访问权限。 |
| 测试连接提示鉴权失败 | 核对 appName、appKey、sid 是否填写正确，并确认旺店通侧已为该应用和卖家开通接口权限。 |
| 
