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

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.1 企业登录表单

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

3.2 发票同步表单

1）将需要同步的发票信息，以字段形式添加至本表单：

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

4. 按钮配置

4.1 添加执行事件

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

4.2 设置事件名称和说明

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

4.3 设置执行动作

1）设置执行动作如下：

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

5. 智能助手Pro配置

5.1 新建智能助手Pro

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

5.2 配置触发动作

定时触发参考设置：

5.3 配置触发动作

添加插件节点，进行如下设置：

5.4 获取版式文件

5.4.1 配置查询节点

点击节点连接线上的加号按钮，添加查询节点，查询节点设置如下：

5.4.2 配置循环容器

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

5.4.3 配置循环插件节点

在循环容器中添加插件节点，进行如下设置：

5.5 保存并启用

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

6. 注意事项

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

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

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

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

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

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

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

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

如该插件用于流程表单中，需要注意开启流程自动审批批量写入表单时，插件执行耗时会大大增加，同步数据量过大，可能会导致超时。

7. 联系方式

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