电子税务局-进项/销项发票同步

1. 简介

1.1 插件简介

电子税务局-进项/销项发票同步插件支持自动将电子税务局中开具的进项/销项发票信息、发票明细和发票文件同步到简道云表单中，减少手工录入发票数据工作量‌。

1.2 应用场景

常用于将电子税务局-进项/销项发票数据，定时同步到简道云表单中，降低手工录入发票数据不及时和出错率高的风险，方便财务人员在简道云中统一管理发票业务。

1.3 预期效果

开启电子税务局-进项/销项发票同步同步插件，在「电子税务局-进项/销项发票同步」表单中配置定时任务后，自动在简道云表单同步发票信息、发票明细和进销项发票文件。以销项发票同步为例，效果如下所示：

1.4 使用说明

1）该插件需要具有 简道云API 权限才能使用。

2）该插件可直接插件市场安装使用，但插件配置时的销方授权码需联系开发者购买。

2. 插件安装及配置

2.1 安装插件

1）直接安装

2）在简道云「插件市场」处，安装「电子税务局-进项/销项发票同步」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

2.2 配置插件

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

2.3 启用插件

在插件管理中，打开「电子税务局-进项/销项发票同步」插件右侧开关，启用插件。

3. 表单搭建

插件配置需要使用 3 张表单，分别是：

完成以上配置及授权后，即可开始配置插件。

3.1 企业登录表单

1）新建「企业登录」表单，字段设置如下所示：

3.2 发票同步中间表单

1）将发票同步的相关内容，以字段形式添加至本表单：

2）表单搭建完成后，在「扩展功能 >> 数据推送」处，点击「设置字段别名」，字段别名设置如下：

3.3 发票同步目标表单

1）将目标表中所需发票信息，以字段形式添加至本表单：

2）表单搭建完成后，在「扩展功能 >> 数据推送」处，点击「设置字段别名」，字段别名设置如下：

4. 按钮配置

4.1 添加执行事件

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

4.2 设置事件名称和说明

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

4.3 设置执行动作

1）设置执行动作如下：

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

5. 智能助手Pro配置

5.1 发票同步

5.1.1 新建智能助手

进入「发票同步目标表」表单中，在「扩展功能 >> 智能助手」处，点击「新增智能助手」，修改智能助手Pro 的名称为「发票同步」，并选择触发方式为定时触发：

5.1.2 配置触发动作

定时触发参考设置：

5.1.3 配置插件节点

添加插件节点，修改节点名称为「发票同步中间表」，进行如下设置：

5.1.4 配置循环容器

点击节点连接线上的加号按钮，添加循环容器节点，循环容器节点设置如下：

5.1.5 配置查询节点

在循环容器中添加查询节点，修改名称为：查询中间表，进行如下设置：

5.1.6 设置条件分支

在查询数据后添加条件分支节点，条件设置如下：

1） 设置 新增/修改目标表 节点：

分支条件下方添加「修改数据节点」，修改节点名称为「新增/修改目标表」，进行如下设置：

2） 设置 新增/修改目标表 节点：

「新增/修改目标表」下方添加「修改数据节点」，修改节点名称为「修改中间表状态」，进行如下设置：

3） 设置 结束循环 节点：

5.2 获取发票明细和文件

5.2.1 创建智能助手

进入「发票同步目标表」表单中，在「扩展功能 >> 智能助手」处，点击「新增智能助手」，修改智能助手Pro 的名称为「发票同步」，选择触发方式为「表单触发」并选择「发票同步目标表」表单。

5.2.2 设置触发动作

点击添加动作按钮，表单触发动作设置如下：

5.2.3 新增计算节点

5.2.4 设置发票明细节点

添加插件节点，修改节点名称为「发票明细」，进行如下设置：

5.2.5 设置条件分支

1）在发票明细同步插件节点后添加条件分支节点，条件设置如下：

2）在分支条件后，添加插件节点，修改节点名称为「数电票文件下载」，进行如下设置：

5.2.6 保存并启用智能助手

全部设置完成后，点击右上方「保存并启用」，启用智能助手。

6. 注意事项

6.1 关于登录时填写销方地区的说明

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

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

注：以上名称中某些城市是独立的税局，因此销方所在地区需要传具体的城市，不能再传省。

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

除广东、浙江外，其他地区税局手机号都是必传。建议首次登录使用时，「1.发送验证码」中点击发送验证码按钮，在「2.上传登录验证码」的【登录任务ID】重返回「succese」，即表示登录状态目前为有效，可以直接同步数据。

广东、浙江虽不用验证码登录，但也需在「1.发送验证码」中点击发送验证码按钮，校验是否在登录状态。

6.3 关于流程表单同步数据的说明

如该插件用于流程表单中，插件执行耗时会大大增加，同步数据量过大，可能会导致超时。

6.4 关于同步特定业务发票明细到表单的说明

目前支持部分特定业务发票明细拿回，如有下方特定业务发票明细内容需同步至表单，可安装使用：电子税务局-进项/销项发票同步应用模板，模板中以不动产经营租赁特定业务发票为例，其他特定业务发票设置相似，即添加需新增的表单字段和别名。字段和别名可参考下方：

7. 联系方式

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