连锁门店管理
收藏
我的收藏

概述

适用范围

适用于以自研身份接入的餐饮、综合连锁品牌，通过 API 的方式将品牌的门店信息同步到抖音生活服务平台。

价值

1、减少新店入驻耗时，降低开店成本

2、减少人工操作、提升运营效率

提供能力

门店匹配：匹配自研系统门店与抖音门店，匹配错误申诉

门店信息报错：报错商户已认领或未被任意商户认领的抖音门店

门店认领：认领抖音门店

认领申诉：如门店被其他人认领，可发起认领申诉

门店证照更新：更新商户已认领抖音门店门店证照

接入流程

门店接口需要在测试环境测试调用，如开发者在测试环境可以拿到正式应用的线上 token , 用正式应用+线上环境 token 调用。否则需要申请新应用用于测试。
切记：不要在测试环境用正式应用的 clientKey 和 secret 调获取 token 接口，会导致线上环境不可用

申请应用参考：

自研商家：自研商家接入指南

技术服务商：partner.open-douyin.com

接口对接前：技术服务商接入需要 by 商户 开白（请联系 BD 开白）

申请开放接口权限

餐饮门店管理

poi匹配/申诉

poi信息报错

门店申诉

开通按钮如果是灰色，点联系我们，注意飞书消息，加 SaaS 服务商建联群

然后回来刷新页面，如果“申请开通”按钮仍是灰色，联系@虞文静，否则直接“申请开通”，联系@虞文静审批。

配置消息回调地址

签名规则

签名规则参考查看这个地址的说明

加密字段解密

业务流程

接口清单

接口	接口类型	是否必接
提交单个门店匹配/匹配申诉任务	OPENAPI	推荐
单门店匹配、匹配结果申诉任务完成通知	WebHook	选接
查询单个门店匹配/匹配申诉任务结果	OPENAPI	推荐
提交单个门店信息报错任务	OPENAPI	推荐
单门店信息报错任务完成通知	WebHook	选接
查询单个门店报错任务结果	OPENAPI	推荐
批量认领餐饮门店	OPENAPI	推荐
门店认领任务通知	WebHook	选接
查询门店认领任务结果	OPENAPI	推荐
提交门店冒领申诉工单	OPENAPI	推荐
门店冒领申诉工单状态变更通知webhook	WebHook	选接
查询门店冒领申诉工单	OPENAPI	推荐

认领证照要求

主体资质

需提供营业执照原件扫描件或加盖公司公章的复印件，不可截屏摄屏

营业执照未注吊销，且有效期截止时间大于15天

由于新注册执照存在公示期，信息可能更新不及时，建议您自注册之日起【14个工作日】后再入驻

图片尺寸为800*800px以上，支持PNG、JPG和JPEG格式，大小不超过 5 MB

行业资质

图片支持PNG、JPG和JPEG格式，大小不超过 5 MB

法人资质

请上传法人的身份证

所提交资质若为复印件请加盖公司鲜章或本人手写签名，并且不能为截屏摄屏，不能带有无效水印

图片尺寸为800*800px以上，支持PNG、JPG和JPEG格式，大小不超过 5 MB

常见问题一览

怎么测试门店接口

对接流程

•

找业务 BD咨询是否可以接入连锁门店管理功能

◦

技术服务商开发者需要签署法务协议

◦

由抖音产运拉门店对接群及负责门店、认领的产品、研发、测试环境审批同学

•

开发者开发接口，联调对接，测试门店联系对接群运营线下审批

•

抖音技术支持安排验收，验收通过之后上线

测试流程

为防止测试期间用户在抖音APP可以看到新建的门店，匹配建店、认领等接口需要在测试环境调用，来客管理后台需要在测试环境查看门店

开放平台接口调用

请求header加
"Rpc-Persist-Life-Test-Data-Access":"all"
"x-tt-env":"ppe_prod"
"x-use-ppe":1

来客管理后台查看门店

chrome安装插件

步骤一：点击chrome浏览器的插件按钮

步骤二：点击打开应用商店

步骤三：点击搜索：ModHeader

插件填写以下数据（与调用接口header增加字段相同），访问测试门店

正式上线时，需要将saas调用，来客chrome插件增加的header参数去掉，包括
Rpc-Persist-Life-Test-Data
x-use-ppe
x-tt-env

类目如何获取

匹配接口需要POI类目type_code

认领接口需要主营类目industry_code

提供线上已有门店的门店类目及主营类目，在对接群联系抖音同学@张迪获取

其他常见问题

Q：匹配建店成功后，来客后台看到的门店营业时间与建店传入的营业时间不同

A：传入的营业时间有概率会被高德平台上的门店营业时间覆盖

验收场景

场景	前置条件	操作步骤	预期结果
匹配已存在门店	准备线上已存在的门店名称、经纬度、类目等信息	调用匹配接口，接收匹配结果通知	匹配到线上已有门店
匹配不存在门店	使用测试数据：准备测试门店名称、经纬度、类目等信息	调用匹配接口，联系抖音帮忙审核成功，接收匹配结果通知	建店送审通过
	使用测试数据：准备测试门店名称、经纬度、类目等信息	调用匹配接口，联系抖音帮忙审核失败，接收匹配结果通知	建店审核错误
提交单个门店信息报错	使用上一步新建的poi	调“提交单门店信息报错”接口修改新门店的各种信息，联系抖音帮忙审核成功，接收匹配结果通知	更新审核成功
	使用上一步新建的poi	调“提交单门店信息报错”接口修改新门店的各种信息，联系抖音帮忙审核失败，接收匹配结果通知	审核失败，门店信息不变
匹配申诉	使用测试数据：准备测试门店名称、经纬度、类目等信息	1.首次调用匹配接口，商户认为匹配错门店 2.用同样的三方门店id再次发起匹配，联系抖音审核	第二次进人审通道
批量认领门店	使用匹配接口新建的poi	调用认领接口，联系抖音帮忙审核成功，接收认领结果通知	认领成功
	使用匹配接口新建的poi	调用认领接口，联系抖音帮忙审核失败，接收认领结果通知	认领审核失败
已认领门店更新资质	使用上一步认领成功的poi	调用认领接口更新资质，联系抖音帮忙审核成功，接收资质更新结果通知，查询资质更新结果	资质更新成功
	使用上一步认领成功的poi	调用认领接口更新资质，联系抖音帮忙审核失败，接收资质更新结果通知，查询资质更新结果	资质更新失败
门店冒领申诉联系抖音提供已认领的测试poi	使用测试poi，做冒领申诉	调用冒领申诉接口，联系抖音帮忙审核成功，接收结果通知	冒领审核通过，门店变成未认领
	使用测试poi，做冒领申诉	调用冒领申诉接口，联系抖音帮忙审核失败，接收结果通知	冒领审核不过，门店仍然被其他人认领

连锁门店管理收藏我的收藏

概述