电子税务局-进项/销项发票同步
1. 简介
1.1 插件简介
电子税务局-进项/销项发票同步插件支持自动将电子税务局中开具的进项/销项发票明细同步到简道云表单中,减少手工录入发票数据工作量。
1.2 应用场景
常用于将电子税务局-进项/销项发票数据,定时同步到简道云表单中,降低手工录入发票数据不及时和出错率高的风险,方便财务人员在简道云中统一管理发票业务。
1.3 预期效果
开启电子税务局-进项/销项发票同步同步插件,在「电子税务局-进项/销项发票同步」表单中配置定时任务后,自动在简道云表单同步发票信息。以销项发票同步为例,效果如下所示:
1.4 使用说明
1)该插件需要具有 API 权限才能使用。
2)该插件可直接插件市场安装使用,但插件配置时的销方授权码需联系开发者购买。
- 一个税号对应一个销方授权码;
- 销方授权码为 1000 元/个/年。
注:开发者联系方式详见本文:【7. 联系方式】。
2. 插件安装及配置
2.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:电子税务局-进项/销项发票同步插件安装。
- 安装成功后,可参考本文【2.2 配置插件】和【2.3 启用插件】,前往「开放平台 >> 插件管理」处配置并启用插件。
2)在简道云「插件市场」处,安装「用友好会计-凭证同步」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。
2.2 配置插件
在插件管理中,点击插件右侧「设置」按钮,将「简道云API Key」「销方授权码」配置进去,配置完成后点击「保存」。
注:
1)简道云API Key为必填项。
2)销方授权码需联系开发者获取。
2.3 启用插件
在插件管理中,打开「电子税务局-进项/销项发票同步」插件右侧开关,启用插件。
3. 表单搭建
插件使用体验可先安装:电子税务局-进项/销项发票同步模板表单。本文将按照示例表单进行讲解。
3.1 企业登录表单
1)新建「企业登录」表单,字段设置如下所示:
字段说明 | 字段名称 | 是否必填 | 字段类型 |
企业登录-发送登录验证码 | 销方地区 | 是 | 下拉框,下拉框内容设置详见【6.1 关于销方地区的说明】 |
销方税号 | 新增一个销方税号字段,用于前端事件配置。 | ||
用户名 | 单行文本 注:此处填写为登录电子税务局的用户名和密码 | ||
用户密码 | |||
身份类型 | 下拉框,设置下拉框选项为:
| ||
税局手机号 | 单行文本 | ||
发送验证码 | 按钮 | ||
企业登录-上传登录验证码 | 登录任务ID | 是 | 单行文本 |
短信验证码 | |||
上传验证码 | 按钮 | ||
登录结果 | 单行文本 | ||
企业登录-发起刷脸认证&检测登录刷脸状态 | 发起刷脸认证 | 是 | 按钮 |
刷脸认证ID | 单行文本 | ||
刷脸认证二维码 | |||
发起刷脸结果 | |||
发起刷脸时间 | 日期时间,设置类型为【年-月-日 时:分:秒】 | ||
企业登录-获取刷脸结果 | 获取刷脸结果 | 是 | 按钮 |
刷脸认证结果 | 单行文本 | ||
刷脸认证时间 | 日期时间,设置类型为【年-月-日 时:分:秒】 |
注:
1)表单中的按钮字段,需购买销方授权码并安装下载【开具数电发票插件】,开启配置插件后再进行按钮配置。
2)本插件中的企业登录和【开具数电发票插件】所用的配置和函数相同
- 如已使用【开具数电发票插件】直接使用原表单中的企业登录即可。
- 如未使用【开具数电发票插件】,则可在本应用中新建一个企业登录表单,使用【开具数电发票插件】中的函数,参考文档重新配置,只需确保数据同步执行时,税局登录在有效时长内即可。
3.2 发票同步表单
1)将需要同步的发票信息,以字段形式添加至本表单:
字段名称 | 字段类型 |
发票类型 | 单行文本 |
开票类型 | |
发票号码 | |
纸质发票号码 | |
纸质发票代码 | |
开票方纳税人识别号 | |
销方税号 | |
购方名称 | |
购方税号 | |
购方名称 | |
合计金额 | |
合计税额 | |
价税合计 | |
开票员姓名 | |
发票状态 | |
原发票号码 | |
开票日期 | 日期时间,年-月-日 时:分 |
2)表单搭建完成后,在「扩展功能 >> 数据推送」处,点击「设置字段别名」,字段别名设置如下:
- 发票类型:fplxdm
- 开票类型:kplx
- 发票号码:fphm
- 纸质发票代码:zz_fpdm
- 纸质发票号码:zz_fphm
- 开票方纳税人识别号:kpf_nsrsbh
- 销方税号:xsf_nsrsbh
- 销方名称:xsf_nsrmc
- 购方税号:gmf_nsrsbh
- 购方名称:gmf_nsrmc
- 合计金额:hjje
- 合计税额:hjse
- 价税合计:jshj
- 开票员姓名:kpr
- 发票状态:fpztdm
- 原发票号码:lpfphm
- 开票日期:kprq
4. 按钮配置
企业税局登录中,「1.发送登录验证码」、「2.上传登录验证码」、「3.发起刷脸认证&检测登录刷脸状态」、「4.获取刷脸结果」这 4 个执行动作均为按钮触发,配置方式相同。本章节以「发送登录验证码」为例,具体配置步骤如下所示:
4.1 添加执行事件
点击「发送验证码」按钮,进入「字段属性」,点击执行动作下的设置,添加执行动作:
4.2 设置事件名称和说明
添加好执行动作后,首先设置前端事件的基础信息,即事件名称和事件说明,用于区分执行动作:
4.3 设置执行动作
1)设置执行动作如下:
- 选择插件:选择「开具数电发票」插件;
- 选择执行动作:1.发送登录验证码
- 配置参数:分别以「字段值」方式配置销方税号、销方地区、用户名、用户密码、身份类型、税局手机号;
2)设置执行返回信息回填至哪些字段中,设置完成点击「保存」。
注:
1)「3.发起刷脸认证&检测登录刷脸状态」和「4.获取刷脸结果」都有认证结果、认证时间两个返回值,因前端事件不支持重复赋值,「3.发起刷脸认证&检测登录刷脸状态」返回到发起刷脸结果和发起刷脸时间字段中,「4.获取刷脸结果」返回到刷脸认证结果和刷脸认证时间中。
2)此处配置方式和用到的插件函数,同【开具数电发票插件 >> 4. 按钮配置】配置相同,可点击参考。
5. 智能助手Pro配置
5.1 新建智能助手Pro
进入「发票同步」表单中,在「扩展功能 >> 智能助手」处,点击「新增智能助手」,修改智能助手Pro 的名称为「客定时线索同步」,并选择触发方式为定时触发:
5.2 配置触发动作
定时触发参考设置:
- 触发时间类型:选为自定义时间;
- 重复触发:每月触发一次;
- 结束触发时间:2025-11-16
注:定时触发配置仅做参考,可根据实际业务勾选「重复触发」及「结束触发时间」。
5.3 配置触发动作
添加插件节点,进行如下设置:
- 插件读写表单「电子税务局-销项发票同步」
- 执行插件:选择「电子税务局-进项/销项发票同步」;
- 应用 ID:选择组合,勾选「插件读写表单-应用 ID(ID)」;
- 表单 ID:选择组合,勾选「插件读写表单-表单 ID(ID)」;
- 销方税号:选择自定义,填写销方税号;
- 同步日期:选择自定义,勾选「上月」。可根据企业实际需求进行勾选,选项包含昨天/今天、上周/本周、上月/本月、去年/今年;
- 发票类型:选择自定义,勾选「销项」;
- 扩展字段:如有其他扩展字段内容同步,可在表单中拼接后,勾选到扩展字段中。
注:
1)同步日期,根据企业实际需求勾选,但建议根据企业实际开票量进行评估,一次同步的发票数据量不宜太大。
2)发票类型目前仅有销项选项,后续迭代会更新进项发票同步。
5.4 保存并启用
全部设置完成后,点击右上方「保存并启用」,启用智能助手。
6. 注意事项
6.1 关于登录时填写销方地区的说明
请根据销方所在地区,填写以下标准名称:
北京市、天津市、河北省、山西省、内蒙古、辽宁省、大连市、吉林省、黑龙江省、上海市、江苏省、浙江省、宁波市、安徽省、福建省、厦门市、江西省、山东省、青岛市、河南省、湖北省、湖南省、广东省、深圳市、广西、海南省、重庆市、四川省、贵州省、云南省、西藏、陕西省、甘肃省、青海省、宁夏、新疆。
注:以上名称中某些城市是独立的税局,因此销方所在地区需要传具体的城市,不能再传省。
6.2 关于登录时税局手机号的说明
除广东、浙江外,其他地区税局手机号都是必传。建议首次登录使用时,按 1-4 登录步骤进行操作,如「3.发起刷脸认证&检测登录刷脸状态」返回 succese,则证明登录在时效内,可以直接同步数据。
6.3 关于流程表单同步数据的说明
如该插件用于流程表单中,需要注意开启流程自动审批批量写入表单时,插件执行耗时会大大增加,同步数据量过大,可能会导致超时。
7. 联系方式
该插件为官方合作的服务商开发,若您在使用过程中有任何疑问,可通过以下方式咨询:
- 公司:成都轻如燕企业服务有限公司
- 联系人:赵鹏
- 联系电话:18583980516(微信同号)