天财商龙（CRM）对接指南

1. 适用范围

本指南适用于在观远连接器中接入天财商龙（CRM）。当前连接器支持会员、会员卡、卡型、会员标签、会员行为、会员卡账户、开票记录、交易类型、交易明细、门店储值、积分兑换、门店充值、门店信息及集团优惠券等数据。

创建数据账户前，请确认已具备天财商龙 CRM 的 API 使用权限。

2. 申请平台对接资质

2.1 获取方式

天财商龙开放平台的公开接入流程为“申请入驻 → 创建应用 → 对接开发 → 发布上线”。productId 是接口调用方 ID；publicKey 是集团对应的 RSA 公钥，用于 API 数据加密/解密。两项均不是自行生成的字段，必须由天财商龙开通或提供。

1. 申请入驻。打开 天财商龙官方开放平台，按平台要求提交申请人信息、法人信息和有效期内的营业执照信息。申请主体应与待接入的 CRM 集团一致。
2. 创建应用。入驻审核通过后，在开放平台创建应用，并将 CRM 所需 API 按业务组合加入应用。申请时注明需要接入会员、会员卡、交易明细、门店和优惠券等数据。
3. 确认 CRM 集团与权限范围。如已有企业后台账号，登录 天财商龙智慧餐厅商户后台 核对所属企业环境；如后台未显示相关入口，联系当前 CRM 集团的管理员或实施人员处理，不要尝试使用其他集团的凭证。
4. 申请凭证交付。在应用审核或对接支持环节，向天财商龙明确索取当前 CRM 集团的 productId（接口调用方 ID）和 publicKey（该集团的 RSA 公钥），并确认已开通生产环境的服务器端 CRM API 权限。服务器端 API 的适用范围和生产环境说明见 天财商龙 CRM 服务端 API 说明。
5. 核对凭证用途。productId 用于标识接口调用方；publicKey 用于 API 数据加密/解密，不是密码，也不应自行生成或替换。可查看 天财商龙 RSA 加密解密说明 核对公钥用途。
6. 对接开发与发布。使用已交付的凭证完成测试连接；验证所需数据接口后，再按开放平台流程发布上线。转入第 3 节，在观远连接器填写两项原始值并测试连接；不要在工单、聊天记录或截图中发送完整凭证。

上图为观远连接器的数据账户表单；点击可回到官方开放平台。开放平台的“申请入驻”页面及“创建应用”页面受登录与企业权限控制，公开访问无法取得可用于客户操作的真实页面截图，因此本文仅使用真实的连接器表单截图，并在每个外部操作点提供官方超链接。

2.2 需要保存的资质字段

请勿在聊天记录、工单描述或截图中暴露完整凭证。开放平台的具体凭证页面需要登录并由企业管理员授权，请以开通后的实际页面为准。

3. 创建连接器数据账户

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

在观远连接器中进入“数据账户管理”，选择“新增数据账户”，平台选择“天财商龙（CRM）”。

选择“天财商龙（CRM）”后，依次填写账户名称、productId 和 publicKey。截图中仅展示空表单，不包含真实凭证。

需要申请或核对凭证时，可点击上图直接进入天财商龙官方开放平台，避免误入非官方页面。

3.2 字段映射关系

3.3 测试连接并保存

1. 按上表填写 productId 和 publicKey。
2. 点击“测试连接”。
3. 测试成功后保存数据账户；如失败，请先核对凭证是否完整、是否已开通 CRM API 权限。

4. 常见问题