精通、通娱支持独立K米通讯服务的说明文档

一、用途说明

部分精通、通娱的管理系统项目,没有配套使用我们的点播系统,或者没有配置网关服务器,又需要使用K米平台的功能,这种情况就需要配置使用管理系统的独立K米通讯服务。

二、系统版本要求

1、精通系统版本

精通标准版V3.6.20201104及以上

独立酒水版本:集成在机顶盒升级包中

2、通娱系统版本

通娱A-V3.0.20210108及以上

独立酒水版本:集成在机顶盒升级包中

3、锋云服务器(小网环境)

版本:EVS7600/NAS1000 V4.5.2或以上 说明:二、无网关版本管理系统配置使用说明 - 图1

更新时间:20210203

4、机顶盒版本

N07/N07S/N08,配套支持的机顶盒版本即可

3、网关服务器

如果场所有使用网关服务器,又想通过管理系统直接与K米通讯,则网关服务器需要以下配置要求:

网关服务器版本在V2.81及以上,且【管理系统配套服务】需要设置为【关闭】状态 二、无网关版本管理系统配置使用说明 - 图2 注:如果网关服务器未升级或服务未关闭,会出现管理系统和网关同时和K米通讯,导致数据异常。

三、管理系统配置说明

1、精通系统

(1)启用K米通讯接口

路径:精通后台管理系统→参数设置→K米通讯接口设置,勾选启用,填写商家编码和密码并保存。

注意:如果在参数设置没有找到【K米通讯接口】,请检查管理系统版本是否低于要求 二、无网关版本管理系统配置使用说明 - 图3

(2)重启小企鹅服务

重启后可以看到小企鹅服务列表增加了【K米通讯接口】 二、无网关版本管理系统配置使用说明 - 图4

2、通娱系统

(1)配置【K米通讯接口】运行机器

路径:通娱后台系统→运营设置→服务设置,配置“K米通讯接口服务”运行在哪台机器上,这台机器直接与K米平台通讯,因此需要确保可以上外网。

注:建议短信、web、K米通讯等需要联外网的服务,使用单独电脑运行,不要配置在利云服务器上,避免病毒等安全问题。

二、无网关版本管理系统配置使用说明 - 图5

(2)配置K米通讯接口参数

路径:通娱后台系统→运营参数→营业参数设置→K米通讯接口,填写商家编码和密码并保存。 二、无网关版本管理系统配置使用说明 - 图6

注:管理系统启用K米通讯服务后,就不需要连接网关服务器,因此原系统配置的“网关服务器IP”将自动修改为启用K米服务的机子IP,这个配置不能修改为实际网关服务器的地址(如果有网关的话)。 二、无网关版本管理系统配置使用说明 - 图7

(3)重启通娱服务管理器

重启后可以看到通娱服务管理器增加了【K米通讯接口】

二、无网关版本管理系统配置使用说明 - 图8

3、线上数据清除

前面几步操作完成后,为了确保线上不会存在历史脏数据,导致冲突,需要在代理商平台进行:

①删除线上数据

重要说明: 如果是同一个商家切换无网关模式,不需要清除线上智慧数据

②重置管理系统版本

③重置网关MAC地址

二、无网关版本管理系统配置使用说明 - 图9

4、执行数据重传,同步基础数据

在管理系统对应的数据库上执行数据初始化脚本,上传会员信息等基础数据

四、无网关版本常见问题

问题1:K米通讯接口出现日志错误:1003 授权失败

二、无网关版本管理系统配置使用说明 - 图10

问题2:同步数据失败:参数access_token为空

二、无网关版本管理系统配置使用说明 - 图11

问题3:K米通讯接口出现日志错误:无法连接网关服务器

二、无网关版本管理系统配置使用说明 - 图12

问题4:各服务日志都没报错,就是不同步数据:

二、无网关版本管理系统配置使用说明 - 图13

问题5:无网关收银系统配置完成后,通讯时好时坏

{“ret”:6662004,”msg”:”商家 40312 线下协议出现超时 代理商平台清除mac地址信息后,好了一会,再过一会,又出现智慧KTV通讯异常的错误 这种情况下,先检查场所是不是使用的NAS版本,如果是确认NAS版本 二、无网关版本管理系统配置使用说明 - 图14