乐檬对接流程

1. 概述

1.1 应用场景

企业已使用乐檬零售、供应链或相关业务系统管理门店、商品、库存、零售、会员、配送等业务数据，希望通过观远数据连接器把乐檬侧数据同步到观远，用于后续经营分析、门店分析、商品分析、库存周转、会员运营、供应链协同或财务对账。

乐檬开放平台提供面向企业应用开发、财务系统对接、WMS 系统对接、订单聚合系统对接等场景的开放能力。连接器接入后，可以把乐檬业务系统中的档案、零售、供应链等数据纳入统一的数据分析链路。

1.2 功能简介

观远数据连接器通过乐檬开放平台 API 获取乐檬业务数据。客户需要先在乐檬开放平台注册开发者账号、创建应用，并完成应用审核和接口权限准备；随后在观远数据连接器中创建“乐檬”数据账户，填写乐檬侧应用的 appId 和 secret，用于后续数据同步、任务配置或接口取数。

观远连接器平台元数据已确认：

1.3 注意事项

新建数据连接前，请注意：

1. 如果在观远数据连接器中无法选择“乐檬”平台，请先联系观远实施或连接器管理员确认平台是否已开通。
2. 乐檬侧应用创建后需要审核。官方帮助文档说明，应用审核阶段需要向乐檬支持人员提供应用的 APPID 和用途，乐檬会推进审批流程；乐檬也会评估项目准入和后台服务器性能配置。
3. 乐檬开放平台存在按接口调用收费和一次性买断收费等收费类型。正式接入前，请以乐檬官方页面、合同或乐檬支持人员说明为准确认服务模式、接口权限和调用额度。
4. 如果应用、接口权限或调用次数未准备完成，观远侧数据账户即使保存成功，后续同步也可能出现无权限、调用失败或无数据。
5. secret、应用信息、商户账号、门店信息等均属于敏感信息，请妥善保管，不要向无关人员披露。

2. 观远数据连接器侧准备

2.1 登录连接器平台

登录观远数据连接器平台：

https://apiconnector.guandata.com/

登录后点击右上角“进入控制台”。如下图所示：

2.2 进入数据账户管理

进入控制台后，点击左侧菜单“数据账户管理”。

在数据账户页面，可以按平台类型、数据账户名称筛选已有账户，也可以点击右侧“新增数据账户”创建新账户。如下图所示：

3. 获取授权信息

3.1 需要准备的字段

新增“乐檬”数据账户前，需要先在乐檬开放平台完成开发者账号注册、应用创建和应用审核，并准备观远连接器表单所需的以下字段：

官方参考入口如下：

乐檬开放平台官网：https://console.nhsoft.cn/
乐檬开放平台应用接入流程：https://lemeng.dochelp.cn/d/1895077838032871426.html
乐檬开放平台接入指引：https://console.nhsoft.cn/documents/docs/1/27
乐檬开放平台接口文档示例：https://console.nhsoft.cn/documents/api-doc/1/15/nhsoft.amazon.branch.list

3.2 创建乐檬开放平台应用

根据乐檬官方帮助文档，应用接入前需要先注册乐檬开放平台开发者账号。注册完成后，进入乐檬开放平台官网并登录，点击右上角“创建应用”，填写应用信息。

创建应用时通常需要填写应用名称、应用地址，并选择收费类型。收费类型包括“按接口调用收费”和“按一次性买断收费”。如下图所示：

字段填写时请注意：

• 应用名称建议能区分项目、环境或业务线，便于后续排查。
• 应用地址为可选项；如果应用需要在乐檬内进行网页端跳转，并由乐檬提供登录用户信息，可按乐檬要求配置。
• 收费类型在应用创建完成后通常不允许更改，正式创建前请先确认项目采用的服务模式。

3.3 获取 appId

应用创建后，在乐檬开放平台应用列表或应用详情中查看 APPID。官方帮助文档示例图中，应用列表会展示应用的审核状态、APPID、APP URL 和状态。如下图所示：

