【到家行业】抖音小程序解决方案
收藏本 SOP 旨在帮助在「抖音生活服务」经营的商家，入驻「开放平台」并开发自营的「小程序」。
- •抖音生活服务，是一个为用户提供真实、优质、丰富的信息，创造美好生活的平台。
- •为了更好地助力抖音生活服务商家的经营，抖音开放平台通过开放抖音本地的经营能力，帮助有开发能力的商家在保留抖音生活服务核心能力的同时，通过双方的商品、订单等信息的打通 + 小程序差异化能力来进一步表达和体现商家的经营能力，帮助商家在 抖音生态下更高效的经营。
一、整体流程概览
从开发者接入到自营商家小程序上线经营流程一般经过三个流程：
- •开发者账号跟生活服务账号关联；
- •开通小程序并对接生活服务基础产品能力；
- •小程序经营能力开发和发布；
二、入驻所需材料速览
序号 | 事项 | 所需材料 |
1 | 注册账号 | 以下账号类型二选一，确保账号可以接收验证码即可。
|
2 | 主体认证 | 以下材料任意一项：
|
3 | 对公认证 | 以下方式任选一种：
|
三、接入能力概览
能力 | 描述 | 能力介绍文档 | 是否必要 |
商品接入 | 通过开发者系统创建/修改/删除各类商品信息。 | 必要 | |
交易能力 | 通过系统接入实现交易正向、逆向流程(包含下单、核销、退款等)及订单信息的同步。 到店综合预约场景暂不支持接入退款组件，退款原因及展示顺序都必须按照文档执行 退款原因枚举值 | 行业交易系统接入指南 | 必要 |
小程序主体资质展示 | 小程序内需具备主体资质展示才可正常上线；需展示与小程序公司主体名称一致的公司营业执照。 | 必要 | |
客服组件 | 两种客服任选一种：
| 必要 | |
直播组件 | 仅可用小房子直播组件。 | 支持提单页 URL 从小房子点击进入后提单（商品库 trade_url 字段） 【指引】直播组件-小房子内带小程序商品 配置操作手册： 【操作手册】直播组件-小房子内带小程序商品 | 必要 |
小程序ICP备案 | |
| 必要 |
其他能力 | 可根据实际业务场景，选择性对接该文档中提供的各种能力，用于满足开发者多种经营流程及营销诉求。如获取用户定位能力、发送订阅消息能力、发起群聊能力等 | 可选 |
四、各流程详细描述
4.1来客账号及角色认证
4.1.1注册账号及角色认证
- •注册抖音来客
- •认领门店，详细流程参照【入驻指南】到家商家入驻及一城一店模式说明
- ◦上门服务行业为特殊经营类目，抖音生活服务为此类目商户更新入驻&poi准备动作
- ◦创建服务城市&门店（店铺管理——城市店铺——添加城市）
- ◦手动添加城市——设置完成后自动生成对应城市的POI
- ◦必须认领至少1个POI后，还可以进行后续的账号绑定动作
4.2开平账号及身份认证
账号注册及身份认证流程可参考：小程序生活服务自营商家接入指南
- •首先需要完成抖音开放平台开发者平台注册，示意如下：
- ◦帐号注册：
- ◦主体认证：
- ▪身份认证
- ▪基础信息
- ◦提审等待结果
- ◦对公认证
- •创建小程序
- ◦小程序是后续开发和经营的主要场所，商家入驻成功后，就可以创建小程序，具体步骤参见创建小程序
- ◦上门服务行业准入：因为上门服务行业为定向准入类目，需要开发者自行联系自己对接的抖音bd同学，由内部同学填写oa：家政准入oa
- ◦类目选择：小程序服务类目选择需覆盖【生活服务- 生活服务-家政】，类目开通白名单后灰色部分会点亮。
4.3双平台账号绑定
需要对 「抖音来客商家」 和 「开放平台开发者」 进行双方身份的绑定，即完成抖音来客商家入驻开放平台的动作，亦或开发者绑定某个抖音来客商家。
注意：绑定前需要确认双方主体一致即社会信用代码一致。
4.3.1从开放平台绑定抖音来客账号
- •在开放平台后台绑定抖音来客帐号，示意如下：
- ◦进入抖音开放平台-控制台-账号信息
- ◦选择生活服务商家角色，去认证，然后绑定已注册的抖音来客账号
4.3.2从抖音来客绑定开平账号
- •在抖音来客绑定开平帐号，示意如下：
- ◦抖音来客-店铺管理-服务应用授权-商家自研服务-绑定开发者，录入开平账号，完成绑定
4.3.3在小程序完成账号角色绑定
进入小程序-基础设置，选择「生活服务商家」角色进行绑定
4.4对接生活服务基础产品能力
4.4.1行业模板接入
4.4.2商户绑定收款账户
在「抖音来客」进行收款账户的绑定，进行核销款项的提现，
4.4.3获取token（接口调用前置条件）
后续 接口调用需要使用access_token，参考接口：获取access_token。对于小程序应用，接口请求参数中的client_key和client_secret传递小程序的appid和app_secret即可。具体位置：抖音开放平台>控制台（右上角）>小程序>开发>开发设置>小程序key。
4.4.4POI使用关系建立
- •在地理信息系统中，一个POI(Point of Interest,兴趣点）可以是一栋房子、一个商铺、一个邮筒、一
个公交站等，在抖音生活服务业务中,POI是商家经营生活服务业务的重要场景。
- •认领其他POI
- •提交资质后进行审核，完成认领动作
- •批量认领POI
- ◦批量认领路径可通过检索选择（如下图流程）或“批量认领”进行；
- •获取认领的POI列表
通过抖音来客获取认领的POI列表，为后续商品入库做准备
- •POI货架展示屏蔽申请
在创建商品后，商品可以展示在POI的货架上。为保障用户体验，当前开通 POI 货架能力需要特殊审批，请提交问卷申请，预计 1~3 个工作日完成审核。申请分为下面 2 种场景：
开发过程申请：开发过程中，需要先申请小程序 POI 能力，且为保障其他用户不被分发，只允许部分测试用户可见。填写问卷POI货架展示屏蔽申请。填好后提交并@群里运营人员（@陈雅婷 ）时间要求：工作日（周一至周五）的 48h 内会完成权限审批开通，请届时自验证能力情况。
正式放量申请：放量申请需要在验收通过后才能申请，参考本指南【3.2.12验收】部分
4.4.5商品入库
需在生活服务经营小程序则需要根据对应标准上传商品信息，具体步骤如下：
- 1.调用下方接口将商品信息并根据商品类目录入到生活服务商家的商品库中
- a.【Saas生活服务开平商品接口文档 】
- b.【商品类目索引】
- 2.将开发好的小程序「商品详情页」送审；
- a.送审前可通过测试商品来完成商品详情页的开发；
- 3.审核成功（一般2~3个小时完成审核）则完成入库动作；
- •到店综合行业可以选择的商品类型为：团购、代金券、次卡、预约商品
能力\商品类型 | 团购/代金券 | 次卡 | 预约商品 |
指定金额退款 | ❌ | ❌ | ✅ |
1个spu下多sku入库 | ❌ | ❌ | ✅ |
即时预约 | ❌ | ❌ | ✅ |
先买后约 | ❌ | ❌ | ✅ |
多次加价 | ❌ | ❌ | ✅ |
多sku下单 | ❌ | ❌ | ✅ |
- •创建多sku商品步骤：
- ◦step1 调用“1.2.1 创建/更新商品接口”创建product
- ◦step1 调用“1.2.3 创建/更新多SKU商品”创建多sku
- •测试商品创建详细操作步骤如下：
- ◦在创建/更新商品接口中，通过如下参数定义测试商品
参数名称 | 参数类型 | 参数描述 |
-- test_extra | struct | 测试商品信息 |
--- uids | list<string> | |
--- test_flag | bool | 标记商品是否为测试商品，当test_flag=true时， 1、uids数量需要大于02、库存数不能大于50 若要取消测试标记：须指定flag=false 2、必传life_account_id |
- ▪如设置为测试商品，则：
- •可以在小程序发布前调用该接口创建商品(小程序发布后也可以调用)
- •仅指定的UID可见，不会造成消费者误下单，选择开发者及测试人员的账号添加至可见的UID列表。UID定义及获取方式参见：UID获取方式
- •测试商品创建后仍需要审核，审核时长约为2-4h
- •创建测试商品后，可以回归测试小程序的商品详情页
- •如使用货补能力，则不不能将商品设置为测试商品
4.4.6交易系统接入
- •参考文档：行业交易系统接入指南（交易系统中涉及三方码场景，需要单独在抖音开放平台-行业模板中进行权限申请才可使用）
- •开发者在抖音开放平台-控制台中配置测试环境和正式环境的回调及通知地址，配置方式详交易系统使用指南
- •在步骤3.2.6 创建测试商品后，调用新增测试物料接口，可以将测试商品配置为测试物料，如识别为是测试物料，则交易相关的回调及通知地址，就会指向行业模板中开发者配置的测试环境。如果不调用新增测试物料接口，即便是测试商品，回调及通知地址也会指向正式环境。开发者可以根据自身测试需求进行配置，详见下表：
是否测试商品 | 是否测试物料 | 回调&通知指向 |
是 | 是 | 测试环境 |
否 | 是 | 不支持非测试商品设置为测试物料 |
是 | 否 | 正式环境 |
否 | 否 | 正式环境 |
4.4.6.1 业务场景描述
业务场景 | 描述 | 流程图 | 示意图 |
即时预约 | 用户在提交订单时就确认预约信息的一种下单模式 如预约保洁服务时，可以在下单时选择需要上门的地址、日期、时间 | 暂时无法在飞书文档外展示此内容 | |
先买后约 | 用户在下单后，才预约的一种下单模式 如在到家的家政/丽人等服务时，先购买服务，在完成购买后再进行预约 | 暂时无法在飞书文档外展示此内容 | |
服务加项 | 到家/到店服务过程中，订单交易完成前，应用户或商家需要而发起的一笔额外的支付。 | 暂时无法在飞书文档外展示此内容 |
4.4.6.2 交易系统字段参考
文档参考【融合预约品】交易环节技术指南
模块 | 子模块 | 注意重点 | 备注 |
即时预约（预约即下单） | 预下单 |
| "tradeOption": "{ "life_trade_flag":"1", "trade_mode":"3" }" life_trade_flag=1必加 |
预下单扩展 |
| | |
返回预约信息 | 接口可参考预约接单结果回调 | | |
先买后约 （在支付后再选择预约时间） | 预下单 |
| |
预下单扩展 |
| | |
预约 | 创建预约单（含服务加价） | 接口可参考创建预约单 | |
预约接单结果回调 | 接口可参考预约接单结果回调 | | |
支付 | 支付方式 | 支付宝/抖音支付
| |
| 核销状态同步（OpenAPI） |
| |
服务确认 | 应用场景：当订单 核销完成后，开放平台会在核销1小时后自动进行服务确认。开发者也可手动调用接口完成服务确认。服务确认后，订单才能进行后续分账操作。 接口请参考服务确认 | | |
退款&售后 | 核销前退款 |
| |
核销后退款 |
| ||
撤销核销 (仅支持酒旅行业） |
| ||
过期自动退 |
| ||
退款算价 | 基本信息 HTTP Method：POST 请求参数： 响应参数： | | |
发起退款 | 接口请参考发起 退款，在以上接口文档的基础上，字段变化如下：
| | |
退款查询 | 接口请参考退款查询 本次变化：补充item单退款金额，对应营销分摊信息字段。
| | |
发起退款扩展点 | 接口请参考发起退款扩展点 本次变化： | | |
结算 | 结算方式 |
| |
提现 | 提现方式 |
| |
查看提现 |
| | |
营销 | 营销方式 |
| |
账单 | 账单查看方式 |
| |
4.4.6.3 履约状态机
标准预约商品履约状态机：查询预约单信息__抖音开放平台
洗涤护理预约商品履约状态机：洗护服务状态更新
4.4.7其他必接能力
4.4.8部署和提审小程序
- 1.完成开发者测试环境的完整的测试流程后，就可以发布小程序，进行提审，从而进行生产环境的灰度测试了。审核规范参考：
- 2.由于在验收环节，必须有真实商品（1-2个即可，商品价格可以是非真实价格）才可以审核通过，因此该环节需要使用真实的商品进行审核，即在创建商品时，接口中不能标识为测试商品。
4.4.9回归测试
- 1.在【4.4.4 POI货架展示屏蔽申请】中申请问卷通过后，开发者可以基于自身的正式环境进行回归测试
- 2.此时可以测试POI中商品的展示（仅针对申请的UID可见）、直播&短视频的挂载功能以及完整的交易流程
4.4.10小程序验收
小程序验收指的是对必要能力的验收，当确定核心功能都已正确实现，可以申请小程序验收
- 1.验收前请先进行自查：本地生服类小程序能力要求与POI验收标准
- 2.更新日志中添加“商家第一次提审，可接受测试商品”，方便审核同学识别。
- 3.验收需填问卷：POI货架全量展示验收
- 4.群内告知@陈雅婷 需要进行验收
- 5.验收预计1-3个工作日，请耐心等待，合理安排时间
- 6.验收发现的问题会在对应群内进行反馈，修改提交版本审核后需要二次验收；
4.4.11POI同步测试能力包关闭
- 1.在验收通过后，就可以申请POI货架全量展示验收的能力，关闭后小程序上传的所有商品信息所有UID都可见了
- 2.如果在此前测试过程中创建的商品价格等信息有误，验收完成后，请及时修正或下架，防止用户误下单。
4.5对接生活服务营销
营销能力配置文档：融合小程序营销能力对接指引
营销能力接口文档：营销信息查询接口
