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

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(微信同号)

文档内容是否对您有帮助?
有帮助
没帮助没帮助
如需获取即时帮助,请联系技术支持
咨询
扫码领取100+零代码资料简道云官方微信号400-111-0890
图标在线咨询
立即体验