美团牵牛花对接流程

1. 概述

1.1 应用场景

企业已使用美团牵牛花系统管理即时零售相关业务，希望将牵牛花侧的门店、商品、订单等经营数据同步到观远数据连接器，用于后续经营分析、门店履约监控、库存分析、渠道经营分析或财务对账。

美团牵牛花系统定位为即时零售数字化中台 SaaS，覆盖商品管理、履约管理、库存管理、员工管理、财务管理、用户管理、供应链管理等商家经营环节。对连锁零售、前置仓、商超便利等场景，连接器接入后可帮助客户把牵牛花业务数据沉淀到统一的数据分析链路中。

1.2 功能简介

观远数据连接器通过牵牛花对外数据共享平台提供的开放能力获取授权数据。完成牵牛花侧自研应用申请和接口权限开通后，在观远数据连接器中创建“牵牛花”数据账户，并在后续数据同步、任务配置或接口取数流程中使用该账户。

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

1.3 注意事项

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

1. 如果在观远数据连接器中无法选择“牵牛花”平台，请先联系观远实施或连接器管理员确认平台是否已开通。
2. 牵牛花侧接口接入通常需要先完成业务合作沟通、自研应用申请和接口权限开通。未开通对应接口权限时，数据账户即使保存成功，后续同步也可能出现无权限或无数据。
3. 涉及正式业务数据时，应使用正式环境的自研应用信息，不要混用测试环境、沙箱环境或演示账号。
4. 牵牛花侧 secret、应用信息、商家账号、公司名称等均属于敏感信息，请妥善保管，不要向无关人员披露。
5. 美团牵牛花官网和牵牛花对外数据共享平台的接入规则、权限范围、审批流程可能随平台政策调整。正式上线前应以牵牛花官方页面和商务/技术对接人的最新说明为准。

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

2.1 登录连接器平台

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

https://apiconnector.guandata.com/

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

2.2 进入数据账户管理

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

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

3. 获取授权信息

3.1 需要准备的字段

新增“牵牛花”数据账户前，需要先在牵牛花对外数据共享平台申请自研应用，并准备观远连接器表单所需的以下字段：

官方参考入口如下：

美团牵牛花官网：https://qianniuhua.meituan.com/
美团技术服务合作中心：https://developer.meituan.com/
美团技术服务合作中心文档中心：https://developer.meituan.com/docs
美团开放平台接入指南：https://open.meituan.com/docs/introduce
美团开发者问答-如何获取应用的 appid 和 appsecret：https://developer.waimai.meituan.com/home/questionDetail/12848

说明：牵牛花开放能力可能需要美团或牵牛花侧商务、运营、技术人员协助开通。若客户已由对接人提供专属开放平台地址、应用管理地址或接口文档，应优先以该专属资料为准。

3.2 获取 appid 和 secret

在牵牛花对外数据共享平台中申请自研应用。应用申请通过后，进入目标应用的信息页，查看应用的 appid 和 secret。如果客户通过美团开发者中心申请应用，可参考美团开发者问答说明：应用申请审核通过后，可前往“开发者中心--应用管理--应用列表”页面查看应用 appid，并通过短信验证码获取 appsecret。

获取 appsecret 时，点击“获取”，系统会向当前登录开发者账号绑定的手机号发送短信验证码；填写验证码并提交后，页面会展示应用的 appsecret。

字段填写时请注意：

• appid 应填写正式自研应用的应用标识，不要填写账号手机号、商家名称、门店名称或接口名称。
• secret 应填写正式自研应用密钥，不要填写测试应用密钥或过期密钥。
• 如果牵牛花侧同时提供测试应用和正式应用，应选择本次连接器数据同步所对应环境的应用。

3.3 字段范围说明

观远连接器平台元数据显示，“牵牛花”数据账户当前只需要填写 appid 和 secret，不需要额外填写授权凭证、门店标识或 customer_id。

如果后续连接器版本新增字段，应以观远后台表单为准同步更新本文档。

4. 连接“牵牛花”数据账户

4.1 新增数据账户

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

4.2 选择所属平台

所属平台选择：

牵牛花

选择后，页面会展示该平台需要填写的连接字段。

选择“牵牛花”后，页面会展示 appid 和 secret 字段。如下图所示：

4.3 填写连接信息

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

4.4 测试连接并保存

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

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

• appid 是否来自牵牛花正式自研应用。
• secret 是否填写完整，是否存在多余空格或复制错误。
• 牵牛花侧接口权限、应用状态和正式环境接入流程是否已完成。
• 观远侧平台是否已为当前客户开通，appid 和 secret 是否填写完整。

5. 后续数据使用

数据账户保存成功后，可在观远数据连接器后续的数据集同步、任务配置或接口取数流程中选择该账户，用于同步牵牛花门店、商品、订单等业务数据。

如果客户有多门店、多商家或多个业务系统，应按数据同步口径确认牵牛花侧应用权限范围。实际拆分方式以观远连接器支持能力和项目数据建模方案为准。

6. 完整流程

完整流程如下：

1. 登录观远数据连接器平台，进入“数据账户管理”。
2. 在牵牛花对外数据共享平台完成自研应用申请和接口权限开通。
3. 在牵牛花侧应用信息页获取 appid 和 secret。
4. 观远数据连接器侧新增数据账户，所属平台选择“牵牛花”。
5. 填写 appid 和 secret。
6. 点击“测试连接”，测试通过后点击“确定”保存。
7. 在后续数据同步或取数流程中使用该数据账户，并根据项目需要配置同步范围、任务周期和数据集落表。