百胜E3-观远数据连接器接入与接口授权说明
1. 适用范围
本文适用于在观远数据连接器中创建“百胜E3”数据账户,并通过百胜 E3OMS 开放接口同步订单、库存和商品等数据。
观远连接器当前采用密码型验密,数据账户必填字段为 domain、key 和 secret。百胜侧实际可访问的数据范围,仍以应用审核结果、已开通的 API 权限和当前 E3 业务权限为准。
2. 申请百胜E3开放接口资质
2.1 注册开发者账号并提交应用接入申请
进入百胜开放平台,注册并登录开发者账号。按照官方接入流程提交应用接入申请,等待接入信息审核;审核通过后再开展第三方集成。

官方页面展示的接入流程依次为:开发者账号注册、应用接入申请、接入信息审核、第三方集成开发。
前往百胜开放平台申请应用;如需确认 E3OMS 文档入口,可查看百胜开放平台开发指南。
2.2 在应用详情页获取 AppKey 和 AppSecret
应用审核通过后,登录百胜开放平台后台,依次进入“应用管理 → 应用列表”,打开本次 E3OMS 对接使用的目标应用。在“应用详情”的“应用概览”区域复制 appkey;appsecret 默认以掩码显示,可使用页面提供的“复制”或“查看”操作获取。

图中为百胜官方白皮书公开的“应用管理 → 应用列表”页面:列表包含 Appkey 列和“操作”入口。实际操作时,请找到对接产品为 E3OMS、审核已通过的目标应用;从列表记录 AppKey,再通过该应用的操作入口进入应用详情获取配套的 AppSecret。截图中的 Adaptor 示例仅用于识别百胜开放平台菜单和字段位置,不代表本连接器应选择 Adaptor。
如页面同时展示普通环境和“应用概览(生产环境)”,请根据实际对接环境使用同一区域内配套的 AppKey 与 AppSecret,不要混用不同环境的凭证。
登录百胜开放平台后台并进入应用管理。
2.3 确认请求 Host
domain 对应当前企业百胜 E3OMS 的实际请求 Host。该地址不在应用详情的 AppKey/AppSecret 区域中,请向百胜实施顾问、百胜技术支持或本企业 E3 系统负责人确认。不要填写开放平台首页、API 文档页或 API 测试工具页面地址。
2.4 需要保存的资质字段
| 百胜E3OMS字段 | 是否必填 | 官方获取入口 | 获取与保存说明 |
| 请求 Host | 是 | 百胜实施/技术支持或企业 E3 系统负责人 | 确认当前企业实际 E3OMS API 请求地址;不填写开放平台或文档页面地址。 |
| AppKey | 是 | 应用管理 → 应用列表 → 应用详情 | 在目标应用“应用概览”中复制 appkey。 |
| AppSecret | 是 | 应用管理 → 应用列表 → 应用详情 | 在目标应用“应用概览”中点击“复制”或“查看”;属于敏感信息。 |
3. 创建观远连接器数据账户
3.1 选择平台并填写字段
在观远数据连接器中进入数据账户管理,点击“新增数据账户”,选择“百胜E3”。填写便于识别的账户名称,并依次填写 domain、key 和 secret。

如图,选择“百胜E3”后,表单展示账户名称以及三个必填验密字段。截图中未包含真实密钥。
3.2 字段映射关系
| 百胜E3OMS字段 | 观远连接器字段 | 是否必填 | 官方获取入口 | 说明 |
| 请求 Host | domain | 是 | 百胜实施/技术支持或企业 E3 系统负责人 | 填写当前企业实际 API 请求地址,保留协议、域名和必要路径,并避免首尾空格。 |
| AppKey | key | 是 | 进入目标应用详情 | 填写目标应用“应用概览”中的 appkey。 |
| AppSecret | secret | 是 | 进入目标应用详情 | 填写同一应用、同一环境下与 AppKey 配套的 appsecret。 |
3.3 测试连接并保存
- 再次核对
domain、key、secret 是否属于同一套已审核应用。
- 点击“测试连接”。
- 测试成功后点击“确定”保存数据账户。
请勿在工单、聊天记录或截图中发送完整 AppSecret。若需协助排查,只提供脱敏后的字段和报错信息。
4. 当前已支持的接口范围
以下范围来自观远连接器当前平台 API 清单;百胜侧能否返回数据仍取决于应用权限和业务数据权限。
| 业务主题 | 已配置接口 | 主要落表 |
| 订单 | 获取订单列表 | 订单、订单明细、订单优惠明细 |
| 订单 | 获取订单详情信息 | 订单详情、SKU 明细 |
| 库存 | 获得仓库库存列表 | 仓库库存 |
| 商品档案 | 获得颜色列表 | 颜色档案 |
| 商品档案 | 获得商品列表 | 商品档案 |
5. 常见问题
| 问题 | 处理建议 |
| 不知道 domain 填什么 | 填写百胜E3OMS实际“请求 Host”,向百胜或企业 E3 接入负责人确认。不要填写开放平台首页或 API 文档页地址。 |
| 测试连接提示认证或签名失败 | 确认 key 与 secret 来自同一套已审核应用,检查是否复制不完整、混入空格或误用了其他环境的密钥。 |
| 测试连接成功但接口无数据 | 确认应用已开通目标 API 权限,并检查当前 E3 账号的数据权限及接口查询时间范围。 |
| AppSecret 已泄露 | 立即在百胜侧停用或重置密钥,再更新观远数据账户;不要继续使用已泄露的 AppSecret。 |
|