数电票开具适配改造，支持特定业务开票

发布说明

发布版本：EAS Cloud 861（计划仅支持861及以上版本）

适用范围：开票管理

上线日期：2023-08-11

补丁号：PT172918

更多内容

1. 新特性介绍

场景：金税四期推行“全面数字化的电子发票”（以下简称“数电票”），随着开票试点的扩展，用户逐步由航信百望等开票软件开票 转变为在地方电子税局开具数电票，涉及发票限行、限额、清单等功能的变动。根据经营的业务，部分用户还需开具特定业务类数电票，必须适配补充传入对应特定信息。

功能： 针对数电票与原税控发票的区别做适配改造

（1）开票类型新增“数电票（增值税专用发票）”、“数电票（普通发票）”；

（2）客商开票资料等支持数电票，对历史客商开票资料等数据升级，自动适配数电票；

（3）参数设置新增数电专票限额、数电普票限额、数电票限行参数，默认值为"0"，即不限额、不限行；

（4）应收单、开票申请单（增值税）支持一键/分步开具数电票；

（5）开票申请单（增值税）、开票单（增值税）支持维护数电特定业务信息，支持开具建筑服务、不动产经营租赁服务、不动产销售、货物运输服务类数电票。

2. 操作指引

2.1 环境准备

税务补丁：使用新功能前，需更新对应税务开收票补丁PT172918（或更新的开收票补丁）

依赖补丁：税务开票的发票类型在基础模块设置，如需选择“数电票”类型开具，必须更新基础模块补丁；

应收补丁：如用户通过应收单一键/分步开票，需同步更新对应的应收补丁PT170790（或更新的应收补丁）。如不涉及应收模块开票功能的使用，可忽略此补丁。

表2.1 数电开票适配补丁详情

2.2 确认金蝶发票云已升级配置

可根据链接文档EAS升级全电配置（RPA）的第2与第3章节内容做升级申请，安装并部署配置新版“发票智慧管家”组件。主要步骤包括：

（1）提交升级数电申请；

（2）发票云新版客户端安装并激活配置；

（3）网络访问环境确认。

开票时，需保证发票云本地客户端或云化客户端已登录成功。

2.3 确认已获取新版开票长链接

目前EAS开具数电票有两种长链接：

版本1：固定前缀+企业税号+企业的clientID

使用此本版本长链接时，所有发票类型不区分纸质/电子，转换为开具数电票（普通发票）/数电票（增值税专用发票）

因更新问题，系统无增值税电子专用发票类型的用户必须使用此链接，否则无法开具数电专票

表2.2 EAS开票类型转换对照表（版本1长链接）

①固定前缀为：https://api.piaozone.com/bill-websocket/v3/invoicewebsocket/push?taxNo=

②taxNo：即企业税号或纳税人识别号

③中间固定格式：&clientId=

④clientID：为发票云提供的发票云ID，clientID对应的字段值可以在激活发票云账号的邮件确认获取，也可以在原配置的金税互联设置“发票云ID”直接获取使用

【长链接组装举例】

企业税号为：123456789012345

企业的发票云ClientID：aaaaaaaaaaaaaaa

则长链接为：https://api.piaozone.com/bill-websocket/v3/invoicewebsocket/push?taxNo=123456789012345 &clientId=aaaaaaaaaaaaaaa

②固定前缀+企业税号+企业的clientID+固定后缀

使用此本版本长链接时，区分纸质/电子类型，原纸质类型转换为开具数电纸质发票（普通发票）/数电纸质发票（增值税专用发票），原电票类型转换为开具数电票（普通发票）/数电票（增值税专用发票）

数电纸质发票为过渡期产物，系统不再针对该类发票做适配，用户在过渡期间如需使用数电平台开具纸质发票，必须使用此链接，通过原纸质发票类型，转换为开具数电纸质发票。

表2.3 EAS开票类型转换对照表（版本2长链接）

①固定前缀为：https://api.piaozone.com/bill-websocket/v3/invoicewebsocket/push?taxNo=

②taxNo：即企业税号或纳税人识别号

③中间固定格式：&clientId=

④clientID：为发票云提供的发票云ID，clientID对应的字段值可以在激活发票云账号的邮件确认获取，也可以在原配置的金税互联设置“发票云ID”直接获取使用

⑤固定后缀为：&paperInvoiceFlag=1

【长链接组装举例】

企业税号为：123456789012345

企业的发票云ClientID：aaaaaaaaaaaaaaa

则长链接为：https://api.piaozone.com/bill-websocket/v3/invoicewebsocket/push?taxNo=123456789012345 &clientId=aaaaaaaaaaaaaaa&paperInvoiceFlag=1

2.4 确认金税互联设置配置正确

       EAS在金税互联设置的“HTTP地址”中配置连接发票云组件的链接，开具原税控发票还是开具数电票，均通过该HTTP地址链接标识判断。因此用户需确认已将开具数电票组织的金税互联设置HTTP地址更新为本文档2.3中的新版长链接。

操作路径：〖税务管理〗->〖发票管理〗->〖基础设置〗->〖金税互联设置〗

操作说明：如需开具数电票，但HTTP地址未更新，选择需升级数电组织的开票金税互联设置记录，禁用后点击“修改”，将新版本长链接粘贴至“HTTP地址”字段中，其余配置不做改动，保存并启用金税互联设置。

注意事项：如数电票最终票面备注中不希望携带复核人、收款人信息，请勿在金税互联设置中配置固定复核人和收款人，否则将携带至数电票备注栏

图2.1  金税互联设置配置界面 

{注：如还需开具原税控发票，可禁用原金税互联设置，复制新增一条数电金税互联设置，两条金税互联设置通过“启用/禁用”或“金税互联设置匹配条件”切换使用，如使用“发票类型”作为匹配字段，可根据业务实际情况具体分析。}

【变通实现双规制的方式】--自定义金税互联设置匹配条件

（1）单据名称=开票单（增值税）、匹配字段=发票类型、匹配字段值=增值税专用发票：对应原税控IP/长链接

（2）单据名称=开票单（增值税）、匹配字段=发票类型、匹配字段值=增值税普通发票：对应原税控IP/长链接

（3）无匹配条件-即除了（1）、（2）的特定场景，其余情况下开票都使用此配置：对应数电长链接

2.