本文档是K米SaaS智助通后台的配置教程，可协助后台管理员快速了解操作流程。

智助通后台：z.ktvme.com

开通SaaS环境，请提供以下资料：

• 商家编码（需清空线上数据，预订切简化版，因此建议用新的商家编码）
• 品牌名称（需要在智慧平台创建对应品牌名称）
• 管理员手机号（用于登录智助通后台和小程序）

演示环境开通说明：默认绑在K米测试品牌，C端预订小程序为【KM自由舱】，点单为【来K歌】。

自助K设备方案选择可参考下图：

一、K米支付签约

1、支付进件

在智助通后台操作支付进件，与常规KTV的支付进件流程一致。

注意：如果使用商家主体小程序，或从KM自由舱切换到商家主体小程序，都需要补充小程序支付的材料：提供商家小程序appid和商家编码，发邮件给K米商务 kmsw@star-net.cn 申请开通/切换。

KM自由舱appid：wx95a20673dbc7390e
商家小程序appid可在小程序后台查询，或绑到智助通后台后，也可以看到
如果没有切到正确的appid，小程序支付时会报错！

2、实名认证

确保微信和支付宝都完成实名认证，以方便后续C端预订功能测试。

二、包厢信息配置

配置顺序：先添加智控设备，然后创建包厢信息时 关联智控。

测试注意事项：包厢设备接智控，通断电由智控场景设置决定。以视易智控为例，测试产品功能前，请确保物联网和智助通的后台配置完整、智控设备联网、智控场景都已设置好。

1、控制器全局设置

方案一：【视易联网智控】

注意事项：此处需要填写7位智控客户号（查询路径：视易物联网云平台-增值-智控中心-客户列表-客户编号）。需要在【智控场景配置工具】完成场景配置，参考文档https://docs.qq.com/doc/DQW1paXFLY3JhV3BP 的【智控房态】板块。若还有其他疑问可以咨询视易技术。

方案二：【铂锐AI pro】

注意事项：

因此推荐配置如下，也可以根据现场情况做一定的调整。
例如智助通后台的“清洁”房态，传参可配置“清洁 FDD1091DCE”或者“清洁关 FDD13F1DCE”

方案三：【科星网络控制器】

科星网络控制器的配置教程，详见https://open-doc.ktvme.com/read/zzk/cx-pzjc

方案四：【和辰智控】

方案五：【立新求索智控】

场景21-25在立新AI灯控软件进行配置，可配置每路继电器的通断。智助通的控制器全局设置，建议直接按下图填写：

2、添加智控设备

如下图，添加智控设备。此处需要填写：

• 设备名称：建议填包厢号，方便后续创建包厢信息时做关联；
• 设备类型：选择智控；
• 设备渠道：视易/海媚/铂锐/科星/和辰/立新求索，根据实际情况填写；
• 传参内容SN：视易F开头13位、海媚D开头12位、铂锐16位、科星12位、和辰13位、立新求索12位；
• 联机码：目前仅铂锐要填，设备上能查到，8位数；
• IP：智控设备IP；

3、填写包厢信息

根据门店实际情况，设置区域和包厢类型，然后新增包厢信息。

如下图，填写包厢基础信息，关联智控设备。此处包厢IP和MAC地址是填机顶盒的。

• 包厢/包厢类型在C端、B端小程序的展示顺序，可修改“排序”进行调整；
• 排序的数值越大，该包厢/包厢类型的展示越靠前；
• 如果看不到排序，可能是屏幕分辨率的问题，可以缩放页面或者点击左上角的按钮，隐藏一级菜单；

4、预订排房设置

此页面主要是预订排房相关的设置，分为下图框起来的4个区域讲解。

• ①三个时间段区别：

营业日起止时间：智助通小程序-营业报表，根据这个时间范围统计每日业绩，可以在【基础设置】页面修改；
自助适用时间段：预订小程序-商家列表，商家的营业时间按此处配置展示；
预订适用时间段：授权开通美团预订直连的情况下，根据此处配置限制美团侧的可预订时间段。

• ②一周库存说明

库存需要设置一周7天，下一周延续本周配置；
如果要在预订小程序隐藏某个包厢，需要依次点击一周7天，分别关闭下面对应包厢的【自助排房开关】。

• ③两个美团预订参数

预订排房设置+完善房型信息，根据页面提示进行配置即可；
此处参数对应的是美团直连预订的功能，与小程序预订无关。

