开具数电发票插件

1. 简介

1.1 插件简介

开具数电发票插件支持连接电子税务局，自动开具数电发票(专票/普票、蓝票/红票），同时支持货物运输服务、建筑服务和不动产经营租赁服务这 3 种特定业务下的数电发票开具，并返回开票日期、发票号码、发票文件、发票地址，且可设置邮箱进行发票的对外交付。

1.2 应用场景

常用于根据销售订单、开票申请等进行自动开具发票，并通过邮件进行发票的对外交付。

1.3 预期效果

1）开票申请人在「开票申请」提交开票申请信息后，财务审批人员进行审批，待开票数据审核通过后，在「数据管理」处自动新增开具的数电发票。效果如下所示：

2）若需要对发票进行对外交付，根据表单内填写的邮箱地址自动发送邮件。效果如下所示：

1.4 使用说明

1）该插件包含 8 种事件，如下所示：

2）开具数电发票插件为免费插件，但插件配置时的销方授权码需联系开发者购买。

2. 插件安装及配置

2.1 安装插件

1）直接安装

2）插件市场处安装

在简道云「插件市场」处，安装「开具数电发票」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

2.2 配置插件

在插件管理中，点击插件右侧「设置」按钮，将「简道云API Key」「销方授权码」配置进去，配置完成后点击「保存」。

2.3 启用插件

在插件管理中，打开「开具数电发票」插件右侧开关，启用插件。

3. 表单搭建

3.1 创建表单

1）以开票申请为例，新建「开票申请」流程表单，字段设置如下所示：

2）点击「开票金额.金额」，在「字段属性 >> 默认值」处，选择「公式编辑」，编辑公式为：

发票明细.数量*发票金额.单价（含税）

3.2 设置字段别名

进入「扩展功能 >> 数据推送」中，点击设置字段别名，依次将字段别名设置为下方别名，设置完成后，点击「保存」按钮。设置如下所示：

4. 按钮配置

4.1 添加执行事件

点击「发送验证码」按钮，进入「字段属性」，点击执行动作下的设置，添加执行动作：

4.2 设置事件名称和说明

添加好执行动作后，首先设置前端事件的基础信息，即事件名称和事件说明，用于区分执行动作：

4.3 设置执行动作

1）设置执行动作如下：

2）设置执行返回信息回填至哪些字段中，设置完成点击「保存」。

5. 流程节点配置

「API 版」「无 API 版」流程节点配置相似，此处以「API 版」做示范进行展示，「无API 版」配置时插件选择「开具数电发票 >> 5.开具数电发票-API 版」即可。

5.1 流程发起节点

点击流程发起节点，在「节点属性 >> 节点名称」处，在「节点属性 >> 字段权限」处，勾选如下部分字段的「可见」、「可编辑」权限：

5.2 配置财务登录&刷脸节点

1）点击流程审批节点，在「节点属性 >> 节点名称」处，修改节点名称为「财务登录&刷脸」，并根据业务需求选择节点负责人，如下所示：

2）在「字段权限」处，勾选部分字段的「可见」、「可编辑」权限。如下所示：

5.3 配置开具数电发票节点

5.3.1 添加插件节点

在「流程设定」中，从工具栏中选择「插件节点」，将其拖动至流程图中，通过流程连接线将全部流程节点串联起来。

5.3.2 配置插件节点

1）选中插件节点，在「节点属性 >> 节点名称」处设置节点名称为「开具数电发票」，然后点击「插件配置」：

2）进入插件配置页面，插件配置如下所示：

全部设置完成后，点击「确定」按钮。

5.4 配置重新获取发票节点

5.4.1 添加插件节点

在「流程设定」中，从工具栏中选择「插件节点」，将其拖动至流程图中，通过流程连接线将全部流程节点串联起来。

5.4.2 配置插件节点

1）选中插件节点，在「节点属性 >> 节点名称」处设置节点名称为「重新获取发票」，然后点击「插件配置」：

2）进入插件配置页面，插件配置如下所示：

全部设置完成后，点击「确定」按钮。

5.5 配置节点连线

1）点击「开具数电发票」和「重新获取发票」之间的节点连接线，在右侧「节点连接线 >> 数据流转条件」处，选择「使用自定义流转条件」，设置流转条件如下所示：

2）点击「开具数电发票」和「流程结束」之间的节点连接线，在右侧「节点连接线 >> 数据流转条件」处，选择「使用 Else 条件」，如下所示：

6. 红冲发票流程节点设置

6.1 流程发起节点

点击流程发起节点，在「节点属性 >> 节点名称」处，修改节点名称为「发起红票申请」；在「节点属性 >> 字段权限」处，勾选部分字段的「可见」、「可编辑」权限：

6.2 插件节点

6.2.1 添加插件节点

在「流程设定」中，从工具栏中选择「插件节点」，将其拖动至流程图中，通过流程连接线将全部流程节点串联起来。

6.2.2 设置插件节点

1）选中插件节点，在「节点属性 >> 节点名称」处设置节点名称为「开具红冲发票」，然后点击「插件配置」：

2）进入插件配置页面，在下拉框中选择「开具数电发票」插件，再选择「7. 红冲发票」函数：

3）选择好插件后，将自动展示该插件需要配置的请求参数，分别以「字段值」方式配置「销方税号」「购方税号」「蓝票号码」「蓝票日期」「发票类型」「红冲原因」；

4）点击「添加」，设置插件的返回参数的存储关系，将返回值「红票号码」「红票地址」「红票日期」「红票请求ID」「红冲结果」存储到表单已有字段中，设置完成点击「确定」。

6.3 启用流程

流程设定完成后，点击「保存」后，再点击「启用流程」，即可启用当前流程。

6.4 效果演示

效果参见本文【1.3 预期效果】。

7. 注意事项

7.1 关于销方地区的说明

请根据销方所在地区，填写以下标准名称：

北京市、天津市、河北省、山西省、内蒙古、辽宁省、大连市、吉林省、黑龙江省、上海市、江苏省、浙江省、宁波市、安徽省、福建省、厦门市、江西省、山东省、青岛市、河南省、湖北省、湖南省、广东省、深圳市、广西、海南省、重庆市、四川省、贵州省、云南省、西藏、陕西省、甘肃省、青海省、宁夏、新疆。

7.2 关于登录时税局手机号的说明

除广东、天津、浙江、湖北外，其他地区税局手机号都是必传。

且广东、天津、浙江、湖北四个地区，仅需要做登录，不需要发送验证码，可直接进入刷脸认证环节。

7.3 关于登录扫脸状态控制的说明

因登录和扫脸存在失效，因次在需要开票前做一次状态的检测，以确保可以正常开票。

在「发起刷脸认证」和「获取刷脸结果」事件中检测到状态有效时，均会返回一个最新的时间，可以在流程节点中设置一个提交校验：DATEDIF(刷脸认证时间,NOW(),"m")<=1，以便控制正好在检查了最新的状态为有效时才能提交，去开具数电发票。

7.4 关于税收分类编码和名称基础表

开票时需要传19位的税收分类编码和名称，可参考右表，选择自己公司所需的编码和名称：税收分类编码和名称表.xls

7.5 关于购方名称/税号的说明

请在开具发票前确保购方名称、购方税号的信息一致性，避免开具的发票购方名称不对，建议在建立客户档案的校验一下购方名称，或者在开票申请时校验一下购方名称、购方税号的信息一致性。

7.6 关于价税分离的说明

本插件统一采用含税金额进行开票，若企业需要分别统计不含税金额和税额、可在表单中预先计算好该金额。

7.7 关于流程自动化的说明

帮忙文档中的配置按照常规操作步骤逐一展开的，若用户想通过流程去自动判断登录/扫脸的状态，根据返回值再去做当前需要执行的动作，可参考以下设置方面，在流程中去做判断，由于情况分支比较多，整个流程的节点会相对较多。

7.8 关于展示销方和购方信息的说明

7.8.1 新增表单字段

在表单中新增销方/购方信息，以新增购方信息为例，字段设置如下所示：

7.8.2 配置插件

在插件配置页面，设置插件配置项如下所示：

7.9 开票时增加返回值及流程配置优化的说明

因税局网络波动，偶有发票开具后未能返回发票文件的情况发生，此次更新开票时增加返回值用于优化流程配置，可自动重新获取发票。如需配置，参考【5. 流程节点配置】；

8. 联系方式

该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：