1 功能介绍

长链接可以支持异地开收票，勾选确认等，从而解决不同区域税盘无法共用问题，如税盘在A地区的分子公司A，其他地区分子公司可通过长链接的方式调用A地区的组件从而进行开收票等操作。

2 基础配置

2.1 更新补丁

以下补丁以及发布日期在之后的补丁，支持长链接功能。

2.2 网络权限

互联网访问权限，内网可单独申请访问发票云相关权限：

IP地址:52.82.108.50

端口：443

端口：80

443与80两个端口都需要申请。

2.3 EAS金税互联设置

（1）采用长链接调用或者局域网内的http调用方式，具体在EAS金税互联设置的http地址进行配置，比如：

适用局域网内的http地址：

http：//172.20.105.60：61624

长链接的http地址：https://wss.piaozone.com/bill-websocket/invoicewebsocket/push?name=3de1f420ed08409bbc3d4b9a156b49453312345667

（2）长链接的链接地址拼接方式：接口地址+发票云秘钥+税盘号

接口地址：https://wss.piaozone.com/bill-websocket/invoicewebsocket/push?name=

发票云秘钥：如3de1f420ed08409bbc3d4b9a156b4945

税盘号：如3312345667

则链接地址为：https://wss.piaozone.com/bill-websocket/invoicewebsocket/push?name= 3de1f420ed08409bbc3d4b9a156b49453312345667

注意：当同公司税号有多个税盘时，链接地址的税盘号要修改成与当前正在启用的税盘一致！！！

2.4 EAS报文设置

管理员登录EAS，税务管理-发票管理-基础设置-金税互联日志-报文设置

根据需要，选择将V2.0组件接口的发送方式、请求方式分别更改为服务端、websocket。

注意：当调用方式更改为http方式时（http：//172.20.105.60：61624），报文设置需要更改回客户端/http，否则会报参数错误。

2.5 发票云组件与税盘设置

（1）插上金税盘与启用发票云组件，组件保持正常启用状态；

（2）长链接地址中的发票云秘钥要与发票云正式/测试环境相对应,即当秘钥为正式秘钥时，发票云组件要启用正式组件；当秘钥为测试秘钥时，需启用发票云测试组件；否则，将提示找不到客户端。

3 常见问题

3.1 查无此客户端，推送失败

（1） 没有更新补丁，请参考第二节补丁列表。

（2） 没有启用发票云组件或者没有插上税盘，重启组件。

（3） 当前请求地址中的秘钥，税盘与实际启用的税盘不一致。

（4） 当前请求接口的报文设置没有更改为服务端/websocket。

可通过金税互联日志请求地址判断是否修改，当请求地址后面拼接；了请求参数，则报文设置没有更改，如下：

（5） 正式/测试秘钥没有与启用的正式/测试发票云组件对应。

3.2 金税互联设置访问超时

（1） 没有网络权限，请检查网络权限，排查仍没解决请求助发票云同事:

分别Telnet发票云的ip端口（52.82.108.50 443/80）检查是否连接成功

连接成功