开具数电发票插件

1. 简介

1.1 插件简介

开具数电发票插件支持连接电子税务局，自动开具数电发票(专票/普票)（蓝票/红票），并返回开票日期、发票号码、发票文件、发票地址，且可设置邮箱进行发票的对外交付。

1.2 应用场景

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

1.3 预期效果

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

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

1.4 使用说明

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

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

2. 插件安装及配置

2.1 安装插件

1）直接安装

2）插件市场处安装

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

2.2 配置插件

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

2.3 启用插件

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

3. 表单搭建

3.1 创建表单

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

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

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

3.2 流程设定

流程表单配置完成后，切换至「流程设定」中，进行流程配置。

3.2.1 配置流程发起节点

点击流程发起节点，进行以下操作：

3.2.2 配置审批节点

1）点击审批节点，在「节点属性 >> 节点名称」处，修改节点名称为「开票审批」；在「节点属性 >> 负责人」处，选择审批负责人。如下所示：

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

3.2.3 启用流程

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

3.3 设置字段别名

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

4. 按钮配置

4.1 添加执行事件

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

4.2 设置事件名称和说明

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

4.3 设置执行动作

1）设置执行动作如下：

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

5. 智能助手配置

5.1 添加智能助手

在「扩展功能」处添加「智能助手」，并修改智能助手名称为「开具数电发票」。

5.2 设置触发动作

根据使用场景需要，选择对应的触发动作。以开票申请流转完成后开具数电发票为例，设置触发动作如下：

设置完成后点击「完成」。

5.3 设置执行动作

1）开票申请流转完成后，触发「开具数电发票」插件，故执行动作在「插件」中选择「开具数电发票」。

2）设置执行动作如下所示：

设置完成后，点击「完成」按钮，保存智能助手设置。

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 关于流程自动化的说明

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

8. 联系方式

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