抖音开放平台Logo
开发者文档
控制台

门店关联及匹配能力

收藏
我的收藏

业务场景

商家或服务商通过做两方门店关联与映射,并在核销时回传抖音门店 id(Poi_id),这样抖音知道这笔核销来自于哪个门店就可以做分账。

接入前期准备

根据以下文档完成开发者账号开通认证、生活服务应用的创建、申请解决方案和接口权限。

技术服务商:技术服务商接入指南

自研:自研商家接入指南

方式一:在商家侧做门店映射

需要申请的能力

门店管理

业务流程

1、查询抖音侧认领门店信息

    • 路径一:直接通过门店查询接口获取商家已认领的抖音 POI信息。
    • 路径二:PC 端商家后台-店铺管理-门店管理-导出数据,下载下来都是商家当前已经认领的 POI 信息。

2、服务商/商家自行和自己系统中的通过查询到的门店 ID 做映射并在服务商/商家系统储存映射关系。

3、如果需要进行分门店结算的,在核销时必须在传入正确的核销 poi_id,否则会报错。

对接接口

接口

接口路径

调用方

门店信息查询

https://open.douyin.com/goodlife/v1/shop/poi/query/

商家/服务商

方式二:在抖音侧做门店映射

需要申请的能力

门店匹配、门店任务查询

业务流程

1、通过门店匹配接口提交抖音侧匹配任务,等待匹配完成。

2、查询门店匹配结果,获得商家侧门店和抖音侧 poi 映射关系,并在服务商/商家系统储存映射关系。

3、核销时候根据映射关系传入抖音侧 poi_id。

对接接口

接口

接口路径

调用方

门店提交匹配任务

https://open.douyin.com/goodlife/v1/poi/match/task/submit/

商家

查询门店匹配结果

https://open.douyin.com/goodlife/v1/poi/match/task/query/

商家

查询匹配关系

https://open.douyin.com/goodlife/v1/poi/match/relation/query/

商家

该文档是否有帮助?