Shopee电商接入指南
准备 Shopee 开放平台应用凭据，在观远连接器中为目标店铺创建并授权数据账户。
1. 适用范围
本文适用于使用 Shopee 电商连接器同步店铺业务数据的客户。连接器提供“店铺授权”和“主账号授权”两种方式；两种方式均按一家店铺创建一个数据账户。若有多家店铺，请分别创建数据账户并逐店完成授权。
2. 在 Shopee 开放平台准备应用凭据
2.1 进入应用管理
- 使用有应用管理权限的账号登录 Shopee Open Platform。
- 进入 开放平台 Console 的 App List，打开用于目标店铺的应用；尚未创建应用时，在该页创建并按平台要求完成配置与审核。
- 进入应用详情的 App Key 区域，确认将用于正式店铺授权的 Partner ID 与 Key。查看 Shopee 官方应用详情示例。
2.2 保存正式环境凭据
从同一应用复制正式环境的 Partner ID 与对应的 Key。不要将测试环境的 Test Partner ID、Test Key 填入正式数据账户，也不要混用不同应用的 ID 与 Key。应用状态、上线和正式凭据以 Shopee 开放平台应用管理页显示为准。
| 需要准备的信息 | 官方获取位置 | 填写说明 |
|---|---|---|
| Partner ID | Console → App List → 目标应用 → App Key | 复制正式环境的 Partner ID。 |
| Partner Key | 同一应用的 App Key 区域 | 复制与上方 Partner ID 配套的正式 Key，妥善保管。 |
3. 创建观远连接器数据账户
- 进入“数据账户管理”，点击“新增数据账户”，所属平台选择“Shopee电商”。
- 填写账户名称，选择“店铺授权”或“主账号授权”，再按下表填写字段。
- 点击“立即授权”，在 Shopee 页面核对授权账号与目标店铺，按提示完成授权。返回连接器看到授权完成状态后，点击“确定”保存。
字段填写对照
| Shopee 信息 | 连接器字段 | 是否必填 | 获取入口与说明 |
|---|---|---|---|
| 不涉及 | 账户名称 | 是 | 自行填写便于识别的名称，建议包含站点和店铺简称。 |
| 授权对象 | 授权方式 | 是 | 选“店铺授权”或“主账号授权”；每个数据账户只授权一家店铺。 |
| 正式 Partner ID | 合作伙伴 ID（partner_id） | 是 | 在 Shopee 应用的 App Key 区域获取。 |
| 同一应用的正式 Partner Key | 合作伙伴密钥（partner_key） | 是 | 在同一应用的 App Key 区域获取。 |
| 无；观远内部账户标识 | 目标店铺 ID（customer_id） | 是 | 可自行填写，建议使用实际店铺 ID 便于识别；此字段用于区分数据账户，不需要向 Shopee 申请。同一批账户中每家店铺的值必须不同。 |
| 卖家授权账号所在区域 | 授权区域（region） | 是 | 按实际授权账号选择“全球（不含中国大陆和巴西）”“中国大陆”或“巴西”；该选项决定打开的 Shopee 授权入口。 |
授权与保存
点击“立即授权”后，按选择的授权方式登录相应的 Shopee 账号，并核对授权页面上的店铺。主账号可能关联多家店铺，请一次只授权当前数据账户对应的一家。授权未完成时先不要保存；返回后确认状态，再点击“确定”。
4. 常见问题
| 问题 | 处理建议 |
|---|---|
| 找不到 Partner ID 或 Key | 确认登录的是 Shopee 开放平台开发者账号，并在 App List 打开正确的应用；测试凭据与正式凭据不要混用。 |
| 目标店铺 ID 从哪里获取 | 这里的 customer_id 是连接器内部标识，可自行填写；建议使用已知店铺 ID 以便识别，并确保多家店铺之间不重复。 |
| 授权页打不开或授权未完成 | 核对授权区域、授权方式和应用凭据，再确认登录的卖家或主账号有权授权目标店铺。返回连接器后查看授权状态。 |
