常见问题汇总【必看】

Q:支持哪些行业？

接口支持 到店综合（服务零售）、到店餐饮 类的门店均可接入使用

覆盖范围：洗车、棋牌、台球、KTV、酒吧、自习室、舞蹈室、健身房、宠物（洗宠机、宠物超市等等）、自助打印机设备、扫码器设备等、奶茶店、烘焙行业（面包店）、服务零售行业（超市、租赁业务等）、美业（美甲、美发、美容）、密室、攀岩馆、洗浴（按摩、足疗等）服务行业、餐饮门店等等。

🚩若以上没有您的业务范围可 【点我添加商务企业微信】

Q:opPoiId 是什么？

opPoiId 是云飞 API 侧的门店ID （唯一标识） ，一旦生成就永久不变。

Q：和抖音门店（dyShopId）是什么关系？

一对一绑定关系：

✅ 同一个 dyShopId 第二次传进来 → 直接返回已有 opPoiId，不会重复建店

🆕 全新的 dyShopId → 自动生成新的 opPoiId

简单说：一个抖音门店，永远只会对应一个 opPoiId

Q：和美团门店（mtShopId）是什么关系？

一对一绑定关系：

✅ 同一个 mtShopId 第二次传进来 → 直接返回已有 opPoiId，不会重复建店

🆕 全新的 mtShopId → 自动生成新的 opPoiId

简单说：一个美团门店，永远只会对应一个 opPoiId

Q：商家同时有美团店和抖音店，怎么合并成一家店？

支持多平台共用同一个 opPoiId，无先后创建顺序，先创建谁都可以，下面以先创建美团门店后创建抖音门店为例：

先调用接口创建「美团门店」，拿到 opPoiId（云飞侧生成）

再创建「抖音门店」时，把这个 opPoiId 作为参数回传

系统会自动把两家平台的门店关联到同一个 opPoiId 下

✅ 效果：你在云飞侧看到的是「一家店」，只是挂了美团 + 抖音两个渠道。

Q：商家的一个实体门店在多个平台都有入驻，接口调用示意图

Q:如何自动区分美团券和抖音券

美团、大众点评的券码是 <=13 位长度 （注：因服务零售方向美团交易券码发券量逐年增长，现有的十位券码号即将使用耗尽，自2025年7月起，券码位数逐步由原来的10位升级到13位，9月30日之后正式升级为13位券码，为避免对您的业务造成影响，请根据自身系统情况，确认本次位数升级是否产生影响，如影响请在2025年6月30日前自行按期完成改造。如有问题请提交工单或联系您的对接运营，感谢您的支持和配合。）

抖音分两种情况：1、券码扫码识别出来的是 https 的短链接；2、复制的券码是 15 位长度

Q:接口支持抖音识别出的短链核销

接口支持抖音短链核销，短链传如 receiptCode 字段

注意：短链不能是全小写的，请保持原始短链传入我们接口

Q:美团门店扫授权码后提示失败

检查提交的门店管理员账号是不是正确的，若不正确重新提交查看绑定美团门店所需基础资料

确认是否修改过管理员账号的账密，修改账密（账号名或密码）后会导致已授权的门店全部失效，若修改过账号名请主动联系我方技术进行同步

Q:美团验券提示当前授权账号验券权限不足

检查提交的门店管理员账号是不是正确的，若不正确重新提交查看绑定美团门店所需基础资料或去来客核销小程序变更绑定门店的管理员账号

Q:美团门店配置修改

修改配置账号后需要重新授权！

修改配置账号后需要重新授权！
变更门店配置.png

Q:查看业务类型和门店管理账号

业务类型对应云飞API侧的应用类型，若是服务零售商家版则统一对应到店综合，显示餐饮字样的则统一对应到店餐饮
美团经营宝查看业务类型.png

Q:查券和验券接口 verifyCount 字段如何传值