• ④两个包厢排房开关

自助排房开关：一般只用于隐藏包厢，需要设置一周7天都关闭；只设置一天不生效；
第三方预订开关：只设置一天也生效，开了美团能直接预订，关了就不行。

三、小程序部署

1、小程序授权

确保商家主体的小程序已完成认证和备案，然后绑定到智助通平台。

在下图所示路径，点击新增小程序，小程序管理员扫码授权即可。

绑定后点击【发布为自助K小程序】。微信可能会响应超时，一般要点击两次发布，然后小程序发布状态变为”审核中“，等审核通过即可使用。工作日的审核时间一般在1小时左右。

2、小程序装修

注意：使用商家主体小程序支持装修，挂KM自由舱使用 则不支持小程序装修。

小程序首页默认为单店形式，连锁商家可配置为“门店列表。”

• 门店首页：适合单店，进入小程序就能看见预订和开门的操作入口。
• 门店列表：适合连锁，进入小程序可以看到各门店信息。可选择浅色/深色模板。

如果要调整小程序的色系，可在“全局设置”进行配置，如下图：

如果不想配置各模块配色，目前有以下4种预设模板可选用，2、3、4用于连锁店。

• 1和2的模板类型，可在后台直接配置发布；
• 3和4的模板类型，无法在后台直接配置，需要联系K米交付负责人配置。

3、小程序弹窗

背景：部分场所需要弹窗展示“未成年人禁入”、“消防安全警示”等合规告示图片。

在小程序装修页面，可根据指引配置符合条件的图片，并设置跳转页面，配置完成后保存发布。客人在首次进入小程序时，即可看到弹窗公告图片。

4、包厢轮播图

素材要求：最佳尺寸为1200*800、图片不超过2M、视频不超过50M

包厢标签：支持自定义设置标签文案

轮播模式：3秒自动轮播 或 手动切换（左右滑动）

效果图如下：

5、首页轮播图

素材要求：图片不超过2M、视频不超过50M

轮播模式：3秒自动轮播 或 手动切换（左右滑动）

顶部轮播图尺寸：最佳尺寸为750*675（占据首页40%，建议放环境图、活动海报）

底部轮播图尺寸：最佳尺寸为710*248（横向长条形，可以放品牌LOGO相关的图片）

效果图如下：

四、预订活动配置

1、小程序预订活动创建

如下图所示，点击“创建活动”：

根据实际情况填写活动内容。具体可参考下图的文字说明。

注意：此处需注意“渠道来源”。
如果仅小程序可用，则勾选小程序；如果抖音和美团也上了这个预订套餐，则需要全部勾选，方便下一步团购和小程序活动做关联。

【酒水套餐】

预订活动可以添加酒水套餐进行备选，需先开通点单功能才能正常出单（详见文档第九部分）。主要配置以下内容：

• ①预订时，酒水套餐是否必选；
• ②续费时，酒水套餐是否必选；
• ③添加酒水套餐；
• ④套餐基础信息，包括图片、名称、售价、是否主推；

【特殊日价格】

点击“特殊日价格管理”，新增特殊日。

将“特殊日价格”设置为周六/周日价格，则特殊日期间都按周末的价格预订。

【设置排序规则】

门店预订活动，可按照金额或时长的高低进行排序。

2、抖音&美团授权

在下图所示路径，点击“去授权”登录抖音来客/美团，并授权门店信息，完成后会显示“已授权”。

如果要开启美团预订直连，则需要在美团授权时，确保勾选“预订”功能。授权成功后，对应页面显示如下。美团预订直连相关的参数配置，详见本手册【二-4 预订排房设置】。

3、团购活动关联小程序预订活动

团购授权完成后，后台会实时同步抖音和美团的预订套餐。
点击“活动配置”，将这些套餐和小程序预订活动做关联，并保存即可。
注意：如果发现活动选不到，可以看下这个活动是否已经勾选了抖音、美团的渠道。

4、折扣活动（非必选）

支持按需配置折扣活动。

功能效果：配置后，在适用门店的活动有效期内，客人预订可以享受对应折扣。

5、小时模式（非必选）

小时模式分为“自助计价”和“固定计价”。具体计费规则如下：

自助计价：根据每分钟归属的时段价格进行计算；
固定模式：将时间按小时切割，按每小时的开始时间归属的时段价格进行计算；

