得物接入指南
得物接入指南
1. 适用范围
本文适用于在观远数据连接器中创建“得物”数据账户，并将有权限的得物商家数据授权给观远。请使用得物企业商家账号完成授权；“得物-海外”是另一平台，不适用本文。
观远连接器已使用服务商应用。创建此类数据账户时，客户无需自行申请或填写得物应用 Key、应用密钥或访问令牌。
2. 准备得物商家授权
2.1 确认授权账号
准备可登录目标得物商家的账号，并确认该账号有权为店铺授权第三方应用。得物官方说明第三方开发者采用授权码模式，商家会在得物开放平台授权页登录并完成授权。
 得物开放平台官方公开说明：第三方接入由商家在得物页面完成登录授权。文档只用于核对授权方式；实际授权从连接器的“立即授权”按钮发起。
2.2 需要准备的信息
| 项目 | 来源 | 用途 |
|---|
| 得物商家账号 | 用于登录得物授权页 | 确认要授权的店铺 |
| 客户标识（customerId） | 在观远连接器中自行填写 | 区分数据账户的内部标识，不是得物开放平台资质 |
3. 创建观远数据账户
3.1 选择得物平台
在观远数据连接器中进入“数据账户管理”，点击“新增数据账户”，所属平台选择“得物”。
 得物数据账户表单：填写账户名称和客户标识后，点击“立即授权”。
3.2 字段映射关系
| 得物平台字段 | 连接器字段 | 必填 | 说明 |
|---|
| 无 | 账户名称 | 是 | 自行填写便于识别的名称，例如“得物旗舰店”。 |
| 无 | 客户标识（customerId） | 是 | 观远内部账户标识，可自定义，例如 dewu_store_001。同一批数据账户中的值必须不同；无需到得物平台获取。 |
| 商家账号授权 | 立即授权 | 是 | 查看得物官方授权说明；使用有权限的得物商家账号在跳转页面完成授权。 |
3.3 完成授权并保存
- 填写账户名称和唯一的客户标识，点击“立即授权”。
- 在打开的得物页面登录目标商家账号，阅读页面展示的应用和权限信息，确认授权。
- 返回连接器，确认授权状态显示“已完成”，再点击“确定”保存数据账户。
4. 常见问题
| 现象 | 处理建议 |
|---|
| 授权状态仍为“未完成” | 返回连接器重新点击“立即授权”，检查得物登录和授权是否完成，确认浏览器没有拦截跳转。 |
| 授权后看不到预期数据 | 核对登录的是目标商家账号，并检查授权范围及接口权限；需要时重新阅读得物官方授权说明。 |
| 需要接入多个商家账户 | 分别创建数据账户，每个账户使用不同的客户标识，并由对应商家完成授权。 |
| 