应用刚创建时可能处于“审核中”。官方帮助文档说明，此时需要联系乐檬支持人员，提供应用的 APPID 和用途，由乐檬推进应用审批。应用审批通过后，再使用该应用对应的 appId 作为观远连接器字段。

字段填写时请注意：

• appId 应填写乐檬正式应用的 APPID，不要填写账号手机号、门店名称、应用名称或接口名称。
• 如果项目同时存在测试应用和正式应用，请选择本次连接器数据同步对应环境的应用。
• 如果应用仍处于审核中，建议先完成审核和接口权限开通，再进行观远侧测试连接。

3.4 获取 secret

观远连接器还需要填写 secret。该字段应来自乐檬开放平台正式应用的密钥信息。由于公开帮助文档主要展示了应用创建、审核和 APPID 位置，secret 的具体展示位置可能与乐檬当前控制台版本、应用状态、接口服务开通方式有关。

获取 secret 时，请在应用审批通过后进入目标应用详情、接口接入配置或密钥管理相关页面查看；如果页面没有直接展示，请联系乐檬支持人员确认应用密钥获取方式。字段填写时请注意：

• secret 应与 appId 属于同一个乐檬正式应用。
• 不要填写测试应用、过期应用或其他项目的密钥。
• 复制时避免多余空格、换行或漏字符。
• 密钥只用于观远连接器配置，不要在文档、工单或聊天中明文传播。

3.5 接口服务和调用额度确认

乐檬官方帮助文档说明，按接口调用收费的应用需要在乐檬开放平台进行接口充值；按次付费应用是预充值次数模式，应用调用次数不足或欠费时间超过平台规则时，可能影响接口可用性。正式上线前，请与乐檬支持人员确认目标应用已完成对应接口权限、服务模式和调用额度准备。

4. 连接“乐檬”数据账户

4.1 新增数据账户

在“数据账户管理”页面点击“新增数据账户”。

4.2 选择所属平台

所属平台选择：

乐檬

选择后，页面会展示该平台需要填写的连接字段。当前观远连接器平台元数据确认，“乐檬”数据账户需要填写 appId 和 secret。

4.3 填写连接信息

新增数据账户时，按观远页面实际字段填写。当前平台元数据确认的必填字段如下：

4.4 测试连接并保存

连接信息填写完成后，先点击“测试连接”。测试通过后，点击“确定”保存数据账户。

如果测试连接失败，建议重点检查：

• appId 是否来自乐檬正式应用，应用是否已审核通过。
• secret 是否填写完整，是否存在多余空格、换行或复制错误。
• 乐檬侧应用接口权限、服务模式和调用额度是否已准备完成。
• 观远侧“乐檬”平台是否已为当前客户开通。

5. 后续数据使用

数据账户保存成功后，可在观远数据连接器后续的数据集同步、任务配置或接口取数流程中选择该账户，用于同步乐檬档案、零售、供应链等业务数据。

如果客户有多套乐檬应用、多业务线或测试/正式环境并行的情况，建议按环境和业务线分别创建清晰命名的数据账户。后续数据同步范围、任务周期和数据集落表方式，以项目实际建模方案和观远连接器支持能力为准。

6. 完整流程

完整流程如下：

1. 登录观远数据连接器平台，进入“数据账户管理”。
2. 在乐檬开放平台注册开发者账号，登录乐檬开放平台。
3. 在乐檬开放平台创建应用，填写应用名称、应用地址和收费类型。
4. 应用创建后，获取应用 APPID，并按乐檬要求联系支持人员完成应用审核、接口权限和服务模式确认。
5. 应用审批和接口服务准备完成后，获取同一应用对应的 appId 和 secret。
6. 在观远数据连接器侧新增数据账户，所属平台选择“乐檬”。
7. 填写 appId 和 secret。
8. 点击“测试连接”，测试通过后点击“确定”保存。
9. 在后续数据同步或取数流程中使用该数据账户，并根据项目需要配置同步范围、任务周期和数据集落表。