精通、通娱支持独立K米通讯服务的说明文档
一、用途说明
部分精通、通娱的管理系统项目,没有配套使用我们的点播系统,或者没有配置网关服务器,又需要使用K米平台的功能,这种情况就需要配置使用管理系统的独立K米通讯服务。
二、系统版本要求
1、精通系统版本
精通标准版V3.6.20201104及以上
独立酒水版本:集成在机顶盒升级包中
2、通娱系统版本
通娱A-V3.0.20210108及以上
独立酒水版本:集成在机顶盒升级包中
3、锋云服务器(小网环境)
版本:EVS7600/NAS1000 V4.5.2
或以上
说明:
更新时间:20210203
4、机顶盒版本
N07/N07S/N08,配套支持的机顶盒版本即可
3、网关服务器
如果场所有使用网关服务器,又想通过管理系统直接与K米通讯,则网关服务器需要以下配置要求:
网关服务器版本在V2.81及以上
,且【管理系统配套服务】需要设置为【关闭】状态
注:如果网关服务器未升级或服务未关闭,会出现管理系统和网关同时和K米通讯,导致数据异常。
三、管理系统配置说明
1、精通系统
(1)启用K米通讯接口
路径:精通后台管理系统→参数设置→K米通讯接口设置,勾选启用,填写商家编码和密码并保存。
注意:如果在参数设置没有找到【K米通讯接口】,请检查管理系统版本是否低于要求
(2)重启小企鹅服务
重启后可以看到小企鹅服务列表增加了【K米通讯接口】
2、通娱系统
(1)配置【K米通讯接口】运行机器
路径:通娱后台系统→运营设置→服务设置,配置“K米通讯接口服务”运行在哪台机器上,这台机器直接与K米平台通讯,因此需要确保可以上外网。
注:建议短信、web、K米通讯等需要联外网的服务,使用单独电脑运行,不要配置在利云服务器上,避免病毒等安全问题。
(2)配置K米通讯接口参数
路径:通娱后台系统→运营参数→营业参数设置→K米通讯接口,填写商家编码和密码并保存。
注:管理系统启用K米通讯服务后,就不需要连接网关服务器,因此原系统配置的“网关服务器IP”将自动修改为启用K米服务的机子IP,这个配置不能修改为实际网关服务器的地址(如果有网关的话)。
(3)重启通娱服务管理器
重启后可以看到通娱服务管理器增加了【K米通讯接口】
3、线上数据清除
前面几步操作完成后,为了确保线上不会存在历史脏数据,导致冲突,需要在代理商平台进行:
①删除线上数据
重要说明:
如果是同一个商家切换无网关模式,不需要清除线上智慧数据
②重置管理系统版本
③重置网关MAC地址
4、执行数据重传,同步基础数据
在管理系统对应的数据库上执行数据初始化脚本,上传会员信息等基础数据
四、无网关版本常见问题
问题1:K米通讯接口出现日志错误:1003 授权失败
问题2:同步数据失败:参数access_token为空
问题3:K米通讯接口出现日志错误:无法连接网关服务器
问题4:各服务日志都没报错,就是不同步数据:
问题5:无网关收银系统配置完成后,通讯时好时坏
{“ret”:6662004,”msg”:”商家 40312 线下协议出现超时 代理商平台清除mac地址信息后,好了一会,再过一会,又出现智慧KTV通讯异常的错误 这种情况下,先检查场所是不是使用的NAS版本,如果是确认NAS版本