查券和验券接口传值： type=1 时表示你查券，此时不会执行验券逻辑，入参可以不传 verifyCount，此时接口返回的 verifyCount 表示你有几张券可以验证。

查券和验券接口传值： type=2 时表示你确定要验券，此时会执行验券逻辑，入参传的 verifyCount 表示你要验几张券，这个时候你可以自己传数量，如果你没传默认就是将查券返回的数据量自动填上提交给美团接口完成核销

Q:该门店不属于团单适用门店，当前门店不可验券，请切换至团单最新适用门店验券

此提示并非异常，属于美团系统正常规则校验返回

接口返回的这个提示表示这个团购无法在当前门店核销，检查美团经营宝里这个团购商品设置的适用门店里有没有你传入接口的这个门店

开发者或商家可自行使用美团经营宝选择该门店进行验券验证是否也是返回类似提示，如是请检查团购设置门店使用规则，如不是请检查传入的opPoiId是否正确

除了检查团购的适用门店还要检查团购券码传入的是否准确，美团的券码通常是13位的数字券码

在美团经营宝PC端查看团购适用门店，如下图所示：
企业微信截图_df1b33e1-7b78-4a06-9a55-c4ecd22b8763.png

Q:一个应用(appId)是否支持绑定多个门店

支持，一个应用(appId)下可以绑定多个门店，前提若应用(appId)是到店综合则只能绑定到店综合类门店，应用(appId)是到店餐饮的则只能绑定餐饮类门店

注意：应用有类型（到店综合、到店餐饮）区分，不可混淆绑定门店

Q:查看应用余额

微信搜索 来客核销 进入小程序查看余额，若看不到可联系商务进行绑定

注意：不同应用间额度互不共享
查看应用余额.png

Q:如何配置Maven拉取

你可以点我查看settings.xml配置，或者按照以下指南自行配置。

步骤一：设置仓库凭证

请在 settings.xml 文件<servers></servers>中设置以下仓库的访问凭证，通常settings.xml在$HOME/.m2/文件目录下。

<servers>
  <server>
    <id>tuangou-java</id>
    <username>6775f438d497cd558d6307ba</username>
    <password>7x9I6tkB]mKv</password>
  </server>
</servers>

步骤二：配置仓库和包信息

在settings.xml文件<repositories></repositories>节点中加入对应的仓库使用地址。

<repositories>
  <repository>
    <id>tuangou-java</id>
    <url>https://packages.aliyun.com/692c1367ccf3499544d9cf5a/maven/tuangou-java</url>
    <releases>
      <enabled>true</enabled>
    </releases>
    <snapshots>
      <enabled>true</enabled>
    </snapshots>
  </repository>
</repositories>

在你项目的pom.xml文件<denpendencies></denpendencies>节点中加入你要引用的文件信息。

<dependency>
    <groupId>com.yunfeiwork</groupId>
    <artifactId>tuangou-java-partner</artifactId>
    <version>1.0.B</version>
</dependency>

步骤三：拉取

运行以下命令完成jar拉取。

mvn install

Q:支持哪些行业？#

Q:opPoiId 是什么？#

Q：和抖音门店（dyShopId）是什么关系？#

Q：和美团门店（mtShopId）是什么关系？#

Q：商家同时有美团店和抖音店，怎么合并成一家店？#

Q：商家的一个实体门店在多个平台都有入驻，接口调用示意图#

Q:如何自动区分美团券和抖音券#

Q:接口支持抖音识别出的短链核销#

Q:美团门店扫授权码后提示失败#

Q:美团验券提示当前授权账号验券权限不足#

Q:美团门店配置修改#

Q:查看业务类型和门店管理账号#

Q:查券和验券接口 verifyCount 字段如何传值#

Q:该门店不属于团单适用门店，当前门店不可验券，请切换至团单最新适用门店验券#

Q:一个应用(appId)是否支持绑定多个门店#

Q:查看应用余额#

Q:如何配置Maven拉取#