举例说明：
门店后台设置时段价格为12:00~15:00 30元/小时，15:00~18:00 36元/小时
换算成每分钟的价格为12:00~15:00 0.5元/分钟，15:00~18:00 0.6元/分钟
客人预订时段为14:30~17:30，共计3小时

价格计算如下：
若为自助计价，则价格=0.5×30+0.6×150=105元
若为固定计价，则价格=30+36+36=102元

设置好周一的价格后，可以直接复制方案到其他日期，然后对周末价格再做微调。
启用小时模式，不影响预订活动套餐的正常售卖，即二者可同时存在，供门店客人选择。

五、预订参数设置

注意：以下参数与客户消费体验密切相关，需根据门店经营实际情况配置验收。

1、商家信息

此处可设置商家电话、地址、营业时间等信息。以下是详细说明：

• 门店状态：常规情况下是“营业中”，特殊情况下可设置“暂停营业”。连锁商家未开业的新门店，可以设置状态为“筹备中”，在小程序列表模式下可展示（无法预订），起到前期宣传作用。
• 不可预订时间段不展示：勾选后，在选择预订套餐时，选不到不可预订的时间，直接不展示。
• 门店logo：对应小程序首页的圆形小logo；
• 门店引导图：配置后小程序首页增加显示【到店指引】，方便客人找到门店；
• 切换门店页的图片：如果是连锁店需要在“切换门店”的页面修改展示的图片，目前需要到K米智慧平台-品牌门店-编辑-上传门店照片，默认展示第一张。

2、退款时限

可设置顾客自助退款的时效。例如，设置预订时间前20分钟可退款，如果只剩15分钟，客人就不能自己操作退款了。

注意：该参数只限制客人C端自助退款的操作，商家可随时在平台或智助通小程序退款。

针对超时/已核销的订单，平台的退款操作路径如下：

3、续费提醒

可设置电视端续费提醒的提前时间、持续时间、二次提醒间隔时间。

电视端提醒的效果图如下。二维码默认在中间，魔云11以下版本可以联系产品负责人调整到左上角。

续费二维码的推送与“送祝福”业务类似，因此需要确保网关和机顶盒通讯正常。

4、保洁状态

可设置包厢关房后是否自动开启保洁状态，以及保洁状态的持续时间。

注意：保洁状态持续时间内，客人无法在C端订房，建议按需设置。

5、小程序按钮

可设置C端小程序首页是否展示“开门”和“续单”按钮。

功能说明：客人点击按钮，可对已预约订单进行“立即开房”，已核销订单进行“续单”。

6、预订设置

客人在C端小程序预订时，与时间限制相关的参数，具体说明如下：

• 预订时间展示模式：支持时间切片模式/精确时间模式，区别如下图；
• 提前开房限制：可以设置较长时间，可防止开错订单；
• 起订时间设置：例如限制客户1小时起订；

六、员工账号分配

1、员工权限配置

首先确认门店哪些员工需要使用B端智助通小程序，进行预订开房、业绩查询等操作，例如老板、股东、店长、财务、保洁等。

针对某个权限，可分配管理后台和小程序的菜单权限。以财务权限为例，在管理后台和小程序都授予财务相关权限，即可满足使用需求。

2、员工账号添加

添加门店员工账号，并分配对应的权限。

七、短信管理

客人预订短信提醒，需要充值短信+启用模板+配置文案。一般至少启用“预订排房提醒”和“预订取消提醒”，其他的按需启用。如下图所示：

八、会员等级

与K米智慧平台的会员功能差不多，存在部分区别：

0元办卡，自助K场景不付费购卡；
支持配置充值方案，小程序最多可显示三个“定额充值”+“自定义金额充值”方案；
门店只有一个会员等级，支持配置连锁会员等级；
会员信息是“纯线上”的，因此支持在智助通后台直接修改，也可以添加标签和备注；

九、点单管理

以“添加一家合作的烧烤店”为例，讲解自助K添加联盟商家的流程。

说明：自助K的点单功能需申请开通（可联系K米严晓红处理）。

【腾讯文档】自助K外卖餐饮联盟业务接入流程
https://docs.qq.com/doc/DRkZTaWRzdFVLWktL

1、设置桌贴码

客人点单可以扫电视二维码，在点歌小程序进行点单。因此桌贴码非必要，可以申请配置二维码常驻，引导客人扫电视二维码点单。

