天财商龙（POS）对接指南

本文用于指导客户在观远数据连接器中创建“天财商龙（POS）”数据账户，并准备接口授权所需信息。天财商龙（POS）连接器需要填写 appid、accessid 和 centerId。这三项信息通常需要联系天财商龙业务人员、实施顾问或客户服务人员获取；请不要在工单、截图或文档中明文传播真实密钥、授权 ID 或集团号。

1. 适用范围

本指南适用于已经使用天财商龙 POS、餐饮 7 或相关餐饮经营系统，并希望通过观远数据连接器同步门店、营业、账单、菜品、会员、支付或餐饮经营分析相关数据的客户。客户可先通过天财商龙开放平台了解开放能力入口，再联系天财商龙业务人员确认本次项目可开通的数据接口范围。

天财商龙公开资料显示，其餐饮管理系统包含后台管理、前台营业、报表中心、移动设备、餐饮 O2O、CRM、供应链等业务模块；天财商龙餐饮 7 管理系统帮助中心版本记录中也出现过“API 接口增加区域、客位档案接口”“账单明细查询”等接口能力。实际可同步的数据范围以客户已购买或开通的天财商龙模块、接口权限以及观远连接器当前开放的数据表为准。

2. 申请平台对接资质

2.1 登录开放平台或授权后台

天财商龙（POS）接口授权通常需要由客户联系天财商龙客户经理、实施顾问或官方支持人员开通。申请时请说明需要将天财商龙 POS 相关数据接入观远数据分析平台，并确认本次要同步的集团、门店、环境和业务模块范围。

2.2 创建应用、授权或获取密钥

请向天财商龙业务人员申请用于接口调用的终端 id、终端授权 id 和 POS 系统餐饮集团 ID。公开资料中的脱敏示例如下，仅用于辅助识别字段名称；实际字段值以客户从天财商龙业务人员处获取的信息为准。

申请和填写时请注意：

• 三项授权信息应来自同一套天财商龙正式授权。
• 确认授权对应的集团、门店、账套或业务范围覆盖本次需要同步的数据。
• accessid 对应的授权信息属于敏感信息，只应填写到观远数据连接器的数据账户表单中。
• 不要在截图、工单、即时通讯群或未加密文档中明文展示真实授权信息。

2.3 需要保存的资质字段

如果天财商龙提供的材料中字段名称写作“终端id”“终端授权id”“餐饮集团ID”或“集团号”，请按上表映射到观远连接器的 appid、accessid、centerId，并确保三项信息来自同一套授权、同一环境和同一业务范围。

3. 创建连接器数据账户

3.1 打开数据账户创建页并选择平台

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

https://apiconnector.guandata.com/

登录后点击右上角“进入控制台”，进入“数据账户管理”，点击“新增数据账户”。在“所属平台”中选择“天财商龙（POS）”。页面会展示账户名称、appid、accessid、centerId 四个必填项。如果下拉列表中没有该平台，请联系观远实施或连接器管理员确认当前客户是否已开通该平台权限。

3.2 字段映射关系

3.3 填写、测试连接并保存

按页面字段填写账户名称、appid、accessid 和 centerId。填写完成后，先点击“测试连接”。测试通过后，点击“确定”保存数据账户。

测试连接前请确认：

• 三项授权信息均来自同一套天财商龙正式授权。
• 复制字段时没有带入多余空格、换行或中文/英文符号错误。
• 天财商龙侧接口权限已经生效，且 centerId 对应的数据范围正确。
• 观远侧选择的平台为“天财商龙（POS）”，不是其他相似平台或测试平台。

4. 常见问题