如果商家需要桌贴也可以，点单桌贴码用的是“动态码”，需要批量生成、扫码绑定，然后一个个绑定包厢。操作步骤如下：

• 小程序绑定：前面步骤有扫码授权过商家主体小程序，则无需额外操作；如果没有商家主体小程序，则需要联系K米严晓红开通【来K歌】用于点单；

• 动态码跳转设置：设置扫动态码跳转小程序首页（用于绑定包厢）；
  

• 生成动态码：在包厢信息页面，设置数量，批量生成动态码；
  

• 扫码绑定包厢：将制作好的动态码贴在各个包厢。技术人员使用微信扫码，跳转商家主体小程序/来K歌小程序，选择包厢绑定；

• 动态码使用：客人微信扫码，即可跳转小程序进行点单。

2、添加联盟商家

点击“联盟商家管理”—“添加新商家”，完善联盟商家信息，通过K米审核后可上架商品进行售卖：

• 商家基础信息
• 营业时间：非营业时间，商品无法购买
• 起送金额：外卖起送费，不足时会提示凑单
• 结算账户：支持分账，需开通合并收单，详见https://open-doc.ktvme.com/read/cs/lmfz）
• 打印机设备号：填写设备背后的SN码；打印机可绑定多个KTV商家，降低成本
• 资质信息：联盟商家需要提交营业执照、食品经营许可证等信息
• …

3、添加商品

首先在下图路径，新增商品分类；

点击添加商品，填写联盟商家的单品信息，包括价格、图片、介绍等。

添加完“单品”，可以在这个页面进一步配置“套餐组合”。

4、库存预警

可设置商品库存，当商品库存低于或等于设置的数值时就会展示在列表中，点击去补货即可修改库存等信息。

5、打印机管理

本店打印机配置、打印机的语音播报方式（播报/静音）、启用停用、信息修改等，可在下图路径操作。

6、小票打印说明

• 本店打印机将自动打印所有商品（本店＋联盟）的结账单；
• 联盟打印机只打印对应联盟店铺的商品结账单；
• 本店打印的小票展示商品销售价，而联盟打印的小票展示的是商品结算价；
• 联盟店小票会显示自助K商家名称、地址、用户手机号

订单页面支持手动打印以及退款操作，退款发起后系统将自动打印退款单。

常见问题解决方案

• Q1：智控和机顶盒有版本要求吗？
• A1：视易联网智控 ZK9500/ZK9230NE/ZK9230NES/9250NE。铂锐支持铂锐AI pro这个款式。科星支持MQTT协议的智能控制盒都可以。
  机顶盒没硬性的版本要求，接智控就行。

• Q2：客人预订开房，锋云服务器如何实现开房，有什么配置需要注意？
• A2：在锋云的包厢管理工具，设置所有自助K包厢为常开状态，客人预订开房时，机顶盒一开机就是开房可点歌状态。另一方面，机顶盒的网络二代配置useLastOrderSongList=1，可确保下一波客人开房，机顶盒开机时清空歌单。

• Q3：测试电视端续费提醒时，没有出现续费二维码。
• A3：需确保网关是开启状态，且网关和机顶盒通讯正常，然后再进行测试。

• Q4：N18机顶盒，通过SaaS系统开房，机顶盒启动后突然断电，查询智控状态正常。
• A4：N18用于自助K场景的bug导致。可以修改配置文件Config.xml的参数“public”值为00（K歌）或12（全开）。
  

• Q5：客人发起团购退款，在智助通退款失败，提示商户余额不足。
• A5：没有限制退款时间，等商户账上有钱时操作退款即可。

• Q6：场所部分包厢改造自助包厢，注册新的商家编码接入SaaS，但服务器还是原先的商家编码，要怎么确保正确使用？
• A6：在对接群提供原商家编码和SaaS商家编码，由K米产品或交付负责人配置映射关系，确保续费二维码可正常推送。

• Q7：测试小程序预订开房时提示“商家号非法或不存在!!”
• A7：智助通后台，设备管理-控制器全局设置，视易客户编码应该填写E123456这种格式的智控商户号，路径：视易物联网云平台-增值-智控中心-客户列表-客户编号。

• Q8：扫桌贴码提示“与KTV通讯异常”
• A8：点单功能未开通，需要联系K米严晓红yanxiaohong@star-net.cn开通。